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 |