You are on page 1of 85

C-DOT DSS MAX

APPLICATION NOTE
ON
RGEN/CMD UTILITY

(w.r.t. Software 2_1_1_1)


Section No. 400-654-0457
System
Practices 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. Introduction ..............................................................................................................................5

Chapter 2. Utilities Present .......................................................................................................................6

Chapter 3. Loading Procedure....................................................................................................................7


3.1. Purpose.........................................................................................................................7
3.2. General conventions ....................................................................................................7
3.3. Installation Procedure.................................................................................................7
Chapter 4. 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
Chapter 5. Limitations & Checks.............................................................................................................24
5.1. Limitations.................................................................................................................24
5.2. Checks ........................................................................................................................24
Chapter 6. Rgen Utility.............................................................................................................................26

Chapter 7. RGEN Scripts at a Glance .....................................................................................................27

Chapter 8. Parameter Description ...........................................................................................................30


8.1. Parameter Description ..............................................................................................30
Chapter 9. Utility Invocation ...................................................................................................................44
9.1. Syntax for Invocation ................................................................................................44
9.2. Queries .......................................................................................................................50
Chapter 10. Output Options .......................................................................................................................52

Chapter 11. 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
11.15. ictgp2 ..........................................................................................................................68
11.16. linchr2 ........................................................................................................................69
11.17. linmod2.......................................................................................................................70
11.18. linsts2 .........................................................................................................................70
11.19. ncbr2...........................................................................................................................71
11.20. ogtgp2 .........................................................................................................................72
11.21. procam2 ......................................................................................................................72
11.22. procbm2 ......................................................................................................................73
11.23. routtrf2 .......................................................................................................................74
11.24. srvckt2........................................................................................................................75
11.25. ssbr2 ...........................................................................................................................75
11.26. subfac2........................................................................................................................76
11.27. submtr2 ......................................................................................................................77
11.28. tgpchr2 .......................................................................................................................78
11.29. tgpmtr2.......................................................................................................................78
11.30. trksts2 ........................................................................................................................79
11.31. dirten2 ........................................................................................................................80
11.32. malc2 ..........................................................................................................................80
11.33. mtrsub ........................................................................................................................81

H:\HOME\MAX2111\WORD\APPRGEN2.DOC August 11, 2000


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 : Rgen Utility
Chapter 7 : Rgen Scripts at a Glance
Chapter 8 : Parameter Description
Chapter 9 : Utility Invocation Procedure
Chapter 10 : Output Options
Chapter 11 : Script Files

APPLICATION NOTE ON RGEN/CMD UTILITY 5


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 Usage Directory


util_mbm_1 To equip modules, frames and service ckts /u/admn/cmdfile
in a multimodule (MBM) exchange
equip To create cmd-file for equipping terminal /u/admn/cmdfile
cards
create To create cmd-file for creation of subs /u/admn/cmdfile
tst To create cmd-file for tst-trm /u/code/tool
cre-space2 To increase Disk-space /u/code/tool
start-prn To cancel printer requests & to enable /u/code/tool
printers
change-port To change the printer port /u/code/tool
help To print backup, ccb, dly.rout /u/code/tool
rgen Report Generation Tool /u/admin/rgen
clog To take CPU history log /u/code/tool
print To print long files /u/code/tool
tapecopy To duplicate cartridges and floppies /u/code/tool
help.txt Text file for procedure of backups, ccb subs /u/code/tool
& daily routines
ncbrprn For printing of detail bill record /u/code/tool

6 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 Indicates
convention
<> Represents `Return key
Italic Normal Command prompts are shown in Italic Normal
Italic Bold Any matter to be typed by the operator is shown in Italic
Bold
Bold Face Messages which appear on the screen are shown in Bold
type face

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 7


Chapter 3.

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

8 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 9


Chapter 4.

Enter the Base Module no.[1 to 16 ] : 1 <>


Enter the starting rack no. [ 1 to 3 ] : 1 <>
Enter the starting frame no. [ 1 to 6 ] : 2 <>
Enter the starting slot no. [3-10 & 17-24] : 3 <>

Note : 1. 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 ] : 1-1-2-10 <>
Enter hardware type for this slot : 1 <>
Enter slot no. to be modified [BM-RACK-FRM-SLT]
[Type 0 to end ] : 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] : 1 <>


Enter the starting rack no. [1 to 3] : 1 <>
Enter the starting frame no. [1 to 6] : 2 <>
Enter the starting slot no. [3-10 & 17-24] : 3 <>
Enter the starting port no. [1 to 8] : 1 <>
Note:
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.
2. If given for frame 1 in SBM than it will display
"TU1 in SBM is Trunk TU"
"Ensure your entries are ok"
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-6-
24 has to be avoided,
Enter the slot no. to be deleted [BM-RACK-FRM-SLT]
[Type 0 to end] : 1-2-1-3 <>
Enter the slot no. to be deleted [BM-RACK-FRM-SLT]
[Type 0 to end] : 1-2-6-24<>
Enter the slot no. to be deleted [BM-RACK-FRM-SLT]
[Type 0 to end] : 0 <>
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


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 ... Wait ...
Traffic Files Deleted
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 <equip-
frame.
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. Line testing
2. Trunk testing
3. 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. By TEN
2. 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 : 1-32 : 1 <>
RACK NUMBER : 1-3 : 1 <>
FRAME NUMBER : 1-6 : 2 <>
SLOT NUMBER : 3-24 : 5 <>
PORT NUMBER : 1-8 : 1 <>
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 & exec-
cmd-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 Line testing
2 Trunk testing
3 Digital Trunk testing
Enter Your Choice : 1 <>
LINE TESTING

18 C-DOT DSS MAX


OPERATIONAL PROCEDURES

1 By TEN
2 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 : 1-16 : 1 <>


RACK NUMBER : ONLY 1 : 1 <>
FRAME NUMBER : 1-6 : 1 <>
SLOT NUMBER : 3-24 : 5 <>
PORT NUMBER : 1-8 : 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 : (give starting Dirno.)
DIRNO TO : (give last Dirno.)
Printer Page Length : (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: From iop5x> prompt enter crp.
iop5x> crp <>
Step 2: 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 : eq-sub <>
Break : N <>
CMD-WAIT : <>
Confirm : <>
Start-num : <>
End-num : <>
Log-opt : <>
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.
ii) 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.

5.2. CHECKS

i) If SBM configuration is chosen the utility assumes the BM no. to `1' thereby
reducing one entry.
ii) If any value does not fall in the range shown, the utility repeats the question
till correct value is entered.
iii) 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.
v) Also the utility avoids equipping or creation in the 24th slot of TU4 in BM
(Rack 1) as it is reserved for TTC.
vi) 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.
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 : From date
TDATE : To date
BM NUM : Base module number
DIRECTORY NUM: Directory number for which information is required
After entering all the values it will display the local counter, STD counter, STD-
CALL 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. Script- Function it Performs


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


