CSYSDEF Resource Table

A CPSM Topology Definition that describes a CICS® system to be managed as part of a CICSplex.

The Primary key field for this resource class is NAME.

There are no object specific actions for this resource class.

Some of the attributes of a CICS system definition can be inherited from a Workload Manager, Real Time Analysis, or Monitor specification with which the system is associated. The attribute value you should use to request inheritance varies by field:
TMEZONE
Specify an asterisk (*) to request inheritance in all languages. You should also use an asterisk to request inheritance if you are creating this field by the batched repository-update facility.
TMEZONEO
For the batched repository-update facility and REXX API programs, specify an asterisk (*) to request inheritance. For API programs in all other languages, specify 255 to request inheritance.
BOTRSUP, CICSSAMP, CONNSAMP, DBXSAMP, FILESAMP, GLBLSAMP, JRNLSAMP, PROGSAMP, RETENTION, READRS, TDQSAMP, TERMSAMP, TOPRSUPD and TRANSAMP
For the batched repository-update facility and REXX API programs, specify an asterisk (*) to request inheritance. For API programs in all other languages, specify -1 to request inheritance.
SAMACTION, SOSACTION, SDMACTION, TDMACTION, MXTACTION, and STLACTION
Specify an asterisk (*) to request inheritance in all languages. You should also use an asterisk to request inheritance if you are creating this field by the batched repository-update facility.
EYUDA
Specify INHERIT when using the batched repository-update facility or REXX API programs. For API programs in all other languages, initialize the field to EYUDA_INHERIT. See the CSYSDEF table below to find the fields of type EYUDA which allow the value INHERIT.

The use of the xxxACTION and xxxSEV attributes is described in Special attribute and resource table considerations.

External resource name
CICSRegionDefinition
Length
472
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
EYUt3500
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
CREATE   MODEL(value) No
UPDATE   MODEL(value) No
REMOVE   None N/A
PERFORM SET ADDTOGRP MONSPC_INHRT(KEEP, NULL, FORCE) No
    RTASPC_INHRT(KEEP, NULL, FORCE) No
    TOGROUP(value) Yes
    WLMSPC_INHRT(KEEP, NULL, FORCE) No
Table 2. CSYSDEF FEEDBACK error codes
Value Code Description
1 CSYSDEF_INV_DATA Attribute data invalid
2 CSYSDEF_REC_NOT_FOUND Requested resource not found
3 CSYSDEF_INV_REFERENCE Group not found
4 CSYSDEF_REC_EXISTS Resource already exists
5 CSYSDEF_REC_CHANGED Resource definition already changed
6 CSYSDEF_INV_RESTYPE Invalid resource type
21 CSYSDEF_INV_SYS_NAME Invalid system name
22 CSYSDEF_INV_MODEL_NAME Invalid model name
23 CSYSDEF_INV_RECADDR Invalid record address
24 CSYSDEF_INV_RECLEN Invalid record length
25 CSYSDEF_INCONSISTENT_SET BAS inconsistent set
26 CSYSDEF_INCONSISTENT_SCOPES BAS inconsistent Scopes
27 CSYSDEF_ASSOCIATION Invalid group association
28 CSYSDEF_CYCLIC_GROUPS Link causes cyclic groups
29 CSYSDEF_CICSSYS_IN_USE Requested resource in use
30 CSYSDEF_IS_PLATFORM_SYSGROUP System group is a platform group
31 CSYSDEF_IS_PLATFORM_SYSTEM System is a platform system
32 CSYSDEF_PLATFORM_PROTECT_FIELD Platform protected field
Table 3. CSYSDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Attr ID
ACTVTIME CHAR CPSM 8 No DIFF Period definition name     37
AINSFAIL EYUDA CPSM 4 Yes LIKE BAS install failure action CONTINUE   45
AINSFAIL Input/output valid values CONTINUE, IMMEDIATE, NORMAL, PROMPT, TERMINATE
APPLID CHAR CPSM 8 Yes DIFF Application ID     43
AUTOINST EYUDA CPSM 4 Yes LIKE Install BAS resources option NEVER   44
AUTOINST Input/output valid values NEVER, ALWAYS, COLDONLY, WARMONLY
BOTRSUPD BINARY CPSM 1 Yes DIFF RS server bottom tier * 1-25 61
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     53
CHANGEAGENT Input/output valid values DREPAPI, DREPBATCH
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     56
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification     1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     55
CICSSAMP BINARY CPSM 4 Yes AVG Sample interval for CICS region monitoring INHERIT 0-86400 8
CONNSAMP BINARY CPSM 4 Yes AVG Sample interval for connection monitoring INHERIT 0-86400 11
CONTEXT CHAR CPSM 8 No DIFF CSYSDEF context     59
CREATEORIGIN EYUDA CPSM 4 No LIKE Definition origin     67
CREATEORIGIN Input/output valid values N_A, PLATFORM
CREATETIME DATETIME CPSM 8 Yes MAX Time created     54
DAYLGHTSV EYUDA CPSM 4 Yes LIKE Daylight saving time in effect INHERIT   41
DAYLGHTSV Input/output valid values YES, NO, INHERIT
DBXSAMP BINARY CPSM 4 Yes AVG Sample interval for DB2/DBCTRL monitoring INHERIT 0-86400 10
DESC CHAR CPSM 58 No DIFF Description     38
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 47
DYNROUTE EYUDA CPSM 4 Yes LIKE Target region active at startup YES   6
DYNROUTE Input/output valid values YES, NO
FILESAMP BINARY CPSM 4 Yes AVG Sample interval for file monitoring INHERIT 0-86400 12
GLBLSAMP BINARY CPSM 4 Yes AVG Sample interval for global region monitoring INHERIT 0-86400 9
HOST CHAR CPSM 116 No DIFF Host name     49
JRNLSAMP BINARY CPSM 4 Yes AVG Sample interval for journal monitoring INHERIT 0-86400 13
MONSTATUS EYUDA CPSM 4 Yes LIKE Monitoring status INHERIT   18
MONSTATUS Input/output valid values YES, NO, INHERIT
MPCMASID CHAR CPSM 8 No DIFF Maintenance point CMAS ID     58
MXTACTION CHAR CPSM 8 No DIFF Action for CICS-at-maximum-tasks event *   34
MXTSEV EYUDA CPSM 4 No LIKE Severity for CICS-at-maximum-tasks event HS   28
MXTSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
 NAME-1  CHAR CPSM 8 Yes DIFF CICS system definition name     5
