VSAM Control Files

This chapter describes the control files used by ISM to save information for each resource. The control files are written to VSAM.

Control and data files sometimes contain output from router show commands; such output is explained in this book. It is essential to understand this output, because should the output of a show command change, it could affect the way data is processed.

When describing a record, or giving an example, a "+" is used at the end of a line to indicate that the next line is a continuation of the record.

This chapter describes the following control files:

ISM System Initialization Control File Format

The ISM system initialization control file is created from ISM Setup, and is used to initialize ISM. There are two control files.

Location: VSAM Data set A (ISMDSA).

Description

Record 1 of 2 Key = ISMSETUP_ccccc_R3 where ccccc is the NetView domain name. Data = APPL( S1 S2 S3 S4 S5 S6 S7 S8 S9) MI( STS ) TH( SU SO ) + IM( I1 I2 I3 I4 I5 I6 I7 I8 I9 I10 I11 I12 ) MI2( STT ) + DB( D1 D2 D3 D4 D5 ) CM( C1 C2 C3 C4 C5 ) CIP(E1 E2) Date Time OPID Field Description Default APPL( S1 S2 S3 S4 S5 S6 S7 S8 S9 ) ISM Applications Resource Management (S1) ( YES | NO ) YES Interface Monitoring (S2) ( YES | NO ) YES Operator Management (S3) ( YES | NO ) YES SNA Session MGMT (S4) ( NO | YES ) NO ISM Scheduler (S5) ( NO | NO ) NO CMCC Management (S6) ( NO | NO ) NO DSPU Management (S7) ( NO | NO ) NO FPM Management (S8) ( NO | NO ) NO MI( STS ) Monitoring interval for Resources 00:15 TH(SU SO) Thresholds CPU Utilization (SU) ( 0 | 99 ) 95 Memory Utilization (SO) ( 0 | 99 ) 10 IM( I1 I2 I3 I4 I5 I6 I7 I8 I9 I10 I11 I12 ) Interface Monitoring Token Ring (I1) ( YES | NO ) YES Ethernet (I2) ( YES | NO ) YES Serial (I3) ( YES | NO ) YES FDDI (I4) ( YES | NO ) YES Loopback (I5) ( NO | YES ) NO Async (I6) ( NO | YES ) NO Channel (I7) ( NO | YES ) NO HSSI (I8) ( NO | YES ) NO ISDN (I9) ( NO | YES ) NO Tunnel (I10) ( NO | YES ) NO ATM (I11) ( NO | YES ) NO Fastethernet (I12) ( NO | YES ) NO MI2(STT) Monitoring interval for interfaces 02:00 DB( D1 D2 D3 D4 D5 ) Data Bases: Resource History (D1) H Interface History (D2) I RIF History (D3) R Router Configuration (D4) C CMCC History (D5) H CM( C1 C2 C3 C4 C5 ) Wrap Counts: Router History (C1) 48 Interface History (C2) 48 RIF History (C3) 5 Router Configuration (C4) 99 CMCC History (C5) 51 CIP(E1 E2) CMCC Thresholds: CPU (E1) ( 0 | 99 ) 90 Memory (E2) ( 0 | 99 ) 10 Misc Last Update (Date Time) Operator who made last update (OPID)

Example

