cc/td/doc/product/rtrmgmt/ism/ism_v2r2
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Servicing and Troubleshooting

Tracing ISM Data

Tracing the ISM Internal Data Flow

Tracing CLISTs

Tracing Routine Entries and Exits

Turning Off Tracing

Restoring the ISM Base Administrator Profile

Displaying Variables

Viewing SNMP Variables

Viewing NetView Timers

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

• Restoring the ISM Base Administrator Profile

• Viewing SNMP Variables

• Viewing NetView Timers

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: Wed Oct 13 00:39:23 PDT 2004
All contents are Copyright © 1992--2004 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.