Anda di halaman 1dari 85

C-DOT DSS MAX

APPLICATION NOTE ON RGEN/CMD UTILITY


(w.r.t. Software 2_1_1_1)

System Practices

Section No. 400-654-0457 Draft 04, August 2000

C-DOT DSS MAX

APPLICATION NOTE ON RGEN/CMD UTILITY


(w.r.t. Software Release 2_1_1_1)

2000, C-DOT Printed in India

C-DOT DSS MAX APPLICATION NOTE ON RGEN/CMD UTILITY (w.r.t. Software Release 2_1_1_1)

DRAFT 04 AUGUST 2000 BHADRA 2057 SERIES 600 : SOFTWARE CSP SECTION NO. 400-654-0457 THIS CDOT SYSTEM PRACTICE REFERS TO THE CDOT DIGITAL SWITCHING SYSTEM MAIN AUTOMATIC EXCHANGE (ABBREVIATED AS CDOT DSS MAX IN THE REST OF THIS PUBLICATION).

THE INFORMATION IN THIS SYSTEM PRACTICE IS FOR INFORMATION PURPOSES AND IS SUBJECT TO CHANGE WITHOUT NOTICE.

A COMMENT FORM HAS BEEN INCLUDED AT THE END OF THIS PUBLICATION FOR READER'S COMMENTS. IF THE FORM HAS BEEN USED, COMMENTS MAY BE ADDRESSED TO THE DIRECTOR (SYSTEMS ), CENTRE FOR DEVELOPMENT OF TELEMATICS, 39, MAIN PUSA ROAD, NEW DELHI - 110 005

2000 BY CDOT, NEW DELHI.

Table of Contents
Chapter 1. Chapter 2. Chapter 3. Introduction ..............................................................................................................................5 Utilities Present .......................................................................................................................6 Loading Procedure....................................................................................................................7 3.1. Purpose.........................................................................................................................7 3.2. General conventions ....................................................................................................7 3.3. Installation Procedure.................................................................................................7 Operational Procedures ...........................................................................................................9 4.1. Equipage Utility ..........................................................................................................9 4.2. Subscriber Creation Utility ......................................................................................11 4.3. CRE-SPACE2.............................................................................................................15 4.4. UTIL_MBM_1............................................................................................................16 4.5. TST Utility .................................................................................................................17 4.6. Change-Port Utility...................................................................................................20 4.7. Tapecopy Utility ........................................................................................................21 4.8. PRINT Utility ............................................................................................................22 4.9. NCBRPRN utility ......................................................................................................22 4.10. RGEN Utility .............................................................................................................23 4.11. Verification of Files ...................................................................................................23 4.12. Executing A Command File ......................................................................................23 Limitations & Checks.............................................................................................................24 5.1. Limitations.................................................................................................................24 5.2. Checks ........................................................................................................................24 Rgen Utility.............................................................................................................................26 RGEN Scripts at a Glance .....................................................................................................27 Parameter Description ...........................................................................................................30 8.1. Parameter Description ..............................................................................................30 Utility Invocation ...................................................................................................................44 9.1. Syntax for Invocation ................................................................................................44 9.2. Queries .......................................................................................................................50 Output Options .......................................................................................................................52 Scripts Files ............................................................................................................................53 11.1. contrf ..........................................................................................................................53 11.2. admbsy2 .....................................................................................................................58 11.3. amtrf2.........................................................................................................................59 11.4. bmicog2 ......................................................................................................................60 11.5. bmortr2.......................................................................................................................61 11.6. bmtrf2.........................................................................................................................61 11.7. bnpdat2 ......................................................................................................................62 11.8. bphdwr2 .....................................................................................................................63 11.9. bwtgp2 ........................................................................................................................63 11.10. cdrcld2 ........................................................................................................................64 11.11. cdrcln2 ........................................................................................................................65 11.12. combil2 .......................................................................................................................65 11.13. crgrtn2........................................................................................................................66 11.14. dcbr2 ...........................................................................................................................67

Chapter 4.

Chapter 5.

Chapter 6. Chapter 7. Chapter 8. Chapter 9.

Chapter 10. Chapter 11.

11.15. 11.16. 11.17. 11.18. 11.19. 11.20. 11.21. 11.22. 11.23. 11.24. 11.25. 11.26. 11.27. 11.28. 11.29. 11.30. 11.31. 11.32. 11.33.

ictgp2 ..........................................................................................................................68 linchr2 ........................................................................................................................69 linmod2.......................................................................................................................70 linsts2 .........................................................................................................................70 ncbr2...........................................................................................................................71 ogtgp2 .........................................................................................................................72 procam2 ......................................................................................................................72 procbm2 ......................................................................................................................73 routtrf2 .......................................................................................................................74 srvckt2........................................................................................................................75 ssbr2 ...........................................................................................................................75 subfac2........................................................................................................................76 submtr2 ......................................................................................................................77 tgpchr2 .......................................................................................................................78 tgpmtr2.......................................................................................................................78 trksts2 ........................................................................................................................79 dirten2 ........................................................................................................................80 malc2 ..........................................................................................................................80 mtrsub ........................................................................................................................81
August 11, 2000

H:\HOME\MAX2111\WORD\APPRGEN2.DOC

Chapter 1.

Introduction
In this document two utilities, Command File Utilities and Report Generation Utilities are described. 1. Command File Utilities Command files form an integral part of the maintenance procedures of C-DOT DSS MAX. One situation where the command files come really handy is during the installation of DSS MAX. Creation of a command file through `crp' commands is a tedious process which takes almost the same effort of issuing the commands one by one. With a fair amount of knowledge about Unix Operating System it is very easy to create a command file containing hundreds of commands. But it is not fair to expect that all operating personnel would have adequate Unix exposure. So a few utilities have been made to ease this operation. These are discussed in detail in the following chapters. Chapter 2 describes the utilities present in this floppy and their use. Chapter 3 describes the loading procedure. Chapter 4 describes the operational procedure for all the utilities. Chapter 5 describes limitations and checks. 2. Report Generation Utilities It is a general purpose tool designed for generation of various reports related for C-DOT DSS MAX. The report generated by this tools are not as detailed as generated by CRP. The information is described in the following chapters. Chapter 6 Chapter 7 Chapter 8 Chapter 9 : : : : Rgen Utility Rgen Scripts at a Glance Parameter Description Utility Invocation Procedure Output Options Script Files
5

Chapter 10 : Chapter 11 :

APPLICATION NOTE ON RGEN/CMD UTILITY

Chapter 2.

Utilities Present
The different utilities contained by this cartridge are listed below alongwith their use & the directories in which they are loaded.

Utility util_mbm_1 equip create tst cre-space2 start-prn change-port help rgen clog print tapecopy help.txt ncbrprn

Usage To equip modules, frames and service ckts in a multimodule (MBM) exchange To create cmd-file for equipping terminal cards To create cmd-file for creation of subs To create cmd-file for tst-trm To increase Disk-space To cancel printer requests & to enable printers To change the printer port To print backup, ccb, dly.rout Report Generation Tool To take CPU history log To print long files To duplicate cartridges and floppies Text file for procedure of backups, ccb subs & daily routines For printing of detail bill record

Directory /u/admn/cmdfile /u/admn/cmdfile /u/admn/cmdfile /u/code/tool /u/code/tool /u/code/tool /u/code/tool /u/code/tool /u/admin/rgen /u/code/tool /u/code/tool /u/code/tool /u/code/tool /u/code/tool

C-DOT DSS MAX

Chapter 3.

Loading Procedure
3.1. PURPOSE When a number of terminal cards have to be equipped or hundreds of subscribers have to be created, then the need arises for a command file. A typical example is the installation of C-DOT DSS MAX. During installation, all the terminal cards in the exchange have to be equipped and a few thousands of subscribers have to be created. Specific requirements of each subscriber are not taken into consideration during this stage. So a set of commands with a pre-defined parameter set is required. Two utilities `equip' and create' help the operator in the creation of command files which can be used for equipage of terminal cards and creation of subscribers. 3.2. GENERAL CONVENTIONS The following conventions are used in this document. Text formatting convention <> Italic Normal Italic Bold Bold Face Represents `Return key Command prompts are shown in Italic Normal Any matter to be typed by the operator is shown in Italic Bold Messages which appear on the screen are shown in Bold type face Indicates

3.3.

INSTALLATION PROCEDURE These utilities are supplied in a cartridge. The cartridge contains the utilities and their support files. To load the utilities into the hard disk follow the procedure given below: Insert the cartridge in the cartridge drive in the IOP log in ADMN. Give the commands,

APPLICATION NOTE ON RGEN/CMD UTILITY

Chapter 3.

iop5x> cd / iop5x> cpio icvdu <$TAPE Remove the cartridge after the cartridge drive LED stops glowing.

C-DOT DSS MAX

Chapter 4.

Operational Procedures
4.1. EQUIPAGE UTILITY This utility is in /u/admn/cmdfile The name of the utility which creates the command file for equipping terminal cards is "equip". First change directory by command. iop5x>cd /u/admn/cmdfile <> Step 1 : Invoke the utility by typing, iop5x> equip <> This utility is a user friendly one, taking inputs from the operator one by one and creates the command file accordingly. At first, the name and version of utility appears on the screen. EQUIPAGE CMD FILE UTILITY VER 2.3 COPYRIGHT (c) C-DOT, NEW DELHI 1993 Step 2 : The first question displayed would be , whether the system configuration is SBM or MBM. If the config. is SBM, then answer as `1', otherwise answer as `2'. Enter the config. type [SBM=1 MBM=2] : 1 <> Step 3 : The next few questions are regarding the slot where from equipping have to start i.e. the starting BM No, Rack no, Frame no. and Slot no. will be asked one by one. In case the configuration is SBM then BM no. will be assumed as `1' and the question asking the BM No. will be skipped. If, it is MBM, then the BM No. will be asked. In case starting slot being 1-1-2-3, then enter as follows:

APPLICATION NOTE ON RGEN/CMD UTILITY

Chapter 4.

Enter the Base Module no.[1 to 16 ] Enter the starting rack no. [ 1 to 3 ] Enter the starting frame no. [ 1 to 6 ] Enter the starting slot no. [3-10 & 17-24] Note : 1.

: : : :

1 <> 1 <> 2 <> 3 <>

In case of SBM, if you are equipping TU1 than it will display. Please equip TU1, card by card (Trunk TU)

2.

If you give slot no. 3 of TU1 in MBM then it will display "slot for ANNC card. Restart.

Step 4 : The following question enquires about the no. of frames in which equipping is required. Suppose the equipping is necessary for 9 frames enter Enter the no. of frames to be equipped : 9 <> Step 5 : After this the hardware type of card to be equipped is asked. The choices available are CCB=1, SUB [LCC]=2, DTK-CAS=4, DTK- CCS=5, TWT=3 and E & M=7. Choose the required type. Suppose LCC is required to be equipped then enter the value as `2'. Enter the hardware type of card : 2 <> Step 6 : A warning will be displayed as follows: Please check the values before proceeding If any value is wrong, press DEL & restart At this point the operator may verify the values keyed in and if any value is found to be wrong, pressing DEL ( <x ) key enables him to get to the prompt. Operator can reinvoke the utility and proceed. Step 7 : Finally a name has to be entered for the command file to be created, for example the name can be given as "eq-sub". Enter a name for the command file : eq-sub <>

10

C-DOT DSS MAX

OPERATIONAL PROCEDURES

Step 8 : The display will show Command file creation starts.... Command file creation ends ... The command file eq-sub has been created. Following this the utility gives an option to modify the hardware type of selected cards. In this way it is possible for the operator to equip a few CCB cards in between LCC cards. Following question is displayed . Do you want to modify equipage of few slot (y/n)? If modification is required then "y" should be entered and if not required, enter "n". Giving "n" displays the iop5x> prompt. Step 9 : If "y" option is chosen then the utility will further enquire about the particular slot(s) and hardware type(s) which is to be modified. Suppose the slot to be modified is 1-1-2-10 to type CCB Enter the slot no. to be modified [BM-RACK-FRM-SLT] [Type 0 to end ] Enter hardware type for this slot Enter slot no. to be modified [BM-RACK-FRM-SLT] [Type 0 to end ] : : : 1-1-2-10 <> 1 <> 0 <>

Note that after the slot(s) to be modified is entered, the same question is answered as `0' instead of slot no. This terminates entry. The display shows Please wait ... changing entries ... Once this operation is over utility displays the following message and goes back to iop5x> prompt. HOPE YOU FOUND THIS UTILITY USEFUL Thus the command file for equipping terminal cards has been created. Operator may create as many command files as he requires but each time the name of the file should be unique and repetition should be avoided. 4.2. SUBSCRIBER CREATION UTILITY Step 1 : Change directory to "/u/admn/cmdfile" if it is not done already.
APPLICATION NOTE ON RGEN/CMD UTILITY 11

Chapter 4.

iop5x> cd /u/admn/cmdfile <> Step 2 : Invoke utility "create" as follows: iop5x> create <> Step 3 : Operation of this utility resembles the operation of "equip" utility which was discussed in the previous section. The first question will be same i.e Enter the config. type [SBM=1 MBM = 2] : Operator may enter `1' or `2' as per his requirement. Consider the config. to be MBM, then `2' has to be entered. Step 4 : The next question will be about the starting directory no. Also it will display a warning as Warning : Ensure that exch code has been created This warning should not be ignored as it is absolutely essential to create exchange code before creation of subscribers. Otherwise the command file, when executed will fail to create even a single subscriber. Also care should be taken so that the starting directory no. matches with exchange code and digit length. For example if the exchange code is "2" and digit length is "5" then the starting directory no. may be "20000". Enter the starting dir no. : 20000 <> Step 5 : The following question asks for the no. of subscribers to be created. Here also a warning is displayed as Warning : The max. no. of subscribers in a file is 999 command file cannot have more than 999 lines as per `crp' requirement and the utility creates the command files on a per-BM basis. So even if operator has to create more than 999 subscribers per BM, (as in 1.4K SBM) he has to proceed with 999 lines in one file and the rest in some other file. Enter no. of subscribers : 999 <> Step 6 : After this the starting TEN is required to be entered. For example if your starting TEN is 1-1-2-3-1 then answer questions as follows:

