apprgen2 (1)

8/3/2019 APPRGEN2 (1)

1/85

C-DOT DSS MAX

APPLICATION NOTEON

RGEN/CMD UTILITY

(w.r.t. Software 2_1_1_1)

8/3/2019 APPRGEN2 (1)

2/85

SystemPractices

Section No. 400-654-0457

Draft 04, August 2000

C-DOT DSS MAX

APPLICATION NOTE

ONRGEN/CMD UTILITY

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

2000, C-DOTPrinted in India

8/3/2019 APPRGEN2 (1)

3/85

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.

8/3/2019 APPRGEN2 (1)

4/85

Table of Contents

Chapter 1. Introduction ..............................................................................................................................5

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

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

3.1. Purpose.........................................................................................................................73.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 ......................................................................................................224.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.......................................................................................................................6111.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

8/3/2019 APPRGEN2 (1)

5/85

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

8/3/2019 APPRGEN2 (1)

6/85

8/3/2019 APPRGEN2 (1)

7/85

APPLICATION NOTE ON RGEN/CMD UTILITY

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

8/3/2019 APPRGEN2 (1)

8/85

6 C-DOT DSS MAX

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

in a multimodule (MBM) exchange

/u/admn/cmdfile

equip To create cmd-file for equipping terminal

cards

/u/admn/cmdfile

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

printers

/u/code/tool

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

& daily routines

/u/code/tool

ncbrprn For printing of detail bill record /u/code/tool

8/3/2019 APPRGEN2 (1)

9/85


Chapter 3.

Loading Procedure

3.1. PURPOSE

When a number of terminal cards have to be equipped or hundreds of subscribers

have to be created, then the need arises for a command file. A typical example is the

installation of C-DOT DSS MAX. During installation, all the terminal cards in the

exchange have to be equipped and a few thousands of subscribers have to be

created. Specific requirements of each subscriber are not taken into consideration

during this stage. So a set of commands with a pre-defined parameter set is

required.

Two utilities `equip' and create' help the operator in the creation of command files

which can be used for equipage of terminal cards and creation of subscribers.

3.2. GENERAL CONVENTIONS

The following conventions are used in this document.

Text formatting

convention

Indicates

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,

8/3/2019 APPRGEN2 (1)

10/85

Chapter 3.

iop5x> cd /

iop5x>cpio icvdu

8/3/2019 APPRGEN2 (1)

11/85


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:

8/3/2019 APPRGEN2 (1)

12/85

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 (

8/3/2019 APPRGEN2 (1)

13/85

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 answeredas `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 fileshould 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.


8/3/2019 APPRGEN2 (1)

14/85

Chapter 4.


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 awarning 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

8/3/2019 APPRGEN2 (1)

15/85


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 givenas "cre-sub-2" etc.

Enter name for command file : cre-sub-1

Step 10 :

The utility displays the message.


8/3/2019 APPRGEN2 (1)

16/85

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 bereduced.

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


[Type 0 to end] : 1-2-6-24


