Servicing and Troubleshooting

This appendix provides procedural and reference information that you can use to determine and resolve problems that you may be experiencing using ISM.

This appendix includes information on the following:

• Tracing ISM Data

• Restoring the ISM Base Administrator Profile

Tracing ISM Data

Sometimes a problem cannot be traced to a specific source. ISM provides three trace utility commands that you can use to isolate problems that ISM may be experiencing (Table C-1).

Table  C-1: Trace Utility Descriptions

Trace Utility	Function
ismaid debug	Traces the internal data flow of ISM.
ismaid ctrace	Traces the internal commands being processed by ISM.
ismaid trflow	Traces the entries and exits of issued commands.

The trace facilities that you enable using the ismaid command affect only the operator ID under which you issue the command. The following sections provide examples of the output received when operating ISM using the any of the trace utilities.

---

Note The actual data shown in the examples will vary at your site depending on the routines that ISM is processing at the time that you run the trace.

---

Tracing the ISM Internal Data Flow

The ISM Internal Data Flow utility traces the internal data flow of the processes occurring in ISM. You turn on the ISM Internal Data Flow utility by issuing the following command:

ismaid debug on

To turn off the trace of the ISM internal data flow, issue the ismaid debug off command.

ISMAID Debug Output Example

The following example shows the data that is returned to your console when you have turned on the ISM debug trace facility. The example provided is the internal tracing of the data flow that occurs when an operator issues the ismistat command.

C CNM01 NSP1129I NSPAID DEBUG set to >YES < NSPAID C CNM01 NSP1103I Exception Data >> NSPISTA3 ENTRY INPUT=CWBC04 ONLY NSPISTA3 C CNM01 NSP1082I Now collecting interface status for router CWBC04 NSPISTA3 C CNM01 NSP1103I Exception Data >> NSPRGET3 -INPUT=CWBC04 SHOW PROTOCOLS NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CLEAROUT CFNAME=>HAL4XXXX< NSPDM=>< NSPSPN=>< NSP=><' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-BLDCMD RCMD=>SHOW PROTOCOLS<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 -SEND NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 -SEND2 NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 -CHKSTAT NSPD= NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKSTAT RUNCMD SP=CWBC04,APPL=CONSOLE,CLISTVAR=YES RCMD=>SHOW PROTOCOLS<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKSTAT RETCODE=>0<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-PROCESS DSIRNCNT=>017<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CMD10 DSIRUN001=>GLOBAL VALUES:<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKMORE MSGIDD=>GLOBAL VALUES:<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKOUT NSPXR1=>GLOBAL VALUES:<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CMD10 DSIRUN002=> INTERNET PROTOCOL ROUTING IS ENABLED<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKMORE MSGIDD=> INTERNET PROTOCOL ROUTING IS ENABLED<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKOUT NSPXR2=> INTERNET PROTOCOL ROUTING IS ENABLED<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CMD10 DSIRUN003=>FASTETHERNET0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKMORE MSGIDD=>FASTETHERNET0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKOUT NSPXR3=>FASTETHERNET0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CMD10 DSIRUN004=> INTERNET ADDRESS IS 172.18.7.36/25<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKMORE MSGIDD=> INTERNET ADDRESS IS 172.18.7.36/25<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKOUT NSPXR4=> INTERNET ADDRESS IS 172.18.7.36/25<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CMD10 DSIRUN005=>LOOPBACK0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKMORE MSGIDD=>LOOPBACK0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3 C CNM01 NSP1103I Exception Data >> NSPRGET3 '-CHKOUT NSPXR5=>LOOPBACK0 IS UP, LINE PROTOCOL IS UP<' NSPRGET3

Tracing CLISTs

The ISM CLIST Trace utility traces different ISM CLIST elements depending on the keyword you specify when turning on the trace utility.

Specify	To
ismaid ctrace all	Trace the execution of all NSP CLISTs.
ismaid ctrace all_nnn	Trace the execution of only the CLIST nnn, where nnn is the number of the CLIST you want to trace.
ismaid ctrace err	Trace only CLIST errors.
ismaid ctrace cmd	Trace the commands issued from a CLIST.
ismaid ctrace off	Turn off CLIST tracing.

CTRACE All Output Example

The following example shows the type of data that is returned to your console as ISM CLISTs are executed when the ismaid ctrace all command has been issued. To turn off the tracing of ISM CLISTs, issue the ismaid ctrace off command.