12

C-DOT DSS MAX

OPERATIONAL PROCEDURES

Enter the Base Module No. [1 to 32] Enter the starting rack no. [1 to 3] Enter the starting frame no. [1 to 6] Enter the starting slot no. [3-10 & 17-24] Enter the starting port no. [1 to 8] Note: 1.

: : : : :

1 <> 1 <> 2 <> 3 <> 1 <>

The utility proceeds to create subscribers in the following order. Starting from rack 1 passes to rack 2 and finally to rack 3. It omits the 24th slot TU4 of BM as it is TTC. If given for frame 1 in SBM than it will display "TU1 in SBM is Trunk TU" "Ensure your entries are ok"

2.

3.

If given for slot 3 of Ist TU it will display "Slot for Annc Card. Restart"

Step 7 : Next question is regarding default instrument type. The operator may enter the type which is in majority among the subscribers. It can be either "DECAD" (Decadic-Rotary/Push button) or "DTMF" (Tone - Push Button) Enter the instrument type [DECAD/DTMF]: DECAD <> Step 8 : Finally the utility asks about outward dialling nature of subscribers, i.e. with STD or without STD. If most of the subscribers do require STD facility, keep this option as `STD' only. The subscriber characteristics can be modified later as per specific requirement. Enter the nature of subscribers [LCL=2, STD=5, ISD=5] : 6 <> Step 9 : At this point the utility gives the message "please check the values before proceeding if some value is wrong press DEL to restart". After this the name for command file is asked which can be given as "cre-sub-1". Please note that the name is given as "cre-sub-1" so as if more than one file is required, the names can be given as "cre-sub-2" etc. Enter name for command file : cre-sub-1 <> Step 10 : The utility displays the message.

APPLICATION NOTE ON RGEN/CMD UTILITY

13

Chapter 4.

"Command file creation starts".... "Command file creation ends" .... "The command file cre-sub-1 has been created" Now one particular requirement comes into picture. If the no. of cards available in the exchange for the time being is less than the max. equipage, then it is only logical to distribute them evenly over all the TUs so that concentration can be reduced. This would lead to empty slots in between, slots where creation of subscribers have to be avoided. To do this the utility gives the user an option to avoid some slots. A question will be asked after the file creation. Do you want to avoid creation in few slots (Y/N) ? If above mentioned situation exists, choose `y' option, other wise choose "n". If `n' is chosen, the utility gives back the iop5x> prompt. Step 11 : The `y' option leads to further questions. For example if slot no. 1-2-1-3 and 1-2-624 has to be avoided, Enter the slot no. to be deleted [BM-RACK-FRM-SLT] [Type 0 to end] Enter the slot no. to be deleted [BM-RACK-FRM-SLT] [Type 0 to end] Enter the slot no. to be deleted [BM-RACK-FRM-SLT] [Type 0 to end] On giving `0' the entry will be terminated. Note: Please make sure the correct slot no is only entered, because the directory numbers meant for the deleted slots will be omitted so that in future when cards are inserted in the empty slots, they can be given the corresponding dir no., so as to maintain sequence. Display shows Input over... Please wait. Operation in progress ... and when it finishes the operation, gives back the iop5x> prompt saying. Over....Exiting HOPE YOU FOUND THIS UTILITY USEFUL
14 C-DOT DSS MAX

: 1-2-1-3 <> : 1-2-6-24<> : 0 <>

OPERATIONAL PROCEDURES

Thus the first file for subscriber creation is made. If more subscribers are required to be created then the utility has to be reinvoked and care is to be taken when giving the name for command file. Repetition should be avoided. 4.3. CRE-SPACE2 This utility increases the disk space by deleting unnecessary files. To invoke this utility type cre-space on iop5x>: iop5x>cre-space2 <> This will display following messages on screen. Creating space .... Nullifying Files of trnsf and ioh groups ... It is to be noted that the following message % Trns ... will appear only when IOP is in warm start level. % Trns-log : no queue % Trns-log : no semaphore % Trns-log : no queue % Trns-log : no semaphore % Trns-log : no queue % Trns-log : no semaphore % Trns-log : no queue % Trns-log : no semaphore Deleting all files from /u/admn/temp/ Directory... Deleting heal* files from /u/tool/script/fdt... Want Traffic Files to be deleted y/n ? If you want to delete traffic files then give option as `y', other wise `n' Note : In case of traffic files for a very long period, you should give option `n' & delete through del-fgp file only. Deleting ALL TRAFFIC FILE ... Traffic Files Deleted Wait ...

Searching And Deleting Core* ,*.log and *.bak files... Please Wait for some minutes ... Finding core* files ...
APPLICATION NOTE ON RGEN/CMD UTILITY 15

Chapter 4.

Finding *.log files ... Finding *.bak files ... Previously space was : 28438 Now Space is : 28698 Press Return key to continue ... Space Occupied by BC Month : 11 2142 Month : 10 4636 Month : 9 Month : 8 Month : 7 Month : 6 Month : 5 Month : 4 Month : 3 Month : 2 Month : 1 Month : 12 Total Blocks Consumed : 6778 Delete the File Groups Regularly by using command del-fgp-file at crp prompt using option trnsf and ioh for fgp option and return key for the first option. Also delete billing cycle bc {from date -> to date} regularly only after taking BACKUP on cartridge tape ... This shows that your detail billing files have used `6778' blocks & if the detail billing files are for more than two months then take the back-up of bc & delete these files using del-fgp with file group as bc {from date -> to date}. 4.4. UTIL_MBM_1 This utility is used in MBM exchanges to equip modules, frame, service ckts like mfc, ttc, annc of BM's. For equipping frames of LM's use crp command <equipframe. util_mbm_1 will create command files for equipage and will equip the BM's. This utility is invoked by typing on iop5x> util_mbm_1 1 2

16

C-DOT DSS MAX

OPERATIONAL PROCEDURES

where 1 & 2 are the physical BM nos, you want to equip. At one time you can give for all BM's you want to equip. The system will then display. Please wait ... Preparing command files for BM#1 Please wait .... Preparing command files for BM#2 After this following message will come respectedly till execution is over % Trns-log : no queue % Trns-log : no semaphore The Data for Required BM's has been created iop5c> Note : If while giving command you have not entered BM nos. then a error message will be displayed. Usage : util_mbm_1 no1 no2 no3 ..... no16 where no1, no2.. no16 are BM nos. to be equipped

After the execution of util_mbm_1 is over enter `crp' and check Displ-sys-all; 4.5. TST UTILITY This utility is for making command file for testing terminals. This can be invoked by giving command on iop5x>cd /u/admn/cmdfile <> iop5x>tst <> it will then display TEST TERMINAL UTILITY 1. 2. 3. Line testing Trunk testing Digital Trunk testing Enter Your Choice : Here enter the choice about which type of terminals you want to test suppose `1' then it will display.
APPLICATION NOTE ON RGEN/CMD UTILITY 17

Chapter 4.

LINE TESTING 1. 2. By TEN By DIR-NO Enter Your Choice : Case 1: Whether you want by TEN (Terminal Equipment Number) or by DIRNO'S, if entered 1 i.e. by TEN then it will further ask for BM NUMBER RACK NUMBER FRAME NUMBER SLOT NUMBER PORT NUMBER Then system will prompt for Number of terminals you want to test : here enter the no. of terminal you want to test excluding the TEN already mentioned `suppose 9 ' system will then prompt for Test Set Number : Enter the test set numbering of lines & message will be displayed. THINKING num-term = 9, sub_no = 0 The command file generated for testing terminal is tst-trml BYE..........BYE entered fun_line here the command file generated is tst-trm1 with 10 records. So enter crp & execcmd-file. Similarly for giving different choice for the option command files, tst.trm1 for tst.trm can be prepared. Case 2 : for line testing by Dirno 1 2 3 Line testing Trunk testing Digital Trunk testing Enter Your Choice : 1 <> LINE TESTING
18 C-DOT DSS MAX

: 1-32 : 1-3 : 1-6 : 3-24 : 1-8

: 1 <> : 1 <> : 2 <> : 5 <> : 1 <>

OPERATIONAL PROCEDURES

1 2

By TEN By DIR-NO Enter Your Choice : 2 <>

ENTER STARTING DIR NO : 22000 <> NO OF SUBSCRIBERS UPTO : 1400 : 20 <> Test Set Number : 103 <> THINKING num-term = 0, sub_no = 20 The command file generated for testing terminal is tst-trml tst-trm:G,B,1,LINE,103,,22000; tst-trm:G,B,1,LINE,103,,22001; tst-trm:G,B,1,LINE,103,,22002; tst-trm:G,B,1,LINE,103,,22003; tst-trm:G,B,1,LINE,103,,22004; tst-trm:G,B,1,LINE,103,,22005; tst-trm:G,B,1,LINE,103,,22006; tst-trm:G,B,1,LINE,103,,22007; tst-trm:G,B,1,LINE,103,,22008; tst-trm:G,B,1,LINE,103,,22009; tst-trm:G,B,1,LINE,103,,22010; tst-trm:G,B,1,LINE,103,,22011; tst-trm:G,B,1,LINE,103,,22012; tst-trm:G,B,1,LINE,103,,22013; tst-trm:G,B,1,LINE,103,,22014; tst-trm:G,B,1,LINE,103,,22015; tst-trm:G,B,1,LINE,103,,22016; tst-trm:G,B,1,LINE,103,,22017; tst-trm:G,B,1,LINE,103,,22018; tst-trm:G,B,1,LINE,103,,22019; tst-trm:G,B,1,LINE,103,,22020; BYE.....BYE entered fun_line Case 3 : for Trunk Testing 1. Line testing 2. Trunk testing 3. Digital Trunk testing Enter Your Choice : 2 <> ANALOG TRUNK TESTING
APPLICATION NOTE ON RGEN/CMD UTILITY 19

Chapter 4.

BM NUMBER RACK NUMBER FRAME NUMBER SLOT NUMBER PORT NUMBER

: : : : :

1-16 ONLY 1 1-6 3-24 1-8

: : : : :

1 <> 1 <> 1 <> 5 <> 1 <>

Number of terminals you want to test : n <> Test Set Number : 201 <> THINKING entered fun-trnk It will generate the command file tst-trml with n+1 terminals. Case 4 : For digital trunk it is not implemented at present. 4.6. CHANGE-PORT UTILITY This utility is useful in case when your default printer port (icc_0 is faulty), & you are required to change the printer port on some other serial link. (i.e. icc_4 or icc_7). For this utility first login into lp account with password DSSlp. This is invoked by typing on iop5x> change-port the system will then display Utility for Changing Printer Port Copyright (c) C-DOT New Delhi. July 94 Warning .... Make sure that printer cable is connected on correct serial port i.e. SL-1 is for port no. 0 ACIO1 for port no. (in case of VH IOP) or SL-5 is for port no. 4 or SL-8 is for port no. 7 Prefer only these three ports for printer .... System will prompt for entering the port Please enter the port number in the range of 0-7 : `7' Then this will display Line printer scheduler stopped Printer scheduler is now enabled ... Printer port in now shifted to SL-8 port no. 7 Note : In case you give command from admn account, then system will display the warning.

20

C-DOT DSS MAX

OPERATIONAL PROCEDURES

Utility for Changing Printer Port Copyright (c) C-DOT New Delhi. July 94 First login in lp account with password DSSlp and then run the same utility there .... 4.7. TAPECOPY UTILITY The utility is used for duplication of cartridges & floppies. This can be invoked only from root account. Sufficient disk space should be there for copying in source floppy/cartridge. First login into root account with password as DSS root # cd $TOOLP Case 1 : Cartridge duplication procedure. # tapecopy -t <no. of blocks> suppose you are duplicating BMDC of SBM 8.9 which is having 1284 blocks then command given is # tapecopy -t 1284 system will than display Media Duplication utility version 1.06 (c) C-DOT India : Jan 1993. Insert source Tape/floppy, press <RETURN> (or<DEL> to abort) Now insert the source cartridge & press return After some time it will display Source media copied in. Insert first blank Tape/floppy, press <Return> (or <DEL> to end) Now insert the blank cartridge & press return Then it will display after sometime Tape/Floppy ready Insert Next Blank Tape/Floppy, press <Return> (or <DEL> to End) If you want further copies then insert the next cartridge & press return otherwise to abort the operation press <DEL> Then system will display Wait ....

APPLICATION NOTE ON RGEN/CMD UTILITY

21

Chapter 4.

Units copied : 1 Case 2 : Floppy duplication procedure Everything is same as in case 1 except the command # tapecopy -m -f 4.8. PRINT UTILITY This utility is useful for printing more number of pages or big file in a single command without errors. The utility is invoked by typing iop5x>print <file name> suppose you want to print log of tst file i.e. tst.log which is in /u/admn/cmdfile. Then give command iop5x>cd /u/admn/cmdfile iop5x>print tst.log 4.9. NCBRPRN UTILITY This utility helps in printing the detail bill records by prescribing the page length. This utility processes on sorted rgen ncbr output file. Using rgen utility `ncbr' generate an output file of detail bill record say `dbill' using rgen document. Then on iop5x> prompt give command. iop5x> ncbrprn dbill | print It will then display DETAIL BILL PRINT UTILITY This utility process on sorted Rgen Ncbr Output Files. DIRNO FROM DIRNO TO Printer Page Length : : : (give starting Dirno.) (give last Dirno.) (length of the page i.e. how may records are to be printed on one page).