[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

8/3/2019 APPRGEN2 (1)

17/85


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 thisutility 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







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


8/3/2019 APPRGEN2 (1)

18/85

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 : 2Month : 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 deletebilling 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

8/3/2019 APPRGEN2 (1)

19/85


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



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


8/3/2019 APPRGEN2 (1)

20/85

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.

T H I N K I N G

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

8/3/2019 APPRGEN2 (1)

21/85


1 By TEN

2 By DIR-NO


ENTER STARTING DIR NO : 22000

NO OF SUBSCRIBERS UPTO : 1400 : 20

Test Set Number : 103

T H I N K I N G

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,,22004;tst-trm:G,B,1,LINE,103,,22005;










tst-trm:G,B,1,LINE,103,,22015;tst-trm:G,B,1,LINE,103,,22016;





BYE.....BYE

entered fun_line

Case 3 :

for Trunk Testing

1. Line testing

2. Trunk testing

3. Digital Trunk testing


ANALOG TRUNK TESTING


8/3/2019 APPRGEN2 (1)

22/85

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

T H I N K I N G

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 PortCopyright (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

8/3/2019 APPRGEN2 (1)

23/85


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

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 (or 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 (or to end)

Now insert the blank cartridge & press return

Then it will display after sometime

Tape/Floppy ready

Insert Next Blank Tape/Floppy, press (or to End)

If you want further copies then insert the next cartridge & press return

otherwise to abort the operation press

Then system will display

Wait ....


8/3/2019 APPRGEN2 (1)

24/85

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

suppose you want to print log of tst file i.e. tst.log which is in /u/admn/cmdfile. Then

give command


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 areto 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

8/3/2019 APPRGEN2 (1)

25/85


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 theoperator 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 andcreating subscribers.

Step 1: From iop5x> prompt enter crp.

iop5x>crp

Step 2: On `crp' prompt `pg eq-sub.log


8/3/2019 APPRGEN2 (1)

26/85


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 equippedbecause 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.

8/3/2019 APPRGEN2 (1)

27/85

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.


8/3/2019 APPRGEN2 (1)

28/85


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.

8/3/2019 APPRGEN2 (1)

29/85

27 C-DOT DSS MAX

Chapter 7.

RGEN Scripts at a Glance

S.No. Script-

file name

Function it Performs

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 andvice 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,

8/3/2019 APPRGEN2 (1)

30/85

Chapter 7.

S.No. Script-

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 ÒOS- SE' or ÒOS-OPR'

status.

21. ncbr2 To display detailed billing records for subscribers.

22. ogtgp2 To display necessary informations about outgoing trunk grouptraffic 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 agiven 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 ÒOS-OPR', ÒOS-SE', ÒOS-

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

8/3/2019 APPRGEN2 (1)

31/85

RGEN SCRIPTS AT A GLANCE

S.No. Script-

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.


8/3/2019 APPRGEN2 (1)

32/85


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

8/3/2019 APPRGEN2 (1)

33/85

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


8/3/2019 APPRGEN2 (1)

34/85

Chapter 8.

32 C-DOT DSS MAX

CALL FAIL TYPE (Call Failure Type)

Parameter Name : Call Failure Type

Mnemonic : CALL FAIL TYPE

Type : Alphabetic

Possible Values : SUCCESS : Success CallDL-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 : BlockingSPR-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

8/3/2019 APPRGEN2 (1)

35/85


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


Default : All


8/3/2019 APPRGEN2 (1)

36/85

Chapter 8.

34 C-DOT DSS MAX

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

8/3/2019 APPRGEN2 (1)

37/85


13. OCR-STD

14. OCR-10X

15. OCR-KW-CHG

16. INTRSN-BAR

17. DIV-MAN-ANS

18. DIV-FXD-ANN

19. DIV-FXD-NUM20. 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.


8/3/2019 APPRGEN2 (1)

38/85

8/3/2019 APPRGEN2 (1)

39/85


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 LineSHR-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.


8/3/2019 APPRGEN2 (1)

40/85

Chapter 8.

38 C-DOT DSS MAX

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 Hotline4. 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

8/3/2019 APPRGEN2 (1)

41/85


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-NBEENM-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


8/3/2019 APPRGEN2 (1)

42/85

Chapter 8.

40 C-DOT DSS MAX

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

8/3/2019 APPRGEN2 (1)

43/85


TGP NUM (Trunk Group Number)

Parameter Name : Trunk Group Number

Mnemonic : TGP NUM

Type : Numeric


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


8/3/2019 APPRGEN2 (1)

44/85

Chapter 8.

42 C-DOT DSS MAX

TRM-FACILITIES (Terminating Facilities)

Parameter Name : Terminating Facility

Mnemonic : TRM-FACILITIES

Type : Alphabetic

Possible Values :1. DIV-SNGL-NUM : Diversion to single number on

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

8/3/2019 APPRGEN2 (1)

45/85


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


8/3/2019 APPRGEN2 (1)

46/85


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.

8/3/2019 APPRGEN2 (1)

47/85

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


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


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


8/3/2019 APPRGEN2 (1)

48/85

Chapter 9.

4. Trunk Group and Routewise traffic report


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


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


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

8/3/2019 APPRGEN2 (1)

49/85

UTILITY INVOCATION

7. Subscriber traffic observation report


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


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 .

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.


8/3/2019 APPRGEN2 (1)

50/85

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

desired Dynamic lock

13. Grnt-Ocr-Sub

5. Restoration of STD-FAC without

granting Dynamic lock

14. Wtd-Sub-Fac

6. Barring STD-FAC by first with

drawing code

15. Frc-Trm-Oos

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

8/3/2019 APPRGEN2 (1)

51/85

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.

Positive integer number

-f Process data for only first records

-r Process data in reverse order for records

-s Sort on field This option is not applicable with Bill monitoringrelated scripts.

i) The parameter in square brackets are optional

ii) Either -f or -r may be used but not both.

iii) If parameter is missing then all records will be processed for -f or -r

option. For -s option if 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

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

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.


8/3/2019 APPRGEN2 (1)

52/85

Chapter 9.

9.1.3. Command line option -s

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 beentered 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

8/3/2019 APPRGEN2 (1)

53/85

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 avalue 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 slotsin the 4th frame of the first rack of BM-01 are generated.


8/3/2019 APPRGEN2 (1)

54/85


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.

8/3/2019 APPRGEN2 (1)

55/85


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, -r, -s 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 betaken)

Now it will display

Report generation is in progress

Please wait

8/3/2019 APPRGEN2 (1)

56/85

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 thefollowing 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

8/3/2019 APPRGEN2 (1)

57/85

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 = 13970Total Lines Under maintenance = 143

Total Trunks equipped = 63Total Trunks Under maintenance = 32

Total Originating Terminating Attempts = 8034Calls Processing Efficiency = 88Calls Completion Ratio = 44

Total Originating Outgoing Attempts = 19541Calls Processing Efficiency = 62Calls Completion Ratio = 20

Total Incoming Terminating Attempts = 7375Calls Processing efficiency = 95Call Completion Ratio = 55

Total Incoming Outgoing Call Attempts = 36656Calls Processing efficiency = 68Call Completion Ratio = 22

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

Total MFR circuits assigned = 203

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