file name
STD and ISD counters) of hunt groups.
17. ictgp2 Display informations about seizures, transit & incoming
terminating attempts including traffic intensity on incoming Trunk
Group.
18. linchr2 Display subscriber lines characteristics data.
19. linmod2 Display reports about subscribers or hunt group related data
modifications.
20. linsts2 To display status of lines which are in `OOS- SE' or `OOS-OPR'
status.
21. ncbr2 To display detailed billing records for subscribers.
22. ogtgp2 To display necessary informations about outgoing trunk group
traffic reports.
23. procam2 To display idle time available for processors in Administration
Module in the multi module exchange.
24. procbm2 To display idle time available for processors in Base Module.
25. routtrf2 To display the route related traffic information.
26. srvckt2 To display the service circuits (DTMF ckts, MF-sender, MF-
Receiver) equipage and their utilization data.
27. ssbr2 To display the special service billing record for subscribers for a
given period.
28. subfac2 To display the list of subscribers having one or more originating
and terminating facilities.
29. submtr2 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.
30. tgcbr2 To display the call detail records of the trunk groups.
31. tgpchr2 To display the characteristics of a trunk group in a given BM.
32. trksts2 To display the trunks which are in `OOS-OPR', `OOS-SE', `OOS-
TST' and `BLK-TRS'.
33. malc2 To display the details of malicious calls in case of local call only
34. tgpname2 To display TGP number to name report
35. cgsname To display CGS number to name report

28 C-DOT DSS MAX


RGEN SCRIPTS AT A GLANCE

S.No. Script- Function it Performs


file name
36. tgputil To display status of TGP having more than 40 trunks.
37. mfrsub 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 : Name of the parameter

Mnemonic : Address - code in the form of a pronounceable word.

Type : Alpha, Numeric, Alphanumeric i.e. type of date


acceptable.

Possible Values/Range : A set of values and/or range accepted.

Default : The value automatically assigned. If the operator does not


assign any value.

Remarks : Some more information regarding special attributes of the


parameter

8.1. PARAMETER DESCRIPTION

BM NUM (Base Module Number)

Parameter Name : Base Module Number


Mnemonic : BM NUM
Type : Integer
Possible Values : 1 to 32
Default : All

APPLICATION NOTE ON RGEN/CMD UTILITY 30


PARAMETER DESCRIPTION

CALLED NUM~ (Called Number)

Parameter Name : Called Number


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

CALLING NUM~ (Calling Number)

Parameter Name : Calling Number


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

APPLICATION NOTE ON RGEN/CMD UTILITY 31


Chapter 8.

CALL FAIL TYPE (Call Failure Type)

Parameter Name : Call Failure Type


Mnemonic : CALL FAIL TYPE
Type : Alphabetic
Possible Values : SUCCESS : Success Call
DL-TMO : Dial Tone Timeout
INV-COD : Invalid Code
IDT-TMO : Inter Digit Timeout
RNG-TMO : Ring Timeout
CP-BSY : Call processing busy
MTN-BSY : Maintenance Busy
ADMN-BSY : Admin Busy
NU : Number Unobtainable
LLO : Line Lock out
ACC-BAR : Access Barred
SWT-BLK : Switch Blocking
SIG-FAL : Signalling Failure
INV-SIG : Invalid Signalling
BCK-PRM : Backward Signal Permanent
FRW-PER : Forward Signal Permanent
BCK-ABS : Backward Absent
NO-RSRC : No Resource Available
CNJ-TRK : Congestion on Trunks
REM-CNJ : Remote Congestion
FTR-FAIL : Feature Activation Fail
BLKING : Blocking
SPR-ANS : Spurious answer
NO-DIAL : No digit dialled
ABANDN : ABANDONED
PAR-DIAL : Partial Digit Dialled
SYS-REC : System Recovery
NRM-USP
SS7-ERR
INV-DGT
NRM-CLR
ACC-BAR
COMPLETE
NO-ACK
CSH-TMO
Default : All

