RTASPEC Resource Table

A CICSPlex® SM Real Time Analysis Definition that describes the RTA control directives for a set of CICS® systems. Using group associators, an RTASPEC object can determine which RTADEF and STATDEF instances are to be installed in each CICS system. Using scope link associators (LNKSRSCS), an RTASPEC object can determine which CICS systems fall under its processing scope. A CICS system can have a scope link associator to only one RTASPEC.

The First key field for this resource is NAME.

The following actions are supported:

ADDSYSDEF

Add an association between an RTA specification and a CICS system.

The parameter data for the ADDSYSDEF action is:

   PARM('SYSTEM(sysname).')

     where:

     sysname = The name of a CSYSDEF definition.

ADDSYSGRP

Add an association between an RTA specification and a CICS group.

The parameter data for the ADDSYSGRP action is:

   PARM('GROUP(sysgroup).')

     where:

     sysgroup = The name of a CSYSGRP definition.

External resource name(CMCI): CICSRTASpecification
Object type: CICSPlex SM Definition
Length: 192
Usage: API, Batch Utility, WUI, CICS Management Client Interface(CMCI)
API view: No
CMAS context: No
SCOPE applies: No
Only query CMASs in workload: No
Copybook identifier: EYUt3512
Security Class: ANALYSIS.DEF
Unsupported CICS Releases: None

Table 1. Valid CPSM operations
Operations	Actions	Parameters	Required
CREATE		None	N/A
GET		None	N/A
REMOVE		None	N/A
UPDATE		None	N/A
PERFORM SET, PERFORM OBJECT	ADDSYSDEF	SYSTEM(value)	Yes
	ADDSYSGRP	FORCE	No
		GROUP(value)	Yes
		INHERIT(NONE, NULL, FORCE)	No
		NONE	No
		NULL	No

Table 2. RTASPEC FEEDBACK error codes
Value	Code	Description
1	RTASPEC_INV_DATA	Attribute data invalid
2	RTASPEC_REC_NOT_FOUND	Requested resource not found
3	RTASPEC_INV_REFERENCE	Does not exist
4	RTASPEC_REC_EXISTS	Resource already exists
5	RTASPEC_REC_CHANGED	Resource definition already changed
6	RTASPEC_INV_RESTYPE	Invalid resource type
7	RTASPEC_INV_VER	Invalid resource version
8	RTASPEC_ACTION_NOT_FOUND	Action not found
9	RTASPEC_LNKASSOC_EXISTS	Association already exists

Table 3. RTASPEC resource table attributes
Name	Datatype	Source	Len	Req	Sum	Description	Default	Value Range	Offset
NAME-1	CHAR	CPSM	8	Yes	DIFF	RTA specification name			36
CHANGEAGENT	CVDAS	CPSM	4	No	LIKE	Last modification agent			8
CHANGEAGENT Input/output valid values	DREPAPI N_A
CHANGEAGREL	CHAR	CPSM	4	No	DIFF	Last modification agent release			32
CHANGETIME	DATETIME	CPSM	8	Yes	MAX	Last modification			0
CHANGEUSRID	CHAR	CPSM	8	No	DIFF	Last modification user ID			24
CREATETIME	DATETIME	CPSM	8	Yes	MAX	Time created			16
DESC	CHAR	CPSM	58	No	DIFF	Description			116
DESCCODEPAGE	BINARY	CPSM	4	No	DIFF	Description code page	37	0-99999999	176
MXTACTION	CHAR	CPSM	8	No	DIFF	Action for CICS-at-maximum-tasks event			100
MXTSEV	EYUDA	CPSM	4	No	LIKE	Severity for CICS-at-maximum-tasks event			60
MXTSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
NRMACTION	CHAR	CPSM	8	No	DIFF	Action for Non-responsive-MAS event			184
NRMSEV	EYUDA	CPSM	4	No	LIKE	Severity for Non-responsive-MAS event			180
NRMSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
SAMACTION	CHAR	CPSM	8	No	DIFF	Action for system availability monitoring event			68
SAMSEV	EYUDA	CPSM	4	No	LIKE	Severity for system availability monitoring event			44
SAMSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
SDMACTION	CHAR	CPSM	8	No	DIFF	Action for system dump event			84
SDMSEV	EYUDA	CPSM	4	No	LIKE	Severity for system dump event			52
SDMSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
SOSACTION	CHAR	CPSM	8	No	DIFF	Action for short on storage (SOS) event			76
SOSSEV	EYUDA	CPSM	4	No	LIKE	Severity for short on storage (SOS) event			48
SOSSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
STLACTION	CHAR	CPSM	8	No	DIFF	Action for CICS-stalled event			108
STLSEV	EYUDA	CPSM	4	No	LIKE	Severity for CICS-stalled event			64
STLSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A
TDMACTION	CHAR	CPSM	8	No	DIFF	Action for transaction dump event			92
TDMSEV	EYUDA	CPSM	4	No	LIKE	Severity for transaction dump event			56
TDMSEV Input/output valid values	VLS LS LW HW HS VHS NO N_A