VSAM Control Files

Table Of Contents

VSAM Control Files

ISM System Initialization Control File Format

ISM Operator Profile Control File Format

ISM Resource Control File Format

ISM Interface Control File Format

CMCC Control File Format

Scheduler Control File Format

TN3270 Control File Format

SNA Switch Control File Format

SNMP Control File Format

SNA Switch Server Control File Format

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

• ISM Operator Profile Control File Format

• ISM Resource Control File Format

• ISM Interface Control File Format

• CMCC Control File Format

• Scheduler Control File Format

• TN3270 Control File Format

• SNA Switch Control File Format

• SNMP Control File Format

• SNA Switch Server Control File Format

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 2Key = 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                                     DefaultAPPL( S1 S2 S3 S4 S5 S6 S7 S8 S9 )         ISM ApplicationsResource Management (S1)   ( YES | NO )          YESInterface Monitoring   (S2)   ( YES | NO ) YESOperator Management    (S3)   ( YES | NO ) YESSNA Session MGMT   (S4)   ( NO | YES ) NOISM Scheduler   (S5)   ( NO | NO  ) NOCMCC Management   (S6)   ( NO | NO  ) NODSPU Management   (S7)   ( NO | NO  ) NOFPM 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 )        10IM( I1 I2 I3 I4 I5 I6 I7 I8 I9 I10 I11 I12 ) Interface MonitoringToken Ring (I1)   ( YES | NO )           YESEthernet (I2)   ( YES | NO )           YESSerial (I3)   ( YES | NO )           YESFDDI (I4)   ( YES | NO )           YESLoopback (I5)   ( NO | YES )           NOAsync (I6)   ( NO | YES )           NOChannel (I7)   ( NO | YES )           NOHSSI (I8)   ( NO | YES )           NOISDN (I9)   ( NO | YES )           NOTunnel (I10)  ( NO | YES )           NOATM (I11)  ( NO | YES )           NOFastethernet (I12)  ( NO | YES )           NO
MI2(STT) Monitoring interval for interfaces 02:00
DB( D1 D2 D3 D4 D5 ) Data Bases:Resource History (D1)                       HInterface History (D2) IRIF History (D3) RRouter Configuration (D4) CCMCC History (D5)   H
CM( C1 C2 C3 C4 C5 ) Wrap Counts:Router History (C1) 48Interface History (C2) 48RIF History (C3)   5Router Configuration  (C4) 99CMCC History (C5) 51
CIP(E1 E2) CMCC Thresholds:CPU (E1) ( 0 | 99 ) 90Memory (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 2Key = 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 A4) ISMMGRI SM( S1 S2) EN( N1 ) +IN( I1 I2 I3 I4 ) TH(T1 T2 T3 T4 T5 T6 T7 T8 T9 T10 T11) B(B1B2B3B4B5B6) Date Time OPID
Field Description             DefaultISMMGR 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 GenerationG1 Router StatusG2 Router Perf/MemoryG3 CMCC Perf/MemoryG4 Interface StatusE1 CMCC RecoveryT(T1) ISM base timer for schedulerAPPL4( A1 A2 A3) Additional ApplicationsA1 TN3270 MonitoringA2 SpareA3 SNMP ManagementA4 SNASw Monitoring
ISMMGRI Name of ISMMGRI Autotask used for interface monitoring.
SM( S1 S2) SMF Control Variables
S1 SMF controlS2 SMF record identifier
EN( N1 ) Enable limitN1 Number of minutes that an operator can remain in enable mode.
IN( I1 I2 I3 I4 ) Additional Interface monitoring controller
I1 IBMCLAW ( YES | NO ) NOI2 MPC ( YES | NO ) NOI3 Future ( YES | NO ) NOI4 Gigabitethernet ( YES | NO ) NO
TH(T1 T2 T3 T4 T5 T6 T7 T8 T9 T10 T11) Interface Reliability ThresholdsT1 Token RingT2 EthernetT3 SerialT4 FDDIT5 LoopbackT6 AsyncT7 ChannelT8 HSSIT9 ISDNT10 TunnelT11 ATMB(B1B2B3B4B5B6) Subinterface MonitoringB1 EthernetB2 SerialB3 HSSIB4 ATMB5 FastEthernetB6 GigabitEthernet
Misc Last Update (Date Time)Operator who made last update (OPID)
Example
ISMSETUPCNM56R4 ISMMGR ISMMGRS ISMMGRM 20 ALRT( NO NO NO NO ) NO T(15) APPL4(YES NO YES YES) ISMMGRI SM(YES 220) EN(15) IN( YES YES NO YES ) TH(254 256 254 254 254 254 254 254 254 254 254 ) B(YYYYYY) 06/18/04 14:14 JI
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 DFilter Enabled (S) N=No Y=Yes NGroup Management (G) N=No Y=YES N
U( U ) AdministratorAuthority (U) N=No Y=Yes N
GF( RT1 RT2 ) Group FiltersGroup Filter 1 (RT1)Group Filter 2 (RT2)
SF( E RT3 RT4 RT5 ) Status FiltersFilter Mode (E) X=Exclude I=Include XStatus Filter 1 (RT3)Status Filter 2 (RT4)Status Filter 3 (RT5)
NAME( N1 ) Operator DataName 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 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 DefaultA A type record
RES Control Name
D=( RT2 ) Domain
H=( RT3 ) Host Name
I=( RT4 ) Resource IP address
V=( RT7A RT7B ) VTAM InterfacesMajor 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 N6Monitor Availability Collect Archive Create  InterfaceResource  Monitor Statistics Statistics  Alarms  Archiving
Q= ( Q1 Q2 Q3 ) Threshold OverridesP=  CPU Threshold ( Q1 )M=  Memory Threshold ( Q2 )A=No  No Archiving ( Q3 )
R= ( YES ) Interface Monitoring ( R1 )
F=( RT9A RT9B ) Resource FeaturesDSPU / 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 DefaultB B type record
RES Control Name
E=( EB ) Description
C=( R=RT6A V=RT6B ) ConfigurationR= Software Level ( RT6A )V= Hardware Level ( RT6B )
MA ( MB ) MB = SNMP Mask
CN( CB ) CB = Community name
TY( TB ) TB = Resource TypeRT = Cisco RouterSW = Cisco SwitchUN = Unknown SNMP managed deviceCA = Cisco CATOS = OS/390 with SNMP supportLD = 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 typecntlname is the resource nameconvint is the converted interfaceCONVINT example: 0/0 = 0S00/0.123 = 0S0P123Data = 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 typecntlname is the router nameslot 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 RouterM( M1) Monitor Mode(M1)  ( YES | NO ) YES
T( T1 T2 T3 )  Override ValuesCPU (Tn) C=MEM (Tn) M=ARCHIVE (Tn) A=( YES | NO ) YES
V( V1 V2 V3 )  CMCC Type and versionCMCC Type (V1)CMCC Hardware  (V2)CMCC Software  (V3)
I( I1 I2 I3 )  Channels UsedChannel 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 CHAND2NSPSTMR2 A(ISMMGRA) R(1) I(12) G(TEST1) 16:28 07/12/98 CHAND2NSPSTMR3 A(ISMMGRC) R(1) I(8) G(TEST2) 16:28 07/12/98 CHAND2NSPSTMR4 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