32 C-DOT DSS MAX


PARAMETER DESCRIPTION

CHARGE MODE (Charge Mode)

Parameter Name : Charge Mode


Mnemonic : CHARGE MODE
Type : ASCII
Possible Values : FXD, FLT, PRD-LCL PRD-TAX, NO-MET
Default : All
Remarks : Mode of charging e.g. fixed charging, flat charging etc.

CHARGE PERIOD (Charge Period)

Parameter Name : Charge Period


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

CHARGE RATE NUM (Charge Rate Number)

Parameter Name : Charge Rate Number


Mnemonic : CHARGE RATE NUM
Type : Integer
Possible Values : 1 to 128
Default : All

APPLICATION NOTE ON RGEN/CMD UTILITY 33


Chapter 8.

DIRECTORY NUM~ (Directory Number)

Parameter Name : Directory Number


Mnemonic : DIRECTORY NUM
Type : Numeric, 7 digit maximum
Possible Values : 3, 4, 5, 6 or 7 digit numbers
Default : All and non for "crethdat"
Remarks : 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. In case of "crethdat" report, Range can be given like (example) 5485000 to
5485010.
2. In case of "crethdat" if you give 0 against directory number, it will exit.

FACILITY TYPE (Facility Type)

Parameter Name : Facility Type


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

34 C-DOT DSS MAX


PARAMETER DESCRIPTION

13. OCR-STD
14. OCR-10X
15. OCR-KW-CHG
16. INTRSN-BAR
17. DIV-MAN-ANS
18. DIV-FXD-ANN
19. DIV-FXD-NUM
20. DIV-SEL-NUM
21. DIV-BSY-FXD
22. DIV-BSY-GRP
23. DBE-SUB-LIN
24. DBE-TRNK
25. DEB-SRV-CKT
Default : All

FDATE (From Date)

Parameter Name : From Date


Mnemonic : FDATE
Type : Numeric string with 3 fields (DD-MM-YYYY)
Possible Values : DD-MM-YYYY
DD = 1 to 31
MM = 1 to 12
YYYY = Any numeric value

Default : Present Date


Remarks : Date from which the reports are required.

APPLICATION NOTE ON RGEN/CMD UTILITY 35


Chapter 8.

INSTRUMENT TYPE (Instrument Type)

Parameter Name : Instrument Type


Mnemonic : INSTRUMENT TYPE
Type : Alphabetic
Possible Values : DECAD = Decadic
DTMF = Dual Tone Multifrequency
DIGITAL = Digital
Default : All
Remarks : Type of instrument used by the subscriber.

LIN-SIG (Line Signalling Type)

Parameter Name : Line Signalling Type


Mnemonic : LINE SIG TYPE
Type : Alpha Numeric
Possible Values : LOOP-DSCT : Loop disconnect
E-M : Ear & month signalling
DR2-CAS1 : Digital R2 channel associated signalling
of type 1
DR2-CAS2 : Digital R2 channel associated
signalling of type 2
DR2-CAS3 : Digital R2 channel associated signalling
of type 3
Default : All

36 C-DOT DSS MAX


PARAMETER DESCRIPTION

LINE STATUS (Line Status)

Parameter Name : Line Status


Mnemonic : LINE STATUS
Type : Alphabetic
Possible Values : OOS-OPR, OOS-SE
Default : All

LINE TYPE (Line Type)

Parameter Name : Line Type


Mnemonic : LINE TYPE
Type : Alphabetic
Possible Values : ORD-LIN : Ordinary Line
CCB : Coin Collection Box
CCB-STD : CCB with STD facility
PABX : Private Automatic Branch Exchange
PBX-REV : PBX with Reversal
SRT-LIN : Short Line
SHR-LIN : Shared Line
TST-LIN : Test Line
UNASSGN : Unassigned Line
CCB-CRD : CCB with Credit Card Facility
LNG-LIN : Long Line
Default : All
Remarks : Type of Line attached to port.

APPLICATION NOTE ON RGEN/CMD UTILITY 37


Chapter 8.

OPERATION TYPE (Operation Type)

Parameter Name : Operation Type


Mnemonic : OPERATION TYPE
Type : Alphabetic
Possible Values : CRE-SUB, DEL-SUB, MOD-LIN, MOD-TEN, MOD-FAC,
CRE-HGP, DEL-HGP, ADD-LIN, DEL-LIN, MOD-CHR,
ADD-MSN
Default : All

ORG FACILITIES (Origination Facilities)

Parameter Name : Origination Facilities


