MONSPEC Resource Table

A CPSM Monitor Definition that describes the control directives for monitoring a set of CICS® systems. Using group associators, a MONSPEC object can determine which MONDEF instances are to be installed in each CICS system. Using scope link associators (LNKSMSCS), a MONSPEC object can determine which CICS systems fall under its processing scope. A CICS System can have a scope link associator to only one MONSPEC.

The Primary key field for this resource class is NAME.

External resource name
CICSMonitorSpecification
Length
168
Usage
API or Batch Utility or WUI or CICS Management Client Interface
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICSPlex SM Definition
Copybook identifier
EYUt3511
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
CREATE   None N/A
UPDATE   None N/A
REMOVE   None N/A
PERFORM SET ADDSYSGRP FORCE Yes
    GROUP(value) Yes
    NONE Yes
    NULL Yes
  ADDSYSDEF SYSTEM(value) Yes
Table 2. MONSPEC FEEDBACK error codes
Value Code Description
1 MONSPEC_INV_DATA Attribute data invalid
2 MONSPEC_REC_NOT_FOUND Requested resource not found
4 MONSPEC_REC_EXISTS Resource already exists
5 MONSPEC_REC_CHANGED Resource definition already changed
6 MONSPEC_RODMCMAS_NOT_FOUND RODM CMAS Not Found
7 MONSPEC_INV_REFERENCE Does not exist
8 MONSPEC_LNKASSOC_EXISTS Association already exists
Table 3. MONSPEC resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Attr ID
ACTSTATUS EYUDA CPSM 4 Yes LIKE Monitor activation status INACTIVE   27
ACTSTATUS Input/output valid values ACTIVE, INACTIVE
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     31
CHANGEAGENT Input/output valid values DREPAPI
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     34
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification     1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     33
CICSSAMP BINARY CPSM 4 Yes AVG Sample interval for CICS region monitoring 0 0-86400 8
CONNSAMP BINARY CPSM 4 Yes AVG Sample interval for connection monitoring 0 0-86400 14
CREATETIME DATETIME CPSM 8 Yes MAX Time created     32
DBXSAMP BINARY CPSM 4 Yes AVG Sample interval for DB2 and DBCTRL monitoring 0 0-86400 12
DESC CHAR CPSM 58 No DIFF Description     28
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 30
FILESAMP BINARY CPSM 4 Yes AVG Sample interval for file monitoring 0 0-86400 16
GLBLSAMP BINARY CPSM 4 Yes AVG Sample interval for global region monitoring 0 0-86400 10
JRNLSAMP BINARY CPSM 4 Yes AVG Sample interval for journal monitoring 0 0-86400 18
 NAME-1  CHAR CPSM 8 Yes DIFF Specification     5
PROGSAMP BINARY CPSM 4 Yes AVG Sample interval for program monitoring 0 0-86400 20
RETENTION BINARY CPSM 4 Yes AVG Data retention period 0 0-1440 6
RODMCMAS CHAR CPSM 8 No DIFF Resource status facility CMAS name     29
TDQSAMP BINARY CPSM 4 Yes AVG Sample interval for TDQ monitoring 0 0-86400 24
TERMSAMP BINARY CPSM 4 Yes AVG Sample interval for terminal monitoring 0 0-86400 22
TRANSAMP BINARY CPSM 4 Yes AVG Sample interval for transaction monitoring 0 0-86400 26