RTAGROUP Resource Table

A CPSM Real Time Analysis Definition that provides the association anchor for a set of RTADEF or STATDEF definitions. References to the RTAGROUP are inferred to be references to the set of associated RTADEF or STATDEF instances.

The Primary key field for this resource class is NAME.

The following actions are supported:

INSTALL

Install the set of definition RTADEF and STATDEF instances in the group into each active CICS system that has Real Time Analysis active within the specified scope.

APINSTALL

Install the set of definition into an active APSPEC.

The parameter data for the APINSTALL action is:

   PARM('APSPEC(spec).')

     where:

     spec = (Required) The name of an active APSPEC.

Only the set of RTADEF instances associated with the RTAGROUP are installed since an APSPEC does not support STATDEF objects.

External resource name: CICSRTAGroup
Length: 112
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: EYUt3505

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	INSTALL	SCOPE(value)	No
	APINSTALL	APSPEC(value)	Yes
		SCOPE(value)	No
	ADDTOSPC	SPEC(value)	Yes
	ADDTOAPS	SCOPE(value)	No
		SPEC(value)	Yes

Table 2. RTAGROUP FEEDBACK error codes
Value	Code	Description
1	RTAGROUP_INV_DATA	Attribute data invalid
2	RTAGROUP_REC_NOT_FOUND	Requested resource not found
3	RTAGROUP_INV_REFERENCE	Attribute references an invalid resource
4	RTAGROUP_REC_EXISTS	Resource already exists
5	RTAGROUP_REC_CHANGED	Resource definition already changed
6	RTAGROUP_INV_RESTYPE	Invalid Restype
7	RTAGROUP_INV_VER	Invalid version
21	RTAGROUP_NONE_INSTALLED	No groups installed
22	RTAGROUP_PARTIAL_INSTALL	Partial install
23	RTAGROUP_NO_ACTIVE_SYSTEMS	No active systems
24	RTAGROUP_DUPLICATE_DEFINITION	Duplicate definition

Table 3. RTAGROUP resource table attributes
Name	Datatype	Source	Len	Req	Sum	Set	Description	Default	Value Range	Attr ID
CHANGEAGENT	CVDAS	CPSM	4	No	LIKE	No	Last modification agent			8
CHANGEAGENT Input/output valid values	DREPAPI
CHANGEAGREL	CHAR	CPSM	4	No	DIFF	No	Last modification agent release			11
CHANGETIME	DATETIME	CPSM	8	Yes	MAX	No	Last time the definition was changed			1
CHANGEUSRID	CHAR	CPSM	8	No	DIFF	No	Last modification user ID			10
CREATETIME	DATETIME	CPSM	8	Yes	MAX	No	Time created			9
DESC	CHAR	CPSM	58	No	DIFF	No	Description			6
DESCCODEPAGE	BINARY	CPSM	4	No	DIFF	No	Description code page	37	0-99999999	7
NAME-1	CHAR	CPSM	8	Yes	DIFF	Yes	RTA group			5