Mnemonic : ORG-FACILITIES
Type : Alphabetic
Possible Values : 1. TIMED-HTLN : Timed Hotline
2. UNTIMED-DIRNO : Untimed Hotline
3. UNTIMED-PWIRE : Nailedup Hotline
4. DIAL-BY-EQPT : Dialling by equipment number
5. CAL-WAIT-CLNG : Call wait by calling
6. 3WAY-CNF : 3-way conference
7. 6WAY-CNF : 6-way conference
8. AUTO-CLBK : Auto Call Back
9. SEMI-AUTO-ALRM : Semi automatic alarm
10. AUTO-ALRM : Automatic alarm
11. MAN-ALRM : Manual Alarm
12. ADMN-OG-BARR : Admin controlled og call
restriction
13. SUB-OG-BARR : Subscriber controlled outgoing
barr.
Default : All

38 C-DOT DSS MAX


PARAMETER DESCRIPTION

PROCESSOR (Processor)

Parameter Name : Processor


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

ROUTING INFO (Routing Information)

Parameter Name : Routing Information


Mnemonic : ROUTING INFO
Type : ASCII Complex (4 field)
1st field : Metered/non metered: M/NM
2nd field : Answer expected/not expected AEX/ANX
3rd field : No ring/normal ring/big ring timeout :
NOR/NMR/BGR
4th field : BEEP/NBEEP
Possible Values : 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 : All
Remarks : Information corresponding to metering, ring and
expectation of answer

APPLICATION NOTE ON RGEN/CMD UTILITY 39


Chapter 8.

TDATE (To Date)

Parameter Name : To Date


Mnemonic : TDATE
Type : Numeric string with 3 fields (DD-MM-YYYY)
Possible Values : DD-MM-YYYY
DD = 1 to 31
MM = 1 to 12
YYYY = Any numeric value

Default : FDATE
Remarks : Date till which the reports are required.

TEN (Terminal Equipment Number)

Parameter Name : Terminal Equipment Number


Mnemonic : TEN
Type : String of 5-subfield of the type AA-B-C-DD-EE where AA,
B, C, DD, EE are integers and represent.
AA : Base Module Number
B : Rack Number
C : FRAME NUMBER
DD : Slot Number
EE : Circuit Number
Possible Values : 1-1-1-1-1 to 32-3-6-26-32
Default : All

40 C-DOT DSS MAX


PARAMETER DESCRIPTION

TGP NUM (Trunk Group Number)

Parameter Name : Trunk Group Number


Mnemonic : TGP NUM
Type : Numeric
Possible Values : 1 to 511
Default : All

TIME~ (Time)

Parameter Name : Time


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

APPLICATION NOTE ON RGEN/CMD UTILITY 41


Chapter 8.

TRM-FACILITIES (Terminating Facilities)

Parameter Name : Terminating Facility


Mnemonic : TRM-FACILITIES
Type : Alphabetic
1. DIV-SNGL-NUM : Diversion to single number on
Possible Values :
busy
2. DIV-GRP : Diversion to a group of number
on busy
3. CAL-WAIT-CLD : Call wait controlled by called
party
4. NO-ANS-SNGL : Diversion to a single number on
no answer
5. NO-ANS-GRP : Diversion to group on no
answer
6. ABS-MAN-ANS : Absentee to manual answer
7. ABS-FXD-ANNC : Absentee to fixed
announcement
8. ABS-FXD-NUM : Absentee to Fixed Number
9. ABS-SEL-NUM : Absentee to single number
10. BOTH-PTY-CLR : Both party clear
11. QING-NO-DCTV : Queing with no deactivation
12. QING-DCTV : Queing with deactivation
13. CLD-PTY-CLR : Called party clear
14. ADMN-INT-BAR :
15. SUB-INT-BAR :

Default : All

42 C-DOT DSS MAX


PARAMETER DESCRIPTION

TRUNK STATUS (Trunk Status)

Parameter Name : Trunk Status


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

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) Menu driven mode
ii) 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. Subscriber reports
2. Trunk Group reports
3. Module and service circuit traffic report
4. Trunk Group and route wise traffic report
5. Subscriber and Trunk Group meter report
6. Terminal type and status report
7. Subscriber traffic observation report
8. 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 File Name


1. Subscriber facility reports subfac2
2. Subscriber characteristics reports linchr2
3. Subscriber modification reports linmod2
4. Subscriber disconnection reports bnpdat2
*5. Main Menu
*6. Exit
2. Trunk Group

Secondary Menu File Name


1. Trunk group characteristics report tgpchr2
2. Trunk group characteristics report tgpname2
3. CGS number to name report cgsname2
*4. Main Menu
*5. Exit
3. Module and Service Circuit traffic Report

Secondary Menu File Name


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

APPLICATION NOTE ON RGEN/CMD UTILITY 45


Chapter 9.

4. Trunk Group and Routewise traffic report

Secondary Menu File Name


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

Secondary Menu File Name


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

Secondary Menu File Name


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

46 C-DOT DSS MAX


UTILITY INVOCATION

7. Subscriber traffic observation report

Secondary Menu File Name


1. Subscriber detail records on calling report cdrcln2
2. Subscriber detail records on called report cdrcld2
3. Subscriber detail records on malicious report malc2
*4. Main Menu
5. Exit
8. Miscellaneous report

Secondary Menu File Name


1. Charge rate number detailed report Crgrtn2
*2. Main Menu
3. Exit

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.
2. 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>.
3. 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.

APPLICATION NOTE ON RGEN/CMD UTILITY 47


Chapter 9.

Procedure to run MODIFY2 utility