MODIFY/EXECUTE/TERMINATE : Press `E' and return. This will print the detail bill records in required format.

22

C-DOT DSS MAX

OPERATIONAL PROCEDURES

4.10. RGEN UTILITY This is a report generation utility and for invoking this utility refer Chapter 6 to 11. 4.11. VERIFICATION OF FILES The user may verify the command files after they have been created. To do this the operator has to give the command iop 5x > pg filename <> where "filename" stands for any command file name created. This command will display the file page by page and the operator has to press `return' key after seeing each page. 4.12. EXECUTING A COMMAND FILE The above mentioned utilities only create the required command files. These files have to be executed to solve the real purpose of equipping terminal cards and creating subscribers. Step 1: Step 2: From iop5x> prompt enter crp. iop5x> crp <> On `crp' prompt `<' give command < EXEC-CMD-FILE <> If the command file "eq-sub" has to be executed, then enter the parameters as shown below: cmd file name Break CMD-WAIT Confirm Start-num End-num Log-opt : eq-sub <> : N <> : <> : <> : <> : <> : <>

Press `E' to execute. When this is being executed the results will be shown on the VDU screen as well as logged into a file eq-sub.log if the command filename is eq-sub. After it finishes execution, the result gets displayed on VDU screen. Operator may come out of crp and check the file eq-sub.log for errors. iop5x> pg eq-sub.log <>

APPLICATION NOTE ON RGEN/CMD UTILITY

23

Chapter 5.

Limitations & Checks


In this chapter some limitations of these command file creation utilities, are discussed. Also the error messages and their significance are listed. 5.1. LIMITATIONS i) These utilities take the input one by one and if operator wants to go back to a previous option, it is not possible. Entry has to be aborted by pressing DEL & the whole process has to be restarted afresh again. These utilities use a built-in algorithm due to which the creation of nos and equipping of cards will always be from rack 1 to rack 2& to rack 3. Similarly the frames are increased one by one from the starting value till end of rack is reached. Suppose, directory nos. are to be created in a irregular fashion, then it has to be done taking one frame at a time. As a result, many command files will be created and each would have to be executed separately. iii) In case of choosing the option to avoid some slots during creation, care has to be taken while keying in the slot details. If any wrong slot is entered which is not present in the command file, the first slot entries will be deleted.

ii)

5.2.

CHECKS i) ii) iii) If SBM configuration is chosen the utility assumes the BM no. to `1' thereby reducing one entry. If any value does not fall in the range shown, the utility repeats the question till correct value is entered. While equipping cards the TU1 of SBM is avoided from being equipped because it is normally trunk TU. A message is displayed. Please equip TU1, card by card (Trunk TU) indicating that the various types of cards in this TU have to be equipped one by one. Similar kind of message is displayed if sub creation is tried on this TU.

APPLICATION NOTE ON RGEN/CMD UTILITY

24

iv)

Similarly if operator tries to equip the 3rd or 4th slot in TU1 of BM (Rack 1), the utility prevents him from doing so. This is necessary because these slots are reserved for announcement card. Also the utility avoids equipping or creation in the 24th slot of TU4 in BM (Rack 1) as it is reserved for TTC. The utility verifies the existence of the support utilities and if it is not able to find them gives the following message and gives back the prompt. Support files missing. Exiting... This can be solved by installing the utilities again from floppy.

v) vi)

vii)

The support utility `dele' is a standalone module which can be invoked separately, if necessary. In case the command file has been already created and subscriber creation in certain slots have to be avoided later, it can be done by typing iop5x> dele filename <> Here the "filename" indicates the name of the command file in which certain slots have to be deleted. Then this utility asks for slot no. & deletes the entries pertaining to that slot.

APPLICATION NOTE ON RGEN/CMD UTILITY

25

Chapter 6.