NSPSETUPCNM01R3 APPL(YES YES YES YES NO YES YES + YES) MI(00:15) TH(95 10) IM(YES YES YES YES YES YES YES YES YES YES + YES YES) MI2(02:00) DB(H I R C H) CM(95 95 5 99 51) CIP(90 10) + 06/25/98 10:09 CHAND1 Record 2 of 2 Key = ISMSETUP_ccccc_R4 where ccccc is the NetView domain name. Data = ISMMGR ISMMGRS ISMMGRM D1 ALRT( G1 G2 G3 G4 ) E1 T(T1) + APPL4( A1 A2 A3) ISMMGRI SM( S1 S2) EN( N1 ) + IN( I1 I2 I3 I4 ) Date Time OPID Field Description Default ISMMGR Name of ISMMGR Autotask. ISMMGRS Name of ISMMGRS Autotask used for refresh operation. ISMMGRM Name of ISMMGRM Autotask used for message automation. D1 Refresh delay ALRT( G1 G2 G3 G4) Generic Alert Generation G1 Router Status G2 Router Perf/Memory G3 CMCC Perf/Memory G4 Interface Status E1 CMCC Recovery T(T1) ISM base timer for scheduler APPL4( A1 A2 A3) Additional Applications A1 TN3270 Monitoring A2 Spare A2 SNMP Management ISMMGRI Name of ISMMGRI Autotask used for interface monitoring. SM( S1 S2) SMF Control Variables S1 SMF control S2 SMF record identifier EN( N1 ) Enable limit N1 Number of minutes that an operator can remain in enable mode. IN( I1 I2 I3 I4 ) Additional Interface monitoring controller I1 IBMCLAW ( YES | NO ) NO I2 MPC ( YES | NO ) NO I3 Future ( YES | NO ) NO I4 Gigabitethernet ( YES | NO ) NO Misc Last Update (Date Time) Operator who made last update (OPID)

Example

ISMSETUPCNM56R4 ISMMGR ISMMGRS ISMMGRM 20 ALRT( YES YES YES YES ) YES T(15) APPL4(YES NO YES) ISMMGRI SM(YES 220) EN(15) IN( YES YES NO YES ) 07/17/00 08:25 ANDYCRA

ISM Operator Profile Control File Format

This control file is used to maintain an ISM operator's profile. Any operator can create this file, but only an administrator can change fields A, S, U, RT1 and RT2.

Location: VSAM Data set A (ISMDSA).

Description

Key = *NSPO_opid where opid is the operator name.

Note * indicates a special character for security.