IOP5x> modify2
It will display following main menu
1. Separate numbers (e.g., 71000, 71003 etc.)
2. A continuous range of Nos. (Directory Nos.)
3. Miscellaneous
4. Exit
5. 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 Individual Commands


1. Restoration from Non-payment 10. Mod-Sub-Fac
2. Disconnection BNP-ANNC 11. Mod-Sub-Char
3. Disconnection BNP-DISC 12. Del-Sub
4. Restoration of STD-FAC with the 13. Grnt-Ocr-Sub
desired Dynamic lock
5. Restoration of STD-FAC without 14. Wtd-Sub-Fac
granting Dynamic lock
6. Barring STD-FAC by first with 15. Frc-Trm-Oos
drawing code
7. Meter reading 16. Frc-Trm-Ins
8. Providing DTMF/DECAD/Digital 17. Save at Exit
9. Mod-Lin-Char 18. Exit
19. 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 Command name (Report generator)
Script file One of the script files made for an application as described under
Chapter 7.
<num> Positive integer number
-f<num> Process data for only first <num> records
-r<num> Process data in reverse order for <num> records
-s<num> Sort on <num> field This option is not applicable with Bill monitoring
related scripts.
i) The parameter in square brackets are optional
ii) Either -f <num> or -r <num> may be used but not both.
iii) 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 2. Screen & printer 3. Exit to main menu
Output format
Every output format provides a header as follows :
Site Name Exchange Type Time Stamp
Site Name : This is the name of the site where exchange is installed.
Exchange Type : This can be strings like SBM-RAX, MBM-MAX, SBM-TAX etc.
Time Stamp : 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. MBM
2. SBM
3. 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. Print
2. View
3. 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 = 89353

Total Lines Equipped = 13970


Total Lines Under maintenance = 143

Total Trunks equipped = 63


Total Trunks Under maintenance = 32

Total Originating Terminating Attempts = 8034


Calls Processing Efficiency = 88
Calls Completion Ratio = 44

Total Originating Outgoing Attempts = 19541


Calls Processing Efficiency = 62
Calls Completion Ratio = 20

Total Incoming Terminating Attempts = 7375


Calls Processing efficiency = 95
Call Completion Ratio = 55

Total Incoming Outgoing Call Attempts = 36656


Calls Processing efficiency = 68
Call Completion Ratio = 22

Total DTMF circuits assigned = 430


Total DTMF circuits operational = 430
Total DTMF attempts = 13121
Total DTMF failures = 0

Total MFR circuits assigned = 203


Total MFR circuits operational = 203
Total MFR attempts = 40584
Total MFR failures = 0

Total MFS circuits assigned = 192


Total MFS circuits operational = 191
Total MFS attempts = 34207
Total MFS failures = 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
Parameters : BM NUM, DIRECTORY NUM ~, LIN-STATUS
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 TEN STATUS

5554052 2-1-4-5-2 BNP-DISC

5554057 2-1-4-5-7 BNP-ANNC

5554058 2-1-4-5-8 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. This report applicable only for MBM sites.
2. Traffic report (LINE-REP) to be enabled in advance to obtain
this report.
3. If FDATE is given as default it will take current date and also
will not ask for TDATE.
The output will be displayed as follows:
DELHI-CANTT MBM-MAX Sat Jul 31 17:20:19 1999
C-DOT DSS EXCHANGE PERFORMANCE AM REPORT
DATE TIME TOTAL PSTN ISDN INCOMING
CALLS
TOT SUC% ERL TOT SUC% ERL TOT SUC% ERL

31-07-1999 16:00 2308 2308 26 22 0 0 0 0 0 0

31-07-1999 16:16 0 0 0 0 0 0 0 0 0 0

31-07-1999 16:45 0 0 0 0 0 0 0 0 0 0

31-07-1999 17:00 0 0 0 0 0 0 0 0 0 0

31-07-1999 17:11 2820 1969 27 28 0 0 0 851 56 11

31-07-1999 17:15 1169 739 29 61 0 0 0 430 83 29

TOT = Total SUC % = Successful Percentage ERL = Erlangs

**

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. For SBM sites only BM1 reports will be available
2. 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 IC-OG OUTGOING


BM DATE TIME TRK OPN IC-SEIZ
ATT SUC ATT SUC ATT SUC

02 31-07-1999 15:00 128 1 1 1 0 0 2 2

02 31-07-1999 15:15 128 2 2 2 0 0 2 2

02 31-07-1999 15:30 128 1 1 1 0 0 1 1

02 31-07-1999 15:45 128 1 1 1 0 0 1 1

02 31-07-1999 16:00 128 0 0 0 0 0 0 0

OPN = Operational SEIZ = Seizure ATT = Attempts 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. For SBM sites only BM1 reports will be available
2. Traffic report (LINE-REP) to be enabled in advance to obtain reports. The
output will be displayed as follows:
DELHI-CANTT MBM-MAX Sat Jul 31 17:36:29 1999
C-DOT DSS ORIGINATING/TERMINATING BM REPORT

ORIGINATING ORG-TRM ORG-OG TERMINATING


BM DATE TIME LINE
OPNL ATT FAIL ATT SUC ATT SUC ATT CMPL

03 31-07-1999 17:11 120 1939 3 0 0 1936 520 0 0