NETWORKID CHAR CPSM 8 No DIFF Network ID     48
NRMACTION CHAR CPSM 8 No DIFF Action for Non-responsive-MAS event *   66
NRMSEV EYUDA CPSM 4 No LIKE Severity for Non-responsive-MAS event HW   65
NRMSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
PORT CHAR CPSM 8 No DIFF Port number   1-65535 50
PRICMAS CHAR CPSM 8 No DIFF Primary CMAS name     36
PROGSAMP BINARY CPSM 4 Yes AVG Sample interval for program monitoring INHERIT 0-86400 14
READRS BINARY CPSM 2 No DIFF RS server read interval * 0-2000 51
RETENTION BINARY CPSM 4 Yes AVG Time data is kept after monitoring stops (minutes) INHERIT 0-1440 7
RTASTATUS EYUDA CPSM 4 Yes LIKE Real time analysis status YES   19
RTASTATUS Input/output valid values YES, NO, SAM, MRM
SAMACTION CHAR CPSM 8 No DIFF Action for system availability monitoring event *   30
SAMSEV EYUDA CPSM 4 No LIKE Severity for system availability monitoring event VHS   24
SAMSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
SDMACTION CHAR CPSM 8 No DIFF Action for system dump event *   32
SDMSEV EYUDA CPSM 4 No LIKE Severity for system dump event VHS   26
SDMSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
SECBYPASS EYUDA CPSM 4 Yes LIKE Exemption from simulated security checks INHERIT   23
SECBYPASS Input/output valid values YES, NO, INHERIT
SECCMDCHK EYUDA CPSM 4 Yes LIKE Simulated CICS-command security checking status INHERIT   21
SECCMDCHK Input/output valid values YES, NO, INHERIT
SECRESCHK EYUDA CPSM 4 Yes LIKE Simulated CICS-resource security checking status INHERIT   22
SECRESCHK Input/output valid values YES, NO, INHERIT
SOSACTION CHAR CPSM 8 No DIFF Action for short on storage (SOS) event *   31
SOSSEV EYUDA CPSM 4 No LIKE Severity for short-on-storage (SOS) event HS   25
SOSSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
STLACTION CHAR CPSM 8 No DIFF Action for CICS-stalled event *   35
STLSEV EYUDA CPSM 4 No LIKE Severity for CICS-stalled event VHS   29
STLSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
SYSID CHAR CPSM 4 Yes DIFF System ID     46
TDMACTION CHAR CPSM 8 No DIFF Action for transaction dump event *   33
TDMSEV EYUDA CPSM 4 No LIKE Severity for transaction dump event HW   27
TDMSEV Input/output valid values N_A, NO, VLS, LS, LW, HW, HS, VHS, INHERIT
TDQSAMP BINARY CPSM 4 Yes AVG Sample interval for TDQ monitoring INHERIT 0-86400 16
TERMSAMP BINARY CPSM 4 Yes AVG Sample interval for terminal monitoring INHERIT 0-86400 15
TMEZONE CHAR CPSM 1 Yes DIFF Time zone *   40
TMEZONEO BINARY CPSM 1 Yes AVG Time zone offset * 0-59 39
TOPRSUPD BINARY CPSM 1 Yes DIFF RS server top tier * 1-25 60
TRANSAMP BINARY CPSM 4 Yes AVG Sample interval for transaction monitoring INHERIT 0-86400 17
UPDATERS BINARY CPSM 1 No DIFF RS server update frequency * 0-25 52
WLMOPTEN EYUDA CPSM 4 Yes LIKE WLM optimization enablement DISABLED   64
WLMOPTEN Input/output valid values ENABLED, DISABLED
WLMQMODE EYUDA CPSM 4 Yes LIKE Task load queue mode ALL   63
WLMQMODE Input/output valid values ALL, MAXTASK
WLMSTATUS EYUDA CPSM 4 Yes LIKE Routing region active at startup YES   20
WLMSTATUS Input/output valid values YES, NO
WLMTHRSH BINARY CPSM 1 Yes DIFF Task load health threshold 60 1-100 62