Data = (( A( A S G ) U( U ) GF( RT1 RT2 ) +
 SF( E RT3 RT4 RT5 ) NAME( N1 )) MISC
 
Field     Description                                   Default
(A(A S G) Group A (Resource Management)
          Enable Authority    (A) D=Display E=Enable      D
          Filter Enabled      (S) N=No Y=Yes              N
          Group Management    (G) N=No Y=YES              N
 
 U( U )   Administrator
           Authority          (U) N=No Y=Yes              N
 
 GF( RT1 RT2 )       Group Filters
          Group Filter 1      (RT1)
          Group Filter 2      (RT2)
 
 SF( E RT3 RT4 RT5 )   Status Filters
          Filter Mode         (E)    X=Exclude I=Include   X
          Status Filter 1     (RT3)
          Status Filter 2     (RT4)
          Status Filter 3     (RT5)
 
 NAME( N1 )      Operator Data
                 Name and data      (N1)
 
 Misc     Last Update                       (Date Time)
          Operator who made last update     (OPID)

Example

*NSPONSPADMIN (( A(N N N) U(Y) GF( ) SF(X ) + NAME(ISM Administrator - Do not delete) )) 10/29/96 10:33 CE1

ISM System Rules Control File Format

This file contains the variables used by ISM. The variables can be updated using routine NSPRULES.

Location: VSAM Data set A (ISMDSA).

Description

Key = NSPSRULES Data = ISMMGR REFOPER MAUTO RDELAY NORIF ALRT( A1 A2 A3 A4 ) + CMCRECOV T(TBASE) Field Description Default ISMMGR ISM Manager ISMMGR Required ISMMGR REFOPER ISM Refresh Autotask ISMMGRS MAUTO ISM Message Automation Operator ISMMGRM RDELAY Summary Panel Refresh delay (seconds) 20 NORIF RIF feature on CMCC (NO YES) NO ALRT(A1 A2 A3 A4) Generic Alert filters. Resource Status (A1) (No |Yes) NO Router/Switch Perf/Memory (A2) (No |Yes) NO CMCC Perf/Memory (A3) (No |Yes) NO Interface Status (A4) (No |Yes) Ignored NO CMCRECOV XCA Recovery (NO |YES) NO (ISM CMCC) T(TBASE) ISM Scheduler Base Timer (15) Minutes 15

Example

NSPSRULES ISMMGR ISMMGRS ISMMGRM 20 YES + ALRT( YES YES YES YES ) YES T(15)

ISM Resource Control File Format

This control file is used to build the control block with which you manage a resource. There are two control file records for each resource.

Location: VSAM Data set A (ISMDSA).

Description

Key = IRAcntlname, where: cntlname is the resource name. Data = A RES D=( RT2 ) H=( RT3 ) I=( RT4 ) V=( RT7A RT7B ) + G=( RT8A RT8B RT8C ) N=( N1 N2 N3 N4 N5 N6 ) Q=( Q1 Q2 Q3 ) R( R1 ) + F=( RT9 )MISC Key = IRBcntlname, where,cntlname,is the resource name. Data = B RES E=( EB ) C=( CB ) MA=( MB ) CN( RT5 ) MO( MB ) + TY( TB ) MISC

ISMAxxxxx

Field Description Default A A type record RES Control Name D=( RT2 ) Domain H=( RT3 ) Host Name I=( RT4 ) Resource IP address V=( RT7A RT7B ) VTAM Interfaces Major Node ( RT7A) XCA Major Node ( RT7B) G( RT8A RT8B RT8C ) Operation Group(s) Group 1 Name ( RT8A ) Group 2 Name ( RT8B ) Group 3 Name ( RT8C ) N=(Y A N N N Y) Resource Control variables: N1 N2 N3 N4 N5 N6 Monitor Availability Collect Archive Create Interface Resource Monitor Statistics Statistics Alarms Archiving Q= ( Q1 Q2 Q3 ) Threshold Overrides P= CPU Threshold ( Q1 ) M= Memory Threshold ( Q2 ) A=No No Archiving ( Q3 ) R= ( YES ) Interface Monitoring ( R1 ) F=( RT9A RT9B ) Resource Features DSPU / CIP /TN3270 ( RT9A ) CIP / DSPU /TN3270 ( RT9B ) TN3270 / CIP / DSPU ( RT9C ) MISC Last Update (Date Time) Operator who made last update (OPID)

Note N=, Q=, and R= appear in the VSAM record only if they were set at some time. Typically, they are not present in the data fields.

ISMBxxxxx

Field Description Default B B type record RES Control Name E=( EB ) Description C=( R=RT6A V=RT6B ) Configuration R= Software Level ( RT6A ) V= Hardware Level ( RT6B ) MA=( MB ) MB = SNMP Mask CN( CB ) CB = Community name TY( TB ) TB = Resource Type RT = Cisco Router SW = Cisco Switch UN = Unknown SNMP managed device CA = Cisco CAT OS = OS/390 with SNMP support LD = Cisco Local Director MISC Last Update (Date Time) Operator who made last update (OPID)

Note N=, Q=, and R= appear in the VSAM record only if they were set at some time. Typically, they are not present in the data fields.

Example

IRACAT19002 A CAT19002 D=(CNM56) H=(CWB-CAT1900-2 ) I=(172.18.7.63) V=(UNKNOWN ) G=(SW1900 ) N=(Y A N N N Y) Q=( ) R=(YES) F=( ) 17:54 07/18/00 HAL2 IRBCAT19002 B CAT19002 E=( CISCO SYSTEMS CATALYST 1900 ) C=((UNKNOWN )) MA(255.255.255.0) CN(public) MO(SNMP) TY(CA) 17:54 07/18/00 HAL2

ISM Interface Control File Format

This control file is used to build the control block with which you manage an interface. Not all variables listed are used.

Location: VSAM Data set A (ISMDSA).

Description

Key = I_type_cntlname_convint where: Type is the interface type cntlname is the resource name convint is the converted interface CONVINT example: 0/0 = 0S0 0/0.123 = 0S0P123 Data = cntlname interface convint DS( D1 ) M( M1 ) G( G1 ) + E( E1 ) T( T1 ) I(I1) MISC Field Description Default cntlname Service Point Name interface Interface Name convint Converted Interface DS ( D1 ) Desired Status (D1) ( UP | DOWN ) M ( M1 ) Monitor Mode (M1) ( YES | NO ) YES G ( G1 ) Converted Interface E ( E1 ) Encapsulation Type T ( T1 ) TN3270 Monitoring Status (Channel only) I ( I1 ) SNMP Index Misc Last Update (Date Time) Operator who made last update (OPID)

Example

Channel (TN3270 SNMP) ICCWBC01XXC3S0 CWBC01 CHANNEL3/0 3/0 DS(UP) M(YES) G(3S0) E (CHANNEL) T(NOMON) I(12) 07/17/00 17:15 HAL1 TokenRing (SNMP) ITCWBC01XXT0S2 CWBC01 TOKENRING0/2 0/2 DS(UP ) M(YES) G(0S2) E(SNAP) I(3) T() 08:33 07/17/00 ISMMGR

CMCC Control File Format

This control file is used to build the control block with which you manage a CMCC (CIP).

Location: VSAM Data set A (ISMDSA).

Description

Key = CIP_cntlname_S_slot where: CIP is the interface type cntlname is the router name slot is the slot number Data = cntlname slot M( M1 ) T( T1 T2 T3) V( V1 V2 V3 ) I( I1 I2 I3 ) MISC Field Description Default Cntlname Service Point Name slot Position in Router

M( M1)		         Monitor Mode
                             (M1)  ( YES | NO )        YES
 
T( T1 T2 T3 )  Override Values 
               CPU            (Tn) C=
               MEM            (Tn) M=
               ARCHIVE        (Tn) A=( YES | NO )      YES
 
V( V1 V2 V3 )  CMCC Type and version
               CMCC Type      (V1)
               CMCC Hardware  (V2)
               CMCC Software  (V3)
 
I( I1 I2 I3 )  Channels Used 
               Channel n/0    (I1)
               Channel n/1    (I2)
               Channel n/2    (I3)
 
MISC           Last Update                             (Date Time)
               Operator who made last update           (OPID)

Example

CIPCWBC01XXS3 CWBC01 3 M(YES) T(C=75 ) + V(CIP 4.132 210.40) I( 3/0 3/1 3/2) 11:59 09/08/98 CE4

Scheduler Control File Format

This control file is used to build the scheduler environment.

Location: VSAM Data set A (ISMDSA).

Description

Key = NSPSTMR_n where: n (1 - 33) is the control file index. Data = A( TA ) R( TR ) I( TD ) G( TF ) MISC Field Description Default A( TA ) Autotask (TA) (aaaaaaaa) R( TR ) Resource interval (TR) ( 0 to 96 ) I( TD ) Interface Interval (TD) ( 0 to 96 ) G( TF ) Group Identifier (TF) ( gggggggg ) MISC Last Update (Date Time) Operator who made last update (OPID)

Note The TR and TD limits depend upon the base time value. If the base time is 15 minutes, the above values would apply.

Example

NSPSTMR1 A(ISMMGR) R(1) I(8) G(NONE) 16:28 07/12/98 CHAND2 NSPSTMR2 A(ISMMGRA) R(1) I(12) G(TEST1) 16:28 07/12/98 CHAND2 NSPSTMR3 A(ISMMGRC) R(1) I(8) G(TEST2) 16:28 07/12/98 CHAND2 NSPSTMR4 A(ISMMGR) R(2 ) I(18) G(TEST3) 15:00 09/03/98 CHAND1 NSPSTMR5 A(ISMMGR) R(5) I(10) G(TEST4) 15:00 09/03/98 CHAND1

Table of Contents

VSAM Control Files