01 31-07-1999 17:11 120 30 0 0 0 30 17 209 38

08 31-07-1999 17:11 8 0 0 0 0 0 0 0 0

01 31-07-1999 17:15 120 20 0 0 0 20 6 188 165

03 31-07-1999 17:15 120 719 400 0 0 319 210 0 0

ATT = Attempts SUC = Success 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. For SBM sites only BM1 reports will be available
2. Traffic report (Line-Rep) to be enabled in advance to obtain reports.
The output will be displayed as follows:
DELHI-CANTT MBM-MAX Sat Jul 31 17:40:53 1999
C-DOT DSS EXCHANGE PERFORMANCE BM REPORT

PSTN ISDN INCOMING


BM DATE TIME TOTAL
CALLS TOT SUC% ERL TOT SUC% ERL TOT SUC% ERL

02 31-07-1999 16:00 0 0 0 0 0 0 0 0 0 0

02 31-07-1999 16:16 0 0 0 0 0 0 0 0 0 0

02 31-07-1999 17:00 0 0 0 0 0 0 0 0 0 0

02 31-07-1999 17:11 0 0 0 0 0 0 0 0 0 0

02 31-07-1999 17:15 0 0 0 0 0 0 0 0 0 0

02 31-07-1999 17:30 0 0 0 0 0 0 0 0 0 0

TOT = Total 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 MBM-MAX Thu Nov 4 11:33:24 1999
2. 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 DATE TIME TRK IC_AT OG_AT TRMAT TR_AT CMPLD TR_NA ERL IDLE
--------------------------------------------------------------------------------------------------------------------------------------------
1 03-11-1999 00:01 124 1534 1427 1501 0 821 0 69 0
2 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
3 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
4 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
5 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
6 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
7 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
8 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
9 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
10 03-11-1999 00:01 372 279 220 258 7 221 0 22 89
--------------------------------------------------------------------------------------------------------------------------------------------
TRK = Trunk Operational T_ATT = Total Attempts CMPL = Completed calls
TRNS = Transit Calls ERL = Erlang Traffic BSY = Called Busy
TRK_NA = Trk Not Available OTHR = Other Reasons IDLE = 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~, FROM-
TIME~, 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. Subscribers need to be put under observation for Terminating calls to obtain
the reports.
2. 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 DATE TIME CLNG-DIR CLNG DURN CALL
dd/mm/yyyy hh:mm:ss TEN mm:ss STATUS
5554054 31-07-1999 17:55:10 5554053000 2-1-4-3-1 0:00 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 DATE TIME DIAL ANS & DURN MTR CALL


dd/mm/yyyy hh:mm:ss DIGITS CLR sec CNT STATUS
5554053 31-07-1999 17:10:23 015554054 AF 1543 318 NRM-CLR
5554053 31-07-1999 17:36:08 015554054 F 3 0 BCK-ABS
5554053 31-07-1999 17:36:23 0155 F 0 0 CNJ-TRK
5554053 31-07-1999 18:29:52 5554054 F 28 0 ABANON
5554053 31-07-1999 18:46:59 015554054 F 0 0 NU
5554053 31-07-1999 18:47:07 015554054 F 0 0 NU
AB = Answer followed by clear back, AF = Answer followed by clear forward, F = Clear
forward

11.12. combil2

Commercial billing record


Usage : rgen combil2
Parameters : DATE, OPERATION TYPE, DIRECTORY NUM, ORG-
FACILITY, TRM-FACILITY.

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 16-1-1-5-1 CRE-SUB 17-12-1998 17:32
LCL : 0 STD: 0 ISD : 0 TOT : 0
50769 16-1-1-5-2 CRE-SUB 17-12-1998 17:33
LCL : 0 STD : 0 ISD : 0 TOT : 0
50770 16-1-1-5-3 CRE-SUB 17-12-1998 17:33
LCL : 0 STD : 0 ISD : 0 TOT : 0
50771 16-1-1-5-4 CRE-SUB 17-12-1998 17:33
LCL : 0 STD : 0 ISD : 0 TOT : 0
50772 16-1-1-5-5 CRE-SUB 17-12-1998 17:33
LCL : 0 STD : 0 ISD : 0 TOT : 0
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Total records printed : 5
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------

11.13. crgrtn2

Charge rate numbers report


Usage : rgnrpt 1st Menu : 8 2nd Menu : 1
Parameter : 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

CRG- CRG- CHARGING-PERIOD-BS1 CRG- CRG- METER-ANSWER-


RTN BAND UNT MODE RING-BEEP INFO
TRF1 TRF2 TRF3 TRF4
0 1 1 0 0 0 0 0 MT-AEX-NMR-NBP
1 -1 0 0 0 0 0 0 MT-AEX-NMR-NBP
2 -1 1 0 0 0 0 0 MT-AEX-NMR-NBP
3 0 0 0 0 0 0 0 NM-AEX-NMR-NBP
4 1-1 0 0 0 0 0 0 MT-AEX-NMR-NBP
5 20 2 3 3 3 3 2 MT-AEX-NMR-NBP
6 21 5 13 13 13 13 5 MT-AEX-NMR-NBP
7 24 0 6 6 6 6 1 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 3465444 03/11/1999 09:08:37 0:01 1
6511444 3465444 03/11/1999 09:17:52 1:40 1
3350389 9845031548 03/11/1999 09:30:36 0:20 1
3356218 3207483 03/11/1999 10:07:36 5:54 2
6348700 6653400 03/11/1999 10:25:14 2:32 1
6348700 6653400 03/11/1999 10:29:47 1:26 1
3356218 3207483 03/11/1999 12:50:38 1:50 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. I/C Trunks groups should be under observation to obtain the report.
2 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 DATE TIME TRK T_ATT SUCC ICRQ TRNS ERL BUSY CNJ ABDN OTHR