Rgen Utility
Rgen Utility is a general purpose tool designed for generating various Switching System related reports. The utility is tailored to produce condensed report in presentable manner in contrast to the reports produced by CRP. However the reports generated by this tool are not as detailed as generated by CRP. Utility is invoked with a script file. Script file consists of instructions written in Rgen language to tailor a report for an application. Programming details of Rgen language are outside the scope of this document. Rgen when invokes read script file and as per directive it may collect more input against queries. Thereafter read one or more data files and arrange output as per format. Output further will be passed through sorting function against user request. It is also possible to get some information which is not available in crp: For example, If one wishes to see the subscribers meter reading i.e., the sum of local and STD counters then he has to invoke the `submtr2' script as follows: iop5x > rgnrpt Select option Main Menu :5 Secondary Menu : 1 It will ask for the following parameter FDATE : TDATE : BM NUM : DIRECTORY NUM: From date To date Base module number Directory number for which information is required

After entering all the values it will display the local counter, STD counter, STDCALL counter and bulk counter (sum of local counter and STD counter) values as the output. Here if directory number is given default value then for all existing subscribers, current meter readings and bulk counters will be displayed. Partial values against directory number parameter is also allowed. For example, if 582 is given and 7 digit DIRNOs are there then meter readings will be displayed for DIRNOs 5820000 to 5829999.
APPLICATION NOTE ON RGEN/CMD UTILITY 26

Chapter 7.

RGEN Scripts at a Glance


S.No. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. Scriptfile name contrf amtrf2 bmicog2 bmortr2 bmtrf2 bnpdat2 bphdwr2 bwtgp2 cdrcld2 cdrcln2 combil2 crgrtn2 dcbr2 dirten2 dtktrf2 hgpmtr2 Function it Performs To display the consolidated traffic report. Display exchange performance report for Administration module. Display important information about incoming outgoing traffic reports (BM-wise). Display important informations about originating terminating traffic reports (BM- wise). Display important informations about originating and incoming call attempts, dial tone delay etc. (BM-wise). To list all the subscribers who have been put in bill not paid state on a particular date. To display the BM wise hardware equipage report. To display necessary information about bothway trunk group traffic reports. Display call detailed informations for called subscribers. Display call detailed informations for calling subscribers. To display the commercial billing records. To display useful informations about a specific charge rate number. To display diverted call billing record. To display directory number vs TEN details in an exchange and vice versa. To display the traffic report of digital trunks (DTKs) running between the main exchange and the Remote BM (RBM). To display the local counter, STD counter, No. of STD calls, ISD Counter, No. of ISD calls and the bulk meter reading (sum of local,

27

C-DOT DSS MAX

Chapter 7.

S.No.

Scriptfile name ictgp2

Function it Performs STD and ISD counters) of hunt groups.

17.

Display informations about seizures, transit & incoming terminating attempts including traffic intensity on incoming Trunk Group. Display subscriber lines characteristics data. Display reports about subscribers or hunt group related data modifications. To display status of lines which are in `OOS- SE' or `OOS-OPR' status. To display detailed billing records for subscribers. To display necessary informations about outgoing trunk group traffic reports. To display idle time available for processors in Administration Module in the multi module exchange. To display idle time available for processors in Base Module. To display the route related traffic information. To display the service circuits (DTMF ckts, MF-sender, MFReceiver) equipage and their utilization data. To display the special service billing record for subscribers for a given period. To display the list of subscribers having one or more originating and terminating facilities. To display local counter, STD counter, No. of STD calls. ISD counter, No. of ISD calls and bulk meter reading (sum of local, STD and ISD counter) of subscribers. To display the call detail records of the trunk groups. To display the characteristics of a trunk group in a given BM. To display the trunks which are in `OOS-OPR', `OOS-SE', `OOSTST' and `BLK-TRS'. To display the details of malicious calls in case of local call only To display TGP number to name report To display CGS number to name report

18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29.

linchr2 linmod2 linsts2 ncbr2 ogtgp2 procam2 procbm2 routtrf2 srvckt2 ssbr2 subfac2 submtr2

30. 31. 32. 33. 34. 35.

tgcbr2 tgpchr2 trksts2 malc2 tgpname2 cgsname

28

C-DOT DSS MAX

RGEN SCRIPTS AT A GLANCE

S.No. 36. 37.

Scriptfile name tgputil mfrsub

Function it Performs To display status of TGP having more than 40 trunks. To display difference in meter readings between 2 given dates.

APPLICATION NOTE ON RGEN/CMD UTILITY

29

Chapter 8.

Parameter Description
On issuing a rgen command, the system will respond by asking for parameters required for execution of that command. Parameters are variables which identify and contain a piece of necessary information to execute a command. Some of the parameters are used in more than one command. In the parameter description to follow, these parameters are discussed only once. Parameter description for each parameter is covered under the following subheads. Parameter Name Mnemonic Type Possible Values/Range Default Remarks 8.1. : : : : : : Name of the parameter Address - code in the form of a pronounceable word. Alpha, Numeric, Alphanumeric i.e. type of date acceptable. A set of values and/or range accepted. The value automatically assigned. If the operator does not assign any value. Some more information regarding special attributes of the parameter

PARAMETER DESCRIPTION (Base Module Number) : : : : : Base Module Number BM NUM Integer 1 to 32 All

BM NUM Parameter Name Mnemonic Type Possible Values Default

APPLICATION NOTE ON RGEN/CMD UTILITY

30

PARAMETER DESCRIPTION

CALLED NUM~ Parameter Name Mnemonic Type Possible Values Default : : : : : Called Number CALLED NUM Numeric 3, 4, 5, 6 or 7 digit numbers. All

(Called Number)

CALLING NUM~ Parameter Name Mnemonic Type Possible Values Default : : : : : Calling Number CALLING NUM~ Numeric, 7 digit maximum 3, 4, 5, 6 or 7 digit numbers. All

(Calling Number)

APPLICATION NOTE ON RGEN/CMD UTILITY

31

Chapter 8.

CALL FAIL TYPE Parameter Name Mnemonic Type Possible Values : : : : Call Failure Type CALL FAIL TYPE Alphabetic SUCCESS : DL-TMO INV-COD IDT-TMO RNG-TMO CP-BSY MTN-BSY ADMN-BSY NU LLO ACC-BAR SWT-BLK SIG-FAL INV-SIG BCK-PRM FRW-PER BCK-ABS NO-RSRC CNJ-TRK REM-CNJ FTR-FAIL BLKING SPR-ANS NO-DIAL ABANDN PAR-DIAL SYS-REC NRM-USP SS7-ERR INV-DGT NRM-CLR ACC-BAR COMPLETE NO-ACK CSH-TMO All

(Call Failure Type)

: : : : : : : : : : : : : : : : : : : : : : : : : :

Success Call Dial Tone Timeout Invalid Code Inter Digit Timeout Ring Timeout Call processing busy Maintenance Busy Admin Busy Number Unobtainable Line Lock out Access Barred Switch Blocking Signalling Failure Invalid Signalling Backward Signal Permanent Forward Signal Permanent Backward Absent No Resource Available Congestion on Trunks Remote Congestion Feature Activation Fail Blocking Spurious answer No digit dialled ABANDONED Partial Digit Dialled System Recovery

Default

32

C-DOT DSS MAX

PARAMETER DESCRIPTION

CHARGE MODE Parameter Name Mnemonic Type Possible Values Default Remarks : : : : : : Charge Mode CHARGE MODE ASCII FXD, FLT, PRD-LCL PRD-TAX, NO-MET All

(Charge Mode)

Mode of charging e.g. fixed charging, flat charging etc.

CHARGE PERIOD Parameter Name Mnemonic Type Possible Values Default Remarks : : : : : : Charge Period CHARGE PERIOD Integer All Period between two charge allocation.

(Charge Period)

CHARGE RATE NUM Parameter Name Mnemonic Type Possible Values Default : : : : : Charge Rate Number CHARGE RATE NUM Integer 1 to 128 All

(Charge Rate Number)

APPLICATION NOTE ON RGEN/CMD UTILITY

33

Chapter 8.

DIRECTORY NUM~ Parameter Name Mnemonic Type Possible Values Default Remarks : : : : : : Directory Number DIRECTORY NUM Numeric, 7 digit maximum 3, 4, 5, 6 or 7 digit numbers All and non for "crethdat"

(Directory Number)

This is the directory number for which reports are to be generated. If default is given for this parameter, reports for all directory numbers will be generated. Partial values are also allowed. If 582 is given and 7 digit numbering scheme is there, then required reports will be generated for directory numbers 5820000 to 5829999.

Note: 1. 2.

In case of "crethdat" report, Range can be given like (example) 5485000 to 5485010. In case of "crethdat" if you give 0 against directory number, it will exit.

FACILITY TYPE Parameter Name Mnemonic Type Possible Values : : : : Facility Type FACILITY TYPE Alphabetic 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 3W-CNF 6W-CNF CNF-ACT MASTER-CNF SEL-DROP-CNF ACB MAL-CALL ALARM CAL-WAT-CLN QUE-SUSP QUE-ACT QUE-DEACT

(Facility Type)

34

C-DOT DSS MAX

PARAMETER DESCRIPTION

13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. Default : All

OCR-STD OCR-10X OCR-KW-CHG INTRSN-BAR DIV-MAN-ANS DIV-FXD-ANN DIV-FXD-NUM DIV-SEL-NUM DIV-BSY-FXD DIV-BSY-GRP DBE-SUB-LIN DBE-TRNK DEB-SRV-CKT

FDATE Parameter Name Mnemonic Type Possible Values : : : : From Date FDATE Numeric string with 3 fields (DD-MM-YYYY) DD-MM-YYYY DD = 1 to 31 MM = 1 to 12 YYYY = Any numeric value Default Remarks : : Present Date Date from which the reports are required.

(From Date)

APPLICATION NOTE ON RGEN/CMD UTILITY

35

Chapter 8.

INSTRUMENT TYPE Parameter Name Mnemonic Type Possible Values : : : : Instrument Type INSTRUMENT TYPE Alphabetic DECAD = Decadic DTMF = Dual Tone Multifrequency DIGITAL = Digital Default Remarks : : All

(Instrument Type)

Type of instrument used by the subscriber.

LIN-SIG Parameter Name Mnemonic Type Possible Values : : : : Line Signalling Type LINE SIG TYPE Alpha Numeric LOOP-DSCT E-M DR2-CAS1 DR2-CAS2 DR2-CAS3 Default : All : : : : :

(Line Signalling Type)

Loop disconnect Ear & month signalling Digital R2 channel associated signalling of type 1 Digital R2 channel associated signalling of type 2 Digital R2 channel associated signalling of type 3

36

C-DOT DSS MAX

PARAMETER DESCRIPTION

LINE STATUS Parameter Name Mnemonic Type Possible Values Default : : : : : Line Status LINE STATUS Alphabetic OOS-OPR, OOS-SE All

(Line Status)

LINE TYPE Parameter Name Mnemonic Type Possible Values : : : : Line Type LINE TYPE Alphabetic ORD-LIN CCB CCB-STD PABX PBX-REV SRT-LIN SHR-LIN TST-LIN UNASSGN CCB-CRD LNG-LIN All Type of Line attached to port. : : : : : : : : : : :

(Line Type)

Ordinary Line Coin Collection Box CCB with STD facility Private Automatic Branch Exchange PBX with Reversal Short Line Shared Line Test Line Unassigned Line CCB with Credit Card Facility Long Line

Default Remarks

: :

APPLICATION NOTE ON RGEN/CMD UTILITY

37

Chapter 8.

OPERATION TYPE Parameter Name Mnemonic Type Possible Values : : : : Operation Type OPERATION TYPE Alphabetic

(Operation Type)

CRE-SUB, DEL-SUB, MOD-LIN, MOD-TEN, MOD-FAC, CRE-HGP, DEL-HGP, ADD-LIN, DEL-LIN, MOD-CHR, ADD-MSN All

Default

ORG FACILITIES Parameter Name Mnemonic Type Possible Values : : : : Origination Facilities ORG-FACILITIES Alphabetic 1. TIMED-HTLN 2. UNTIMED-DIRNO 3. UNTIMED-PWIRE 4. DIAL-BY-EQPT 5. CAL-WAIT-CLNG 6. 3WAY-CNF 7. 6WAY-CNF 8. AUTO-CLBK 9. SEMI-AUTO-ALRM 10. AUTO-ALRM 11. MAN-ALRM 12. ADMN-OG-BARR 13. SUB-OG-BARR Default : All : : : : : : : : : : : : :

(Origination Facilities)

Timed Hotline Untimed Hotline Nailedup Hotline Dialling by equipment number Call wait by calling 3-way conference 6-way conference Auto Call Back Semi automatic alarm Automatic alarm Manual Alarm Admin controlled og call restriction Subscriber controlled outgoing barr.

38

C-DOT DSS MAX

PARAMETER DESCRIPTION

PROCESSOR Parameter Name Mnemonic Type Possible Values : : : : Processor PROCESSOR Alphanumeric AP, CMS1, CMS2, CMS3, CMS4

(Processor)

ROUTING INFO Parameter Name Mnemonic Type : : : Routing Information ROUTING INFO ASCII Complex (4 field) 1st field 2nd field 3rd field 4th field Possible Values : : : : :

(Routing Information)

Metered/non metered: M/NM Answer expected/not expected AEX/ANX No ring/normal ring/big ring timeout : NOR/NMR/BGR BEEP/NBEEP

NM-ANX-NOR-NBEE, NM-AEX-NOR-NBEE NM-ANX-NMR-NBEE, NM-AEX-NMR-NBEE NM-ANX-BGR-NBEE, NM-AEX-BGR-NBEE NM-ANX-NOR-BEEP, NM-AEX-NOR-BEEP NM-ANX-NMR-BEEP, NM-AEX-NMR-BEEP NM-ANX-BGR-BEEP, NM-AEX-BGR-BEEP M-ANX-NOR-NBEE, M-AEX-NOR-NBEE M-ANX-NMR-NBEE, M-AEX-NMR-NBEE M-ANX-BGR-NBEE, M-AEX-BGR-NBEE M-ANX-NOR-BEEP, M-AEX-NOR-BEEP M-ANX-NMR-BEEP, M-AEX-NMR-BEEP M-ANX-BGR-BEEP, M-AEX-BGR-BEEP

Default Remarks

: :

All Information corresponding to metering, ring and expectation of answer

APPLICATION NOTE ON RGEN/CMD UTILITY

39

Chapter 8.

TDATE Parameter Name Mnemonic Type Possible Values : : : : To Date TDATE Numeric string with 3 fields (DD-MM-YYYY) DD-MM-YYYY DD = 1 to 31 MM = 1 to 12 YYYY = Any numeric value Default Remarks : : FDATE Date till which the reports are required.

(To Date)

TEN Parameter Name Mnemonic Type : : :

(Terminal Equipment Number) Terminal Equipment Number TEN String of 5-subfield of the type AA-B-C-DD-EE where AA, B, C, DD, EE are integers and represent. AA B C DD EE : : : : : Base Module Number Rack Number FRAME NUMBER Slot Number Circuit Number

Possible Values Default

: :

1-1-1-1-1 to 32-3-6-26-32 All

40

C-DOT DSS MAX

PARAMETER DESCRIPTION

TGP NUM Parameter Name Mnemonic Type Possible Values Default : : : : : Trunk Group Number TGP NUM Numeric 1 to 511 All

(Trunk Group Number)

TIME~ Parameter Name Mnemonic Type Possible Values : : : : Time TIME Numeric HH:MM HH --> 00 to 23 MM --> 00 to 59 Default : All

(Time)

APPLICATION NOTE ON RGEN/CMD UTILITY

41

Chapter 8.

TRM-FACILITIES Parameter Name Mnemonic Type Possible Values : : : : Terminating Facility TRM-FACILITIES Alphabetic 1. DIV-SNGL-NUM 2. DIV-GRP 3. CAL-WAIT-CLD 4. NO-ANS-SNGL 5. NO-ANS-GRP 6. ABS-MAN-ANS 7. ABS-FXD-ANNC 8. ABS-FXD-NUM 9. ABS-SEL-NUM 10. BOTH-PTY-CLR 11. QING-NO-DCTV 12. QING-DCTV 13. CLD-PTY-CLR 14. ADMN-INT-BAR 15. SUB-INT-BAR Default : All : : : : : : : : : : : : : : :

(Terminating Facilities)

Diversion to single number on busy Diversion to a group of number on busy Call wait controlled by called party Diversion to a single number on no answer Diversion to group on no answer Absentee to manual answer Absentee to fixed announcement Absentee to Fixed Number Absentee to single number Both party clear Queing with no deactivation Queing with deactivation Called party clear

42

C-DOT DSS MAX

PARAMETER DESCRIPTION

TRUNK STATUS Parameter Name Mnemonic Type Possible Values Default : : : : : Trunk Status TRUNK STATUS Alphabetic OOS-TST, OOS-OPR, OOS-SE, BLK-TRS All

(Trunk Status)

APPLICATION NOTE ON RGEN/CMD UTILITY

43

Chapter 9.

Utility Invocation
9.1. SYNTAX FOR INVOCATION The regen utility can be invoked from the UNIX prompt in two different modes : i) ii) Menu driven mode Direct utility mode

The syntax for invoking rgen is as follows : Method 1 : Menu driven iop5c> rgnrpt On issuing the above command main menu will be displayed, choose the number options from main and secondary menus to display/print the desired reports. Rgen Scripts Main menu 1. 2. 3. 4. 5. 6. 7. 8. Subscriber reports Trunk Group reports Module and service circuit traffic report Trunk Group and route wise traffic report Subscriber and Trunk Group meter report Terminal type and status report Subscriber traffic observation report Miscellaneous reports

On selecting any option from the above menu corresponding secondary menu will be displayed. After selecting the secondary menu option the corresponding reports will be displayed/printed.

APPLICATION NOTE ON RGEN/CMD UTILITY

44

UTILITY INVOCATION

1.

Subscriber Report Secondary Menu 1. 2. 3. 4. Subscriber facility reports Subscriber characteristics reports Subscriber modification reports Subscriber disconnection reports File Name subfac2 linchr2 linmod2 bnpdat2

*5. Main Menu *6. Exit 2. Trunk Group Secondary Menu 1. 2. 3. Trunk group characteristics report Trunk group characteristics report CGS number to name report File Name tgpchr2 tgpname2 cgsname2

*4. Main Menu *5. Exit 3. Module and Service Circuit traffic Report Secondary Menu 1. 2. 3. 4. 5. 6. 7. Administrative Processor traffic report Base Module processor traffic report Administrative module traffic report BM Traffic report BM originating traffic report BM Incoming Outgoing traffic report BM Service Circuit traffic report File Name procom2 procbm2 amtrf2 bmtrf2 bmortr2 bmicog2 srvckt2

*8. Main Menu *9. Exit

APPLICATION NOTE ON RGEN/CMD UTILITY

45

Chapter 9.

4.

Trunk Group and Routewise traffic report Secondary Menu 1. 2. 3. *4. *5. 6. Outgoing trunk group traffic report Incoming trunk group traffic report Bothway trunk group traffic report Routecode wise traffic report Main Menu Exit File Name ogtgp2 ictgp2 bwtgp2 routrf2

5.

Subscriber and Trunk Group meter report Secondary Menu 1. 2. 3. 4. 5. 6. 7. *8. 9. Subscriber meter reading report HGP subscriber meter reading report Subscriber detailed billing report Subscriber special service bill report Subscriber diverted call bill report Trunk group meter reading report Trunk group detailed billing report Main Menu Exit File Name submtr2 hgpmtr2 ncbr2 ssbr2 dcbr2 tgpmtr2 tgcbr2

6.

Terminal type and status report Secondary Menu 1. 2. 3. *4. 5. Line terminal status report Trunk terminal status report Terminal and type & status report Main Menu Exit File Name linsts2 trksts2 bphdwr2

46

C-DOT DSS MAX

UTILITY INVOCATION

7.

Subscriber traffic observation report Secondary Menu 1. 2. 3. *4. 5. Subscriber detail records on calling report Subscriber detail records on called report Subscriber detail records on malicious report Main Menu Exit File Name cdrcln2 cdrcld2 malc2

8.

Miscellaneous report Secondary Menu 1. *2. 3. Charge rate number detailed report Main Menu Exit File Name Crgrtn2

Utility MODIFY2 to Create Command files A menu driven utility modify2 is provided in this Rgen. It will be helpful in creation of command files required to carry out a specific activity e.g., STD barring, BNP-ANNC, BNP-DISC, Restoration of STD facility providing DTMF/DECAD, del sub, meter reading etc. This utility can be run by any directory from IOP5x> prompt. One has to simply fill in the Dir. Nos. (Or a range of Dir Nos.) and select from the Menu the activity to be performed. Features of utility 1. Meter reading option in command menu enables to get meter reading of selected Dir. Nos. on a particular date provided the formatting is done on that date and Rgen tool along with its script file submtr2 are available in $TOOLP at /u/admn/rgen directories. If DIR NOS. are already stored in a file, then one need not fill in them again, the utility can operate over the file directly as modify <filename>. Save & Exit options allows the user to save the Dir. Nos. so far extered in a file named safe so that he used not enter them again if required.

2. 3.

APPLICATION NOTE ON RGEN/CMD UTILITY

47

Chapter 9.

Procedure to run MODIFY2 utility IOP5x> modify2 It will display following main menu 1. 2. 3. 4. 5. Separate numbers (e.g., 71000, 71003 etc.) A continuous range of Nos. (Directory Nos.) Miscellaneous Exit Enter your option

After, entering proper option it will display following message, say entering option `1 Enter the Directory Number : Any more ? y/n (If want to enter more directory nos. give y If not give n) after above entries following menu will appear on screen. Set of Commands 1. 2. 3. 4. 5. 6. 7. 8. 9. Restoration from Non-payment Disconnection BNP-ANNC Disconnection BNP-DISC 10. 11. 12. Individual Commands Mod-Sub-Fac Mod-Sub-Char Del-Sub Grnt-Ocr-Sub Wtd-Sub-Fac Frc-Trm-Oos Frc-Trm-Ins Save at Exit Exit

Restoration of STD-FAC with the 13. desired Dynamic lock Restoration of STD-FAC granting Dynamic lock Barring STD-FAC drawing code Meter reading Providing DTMF/DECAD/Digital Mod-Lin-Char 19. by without 14. with 15. 16. 17. 18.

first

Enter your option : (enter proper option as per required activity)

Now following message will appear on screen. The command file (say xx) has been created in /u/admn/cmdfile

48

C-DOT DSS MAX

UTILITY INVOCATION

Do you want to run the command file : y/n after giving y command file will executive and a log file will be made in /u/admn/cndfile Method 2 : iop5x> rgen script-file [-f(num) | -r(num)] [-s(num)] Description of command line parameters rgen Script file <num> -f<num> -r<num> -s<num> i) ii) iii) Command name (Report generator) One of the script files made for an application as described under Chapter 7. Positive integer number Process data for only first <num> records Process data in reverse order for <num> records Sort on <num> field This option is not applicable with Bill monitoring related scripts.

The parameter in square brackets are optional Either -f <num> or -r <num> may be used but not both. If <num> parameter is missing then all records will be processed for -f or -r option. For -s option if <num> not specified then sorting will be performed on first field.