Total MFS circuits assigned = 192Total MFS circuits operational = 191Total MFS attempts = 34207Total MFS failures = 0


8/3/2019 APPRGEN2 (1)

58/85

Chapter 11.

SITE NAME : DELHI CANTT---------------------------------------------------------------------------------------------------------------------------C-DOT DSS ORIGINATING PERFORMANCE SYSTEM REPORT---------------------------------------------------------------------------------------------------------------------------

Originating attempts = 40733Originating Call Completion Ratio = 18Originating Call Processing Efficiency = 47Originating Calls Blocked due to Overload = 9---------------------------------------------------------------------------------------------------------------------------Calls Failed Due To Following Reasons---------------------------------------------------------------------------------------------------------------------------Clear Due To Incomplete Dialling = 3055Calling Subscriber Being Access Barred = 625Called Subscriber Being Access Barred = 11Wrong Prefix = 741No Answer / Abandoned after Dialling Complete = 6253Number Unobtainable = 301

Called Subscriber busy = 5807Non availability of remote unit (RSU) links = 0Faulty signalling = 1648Called Subscriber Out Of Order = 182Called Subscriber Number Changed = 0Any Other Reason = 3516

---------------------------------------------------------------------------------------------------------------------------C-DOT DSS INCOMING PERFORMANCE SYSTEMS REPORT---------------------------------------------------------------------------------------------------------------------------Incoming Call Attempts = 48624

Incoming Call Completion ratio = 25Incoming Call Processing Efficiency = 65System Over Load = 18---------------------------------------------------------------------------------------------------------------------------Incoming Calls Failed Due To Following Reasons---------------------------------------------------------------------------------------------------------------------------No Digit Dialled = 2234IDT / Partial dialling = 2122Called Subscriber being Access Barred = 28Wrong Prefix = 1329Number Unobtainable = 448No Answer / Abandoned After Dialling Complete = 11921Called Subscriber Busy = 3690

Faulty Signalling = 4643Non Availability Of Internal Resources = 0PCM Channel In RSU = 0Congestion At Remote End = 2938Any Other Reason = 997Trunk Circuit Not Available = 5559Called Number Changed = 0

56 C-DOT DSS MAX

8/3/2019 APPRGEN2 (1)

59/85

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 2102 4485 21 339 0 5103 4127 19 374 0 2104 4994 19 438 0 6905 3777 20 269 0 2909 2698 21 127 0 3113 2909 20 300 0 2114 3385 15 316 0 7016 5620 15 543 0 4318 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 007 7814 21 1150 0 008 6370 19 670 0 510 7772 27 735 0 311 6187 30 472 0 315 6876 26 708 0 317 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 8142 30 0 49 42 3 44 5144 30 0 84 59 23 60 20152 30 0 112 20 76 33 11140 40 30 116 8 107 48 12

142 30 0 103 50 34 47 10144 30 0 219 131 82 42 29152 30 0 211 43 156 32 16


8/3/2019 APPRGEN2 (1)

60/85

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 02 40 0 80 51 21 4 03 30 0 304 232 29 14 05 35 0 230 152 39 15 06 40 1 360 196 40 31 07 35 5 83 48 51 11 013 40 0 252 188 39 28 023 40 0 35 22 45 4 026 15 0 48 26 14 1 048 30 0 248 111 50 29 053 60 0 377 372 45 28 0105 15 0 24 13 50 1 0115 85 2 416 177 33 29 0131 30 0 227 82 49 18 0141 30 0 188 108 48 22 0143 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 equippedIC_TRM = Incoming terminating calls TOTAL_ATMPT = Total attempts

RSRC_N_AVL = Resource not available TRK_N_AVL = Trunk not availableIC_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

8/3/2019 APPRGEN2 (1)

61/85

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.


DELHI-CANTT MBM-MAX Sat Jul 31 17:20:19 1999

C-DOT DSS EXCHANGE PERFORMANCE AM REPORT

PSTN ISDN INCOMINGDATE TIME TOTAL

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

**


8/3/2019 APPRGEN2 (1)

62/85

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.



C-DOT DSS BM IC / OG REPORT

IC-TERM IC-OG OUTGOINGBM 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

8/3/2019 APPRGEN2 (1)

63/85

SCRIPTS FILES

11.5. bmortr2

BM wise originating-terminating traffic report

Usage : rgnrpt 1st Menu : 3 2nd Option : 5


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 :


2. Traffic report (LINE-REP) to be enabled in advance to obtain reports. Theoutput will be displayed as follows:


C-DOT DSS ORIGINATING/TERMINATING BM REPORT

ORIGINATING ORG-TRM ORG-OG TERMINATINGBM 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


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.


8/3/2019 APPRGEN2 (1)

64/85

Chapter 11.

NOTE :


2. Traffic report (Line-Rep) to be enabled in advance to obtain reports.


DELHI-CANTT MBM-MAX Sat Jul 31 17:40:53 1999C-DOT DSS EXCHANGE PERFORMANCE BM REPORT

PSTN ISDN INCOMINGBM DATE TIME TOTAL

CALLSTOT 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 : rgnr

apprgen2 (1)

Documents