200 03-11-1999 00:01 89 65 24 57 0 4 13 0 7 13

201 03-11-1999 00:01 44 23 17 22 0 1 1 0 2 2

202 03-11-1999 00:01 45 53 25 50 0 2 19 0 6 0

203 03-11-1999 00:01 30 7 6 7 0 1 0 0 1 0

204 03-11-1999 00:01 90 28 13 27 0 1 11 0 3 0

205 03-11-1999 00:01 120 349 54 97 0 4 25 0 16 246

TRK = Trunk Operational T_ATT = Total Attempts SUCC = Successful calls


ICRQ = Incoming Requests TRANS = Transit Calls ERL = Erlang Traffic
CNJ = Congestion ABEN = Abandon OTHR = 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 INS-TYP LIN-TYP


2-1-4-5-2 DTMF ORD-LIN
2-1-4-5-3 DTMF ORD-LIN
2-1-4-5-4 DTMF ORD-LIN
2-1-4-5-6 DTMF ORD-LIN
2-1-4-5-7 DTMF CCB-STD
2-1-4-5-8 DTMF 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

DIRNO TEN COMMAND DATE TIME ORG_F/DIR/ TRM_F/


dd/mm/yyyy hh:mm:ss OLD_STA NEW_STA
555405 2-1-4-5-2 MOD-LIN 31-7-1999 17:04 NRML BN-AN
2
555405 2-1-4-5-7 MOD-LIN 31-7-1999 17:04 NRML BN-AN
7
555405 2-1-4-5-2 MOD-LIN 31-7-1999 17:04 BN-AN BN-DS
2
555405 2-1-4-5-8 MOD-LIN 31-7-1999 17:09 NRML BE-CU
8
555405 2-1-4-5-2 MOD-LIN 31-7-1999 17:42 BN-DS NRML
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 STATUS
2-1-4-5-2 OOS-OPR
2-1-4-5-7 OOS-OPR
2-1-4-5-8 OOS-OPR
Total Records printed = 3

11.19. ncbr2

Detailed Bill Record Report


Usage : rgen ncbr2
Parameters : FDATE, TDATE, DIRECTORY NUM~, CALLD NUM~, UNIT>,
F_TIME, T_TIME
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 CALLED- DATE TIME DURATION UNITS


NUMBER
5554053 015554054 31/07/1999 14:45:06 11:49 2721
5554053 015554054 31/07/1999 14:59:29 4:17 981
5554053 015554054 31/07/1999 15:04:52 9:01 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. Trunk Groups need to be under observation to obtain report.
2. TGPs to be put under observation should be in multiple of 4 (i.e., 4, 8, 12, . . .)
DELHI-CANTT MBM-MAX Wed Aug 18 15:51:40 1999
C-DOT DSS OUTGOING TRUNK TRAFFIC REPORT

TGP DATE TIME TRK T_ATT CMPL TRNS ERL BSY TRK-NA OTHR IDLE

1. 15/04/1999 00:00 29 20 13 7 4 1 0 12 79

2. 15/04/1999 00:00 25 63 35 47 7 6 0 23 108

3. 15/04/1999 00:00 30 27 7 17 2 0 0 17 83

4. 15/04/1999 00:00 15 2 2 2 1 0 0 0 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. This report available only in Multi module exchange.
2. 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 TIME OBS-DUR IDLE TIME


PROCESSOR
dd/mm/yyyy hh:mm:ss minutes PERCENT(%)
14-05-19999 10:01:29 15 AP 83.0
14-05-19999 10:01:29 15 CMS1 57.3
14-05-19999 10:01:29 15 CMS2 55.9
14-05-19999 10:01:29 15 CMS3 55.9
14-05-19999 10:01:29 15 CMS4 55.5

11.22. procbm2

Processor Report Base Module wise.


Usage : rgnrpt 1st Menu : 3 2nd Menu : 2
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. For SBM site, only BM1 report will be available
2. 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 DATE TIME OBS-DUR BP BMS-0 BMS-1


dd/mm/yyyy hh:mm:ss minutes PERCENT PERCENT PERCENT
03 14-05-1999 10:00:02 15 51.7 52.2 58.3
10 14-05-1999 10:00:09 15 68.8 60.8 54.6
11 14-05-1999 10:00:14 15 76.6 56.4 60.6
12 14-05-1999 10:00:19 15 92.0 61.7 57.8
09 14-05-1999 10:00:45 15 49.4 50.3 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
- DTMF - - MFR - - MFS -
BM DATE TIME
ASG OPR ATT FLR ASG OPR ATT FLR ASG OPR ATT FLR

01 21-12-1999 01:00 45 45 9 0 0 0 0 0 0 0 0 0