All script files are supplied along with the rgen software. However some script files have application only in multi-module configuration. 9.1.1. Command line option -f <num> The command line option -f allows the user to process only a given number of records from the beginning of the data files. When this option is given only the given number of records are read from the data file and processed. If some other conditions are also given against queries for the output generation, the actual number of records in output may be less than the number of records given in the -f option. If a range of dates or BMs are given for generating reports, given number of records will be read from files corresponding to each date and for all equipped BMs. 9.1.2. Command line option -r <num> This option is similar to -f option. In this case the given number of records are read from the end of the data file in the reverse order. This can be used to get only the last few records in a file.

APPLICATION NOTE ON RGEN/CMD UTILITY

49

Chapter 9.

9.1.3.

Command line option -s <num> This option can be used to sort the report generated by rgen in ascending order lexically on a given field. For example, if the sorting is to be done on 3rd field of the report, rgen can be invoked as iop5x > rgen script-file -s3

9.2.

QUERIES When rgen is invoked with a script file, it may prompt the user to enter some data. User can press return for entering the default values in all cases. Details of queries may vary with different script files. The user may prompt for the required information. Query is prompted in following form [ Parameter-name ~] : The square bracket shows that value can be default. To specify default, press return key of the keyboard. Depending on parameter, default value will be displayed on screen. The tild sign (~) if present indicates that partial matching of parameter is possible. That is, records fields which have some prefix as against parameter entry, will be matched. However no validation is performed on length of the parameter. If no tild sign (~) displayed during query then complete input is to be given for matching. BM NUM query is validated against range. Whenever query is displayed bottom of the screen will either have a guiding message or actual possible values. If the message at bottom only guidance then only general validation is made, however if actual values are displayed then input is tested against the possible values. Following queries are commonly used :-

9.2.1.

FDATE This is the date from which the reports are to be generated. User can select the current date by pressing return when prompted. Any other date has to be entered in the format dd-mm-yyyy where dd = date, mm = month and yyyy = year.

9.2.2.

TDATE This is the date until which the reports are to be generated. This is prompted only if non default value entered for FDATE. The default value for TDATE is

50

C-DOT DSS MAX

UTILITY INVOCATION

the value entered for FDATE. If any other value is entered, the reports for the period valid from FDATE to TDATE are generated. 9.2.3. BM NUM This is the Base Module Number for which reports are to be generated. If default value is entered, reports are generated for all equipped BMs. If a value is entered at the prompt for this parameter, reports are generated only for that BM. 9.2.4. Directory Number This is the directory number for which reports are to be generated. If default value is given for this parameter, reports for all directory numbers are generated. If partial values are allowed against this parameters then a tild (~) sign will be indicated in query parameter. e.g. : If 582 is entered for DIR NO, then reports for the numbers 582x... are generated. 9.2.5. TEN This is the Terminal Equipment Number (TEN) for which reports have to be generated. If default value is given for this parameter, reports are generated for all the TENs. If any value is given, reports are generated only for that TEN. This parameter has to be entered in the format BB-R-F- SL-CC where BB = BM number, R = rack number, F=frame number, SL = slot number and CC = circuit number. Partial value also may be entered if allowed for this parameter. Then if 1-1-4 is entered, reports for all the circuits of all the slots in the 4th frame of the first rack of BM-01 are generated.

APPLICATION NOTE ON RGEN/CMD UTILITY

51

Chapter 10.

Output Options
When the choices in Main Menu, Secondary Menu an entered a third menu appears as follows you want the output on Choose the option for desired output 1. Screen Output format Every output format provides a header as follows : Site Name Site Name Exchange Type : Time Stamp : : Exchange Type Time Stamp 2. Screen & printer 3. Exit to main menu

This is the name of the site where exchange is installed. This can be strings like SBM-RAX, MBM-MAX, SBM-TAX etc. Time at which the report is made.

Remaining part of the output is script file dependent. On Selecting proper option above report can be either displayed or printed.

APPLICATION NOTE ON RGEN/CMD UTILITY

52

Chapter 11.