TN3270 Control File Format

This control file is used to build the tn3270 monitor environment.

Location: VSAM Data set A (ISMDSA).

Description
Key = ISMTN32SETUP
Data = L=(LU) D=(DB) W=(WC) S=(S) H=(H) M=(M) R=(RE) Time + Date OPID
Field Description Default
L=(LU) LU per cent free threshold 10D=(DB) History Logging data base DW=(WC) History wrap count 99S=(S) SMF logging YESH=(H) History logging YESM=(M) Access mode SNAR=(RE) Response time threshold 1000Misc Last Update (Time Date)OPID Operator who made last update

Example

ISMTN32SETUP L=(10) D=(H) W=(99) S=(YES) H=(YES) + M=(SNA) R=(1000) 11:23 01/28/04 JIM1

SNA Switch Control File Format

This control file is used to build the SNASw monitor environment.

Location: VSAM Data set A (ISMDSA).

Description
Key = ISMSWSNSETUP
Data = O=(O) D=(W) W=(W) S=(S) H=(H) M=(M) L=(L) F=(F) Time +Date OPID
Field Description Default
O=(O) Monitor operator id SNASWMOND=(DB) History Logging data base WW=(WC) History wrap count 99S=(S) SMF logging YESH=(H) History logging YESM=(M) Access mode SNAL=(L) Monitor links YESF=(F) History data set nameMisc Last Update (Time Date)OPID Operator who made last update
Example
ISMSWSNSETUP O=(SNASWMON) D=(W) W=(99) S=(YES) + H=(YES) M=(SNA) L=(YES) F=() 13:17 06/14/04 JIM2

SNMP Control File Format

This control file is used to build the SNMP environment.

Location: VSAM Data set A (ISMDSA).

Description
Key = SNMPSETUP
Data = MGR(MG) MON(MO) TR(T) PI(P) AL(A) MI(MI) TS(T) LO(L) +RT(RT) MA(MA) CN(C) Date Time OPID
Field Description Default
MGR(MG) SNMP Monitoring Operator SNMPMGRMON(MO) SNMP Message Autotask SNMPOPERTR(T) SNMP TRAP Monitoring YESPI(P) SNMP PING Monitoring NOAL(A) Generic Alert Generation NOMI(MI) Monitoring Interval not usedTS(T) TCP/IP OS/390 Task NameLO(L) Local IP_AddressRT(RT) Recovery Interval not usedMA(MA) Default Mask 255.255.255.0CN(C) Community Name publicMisc Last Update (Date Time)OPID Operator who made last update
Example
SNMPSETUP MGR(SNMPMGR) MON(SNMPOPER) +TR(YES) PI(NO) AL(NO) MI(00:00) TS(TCPMVSE1) +LO(172.18.55.15) RT(00) MA(255.255.255.0) CN(public) 01/28/04 11:25 JIM1

SNA Switch Server Control File Format

This control file is used to build the SNASw server monitor environment.

Location: VSAM Data set A (ISMDSA).

Description
Key = SNASW_cccccccc where ccccccc is the SNASw CP name.
Data = CPNAME ROUTER DS(DS) E(E1 E2 E3 E4) N(N) C(C) H(H) +I(I) V(V) Time Date OPID
Field Description Default
CPNAME Control Point NameROUTER Router Focal Point NameDS(DS) Desired Status ACTIVE( E1 E2 E3 E4) Control ValuesE1 Monitor resource YE2 Collect Statistics YE3 Archive Statistics YE4 Write SMF Records YN(N) Node TypeC(C) CP AliasH(H) Host NameI(I) Node ID (IDNUM/IDBLK)V(V) VTAM Net NameMisc Last Update (Time Date)OPID Operator who made last update

Example
SNASWCATDOG CATDOG ISMCATDG DS(ACTIV) E(Y Y Y Y ) N(Branch) C(CISCO) H(CATDOG) I(X'FFF00000') V(NETA.CATDOG) 14:32 04/30/04 JIM1