02 21-12-1999 01:00 45 45 3 0 0 0 0 0 0 0 0 0

03 21-12-1999 01:00 45 45 16 0 0 0 0 0 0 0 0 0

04 21-12-1999 01:00 45 45 14 0 0 0 0 0 0 0 0 0

05 21-12-1999 01:00 45 45 2 0 0 0 0 0 0 0 0 0

08 21-12-1999 01:00 0 0 0 0 24 24 127 0 21 19 133

06 21-12-1999 01:00 0 0 0 0 24 24 179 0 21 21 90 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 DIALED DIGITS DATE TIME FACILITY TYPE METER


36425 1160700 27/11/1998 01:38:44 ALRM-ONCEA ACT 2
36958 1160600 27/11/1998 11:34:06 ALRM-ONCEA ACT 2
34346 1160545 27/11/1998 16:11:52 ALRM-ONCEA ACT 2
32105 1162001 27/11/1998 19:51:40 ALRM-ONCEA ACT 2
31399 1160430 27/11/1998 20:09:36 ALRM-ONCEA ACT 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 TEN ACC-BAR ORG-FAC TRM-FAC L-STA M-CLS


5554052 2-1-4-5-2 ISD TM-HT DIV-F NRML NRML
5554052 2-1-4-5-3 ISD no-org no-trm NRML NRML
5554052 2-1-4-5-4 ISD no-org no-trm NRML NRML
5554052 2-1-4-5-6 ISD no-org no-trm NRML NRML
5554052 2-1-4-5-7 ISD no-org no-trm NRML NRML
5554052 2-1-4-5-8 ISD DBE CL-WT 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 MBM-MAX Wed Aug 11 14:48:20 1999
DELHI-CANTT SUBSCRIBER METER READINGS @ Wed Aug 4 18:32:15 1999
DIRNO LCL-MTR STD-MTR STD-CAL ISD- ISD-CAL BULK-MTR
MTR
5554053 3 8295 14 0 0 8298
5554054 0 0 0 0 0 0
5554107 0 1264 13 0 0 1264
5554056 0 0 0 0 0 0
5554057 0 0 0 0 0 0
5554058 0 0 0 0 0 0
6 3 9559 0 9562

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 TGP LIN-SIG REG- DGT ROD PRF TGP TGP CAMA DET SIG. -
NUM STA SIG SFD DGT TYP CAT BLG INF..

63 BW CCS CCS7 1 1 ORD 1 CHB

64 BW CCS CCS7 1 3 ORD 1 CHB

86 OG CAS3 MFR2 1 3 ORD 1

85 IC CAS3 MFR2 1 1 ORD 1

81 OG CAS3 MFR2 1 3 ORD 1

80 IC CAS3 MFR2 1 1 TTX 1

10 IC CAS3 MFR2 1 1 68 ORD 1 YES

11 OG CAS3 MFR2 1 3 ORD 1


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 MBM-MAX Fri Dec 31 12:24:51 1999

DELHI-CANTT TGP METER READINGS (IC+OG) @ Sat Jun 26 14:04:26 1999


TGP LCL-MTR STD-MTR STD-CAL ISD-MTR ISD-CAL BULK-MTR

1 0 0 0 0 0 0

2 0 0 0 0 0 0

3 0 0 0 0 0 0

4 0 0 0 0 0 0

5 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 TEN STATUS


TWT 4-1-1-10-5 OOS-OPR
4W-E-M 4-1-1-5-3 OOS-OPR
4W-E-M 4-1-1-20-5 OOS-OPR
4W-E-M 4-1-4-17-4 OOS-OPR
4W-E-M 4-1-4-20-1 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 : rgen dirten2
Parameter : 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 TEN
5554052 2-1-4-5-2
5554053 2-1-4-5-3
5554054 2-1-4-5-4
5554056 2-1-4-5-6
5554057 2-1-4-5-7
5554058 2-1-4-5-8
Total records printed : 6

11.32. malc2

Malicious call reports.


Usage : rgnrpt 1st Menu : 7 2nd Menu : 3
Parameters : FDATE, TDATE, DIRECTORY NUM~, CALLING NUM~,
TIME~
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. DATE TIME CALLING-


dd/mm/yy hh:mm:ss DIR
5554054 31/07/1999 17:55:14 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
Parameters : FROMDATE, TO-DATE, BM NUMBER (for BM wise report)
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. CCB-STD
2. CCB-PCO
3. ISD-SUB
4. STD-SUB
5. HNG-SUB
6. ALL-SUB
7. BM-WISE
8. LVL-WISE
9. MISC.
10. 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 LCL-MTR STD-MTR STD-CAL ISD-MTR ISD-CAL BULK-MTR

16/03/00 3129 1930 192 0 0 5059

18/03/00 03235 1945 194 0 0 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 COMMENTS

The following comments pertain to:

Document Name

CSP Section - -

Issue/Draft , -
No. (Month) (Year)

COMMENTS :

(Use a separate sheet if required)

Please mail your comments to: Your Reference:


Centre for Development of Telematics Name :
Designation :
Attn: Director, Systems
Company :
39, Main Pusa Road Address :
New Delhi 110 005
Tel.: +91-11-5740374
Fax: +91-11-5756378 Tel. :
Fax :

You might also like