RTAGROUP Resource Table

A CICSPlex® SM 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 First key field for this resource is NAME.

The following actions are supported:
ADDTOAPS
Add an association between an RTA group and an RTA analysis point specification.
The parameter data for the ADDTOAPS action is: 
   PARM('SPEC(specname) [SCOPE(scope)].')

     where:

     specname = The name of an APSPEC definition.
     scope    = The CSYSDEF or CSYSGRP to install into.
ADDTOSPC
Add an association between an RTA group and an analysis specification.
The parameter data for the ADDTOSPC action is: 
   PARM('SPEC(specname).')

     where:

     specname = The name of a RTASPEC definition.
APINSTALL
Install the set of definitions into an active APSPEC.
The parameter data for the APINSTALL action is: 
   PARM('APSPEC(specname).')

     where:

     specname = (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.

INSTALL
Install the set of RTADEF and STATDEF definitions in the group into each active CICS® system that has Real Time Analysis active within the specified scope.
The parameter data for the INSTALL action is: 
   PARM('[SCOPE(scope)].')

     where:

     scope    = The CSYSDEF or CSYSGRP to install into.

External resource name(CMCI)
CICSRTAGroup
Object type
CICSPlex SM Definition
Length
112
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
EYUt3505
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 ADDTOAPS SCOPE(value) No
    SPEC(value) Yes
  ADDTOSPC SPEC(value) Yes
  APINSTALL APSPEC(value) Yes
    SCOPE(value) No
  INSTALL SCOPE(value) No
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 Description Default Value Range Offset
 NAME-1  CHAR CPSM 8 Yes DIFF RTA group     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 time the definition was changed     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     44
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 104