C CNM01 NSP1129I NSPAID CTRACE set to >ALL NSPRGET3< NSPAID C CNM01 &IF .CWBC04 EQ .? &THEN VIEW 4 NSPHRGET C CNM01 &IF .CWBC04 EQ .? &THEN &EXIT C CNM01 &IDENT = NSPRGET3 C CNM01 &IF .OFF = .ON &THEN NSPMBLD L 1104 &IDENT ENTRY &PARMSTR C CNM01 &IF .CWBC04 EQ . &THEN &GOTO -INPUTE C CNM01 &IF .NO = . &THEN &DEBUG = NO C CNM01 &IF NO EQ YES &THEN NSPMBLD L 1103 &IDENT -INPUT=&PARMSTR C CNM01 &CGLOBAL NSPMORE NSPHCOPY C CNM01 ******************** INITALIZATION ROUTINE *************************** C CNM01 -BLDOVR C CNM01 &TGLOBAL RGETKEY C CNM01 &IF .HAL4 = . &THEN &RGETKEY = &OPID C CNM01 PARSEL2R PARMSTR SPNAME SHCMD C CNM01 &PAD = 'XXXXXXX' C CNM01 &CFNAME = &CONCAT HAL4 XXXXXXX C CNM01 &CFNAME = &SUBSTR HAL4XXXXXXX 1 8 C CNM01 &NAME = &CONCAT HAL4XXXX 000 C CNM01 &TGLOBAL HAL4XXXX000 C CNM01 &HAL4XXXX000 = C CNM01 &X = '>CWBC04<' C CNM01 &CGLOBAL NSPCWBC04 C CNM01 &RINDEX = 7 C CNM01 &CGLOBAL NSP7 RTH7 RTD7 RTS7 RTO7 C CNM01 &CGLOBAL RTB7 C CNM01 &PC = 1 C CNM01 &PTR = 0 C CNM01 &NSPMSG = C CNM01 &NSPTARGET = CNM01 C CNM01 &NSPNRDX = 1 C CNM01 &N = 1 C CNM01 &M = 0 C CNM01 &TYPE = T C CNM01 &IF .show = .C &THEN &TYPE = C C CNM01 -CHKOP C CNM01 &IF NO EQ YES &THEN NSPMBLD L 1103 &IDENT '-CLEAROUT CFNAME=>&CFNAME< NSPDM=>&NSPDM< NSPSPN=>&NSPSPN< NSP&NSPSPN=>&NSP&NSPSPN<'

Tracing Routine Entries and Exits

The ISM Flow Trace utility traces the entries and exits of all the ISM routines issued by an ISM operator.

TRFLOW Output Example

The following example shows the type of data that is returned to your console as ISM routines are processed when the ismaid trflow on command has been issued. To turn off the tracing of the entries and exits of ISM routines, issue the ismaid trflow off command.

NSPAID TRFLOW ON
C CNM01 NSP1129I NSPAID TRFLOW set to >ON < NSPAID
NSPISTAT CWBC04
* CNM01 NSPISTAT CWBC04
C CNM01 NSP1104I Module Entry Trace >> NSPISTAT ENTRY CWBC04 NSPISTAT
C CNM01 NSP1104I Module Entry Trace >> NSPRGET ENTRY CWBC04 SHOW PROTOCOLS NSPRGET
C CNM01 NSP1105I Module Exit Trace >> NSPRGET EXIT=END CODE= NSPRGET
C CNM01 NSP1104I Module Entry Trace >> NSPIBCF ENTRY NSPILCWBC04XXL0 CWBC04 LOOPBACK0 0 DS(UP) M(YES) G(0) NSPIBCF
C CNM01 NSP1104I Module Entry Trace >> NSPVSAM ENTRY NSPVSAM
- CNM01 NSPVSAM
C CNM01 NSP1104I Module Entry Trace >> NSPVSAM ENTRY NSPVSAM
C CNM01 NSP1105I Module Exit Trace >> NSPIBCF EXIT RC 0 NSPIBCF
- CNM01 CNM421I COMMAND LIST NSPISTAT - INVALID COMMAND NSPIBCV ENCOUNTERED
C CNM01 NSPIBCV L NSPILCWBC04XXL0 CWBC04 LOOPBACK0 0 DS(UP) M(YES) G(0)
C CNM01 NSP1104I Module Entry Trace >> NSPIBCF ENTRY NSPISCWBC04XXS0 CWBC04 SERIAL0 0 DS(UP) M(YES) G(0) NSPIBCF
C CNM01 NSP1104I Module Entry Trace >> NSPVSAM ENTRY NSPVSAM
- CNM01 NSPVSAM
C CNM01 NSP1104I Module Entry Trace >> NSPVSAM ENTRY NSPVSAM
C CNM01 NSP1105I Module Exit Trace >> NSPIBCF EXIT RC 0 NSPIBCF
- CNM01 CNM421I COMMAND LIST NSPISTAT - INVALID COMMAND NSPIBCV ENCOUNTERED
C CNM01 NSPIBCV S NSPISCWBC04XXS0 CWBC04 SERIAL0 0 DS(UP) M(YES) G(0)
C CNM01 NSP1104I Module Entry Trace >> NSPIBCF ENTRY NSPISCWBC04XXS0P1 CWBC04 SERIAL0.1 0.1 DS(UP) M(YES) G(0P1) NSPIBCF

Turning Off Tracing

If you have enabled all of the ISM trace utilities (debug, ctrace, and trflow), you can turn off each utility individually, or you can issue a command that turns off all tracing. For information on turning off a trace utility individually, see the command provided in the appropriate trace utility section. To turn off all ISM trace utilities running, issue the ismaid off command.

Restoring the ISM Base Administrator Profile

ISM provides a backup ISM administrator profile that can be used by a system administrator to recreate an ISM administrator profile if all existing ISM administrator profiles are accidentally deleted. If all ISM administrator profiles are deleted, there is not an ISM user capable of modifying the ISM management environment and assigning user authority levels for ISM users.

If the base ISM administrator profile is deleted, complete the following steps to create a new profile:

Step 1 Add an ISMADMIN operator to NetView.

Step 2 Log on to NetView as the ISMADMIN operator.

Step 3 Create several ISM administrator profiles as described in the "Defining the ISM User Profiles" section in the "Setting Up the ISM Environment" chapter to ensure that there will be additional ISM administrator-level profiles available for backup if needed.

 
Caution This backup procedure can be performed only one time. Please ensure that several administrator level profiles are created to serve as backups in case this situation occurs again.