cc/td/doc/product/rtrmgmt/ism/ism-v2r1
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Servicing and Troubleshooting

Servicing and Troubleshooting

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:

Tracing ISM Data

Sometimes a problem cannot be traced to a specific source. ISM provides the following trace utility commands that you can use to isolate problems:


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

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

Tracing CLISTs

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.


Table C-2: ISM CLIST Trace Utility Description
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<'

Tracing Routine Entries and Exits

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

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


Displaying Variables

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.


Figure C-1: ISM Common Globals Panel


ISM's control variables are described in Table C-3 through Table C-6.


Table C-3:
ISM Control Variables, Part 1
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.


Table C-4: ISM Control Variables, Part 2

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


Table C-5: ISM Control Variables, Part 3

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


Table C-6: ISM Control Variables, Part 4
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.


Table C-7:
Service Point/Control Name: CAT19002, Index=3, ISM3=CAT19002
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.


Table C-8:
Interface Control Block Index: 4, Type: Ethernet, Encapsulation: ARPA
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.


Table C-9: CMCC Control Block Index: 1, TARGET: CNM56
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.


Table C-10: Interface Control Block Index: 10, Type: Channel Encapsulation
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

Viewing SNMP Variables

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.


Figure C-2: ISM Common Globals for SNMP


Viewing NetView Timers

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.


Figure C-3: List NetView Timers Panel



hometocprevnextglossaryfeedbacksearchhelp
Posted: Sat Oct 7 16:36:21 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.