|
This appendix provides procedural and reference information that you can use to determine and resolve problems you might experience while using ISM.
This appendix includes information on the following:
Sometimes a problem cannot be traced to a specific source. ISM provides the following trace utility commands that you can use to isolate problems:
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 using any of the trace utilities.
Note The actual data you receive at your site can vary depending on the routines ISM is processing when you run the trace. |
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 onTo turn off the utility, issue the ismaid debug off command.
The following example shows the data returned to your console once you turn 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
The ISM CLIST Trace utility traces different ISM CLIST elements based on the keyword you specify when you turn on the utility. Table C-2 explains this utility's commands and options.
Specify | To |
---|---|
ismaid ctrace all | Trace the execution of all NSP CLISTs. |
ismaid ctrace i | Option when tracing a REXX CLIST. |
ismaid ctrace all_name | Trace the execution of only the CLIST name, where name is the name of the CLIST you want to trace. |
ismaid ctrace i_name | Trace the execution of only the REXX CLIST name, where name is the name 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. |
The following example shows the type of data returned to your console as ISM CLISTs are executed when the ismaid ctrace all command is issued. To turn off the utility, 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<'
The ISM Flow Trace utility traces the entries and exits of all ISM routines.
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 is issued. To turn off the utility, 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
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 section. To turn off all ISM trace utilities running, issue the ismaid off command.
ISM provides a backup ISM administrator profile that can be used by a system administrator to recreate an ISM administrator profile if all existing profiles are deleted accidentally. If all ISM administrator profiles are deleted, an ISM user does not have the authority to modify the ISM management environment or to assign user authority levels.
If the base ISM administrator profile is deleted, complete the following steps to create a new profile:
Step 2 Log on to NetView as the ISMADMIN operator.
Step 3 Create several ISM administrator profiles as described in Chapter 5, "Configuring ISM," in the CiscoWorks Blue Internetwork Status Monitor Installation Guide. Creating these profiles ensures the availability of additional ISM administrator-level profiles for backup.
There are ISM commands to display each set of control variables.
ISMVARS displays all common variables used in all ISM functions. Enter this command from the NetView command line or from the ISM Administration menu panel. The ISM Common Globals panel (Figure C-1) shows sample output for the ISMVARS display.
ISM's control variables are described in Table C-3 through Table C-6.
Variable | Value | Description |
---|---|---|
ISMSINIT | 09/21/00 10:09 ISMMGR | Indicates when ISM was initialized. |
ISMMGR | ISMMGR | Name of autotask managing ISM. |
ISMMAUTO | ISMMGRM | Autotask that monitors alerts. |
ISMREFOPER | ISMMGRS | Autotask that does status updates. |
ISMMGRI | ISMMGRI | Autotask that collects interface statistics. |
ISMOPNUM | Reserved |
|
ISMRMONI | 00:30 | Monitoring interval for resources. |
ISMIMONI | 12:00 | Monitoring interval for interfaces. |
NSPMOPER | YES | ISM security indicator. |
ISMSINIT: 08/04/00 15: | 10 ISMMGR |
|
|
---|---|---|---|
ISM Application Control (ISMAPPLS3) YES YES YES YES NO YES YES NO YES | |||
ISM Application Control Ext. (ISMAPPLS4) YES NO YES | |||
Application | Value | Variable | When Initialized |
ISM |
| ISMSINIT | 08/04/00 15:10 ISMMGR |
Resource Monitor | YES | ISMRINIT | 08/04/00 15:10 ISMMGR |
Interface Monitoring | YES |
|
|
Interface Archiving | YES |
|
|
Operator Management | YES |
|
|
SNA Session Monitoring | YES |
|
|
ISM Scheduler | NO |
|
|
CMCC Monitoring | YES | ISMCINIT | 08/04/00 15:10 ISMMGR |
TN3270 Monitoring | YES | ISMTNINIT | TN3270 initialized 08/04/00 15:10 I |
SNMP Monitoring | YES | SNMPINT | SNMP initialized 07/31/00 08:18 SNMP |
Interface Control Variable | |||
---|---|---|---|
ISMINTI YES YES YES YES YES YES YES YES YES YES YES YES YES YES NO YES | |||
Interface Type | Initialize | Variable | When Initialized |
TokenRing | YES | ISMITINT | 08/04/00 15:10 ISMMGR |
Ethernet | YES | ISMIENIT | 08/04/00 15:10 ISMMGR |
Serial | YES | ISMISINT | 08/04/00 15:10 ISMMGR |
FDDI | YES | ISMIFINT | 08/04/00 15:10 ISMMGR |
Loopback | YES | ISMILINT | 08/04/00 15:10 ISMMGR |
ASYNC | YES | ISMIANIT | 08/04/00 15:10 ISMMGR |
HSSI | YES | ISMIHINT | 08/04/00 15:10 ISMMGR |
Channel | YES | ISMICINT | 08/04/00 15:10 ISMMGR |
ISDN | YES | ISMIBINT | 08/04/00 15:10 ISMMGR |
TUNNEL | YES | ISMIUINT | 08/04/00 15:10 ISMMGR |
ATM | YES | ISMIMINT | 08/04/00 15:10 ISMMGR |
FastEthernet | YES | ISMIDINT | 08/04/00 15:10 ISMMGR |
IBM Claw | YES | ISMIIINT | 08/04/00 15:10 ISMMGR |
MPC (Multiprotocol) | YES | ISMININT | 08/04/00 15:10 ISMMGR |
GigabitEthernet | YES | ISMIGINT | 08/04/00 15:10 ISMMGR |
Variable: | Value: | Description: |
---|---|---|
ISMRDELAY | 20 | Minimum refresh rate. |
ISMDELAYSON | OFF | Indicates refresh in progress. |
ISMUPDATE |
| Indicates that a refresh is requested. |
PREFIX | ?? | Command suppression characters. |
DOMAINID | CNM56 | ID used for this domain. |
ISMCIPTHPU | 90 | Default CMCC processor threshold. |
ISMCIPTHMU | 10 | Default CMCC memory threshold. |
ISMCMCCRCV | YES | Controls auto-recovery of CMCCs. (Default=NO) |
ISMALRTCTL | YES YES YES YES | Generic alert control options. (Default=NO) |
ISMTBASE |
| ISM base time for scheduler. (Default=15 Min) |
ISMTINIT |
| ISM scheduler initialization. |
ISMMTHPU | 95 | Resource CPU performance threshold. |
ISMMTHMU | 10 | Resource memory level threshold. |
ISMSMFR | YES | SMF recording status. |
ISMRECID | 220 | SMF recording record number. |
ISMRTRHDB H | ISMRTRMAX 48 | Resource database values. |
ISMINTHDB I | ISMINTMAX 48 | Interface database values. |
ISMRIFHDB R | ISMRIFMAX 5 | SNA View RIF database values. |
ISMCONHDB C | ISMCONMAX 99 | Router configuration db values. |
ISMCIPHDB H | ISMCIPMAX 51 | CMCC database values. |
ISMTN32DB H | ISMTN32MAX 99 | TN3270 database values. |
ISMTN32MON | SNA | TN3270 monitor default. |
ISMTN32SMF | YES | TN3270 SMF recording control. |
ISMTN32THLU | 10 | TN3270 LU threshold. |
ISMTN32LOG | YES | TN3270 LOG recording control. |
ISMTN32THRT | 1000 | TN3270 response time threshold. |
ISMTNNUMR | 10 | TN3270 resource count. |
Note From the Resource Status with Options panel, press PF9 to show all variables associated with a resource. |
ISM uses address letters followed by an index number to build each variable. Table C-7 shows the name of each variable, its description and its contents.
Variable | Function | Value |
---|---|---|
RTA3 | Last status change | 11:07 08/06/00 |
RTB3 | Router busy with operator |
|
RTC3 | Configuration: Resource type and Cisco IOS level | UNKNOWN |
RTD3 | Domain that owns resource | CNM56 |
RTE3 | Description of resource | CISCO SYSTEMS CATALYST 1900 |
RTF3 | Features supported by this resource |
|
RTG3 | Operation groups | SW1900 |
RTH3 | Resource host name (IP name) | CWB-CAT1900-2 |
RTI3 | Resource IP address | 172.18.7.63 |
RTJ3 | CMCC management indicator |
|
RTK3 | DSPU management indicator |
|
RTL3 | Last related alarm |
|
RTM3 | Managing autotask |
|
RTN3 | Resource control variables | Y A N N N Y |
Y A N N N Y Monitor Availability Collect Archive Create Interface Resource Monitor Statistics Statistics Alarms Archiving | ||
RTO3 | Enabled operator |
|
RTP3 | VSAM key for performance history |
|
RTQ3 | Override values for archiving and thresholds | NONE |
RTS3 | Current ISM resource status | ACTIV |
RTT3 | Last performance record |
|
RTU3 | SNA service point name |
|
RTV3 | VTAM major node | UNKNOWN |
RTW3 | XCA MAJOR node name (used for CMCC recovery) |
|
RTX3 | Extended status indicators |
|
RXA3 | Monitor mode SNMP |
|
RXC3 | CASA support on router |
|
RXD3 | TN3270 support on router |
|
RXF3 | Last failure |
|
RXL3 | SysUpTime MIB value | 216674665 |
RXM3 | SNMP mask | 255.255.255.0 |
RXS3 | SYSUPTIME | 25 day/1 hour/52 min/26 sec |
RXT3 | Resource type | CA |
Display interface variables by selecting the Display Interfaces option in the ISM Interface Operation Options panel. Table C-8 describes sample output for this option.
Variable | Use | Value |
---|---|---|
ISMIEA4 | Status change | 15:15 08/04/00 INVALID |
ISMIEB4 | Owning domain | CNM56 |
ISMIEC4 | Desired status | UP |
ISMIED4 | Control data | RTZ3.E1 IECAT19002E1 CAT19002 ETHERNET1 1 DS(UP ) M(YES) G(1) E (ARPA) I(1) T() 18:07 07/18/00 HAL1 NSPIBCV4 |
ISMIEE4 | Encapsulation | ARPA |
ISMIEH4 | History pointer | (VSAM key) |
ISMIEI4 | Interface index (SNMP) | 1 |
ISMIEK4 | Copy of last performance record | 20000806 19:52 MTU 1500 bytes, BW 10000 Kbit, DLY N/A usec, rely 255/255, load 1/255 |
ISMIEL4 | Copy of last statistics record (history) |
|
ISMIEM4 | Monitor mode | YES |
ISMIEO4 |
|
|
ISMIEP4 | Performance pointer (VSAM key) | PCAT19002E1 129 48 |
ISMIES4 | Current status | UP |
ISMIET4 | Reserved |
|
ISMIEU4 | Reserved |
|
Display the CMCC variables by pressing PF9 on the ISM CMCC Administration panel.
Variable | Use | Value |
---|---|---|
ISMCIPA1 | When status changed plus previous status |
|
ISMCIPB1 | Owning domain | CNM56 |
ISMCIPD1 | VSAM key, router, slot | CIPCWBC01S3 CWBC01 3 M(YES) T( ) V(CIP 4.132 26.9) I(3/0 3/1 3/2) ACTIV |
ISMCIPH1 | History pointer (VSAM key) | HCIPCWBC01S3 114 51 08/06/00 20:48 ISMMGR |
ISMCIPI1 | Related channel interfaces | 3/0 3/1 3/2 |
ISMCIPL1 | Copy of last history record | 20000806 20:48 MEM 52165K/64M CPU 1 0 1 DMA 1 0 0 PCA0 0 0 0 ECA1 0 0 0 |
ISMCIPM1 | Monitor mode (YES/NO) | YES |
ISMCIPS1 | Current status | ACTIV |
ISMCIPT1 | Override values |
|
ISMCIPV1 | Hardware and software versions | CIP 4.132 26.9 |
Display the TN3270 variables by selecting the ISM Interface Administration panel and pressing PF9.
Variable | Use | Value |
---|---|---|
ISMICA10 | Status change | 15:17 08/04/00 INVALID |
ISMICB10 | Owning domain | CNM56 |
ISMICC10 | Desired status | UP |
ISMICD10 | Control data | RTZ33.C2S0 ICISM7200BC2S0 ISM7200B CHANNEL2/0 2/0 DS(UP) M(YES) G(2S0) E() (T() 08:36 07/17/00 ISMMGR NSPIBCV4 |
ISMICE10 | Encapsulation |
|
ISMICH10 | History pointer (VSAM key) | HISM7200BC2S0 147 48 08/06/00 19:54 ISMMGRI |
ISMICI10 | Interface index (SNMP) |
|
ISMICK10 | Copy of last performance record | 20000806 21:34 100 ISM7200B 2/0 255 0 9 9 0 293 10 |
ISMICL10 | Copy of last statistics record (history) |
|
ISMICM10 | Monitor mode | YES |
ISMICO10 | TN3270 overrides |
|
ISMICP10 | Performance pointer (VSAM key) | PISM7200BC2S0 146 48 08/06/00 21:34 ISMMGR |
ISMICS10 | Current status | UP |
ISMICT10 | TN3270 status | ACTIV |
ISMICU10 | TN3270 status change | 08/04/00 15:20 ACTIV |
To view SNMP variables, on the SNMP for ISM Management Setup panel (Figure 3-8), press PF10. The ISM Common Globals for SNMP (Figure C-2) is displayed.
To view NetView timers based on the current scheduler options, on the ISM Schedule Setup panel (Figure 3-9), press PF10. The List NetView Timers panel (Figure C-3) is displayed.
Posted: Sat Oct 7 16:36:21 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.