Scripts Files
This chapter gives the details of all the scripts that are supplied with the rgen utility. The script files are named according to the report they generate. Usage, parameters and description of each script file is specified. Usage may be extended with flags i.e. -f<num>, -r<num>, -s<num> or `| print' etc. as per requirement. 11.1. contrf Procedure to run contrf utility IOP5x > cd /u/admn IOP5x> contrf It will display 1. 2. 3. MBM SBM Exit

Enter Option Enter proper option as required Now it will display Enter day number = (enter proper date) Enter month = (enter proper month) Enter year number = (enter year) Enter the dump time in hours = (enter required time for which hour report is to be taken) Now it will display Report generation is in progress Please wait

APPLICATION NOTE ON RGEN/CMD UTILITY

53

Chapter 11.

Service circuit report generated Originating and terminating report is generated Incoming TGP report is generated Enter the option 1. 2. 3. Print View Exit

Now give proper option for either display or print the report. Please note : To see the report of 31.7.2000 for 21st hour Day number will be =31 Month will be = 7 Year number will be = 2000 Dump time in hours will be = 21 The consolidated traffic report is equivalent to the OCHEALA report which is desired by the exchange persons. This report indicates the performance of the exchange which includes the lines assigned, BHCA of the system, number of trunks assigned in the exchange. In addition to this the originating performance reports, incoming performance report, processing efficiency and the calls completion ratio of the individual BM as well for the exchange is also generated and the major reasons for call failures with their counters are also included. In order to get the report the following mentioned points should be taken care of All the traffic reports for line, trunks and service results should be activated. The periodicity of the traffic report should be of 60 minutes. The TGP's under observation should be in multiples of 4 in case of incoming and outgoing TGP's and for BW-TGP it should be in multiples of 2.

The output report is displayed as follows

54

C-DOT DSS MAX

SCRIPTS FILES SITE NAME : DELHI-CANTT REPORT TAKEN ON : Mon Jul 3 23:35:10 IST 2000

--------------------------------------------------------------------------------------------------------------------------EXCHANGE PERFORMANCE REPORT OF C-DOT DSS --------------------------------------------------------------------------------------------------------------------------Dumps Time Inputed IS = 21 hours Dumps Time scanned from = 20:50 hours to 21:10 hours Observation duration in minutes = 60

Report From_Time = 20 Hours To_Time = 21 Hours Observation Date and Time = 16-MR-2000 21:00:02

--------------------------------------------------------------------------------------------------------------------------Total BHCA of the system Total Lines Equipped Total Lines Under maintenance Total Trunks equipped Total Trunks Under maintenance Total Originating Terminating Attempts Calls Processing Efficiency Calls Completion Ratio Total Originating Outgoing Attempts Calls Processing Efficiency Calls Completion Ratio Total Incoming Terminating Attempts Calls Processing efficiency Call Completion Ratio Total Incoming Outgoing Call Attempts Calls Processing efficiency Call Completion Ratio Total DTMF circuits assigned Total DTMF circuits operational Total DTMF attempts Total DTMF failures Total MFR circuits assigned Total MFR circuits operational Total MFR attempts Total MFR failures Total MFS circuits assigned Total MFS circuits operational Total MFS attempts Total MFS failures = 89353 = 13970 = 143 = 63 = 32 = 8034 = 88 = 44 = 19541 = 62 = 20 = 7375 = 95 = 55 = 36656 = 68 = 22 = = = = = = = = = = = = 430 430 13121 0 203 203 40584 0 192 191 34207 0

APPLICATION NOTE ON RGEN/CMD UTILITY

55

Chapter 11.

SITE NAME : DELHI CANTT --------------------------------------------------------------------------------------------------------------------------C-DOT DSS ORIGINATING PERFORMANCE SYSTEM REPORT --------------------------------------------------------------------------------------------------------------------------Originating attempts = 40733 Originating Call Completion Ratio = 18 Originating Call Processing Efficiency = 47 Originating Calls Blocked due to Overload = 9 --------------------------------------------------------------------------------------------------------------------------Calls Failed Due To Following Reasons --------------------------------------------------------------------------------------------------------------------------Clear Due To Incomplete Dialling = 3055 Calling Subscriber Being Access Barred = 625 Called Subscriber Being Access Barred = 11 Wrong Prefix = 741 No Answer / Abandoned after Dialling Complete = 6253 Number Unobtainable = 301 Called Subscriber busy = 5807 Non availability of remote unit (RSU) links = 0 Faulty signalling = 1648 Called Subscriber Out Of Order = 182 Called Subscriber Number Changed = 0 Any Other Reason = 3516

--------------------------------------------------------------------------------------------------------------------------C-DOT DSS INCOMING PERFORMANCE SYSTEMS REPORT --------------------------------------------------------------------------------------------------------------------------Incoming Call Attempts = 48624 Incoming Call Completion ratio = 25 Incoming Call Processing Efficiency = 65 System Over Load = 18 --------------------------------------------------------------------------------------------------------------------------Incoming Calls Failed Due To Following Reasons --------------------------------------------------------------------------------------------------------------------------No Digit Dialled = 2234 IDT / Partial dialling = 2122 Called Subscriber being Access Barred = 28 Wrong Prefix = 1329 Number Unobtainable = 448 No Answer / Abandoned After Dialling Complete = 11921 Called Subscriber Busy = 3690 Faulty Signalling = 4643 Non Availability Of Internal Resources = 0 PCM Channel In RSU = 0 Congestion At Remote End = 2938 Any Other Reason = 997 Trunk Circuit Not Available = 5559 Called Number Changed = 0

56

C-DOT DSS MAX

SCRIPTS FILES

SITE NAME : DELHI CANTT --------------------------------------------------------------------------------------------------------------------------C-DOT DSS BM WISE ORIGINATING PERFORMANCE REPORT --------------------------------------------------------------------------------------------------------------------------BM_NO TOTAL_ATTEMPT CCR TRK_N_AVL RSRC_N_AV OVERLOAD --------------------------------------------------------------------------------------------------------------------------01 3416 22 223 0 21 02 4485 21 339 0 51 03 4127 19 374 0 21 04 4994 19 438 0 69 05 3777 20 269 0 29 09 2698 21 127 0 31 13 2909 20 300 0 21 14 3385 15 316 0 70 16 5620 15 543 0 43 18 5322 14 657 0 69

--------------------------------------------------------------------------------------------------------------------------C-DOT DSS BM WISE INCOMING PERFORMANCE REPORT --------------------------------------------------------------------------------------------------------------------------BM_NO TOTAL_ATTEMPT CCR TRK_N_AVL RSRC_N_AVL OVERLOAD --------------------------------------------------------------------------------------------------------------------------06 6578 26 852 0 0 07 7814 21 1150 0 0 08 6370 19 670 0 5 10 7772 27 735 0 3 11 6187 30 472 0 3 15 6876 26 708 0 3 17 7027 27 972 0 4

SITE NAME : DELHI CANTT C-DOT DSS IC-TGP REPROTS ---------------------------------------------------------------------------------------------------------------------------------------------C-DOT DSS INCOMING TRUNK TRAFFIC REPORT ---------------------------------------------------------------------------------------------------------------------------------------------TGP TGP NAME TRK_EQP TRK_MAIN TOTAL_ATMPT IC_TRM IC_OG CCR ERLN ---------------------------------------------------------------------------------------------------------------------------------------------140 40 30 57 2 54 43 8 142 30 0 49 42 3 44 5 144 30 0 84 59 23 60 20 152 30 0 112 20 76 33 11 140 40 30 116 8 107 48 12 142 30 0 103 50 34 47 10 144 30 0 219 131 82 42 29 152 30 0 211 43 156 32 16

APPLICATION NOTE ON RGEN/CMD UTILITY

57

Chapter 11.

SITE NAME : DELHI CANTT C-DOT DSS OG-TGP REPROTS --------------------------------------------------------------------------------------------------------------------------------------------C-DOT DSS OUTGOING TRUNK TRAFFIC REPORT ---------------------------------------------------------------------------------------------------------------------------------------------TGP TGP NAME TRK_EQP TRK_MAIN TOTAL_ATMPT IC_OG CCR ERLN TRK_N_AVL ---------------------------------------------------------------------------------------------------------------------------------------------1 30 0 177 130 40 12 0 2 40 0 80 51 21 4 0 3 30 0 304 232 29 14 0 5 35 0 230 152 39 15 0 6 40 1 360 196 40 31 0 7 35 5 83 48 51 11 0 13 40 0 252 188 39 28 0 23 40 0 35 22 45 4 0 26 15 0 48 26 14 1 0 48 30 0 248 111 50 29 0 53 60 0 377 372 45 28 0 105 15 0 24 13 50 1 0 115 85 2 416 177 33 29 0 131 30 0 227 82 49 18 0 141 30 0 188 108 48 22 0 143 30 0 275 147 45 25 0

--------------------------------------------------------------------------------------------------------------------------------------------C-DOT DSS BOTH WAY TRUNK TRAFFIC REPORT --------------------------------------------------------------------------------------------------------------------------------------------TGP TGP NAME TRK_EQP TRK_MAIN TOTAL_ATMPT CCR ERLN TRK_N_AVL OVRFLW

--------------------------------------------------------------------------------------------------------------------------------------------TRK_MAIN = Trunk under maintenance TRK_EQP = Trunks equipped IC_TRM = Incoming terminating calls TOTAL_ATMPT = Total attempts RSRC_N_AVL = Resource not available TRK_N_AVL = Trunk not available IC_OG = Incoming and Outgoing calls ERLN = Erlangs

11.2. admbsy2 To list subscribers in Bill not paid (ANNC & DISC), safe custody passed tempered, charge threshold and being shifted status Usage : rgen admbsy2 BM NUM, DIRECTORY NUM ~, LIN-STATUS

Parameters :

Reports can be generated for all the BM's or for a given BM and for one directory number or for range of directory numbers or for all directory numbers.

58

C-DOT DSS MAX

SCRIPTS FILES

The output will be displayed as follows: C-DOT-CANTT MBM-MAX Sat Jul 31 17:12:47 1999 ADMN LINE STATUS REPORT DIRNO 5554052 5554057 5554058 TEN 2-1-4-5-2 2-1-4-5-7 2-1-4-5-8 STATUS BNP-DISC BNP-ANNC SAFE-CUST

Total Records Printed : 3 11.3. amtrf2 Exchange Performance Report for Administration module Usage : rgnrpt option 1 : 3 option 2 : 3 Parameters : FDATE, TDATE, FROM-TIME~, TO-TIME~

The report gives the total attempts, originating traffic, incoming traffic, percentage of successful calls, and traffic intensely in erlangs. NOTE : 1. 2. 3. This report applicable only for MBM sites. Traffic report (LINE-REP) to be enabled in advance to obtain this report. If FDATE is given as default it will take current date and also will not ask for TDATE. MBM-MAX Sat Jul 31 17:20:19 1999 REPORT
ISDN ERL 22 0 0 0 28 61 ERL = Erlangs TOT 0 0 0 0 0 0 SUC% 0 0 0 0 0 0 ERL 0 0 0 0 0 0 TOT 0 0 0 0 851 430 INCOMING SUC% 0 0 0 0 56 83 ERL 0 0 0 0 11 29

The output will be displayed as follows: DELHI-CANTT C-DOT DSS EXCHANGE PERFORMANCE AM
DATE TIME TOTAL CALLS TOT 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999 TOT = Total ** 16:00 16:16 16:45 17:00 17:11 17:15 2308 0 0 0 2820 1169 2308 0 0 0 1969 739 PSTN SUC% 26 0 0 0 27 29

SUC % = Successful Percentage

APPLICATION NOTE ON RGEN/CMD UTILITY

59

Chapter 11.

11.4. bmicog2 BM wise incoming Outgoing Traffic Report for Trunk BMs. Usage : rgnrpt 1st Menu : 3 2nd Menu : 6

Parameters :

FDATE, TDATE, BM NUM, FROM-TIME~, TO-TIME~

By default reports for all BMs can be generated. BM number can be given as 01 to 32 for getting reports for any particular BM. If default value is given for this parameter, reports for all equipped and in service BMs will be generated. If any BM was not in service during the time of traffic report period, report for that BM will not be present. The report contains the number of incoming requests (seizures), incoming successful calls, incoming terminating call attempts, transit call attempts, outgoing call attempts, successful outgoing calls and total outgoing and incoming call attempts for all BMs. NOTE : 1. 2. For SBM sites only BM1 reports will be available Traffic report (LIN-REP) to be enabled in advance to obtain report.

The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 17:28:7 1999

C-DOT DSS BM IC / OG REPORT


IC-TERM ATT 1 2 1 1 0 SUC 1 2 1 1 0 IC-OG ATT 0 0 0 0 0 SUC 0 0 0 0 0 OUTGOING ATT 2 2 1 1 0 SUC 2 2 1 1 0

BM 02 02 02 02 02

DATE 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999

TIME 15:00 15:15 15:30 15:45 16:00

TRK OPN 128 128 128 128 128 ATT = Attempts

IC-SEIZ 1 2 1 1 0

OPN = Operational SEIZ = Seizure

SUC = Success

**

60

C-DOT DSS MAX

SCRIPTS FILES

11.5. bmortr2 BM wise originating-terminating traffic report Usage : rgnrpt 1st Menu : 3 2nd Option : 5

Parameters :

FDATE, TDATE, BM NUM, FROM-TIME~, TO-TIME~

Reports for a particular BM may be obtained by specifying the value for the parameter BM NUM. If default value is given for this parameter, reports for all equipped and in service BMs will be generated. The report gives the number of originating call attempts, successful calls, terminating call attempts, successful terminating calls and total originating and terminating call attempts. NOTE : 1. 2. For SBM sites only BM1 reports will be available Traffic report (LINE-REP) to be enabled in advance to obtain reports. The output will be displayed as follows: MBM-MAX Sat Jul 31 17:36:29 1999

DELHI-CANTT

C-DOT DSS ORIGINATING/TERMINATING BM REPORT


ORIGINATING ATT 1939 30 0 20 719 FAIL 3 0 0 0 400 SUC = Success ORG-TRM ATT 0 0 0 0 0 SUC 0 0 0 0 0 ORG-OG ATT 1936 30 0 20 319 SUC 520 17 0 6 210 TERMINATING ATT 0 209 0 188 0 CMPL 0 38 0 165 0

BM 03 01 08 01 03

DATE 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999

TIME 17:11 17:11 17:11 17:15 17:15

LINE OPNL 120 120 8 120 120

ATT = Attempts

CMPL = Completed

11.6. bmtrf2 Exchange Performance Report for Base Modules Usage : rgnrpt 1st Menu : 3 2nd Menu : 4

Parameters :

FDATE, TDATE, BM NUM, FROM-TIME~, TO-TIME~

Reports for a particular BM may be obtained by specifying the value for the parameter BM NUM. If default value is given for this parameter, reports for all equipped and in service BMs will be generated. The report contains the number of total attempts (originating and incoming), traffic intensity for originating calls, traffic intensity for incoming calls, percentage of successful originating calls, percentage of successful terminating calls.
APPLICATION NOTE ON RGEN/CMD UTILITY 61

Chapter 11.

NOTE : 1. 2. For SBM sites only BM1 reports will be available Traffic report (Line-Rep) to be enabled in advance to obtain reports. MBM-MAX Sat Jul 31 17:40:53 1999

The output will be displayed as follows: DELHI-CANTT C-DOT DSS EXCHANGE PERFORMANCE BM REPORT
PSTN TOT 0 0 0 0 0 0 TOT = Total SUC% 0 0 0 0 0 0 ERL 0 0 0 0 0 0 TOT 0 0 0 0 0 0 ISDN SUC% 0 0 0 0 0 0 ERL 0 0 0 0 0 0 TOT 0 0 0 0 0 0 INCOMING SUC% 0 0 0 0 0 0 ERL 0 0 0 0 0 0

BM

DATE

TIME

TOTAL CALLS 0 0 0 0 0 0

02 02 02 02 02 02

31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999

16:00 16:16 17:00 17:11 17:15 17:30

SUC = Successful ERL = Erlangs

11.7. bnpdat2 Usage : rgnrpt 1st Menu : 1 2nd Menu : 4 Parameters : DIRECTORY NUM~, DAY, MONTH, YEAR, LIN STATUS

This script file gives the list of subscribers that have been put under bill not paid status (BNP-ANNC & BNP-DISC) on a particular date. The report for all dates can also be generated by giving default value against the DATE parameter. The output is displayed as follows. DELHI-CANTT MBM-MAX Fri Dec 31 12:21:13 1999 SUBSCRIBER LINE STATUS
--------------------------------------------------------------------------------------------------------------------------DIRNO DATE LIN-STA --------------------------------------------------------------------------------------------------------------------------40136 29-04-1999 BNP-DISC 40166 29-04-1999 BNP-DISC 40200 29-04-1999 BNP-DISC 40214 29-04-1999 BNP-DISC 40586 29-04-1999 BNP-DISC --------------------------------------------------------------------------------------------------------------------------Total Records printed : 5

62

C-DOT DSS MAX

SCRIPTS FILES

11.8. bphdwr2 BM wise hardware equipage report Usage : rgnrpt 1st Menu : 6 2nd Menu : 3

Parameters :

BM NUM, HW TYPE, STATUS

This script generates the BM wise hardware equipage report. The script can be used to get the specified hardware equipage in a particular BM or in all the BMs equipped in the system. The report also displays the version number of the hardware type and their current status (i.e., Inservice, Out Of Service etc.). The output report is displayed as follows: DELHI-CANTT MBM-MAX Mon Jan 3 11:53:44 2000

BM HARDWARE EQUIPAGE
--------------------------------------------------------------------------------------------------------------------------TEN VER HW-TYPE STATUS --------------------------------------------------------------------------------------------------------------------------1-2-6-23-1 1 LCC INS 1-2-6-23-2 1 LCC INS 1-2-6-23-3 1 LCC INS 1-2-6-23-4 1 LCC INS 1-2-6-23-5 1 LCC INS --------------------------------------------------------------------------------------------------------------------------Total records printed : 5

11.9. bwtgp2 Bothway trunk group traffic report Usage : rgnrpt 1st Menu : 4 2nd Menu : 3

Parameters :

FDATE, TDATE, FROM-TIME, TO-TIME

This script can be used to get the traffic reports of bothway trunk groups for a specified period. The report will have number of incoming call attempts, outgoing call attempts, completed calls, transit calls, and calls failing due to non-availability of trunk circuits. It will also have the traffic intensity in erlangs. Note: 1. Trunk groups need to be under observation to obtain report. DELHI-CANTT 2. MBM-MAX Thu Nov 4 11:33:24 1999

The TGPs to be put under observation should be in multiples of 2 (i.e. 2,4,6, ). The output will be displayed as follows:

APPLICATION NOTE ON RGEN/CMD UTILITY

63

Chapter 11.

C-DOT DSS BOTHWAY TRUNK TRAFFIC REPORT


-------------------------------------------------------------------------------------------------------------------------------------------TGP 1 2 3 4 5 6 7 8 9 10 TRK TRNS TRK_NA DATE 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 TIME 00:01 00:01 00:01 00:01 00:01 00:01 00:01 00:01 00:01 00:01 TRK 124 372 372 372 372 372 372 372 372 372 T_ATT ERL OTHR IC_AT 1534 279 279 279 279 279 279 279 279 279 OG_AT 1427 220 220 220 220 220 220 220 220 220 TRMAT 1501 258 258 258 258 258 258 258 258 258 TR_AT 0 7 7 7 7 7 7 7 7 7 CMPL BSY IDLE CMPLD 821 221 221 221 221 221 221 221 221 221 TR_NA 0 0 0 0 0 0 0 0 0 0 ERL 69 22 22 22 22 22 22 22 22 22 IDLE 0 89 89 89 89 89 89 89 89 89

--------------------------------------------------------------------------------------------------------------------------------------------

-------------------------------------------------------------------------------------------------------------------------------------------= Trunk Operational = Transit Calls = Trk Not Available = Total Attempts = Erlang Traffic = Other Reasons = Completed calls = Called Busy = Min-ckt Idle %

11.10. cdrcld2 Call Detail Records (CDR) of called subscribers Usage : rgnrpt 1st Menu : 7 2nd Menu : 2

Parameters :

FDATE, TDATE, CALLED DIR~, CALLING DIR~, FROMTIME~, TO-TIME~

The reports can be generated for a particular directory number or for range of DIRNOs on which calls are terminated, for a given period or for a given range of calling numbers. More than one option can also be given. Hence to get details of all calls terminating on a given number and originated by a given number, the values for CALLED DIR~, and CALLING DIR~ can be specified. NOTE : 1. 2. Subscribers need to be put under observation for Terminating calls to obtain the reports. The TGPs to be put under observation should be in multiples of 2 (i.e. 2,4,6, ). The output will be displayed as follows:

The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 18:29:16 1999

CALL DETAILED RECORDS - CALLED


CALLED 5554054 DATE dd/mm/yyyy 31-07-1999 TIME hh:mm:ss 17:55:10 CLNG-DIR 5554053000 CLNG TEN 2-1-4-3-1 DURN mm:ss 0:00 CALL STATUS NRM-USP

Total Records printed : 1

64

C-DOT DSS MAX

SCRIPTS FILES

11.11. cdrcln2 Call detail records (CDR) of calling Subscribers Usage : rgnrpt 1st Menu : 7 2nd Menu : 1

Parameters :

FDATE, TDATE, DIRECTORY NUM~, CALLED NUM~, FROM-TIME~, TO-TIME~

The called number can be selected to choose only those records corresponding to a given route. The report gives the parameter ANS & CLR status. It can have following values. F: Clear forward received AF: Answer and clear forward received AB: Answer and clear back received NOTE : Subscribers need to be under observation for originating calls to obtain this report. The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 18:48:21 1999

C-DOT DSS:CALL DETAIL RECORDS - CALLING


DIRNO 5554053 5554053 5554053 5554053 5554053 5554053 DATE dd/mm/yyyy 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999 31-07-1999 TIME hh:mm:ss 17:10:23 17:36:08 17:36:23 18:29:52 18:46:59 18:47:07 DIAL DIGITS 015554054 015554054 0155 5554054 015554054 015554054 ANS & CLR AF F F F F F DURN sec 1543 3 0 28 0 0 MTR CNT 318 0 0 0 0 0 CALL STATUS NRM-CLR BCK-ABS CNJ-TRK ABANON NU NU F = Clear

AB = Answer followed by clear back, forward

AF = Answer followed by clear forward,

11.12. combil2 Commercial billing record Usage : rgen combil2 DATE, OPERATION TYPE, FACILITY, TRM-FACILITY. DIRECTORY NUM, ORG-

Parameters :

APPLICATION NOTE ON RGEN/CMD UTILITY

65

Chapter 11.

This script file gives the report for the modifications, creations and deletion of subscriber, trunk group and hunt group related data. If default value is given for the parameter DIRECTORY NUM, reports for all the numbers corresponding to the particular date will be generated. The report also displays the meter counters of the subscribers and hunt groups at the time of their creation or deletion. The output report is displayed as follows : DELHI-CANTT MBM-MAX Mon Jan 3 11:46:28 2000

COMMERCIAL BILL RECORD


---------------------------------------------------------------------------------------------------------------------------------------------------------------------------DIRNO TEN COMMND DATE TIME ORG_F/DIR/ TRM_F/ OLD_STA NEW_STA ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------50768 50769 50770 50771 50772 16-1-1-5-1 LCL : 0 16-1-1-5-2 LCL : 0 16-1-1-5-3 LCL : 0 16-1-1-5-4 LCL : 0 16-1-1-5-5 LCL : 0 CRE-SUB STD: 0 CRE-SUB STD : 0 CRE-SUB STD : 0 CRE-SUB STD : 0 CRE-SUB STD : 0 17-12-1998 17-12-1998 17-12-1998 17-12-1998 17-12-1998 17:32 ISD : 0 17:33 ISD : 0 17:33 ISD : 0 17:33 ISD : 0 17:33 ISD : 0 TOT : 0 TOT : 0 TOT : 0 TOT : 0 TOT : 0

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------Total records printed : 5 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

11.13. crgrtn2 Charge rate numbers report Usage Parameter : : rgnrpt 1st Menu : 8 2nd Menu : 1

CHARGE RATE NUM, CHARGE BAND NUM, CHARGE MODE, ROUTING INFO.

This report will be useful in knowing details of charge rate numbers already programmed in exchange.

66

C-DOT DSS MAX

SCRIPTS FILES

The output will be displayed as follows: DELHI-CANTT MBM-MAX Mon Aug 9 16:42:14 1999

CRGRTN 0 1 2 3 4 5 6 7

CRGBAND 1 -1 -1 0 1-1 20 21 24

CHARGING-PERIOD-BS1 TRF1 1 0 1 0 0 2 5 0 TRF2 0 0 0 0 0 3 13 6 TRF3 0 0 0 0 0 3 13 6 TRF4 0 0 0 0 0 3 13 6

CRGUNT 0 0 0 0 0 3 13 6

CRGMODE 0 0 0 0 0 2 5 1

METER-ANSWERRING-BEEP INFO MT-AEX-NMR-NBP MT-AEX-NMR-NBP MT-AEX-NMR-NBP NM-AEX-NMR-NBP MT-AEX-NMR-NBP MT-AEX-NMR-NBP MT-AEX-NMR-NBP MT-AEX-NMR-NBP

[INI-CRG, CRG-UNT, CRG-MOD & RUT-INF are for TRF-CLS 1 of BS1]

11.14. dcbr2 Diverted call billing record Usage : rgnrpt 1st Menu : 5 2nd Menu : 5

Parameters :

FDATE, DIRECTORY NUM~, CALLED NUM~, Unit>

This script is used to display the detailed billing seconds of the calls diverted from a subscriber. The output report shows the diverted directory number, date and time of the calls, duration of the calls and the units charged for each call. The output is displayed as follows :

APPLICATION NOTE ON RGEN/CMD UTILITY

67

Chapter 11.

DELHI-CANTT

MBM-MAX

Thu Nov

4 11:04:05 1999

DIVERTED CALL BILLING RECORDS


---------------------------------------------------------------------------------------------------------------------------------------------------------------------------DIR DIVERTED NUM DATE TIME DURTN UNITS ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------6511444 6511444 3350389 3356218 6348700 6348700 3356218 3465444 3465444 9845031548 3207483 6653400 6653400 3207483 03/11/1999 03/11/1999 03/11/1999 03/11/1999 03/11/1999 03/11/1999 03/11/1999 09:08:37 09:17:52 09:30:36 10:07:36 10:25:14 10:29:47 12:50:38 0:01 1:40 0:20 5:54 2:32 1:26 1:50 1 1 1 2 1 1 1

---------------------------------------------------------------------------------------------------------------------------------------------------------------------------Records : 7 (* CALL ORIGINATED PREVIOUS DAY) Units: 8 ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

11.15. ictgp2 Incoming Trunk Group Traffic Report Usage : rgnrpt 1st Menu : 4 2nd Menu : 2

Parameters :

FDATE, TDATE, FROM-TIME~, TO-TIME~, TGP-NO

The report contains the number of attempts (seizures), successful, transit, incoming terminating attempts. The traffic intensity in erlangs is also displayed for all the trunk groups under observation. NOTE : 1. 2 I/C Trunks groups should be under observation to obtain the report. The Trunk groups under observation should be in multiple of '4' (4, 8, 12, . . . ) otherwise report may not be displayed for all TGPs and for all the time periods.

The output will be displayed as follows:

68

C-DOT DSS MAX

SCRIPTS FILES

DELHI-CANTT

MBM-MAX

Tue Nov 4 11:25:04 1999

C-DOT DSS - INCOMING TRUNK TRAFFIC REPORT

TGP 200 201 202 203 204 205 TRK ICRQ CNJ

DATE 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999 03-11-1999

TIME 00:01 00:01 00:01 00:01 00:01 00:01

TRK 89 44 45 30 90 120

T_ATT 65 23 53 7 28 349

SUCC 24 17 25 6 13 54

ICRQ 57 22 50 7 27 97

TRNS 0 0 0 0 0 0

ERL 4 1 2 1 1 4 SUCC ERL OTHR

BUSY 13 1 19 0 11 25

CNJ 0 0 0 0 0 0

ABDN 7 2 6 1 3 16

OTHR 13 2 0 0 0 246

= Trunk Operational = Incoming Requests = Congestion

T_ATT = Total Attempts TRANS = Transit Calls ABEN = Abandon

= Successful calls = Erlang Traffic = Other reason

11.16. linchr2 Subscriber line characteristics Usage : rgnrpt 1st Menu : 1 2nd Menu : 2

Parameters :

BM NUM, INSTRUMENT TYPE, LINE TYPE.

This script can be used to get details of subscribers Line Characteristics. The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 19:43:44 1999

SUBSCRIBER LINE CHARACTERISTICS


TEN 2-1-4-5-2 2-1-4-5-3 2-1-4-5-4 2-1-4-5-6 2-1-4-5-7 2-1-4-5-8 INS-TYP DTMF DTMF DTMF DTMF DTMF DTMF LIN-TYP ORD-LIN ORD-LIN ORD-LIN ORD-LIN CCB-STD PABX

Total records printed : 6

APPLICATION NOTE ON RGEN/CMD UTILITY

69

Chapter 11.

11.17. linmod2 Subscriber Line Modification Report Usage : rgnrpt 1st Menu : 1 2nd Menu : 3

Parameters :

DATE, OPERATION TYPE, DIRECTORY NUM~, ORG-FACILITIES, TRM FACILITIES

This script can be used to generate reports of any subscriber, range of subscribers or hunt group related data modifications. The operation type can be specified to get reports of a particular type of operation. Billing counters will be given where ever it is applicable. In the case of facility modifications, the new facilities will be given in the report. Alternately listing of a directory number, TEN or facility may be obtained by prompting respective parameters. The output will be displayed as follows : DELHI-CANTT MBM-MAX Sat Jul 31 19:45:27 1999 COMMERCIAL BILL RECORD
COMMAND MOD-LIN MOD-LIN MOD-LIN MOD-LIN MOD-LIN DATE dd/mm/yyyy 31-7-1999 31-7-1999 31-7-1999 31-7-1999 31-7-1999 TIME hh:mm:ss 17:04 17:04 17:04 17:09 17:42 ORG_F/DIR/ OLD_STA NRML NRML BN-AN NRML BN-DS TRM_F/ NEW_STA BN-AN BN-AN BN-DS BE-CU NRML

DIRNO 555405 2 555405 7 555405 2 555405 8 555405 2

TEN 2-1-4-5-2 2-1-4-5-7 2-1-4-5-2 2-1-4-5-8 2-1-4-5-2

Total records printed : 5

11.18. linsts2 Out of Service Line Status Report Usage : rgnrpt 1st Menu : 5 2nd Menu : 3

Parameters :

BM NUM, LINE STATUS

This script can be used to get the list of lines which are OOS-SE or OOS-OPR.

70

C-DOT DSS MAX

SCRIPTS FILES

The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 19:47:31 1999

OUT OF SERVICE LINES REPORT


TEN 2-1-4-5-2 2-1-4-5-7 2-1-4-5-8 Total Records printed = 3 STATUS OOS-OPR OOS-OPR OOS-OPR

11.19. ncbr2 Detailed Bill Record Report Usage : rgen ncbr2 FDATE, TDATE, DIRECTORY NUM~, CALLD NUM~, UNIT>, F_TIME, T_TIME

Parameters :

This script can be used to get the report of detailed billing records of the subscribers. Records for calls in a particular direction can be obtained by specifying the CALLDNUM. If any value for UNITS is specified, records with unit count greater than the given value will be displayed. Using the utility detail bills can be obtained for specific number, all numbers with a prefix or for the whole working numbers of the exchange. However, the scope of the report limited to the period for which data available in IOP hard disk. If disk space permit and need dictates previous billing cycle backup may be restored to IOP by CRP copy-in command and further processing may be done to obtain report for the required period. The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 19:51:32 1999

NORMAL CALL BILLING RECORDS DIR-NO 5554053 5554053 5554053 CALLEDNUMBER 015554054 015554054 015554054 DATE 31/07/1999 31/07/1999 31/07/1999 TIME 14:45:06 14:59:29 15:04:52 DURATION 11:49 4:17 9:01 UNITS 2721 981 542

Records : 3 (*CALL ORIGINATED PREVIOUS DAY) Units : 4244.

APPLICATION NOTE ON RGEN/CMD UTILITY

71

Chapter 11.

11.20. ogtgp2 O/G Trunk Group Traffic Report Usage : rgnrpt 1st Menu : 4 2nd Menu : 1

Parameters :

FDATE, TDATE, FROM- TIME~, TO-TIME~

This script can be used to get the traffic reports of outgoing trunk groups for a specified period. The report will have the number of attempts, successful calls, transit calls, calls failing with busy signal and number calls overflowing to other trunk groups. It will also have the traffic intensity in erlangs. NOTE : 1. 2. Trunk Groups need to be under observation to obtain report. TGPs to be put under observation should be in multiple of 4 (i.e., 4, 8, 12, . . .) MBM-MAX Wed Aug 18 15:51:40 1999

DELHI-CANTT

C-DOT DSS OUTGOING TRUNK TRAFFIC REPORT


TGP 1. 2. 3. 4. DATE 15/04/1999 15/04/1999 15/04/1999 15/04/1999 TIME 00:00 00:00 00:00 00:00 TRK 29 25 30 15 T_ATT 20 63 27 2 CMPL 13 35 7 2 TRNS 7 47 17 2 ERL 4 7 2 1 BSY 1 6 0 0 TRK-NA 0 0 0 0 OTHR 12 23 17 0 IDLE 79 108 83 193

11.21. procam2 Processor Report Administration Module Usage : rgnrpt 1st Menu : 3 2nd Menu : 1 Parameters : FDATE, TDATE, PROCESSOR, FROM-TIME~, TO-TIME~

This script can be used to get the percentage processor idle time for AP and CMSs. The idle time will be displayed correct to one decimal point. Idle time will be shown as zero percent if any CMS was out of service when the processor report was generated. Observation duration also will be displayed in the report. NOTE : 1. 2. This report available only in Multi module exchange. Processor report need to be enabled in advance to obtain the report. The output will be displayed as follows:

72

C-DOT DSS MAX

SCRIPTS FILES

C-DOT-CANTT

MBM-MAX

Tue May 14 10:10:57 1999

C-DOT DSS PROCESSOR IDLE TIMES FOR AP/CMS DATE dd/mm/yyyy 14-05-19999 14-05-19999 14-05-19999 14-05-19999 14-05-19999 11.22. procbm2 Processor Report Base Module wise. Usage : rgnrpt 1st Menu : 3 2nd Menu : 2 TIME hh:mm:ss 10:01:29 10:01:29 10:01:29 10:01:29 10:01:29 OBS-DUR minutes 15 15 15 15 15 PROCESSOR AP CMS1 CMS2 CMS3 CMS4 IDLE TIME PERCENT(%) 83.0 57.3 55.9 55.9 55.5

Parameters :

FDATE, TDATE, BM NUM, FROM-TIME~, TO-TIME~

This script can be used to get the percentage processor idle time for BPs and BMSs. The idle time will be displayed correct to one decimal point. Idle time will be shown as zero percent if any BMS was out of service when the processor report was generated. Observation duration also will be displayed in the report. The reports may be generated for any given BM. By default reports will be generated for all equipped and in service BMs. NOTE : 1. 2. For SBM site, only BM1 report will be available Processor report to be enabled in advance to obtain report.

The output will be displayed as follows:

APPLICATION NOTE ON RGEN/CMD UTILITY

73

Chapter 11.

C-DOT-CANTT

MBM-MAX

Tue May 14 10:10:57 1999

C-DOT DSS BASE MODULE PROCESSOR IDLE TIME REPORT

BM-NO 03 10 11 12 09

DATE dd/mm/yyyy 14-05-1999 14-05-1999 14-05-1999 14-05-1999 14-05-1999

TIME hh:mm:ss 10:00:02 10:00:09 10:00:14 10:00:19 10:00:45

OBS-DUR minutes 15 15 15 15 15

BP PERCENT 51.7 68.8 76.6 92.0 49.4

BMS-0 PERCENT 52.2 60.8 56.4 61.7 50.3

BMS-1 PERCENT 58.3 54.6 60.6 57.8 58.1

11.23. routtrf2 Route Code Wise Traffic Report Usage : rgnrpt 1st Menu : 4 2nd Menu : 4

Parameters :

FDATE, FROM-TIME, TO-TIME

This script file generates the traffic report for routes such as total attempt on a particular route, completed calls, various failures, traffic intensity and calls passed through alternate choice trunk groups. Before generating this report the routes should be put under observation. The output report is displayed as follows: DELHI-CANTT MBM-MAX Fri Dec 31 12:22:55 1999

C-DOT DSS ROUTE TRAFFIC REPORT


---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ROUT DATE TIME T_ATT COMP F_CLN F_CLD F_NET F_SYS ERL TGP1 TGP2 ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------913 21/12/1999 01:00 7 4 3 0 0 0 2 7 0 914 21/12/1999 01:00 14 6 5 2 1 0 1 14 0 9151 21/12/1999 01:00 1 1 0 0 0 0 1 1 0 921236 21/12/1999 01:00 0 0 0 0 0 0 0 0 0 012635 21/12/1999 01:00 7 7 0 0 0 0 0 2 7 ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------T_ATT = Total attempts COMP = Completed calls F_CLN = Part_dial+IDT+Abandon_after_dial F_CLD = Busy+No_Ans+NU+Access_Barr F_NET = Flty_signal+Remot_cong+Any_other F_SYS = No_trunks+No_srv+Over_load TGP1 = Calls through First Choice TGP TGP2 = Calls through 2 Choice TGP ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

74

C-DOT DSS MAX

SCRIPTS FILES

11.24. srvckt2 Service circuit traffic report Usage : rgnrpt 1st Menu : 3 2nd Menu : 7

Parameters :

FDATE, TDATE, BM NUM, FROM-TIME, TO-TIME

This script generates the status of service circuits for a particular BM by specifying the value for the parameter BM NUM. If default value is given against this parameter the status of service circuits [dtmf, mf sender, mf receiver] for all the BM's equipped in the system is displayed. This gives the complete idea of the number of circuits assigned, the number of circuits operational, total attempts made on this circuit and the failures. Output report is display as follows : DELHI-CANTT MBM-MAX Fri Dec 31 12:30:39 1999

C-DOT DSS EXCHANGE PERFORMANCE BM REPORT


BM 01 02 03 04 05 08 06 DATE 21-12-1999 21-12-1999 21-12-1999 21-12-1999 21-12-1999 21-12-1999 21-12-1999 TIME ASG 01:00 01:00 01:00 01:00 01:00 01:00 01:00 45 45 45 45 45 0 0 - DTMF OPR 45 45 45 45 45 0 0 ATT 9 3 16 14 2 0 0 FLR 0 0 0 0 0 0 0 ASG 0 0 0 0 0 24 24 - MFR OPR 0 0 0 0 0 24 24 ATT 0 0 0 0 0 127 179 FLR 0 0 0 0 0 0 0 ASG 0 0 0 0 0 21 21 - MFS OPR 0 0 0 0 0 19 21 ATT 0 0 0 0 0 133 90 0 FLR 0 0 0 0 0

OPR = Operational ATT = Total Attempts ASG = Assigned FLR = Failure

11.25. ssbr2 Special Service Billing Records Usage : rgnrpt 1st Menu : 5 2nd Menu : 4

Parameters :

FDATE, TDATE, DIRECTORY NUM~, FACILITY TYPE

This script can be used to process the special service billing records for any given subscriber for a given period. The date and time will be given along with the dialed digits. If SUB-OG-BARR facility is invoked for activation, deactivation or keyword change, key word will not be displayed. The output will be displayed as follows:

APPLICATION NOTE ON RGEN/CMD UTILITY

75

Chapter 11.

C-DOT-CANTT

MBM-MAX

Wed Aug 18 16:01:03 1999

SPECIAL SERVICE BILLING RECORDS


DIRNO 36425 36958 34346 32105 31399 DIALED DIGITS 1160700 1160600 1160545 1162001 1160430 DATE 27/11/1998 27/11/1998 27/11/1998 27/11/1998 27/11/1998 TIME 01:38:44 11:34:06 16:11:52 19:51:40 20:09:36 FACILITY ALRM-ONCEA ALRM-ONCEA ALRM-ONCEA ALRM-ONCEA ALRM-ONCEA TYPE ACT ACT ACT ACT ACT METER 2 2 2 2 2

Total records printed : 5

11.26. subfac2 Report on facilities given to subscribers Usage : rgnrpt 1st Menu : 1 2nd Menu : 1

Parameters :

BM NUM, DIRECTORY NUM~, ORG FACILITIES, TRM FACILITIES, ACC-BAR, LINE-STA, MTR-CLASS

This script can be used to get the list of subscribers having one or more originating or terminating facilities registered. All the given facilities will be displayed along with the directory number. The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 20:00:35 1999

ORIGINATING/TERMINATING FACILITY & CHARACTERISTICS OF SUBSCRIBERS


DIRNO 5554052 5554052 5554052 5554052 5554052 5554052 TEN 2-1-4-5-2 2-1-4-5-3 2-1-4-5-4 2-1-4-5-6 2-1-4-5-7 2-1-4-5-8 ACC-BAR ISD ISD ISD ISD ISD ISD ORG-FAC TM-HT no-org no-org no-org no-org DBE TRM-FAC DIV-F no-trm no-trm no-trm no-trm CL-WT L-STA NRML NRML NRML NRML NRML NRML M-CLS NRML NRML NRML NRML NRML NRML

Total Records Printed : 6

[L-STA = Line Status M-CLS = Metering Class]

76

C-DOT DSS MAX

SCRIPTS FILES

11.27. submtr2 Subscriber Meter Reading Report Usage : rgnrpt 1st Menu : 5 2nd Menu : 1

Parameters :

FDATE, TDATE, BM NUM, DIRECTORY NUM~

This script can be used to generate the bulk meter reading of subscribers. Prior to executing this utility formatting the billing counters need to be performed from CRP by command fmt-blg-cntr. The report can be generated for a particular BM by specifying the value for the parameter BM NUM. The report gives the local counter, STD counter, ISD counter, number of STD calls, number of ISD calls and the total counter (bulk counter) which is the sum of local, STD and ISD counters. Print out can be taken by choosing option as print in the menu If directory numbers are to be sorted then give iop5x > rgen submtr2 -s1|print In above both cases default can be made for all parameters. However the volume of output may be noticed if exchange is MBM. The output is stored in the file u/admn /submtr-rec. The print out of the file can be taken as iop5x > print file-name. The output will be displayed as follows: DELHI-CANTT DELHI-CANTT
DIRNO 5554053 5554054 5554107 5554056 5554057 5554058 6

MBM-MAX

Wed Aug 11 14:48:20 1999

SUBSCRIBER METER READINGS @ Wed Aug 4 18:32:15 1999


STD-MTR 8295 0 1264 0 0 0 9559 STD-CAL 14 0 13 0 0 0 ISDMTR 0 0 0 0 0 0 0 ISD-CAL 0 0 0 0 0 0 BULK-MTR 8298 0 1264 0 0 0 9562

LCL-MTR 3 0 0 0 0 0 3

APPLICATION NOTE ON RGEN/CMD UTILITY

77

Chapter 11.

11.28. tgpchr2 Trunk Group Characteristic Report Usage : rgnrpt 1st Menu : 2 2nd Menu : 1

Parameters :

BM NUM, TGP-NUM, TGP-STA, LIN-SIG, REG-SIG

This script can be used to get the characteristics of any trunk group in a given BM. By default reports are generated for all trunk groups in all BMs. The output will be displayed as follows: DELHI-CANTT MBM-MAX Mon Aug 9 17:40:56 1999

TRUNK GROUP CHARACTERISTICS


TGP NUM 63 64 86 85 81 80 10 11 TGP STA BW BW OG IC OG IC IC OG LIN-SIG CCS CCS CAS3 CAS3 CAS3 CAS3 CAS3 CAS3 REGSIG CCS7 CCS7 MFR2 MFR2 MFR2 MFR2 MFR2 MFR2 DGT SFD 1 1 1 1 1 1 1 1 ROD 1 3 3 1 3 1 1 3 68 PRF DGT TGP TYP ORD ORD ORD ORD ORD TTX ORD ORD TGP CAT 1 1 1 1 1 1 1 1 YES CAMA DET BLG SIG. INF.. CHB CHB

SFD = Seize Forward PRF = Prefix Digit CAT = Category <SIGNALLING INFORMATION DETAILS> CHB = ISUP-CRG-CHB CHU = ISUP-CRG-CHU TON = ISUP-UNKN-TON ACD-NP = ISUP-ACS-CD-NP CLI-F = CLI-N-FAIL ACD-F = ACOD-N-FAIL

11.29. tgpmtr2 Usage : rgnrpt 1st Menu : 5 2nd Menu : 6

Parameters :

FDATE, TGP NUM

This script file generates the report for meter readings of the TGPs. Prior to executing this utility, formatting the billing counters need to be performed from CRP by command FMT-BLG-CNTR. This report includes the local counter, STD counter, STD calls, ISD counter, ISD calls and the bulk counter (ie., the sum of local, STD & ISD counters) of the trunk groups. If default value is given against this parameter the meter readings of all the tgp's will be displayed.

78

C-DOT DSS MAX

SCRIPTS FILES

C-DOT-CANTT
DELHI-CANTT
TGP 1 2 3 4 5 LCL-MTR 0 0 0 0 0

MBM-MAX

Fri Dec 31 12:24:51 1999


@ Sat Jun 26 14:04:26 1999
ISD-CAL 0 0 0 0 BULK-MTR 0 0 0 0 0

TGP METER READINGS (IC+OG)


STD-MTR 0 0 0 0 0 STD-CAL 0 0 0 0 ISD-MTR 0 0 0 0 0

11.30. trksts2 Out of Service Trunk Status Report Usage : rgnrpt 1st Menu : 6 2nd Menu : 2

Parameters :

BM NUM, TRUNK STATUS

This report can be used to get a list of trunks in the status OOS-OPR, OOS-SE, OOS-TST or BLK-TRS. The output will be displayed as follows: C-DOT-CANTT MBM-MAX Wed Aug 18 16:31:05 1999

OUT OF SERVICE TRUNKS REPORT (OOS-SE/OOS-OPR/OOS-TST/BLK-TRS/OOS-TRANS)


TRNK-HW TWT 4W-E-M 4W-E-M 4W-E-M 4W-E-M TEN 4-1-1-10-5 4-1-1-5-3 4-1-1-20-5 4-1-4-17-4 4-1-4-20-1 STATUS OOS-OPR OOS-OPR OOS-OPR OOS-OPR OOS-OPR

Total Trunks Faulty = 5 Warning : Trunks which are in BLK-SUS/BLK-CNF/ OOS-SO are not included.

APPLICATION NOTE ON RGEN/CMD UTILITY

79

Chapter 11.

11.31. dirten2 Directory to Terminal Equipment Number Translation Usage Parameter : : rgen dirten2 BM NUM~, DIRECTORY NUM~

This report will enable to see directory number Vs TEN details or vice versa across exchange or for specific Base Module. The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 19:31:19 1999

DIR-TEN TRANSLATION
DIRNO 5554052 5554053 5554054 5554056 5554057 5554058 TEN 2-1-4-5-2 2-1-4-5-3 2-1-4-5-4 2-1-4-5-6 2-1-4-5-7 2-1-4-5-8

Total records printed : 6

11.32. malc2 Malicious call reports. Usage : rgnrpt 1st Menu : 7 2nd Menu : 3

Parameters : TIME~

FDATE, TDATE, DIRECTORY NUM~, CALLING NUM~,

This script can be used to display malicious calls on a particular subscriber for a defined period. This script is used in case of local calls and also for incoming malicious calls.

80

C-DOT DSS MAX

SCRIPTS FILES

The output will be displayed as follows: DELHI-CANTT MBM-MAX Sat Jul 31 12:49:01 1999

MALICIOUS CALL DETAIL RECORDS DIR NO. 5554054 DATE dd/mm/yy 31/07/1999 TIME hh:mm:ss 17:55:14 CALLINGDIR 5554053000

Total Records Printed : 1 11.33. mtrsub To display the meter readings of subscriber on the entered dates and show the difference in meter readings. Usage : mtrsub FROMDATE, TO-DATE, BM NUMBER (for BM wise report)

Parameters :

This reports give the subscriber wise meter readings on the two dates FROM DATE and TO DATE and then calculates the difference of the two meter readings. On execution the following menu is displayed. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. CCB-STD CCB-PCO ISD-SUB STD-SUB HNG-SUB ALL-SUB BM-WISE LVL-WISE MISC. BNP-SUB

Select the type for which you want the listing to be. It will then ask for FROMDATE TODATE. Note : Formatted meter reading files must be available for the dates that you enter.

APPLICATION NOTE ON RGEN/CMD UTILITY

81

Chapter 11.

The output is displayed as follows :

TELEPHONE NUMBER IS = 40023


DATE 16/03/00 18/03/00 LCL-MTR 3129 03235 STD-MTR 1930 1945 STD-CAL 192 194 ISD-MTR 0 0 ISD-CAL 0 0 BULK-MTR 5059 5180

Total chargeable units = 121

TELEPHONE NUMBER IS = 40028


DATE LCL-MTR STD-MTR STD-CAL ISD-MTR ISD-CAL BULK-MTR

The files are also saved in /u/admn. Say you had chosen option std-sub then the file will be available as /u/admn/stdsub-rec.

82

C-DOT DSS MAX

System Practices
The following comments pertain to: Document Name CSP Section Issue/Draft No. , (Month) -

COMMENTS

(Year)

COMMENTS :

(Use a separate sheet if required)


Please mail your comments to: Centre for Development of Telematics Attn: Director, Systems
39, Main Pusa Road New Delhi 110 005 Tel.: +91-11-5740374 Fax: +91-11-5756378

Your Reference: Name : Designation : Company : Address :


Tel. : Fax :