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	Set	Description	Default	Value Range	Attr ID
ACTVTIME	CHAR	CPSM	8	No	DIFF	No	Period definition name			37
AINSFAIL	EYUDA	CPSM	4	Yes	LIKE	No	BAS install failure action	CONTINUE		45
AINSFAIL Input/output valid values	CONTINUE, IMMEDIATE, NORMAL, PROMPT, TERMINATE
APPLID	CHAR	CPSM	8	Yes	DIFF	No	Application ID			43
AUTOINST	EYUDA	CPSM	4	Yes	LIKE	No	Install BAS resources option	NEVER		44
AUTOINST Input/output valid values	NEVER, ALWAYS, COLDONLY, WARMONLY
BOTRSUPD	BINARY	CPSM	1	Yes	DIFF	No	RS server bottom tier	*	1-25	61
CHANGEAGENT	CVDAS	CPSM	4	No	LIKE	No	Last modification agent			53
CHANGEAGENT Input/output valid values	DREPAPI, DREPBATCH
CHANGEAGREL	CHAR	CPSM	4	No	DIFF	No	Last modification agent release			56
CHANGETIME	DATETIME	CPSM	8	Yes	MAX	No	Last modification			1
CHANGEUSRID	CHAR	CPSM	8	No	DIFF	No	Last modification user ID			55
CICSSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for CICS region monitoring	INHERIT	0-86400	8
CONNSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for connection monitoring	INHERIT	0-86400	11
CONTEXT	CHAR	CPSM	8	No	DIFF	No	CSYSDEF context			59
CREATEORIGIN	EYUDA	CPSM	4	No	LIKE	Yes	Definition origin			67
CREATEORIGIN Input/output valid values	N_A, PLATFORM
CREATETIME	DATETIME	CPSM	8	Yes	MAX	No	Time created			54
DAYLGHTSV	EYUDA	CPSM	4	Yes	LIKE	No	Daylight saving time in effect	INHERIT		41
DAYLGHTSV Input/output valid values	YES, NO, INHERIT
DBXSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for DB2/DBCTRL monitoring	INHERIT	0-86400	10
DESC	CHAR	CPSM	58	No	DIFF	No	Description			38
DESCCODEPAGE	BINARY	CPSM	4	No	DIFF	No	Description code page	37	0-99999999	47
DYNROUTE	EYUDA	CPSM	4	Yes	LIKE	No	Target region active at startup	YES		6
DYNROUTE Input/output valid values	YES, NO
FILESAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for file monitoring	INHERIT	0-86400	12
GLBLSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for global region monitoring	INHERIT	0-86400	9
HOST	CHAR	CPSM	116	No	DIFF	Yes	Host name			49
JRNLSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for journal monitoring	INHERIT	0-86400	13
MONSTATUS	EYUDA	CPSM	4	Yes	LIKE	No	Monitoring status	INHERIT		18
MONSTATUS Input/output valid values	YES, NO, INHERIT
MPCMASID	CHAR	CPSM	8	No	DIFF	No	Maintenance point CMAS id			58
MXTACTION	CHAR	CPSM	8	No	DIFF	No	Action for CICS-at-maximum-tasks event	*		34
MXTSEV	EYUDA	CPSM	4	No	LIKE	No	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	Yes	CICS system definition name			5
NETWORKID	CHAR	CPSM	8	No	DIFF	No	Network ID			48
NRMACTION	CHAR	CPSM	8	No	DIFF	No	Action for Non-responsive-MAS event	*		66
NRMSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	Port number		1-65535	50
PRICMAS	CHAR	CPSM	8	No	DIFF	No	Primary CMAS name			36
PROGSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for program monitoring	INHERIT	0-86400	14
READRS	BINARY	CPSM	2	No	DIFF	No	RS server read interval	*	0-2000	51
RETENTION	BINARY	CPSM	4	Yes	AVG	No	Time data is kept after monitoring stops (minutes)	INHERIT	0-1440	7
RTASTATUS	EYUDA	CPSM	4	Yes	LIKE	No	Real time analysis status	YES		19
RTASTATUS Input/output valid values	YES, NO, SAM, MRM
SAMACTION	CHAR	CPSM	8	No	DIFF	No	Action for system availability monitoring event	*		30
SAMSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	Action for system dump event	*		32
SDMSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	Exemption from simulated security checks	INHERIT		23
SECBYPASS Input/output valid values	YES, NO, INHERIT
SECCMDCHK	EYUDA	CPSM	4	Yes	LIKE	No	Simulated CICS-command security checking status	INHERIT		21
SECCMDCHK Input/output valid values	YES, NO, INHERIT
SECRESCHK	EYUDA	CPSM	4	Yes	LIKE	No	Simulated CICS-resource security checking status	INHERIT		22
SECRESCHK Input/output valid values	YES, NO, INHERIT
SOSACTION	CHAR	CPSM	8	No	DIFF	No	Action for short on storage (SOS) event	*		31
SOSSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	Action for CICS-stalled event	*		35
STLSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	System ID			46
TDMACTION	CHAR	CPSM	8	No	DIFF	No	Action for transaction dump event	*		33
TDMSEV	EYUDA	CPSM	4	No	LIKE	No	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	No	Sample interval for TDQ monitoring	INHERIT	0-86400	16
TERMSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for terminal monitoring	INHERIT	0-86400	15
TMEZONE	CHAR	CPSM	1	Yes	DIFF	No	Time zone	*		40
TMEZONEO	BINARY	CPSM	1	Yes	AVG	No	Time zone offset	*	0-59	39
TOPRSUPD	BINARY	CPSM	1	Yes	DIFF	No	RS server top tier	*	1-25	60
TRANSAMP	BINARY	CPSM	4	Yes	AVG	No	Sample interval for transaction monitoring	INHERIT	0-86400	17
UPDATERS	BINARY	CPSM	1	No	DIFF	No	RS server update frequency	*	0-25	52
WLMOPTEN	EYUDA	CPSM	4	Yes	LIKE	No	WLM optimization enablement	DISABLED		64
WLMOPTEN Input/output valid values	ENABLED, DISABLED
WLMQMODE	EYUDA	CPSM	4	Yes	LIKE	No	Task load queue mode	ALL		63
WLMQMODE Input/output valid values	ALL, MAXTASK
WLMSTATUS	EYUDA	CPSM	4	Yes	LIKE	No	Routing region active at startup	YES		20
WLMSTATUS Input/output valid values	YES, NO
WLMTHRSH	BINARY	CPSM	1	Yes	DIFF	No	Task load health threshold	60	1-100	62

CSYSDEFtab.html | Timestamp icon

Last updated: Thursday, 27 June 2019