RESGROUP Resource Table

A CICSPlex® SM Business Application Services Definition that provides the association anchor for a set of CICS® Definitions. References to a RESGROUP are inferred to be references to the set of associated CICS Definition instances.

The First key field for this resource is RESGROUP.

The following actions are supported:
ADDTODSC
Add a resource group definition to a resource description.
The parameter data for the ADDTODSC action is: 
   PARM('RESDESC(resdesc) [DESCCODEPAGE(codepage)] [DESCRIPTION(desc)].')

     where:

     resdesc  = (Required) Resource description to link to.
     codepage = Description code page.
     desc     = Description text.
INSTALL
Install definitions from a Resource Group.

The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

For information on the API CREATE parameters (MODEL and MODE), see Parameters for managing CICS Definitions.

External resource name(CMCI)
CICSResourceGroup
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
EYUt3519
Security Class
BAS.DEF
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
CREATE   MODE(NO, ASSOCIATIONS, MEMBERS) No
    MODEL(value) No
GET   None N/A
REMOVE   None N/A
UPDATE   None N/A
PERFORM SET, PERFORM OBJECT ADDTODSC DESCCODEPAGE(value) No
    DESCRIPTION(value) No
    RESDESC(value) Yes
  INSTALL ASSIGNMENT(value) No
    CRITERIA No
    FORCEINS(YES, NO) No
    MODE(DYNAM, STAT, INTRA, EXTRA, IND) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    OVERRIDE No
    OVERTYPE(TARGET, RELATED, BOTH, NONE) No
    REFASSIGN(value) No
    RELATED(value) No
    RESTYPE(ATOMDEF, BUNDDEF, CONNDEF, DB2CDEF, DB2EDEF, DB2TDEF, DOCDEF, DUMPDEF, EJCODEF, EJDJDEF, ENQMDEF, FENODDEF, FEPOODEF, FEPRODEF, FETRGDEF, FILEDEF, FSEGDEF, IPCONDEF, JRNLDEF, JRNMDEF, JVMSVDEF, LIBDEF, LSRDEF, MAPDEF, MQCONDEF, MQMONDEF, PARTDEF, PIPEDEF, PROCDEF, PROFDEF, PROGDEF, PRTNDEF, RQMDEF, SESSDEF, TCPDEF, TDQDEF, TERMDEF, TRANDEF, TRNCLDEF, TSMDEF, TYPTMDEF, URIMPDEF, WEBSVDEF) No
    STATECHK(YES, NO) No
    TARGET(value) No
    USAGE(LOCAL, REMOTE) No
Table 2. RESGROUP FEEDBACK error codes
Value Code Description
1 RESGROUP_INV_DATA Attribute data invalid
2 RESGROUP_REC_NOT_FOUND Requested resource not found
4 RESGROUP_REC_EXISTS Resource already exists
5 RESGROUP_REC_CHANGED Resource definition already changed
6 RESGROUP_INV_RESTYPE Invalid resource type
11 RESGROUP_NON_MP Maintenance point CMAS not available
12 RESGROUP_INV_CONTEXT Context not found
21 RESGROUP_INV_RECORD Invalid record
22 RESGROUP_INV_COPYRES Invalid copy mode
23 RESGROUP_INV_MODEL Invalid model
24 RESGROUP_INV_MODEL_REQUIRED Model name required
25 RESGROUP_INV_MAX_VERSIONS Invalid maximum versions
26 RESGROUP_INCOMPLETE_DEFSET Incomplete definition set
27 RESGROUP_RESGROUP_IN_USE Resource group in use
28 RESGROUP_RASGNDEF_IN_USE Resource assignment definition in use
29 RESGROUP_INV_NAME Invalid name
30 RESGROUP_NOTIFY Notify
31 RESGROUP_PARTIAL_INSTALL Partial install
32 RESGROUP_NOTHING_INSTALLED Nothing installed
33 RESGROUP_NO_TARGETS No targets
34 RESGROUP_NO_RELATED No related systems
35 RESGROUP_INV_TSCOPE Invalid target scope
36 RESGROUP_INV_RSCOPE Invalid related scope
37 RESGROUP_INV_USAGE Invalid usage
38 RESGROUP_INV_MODE Invalid mode value
39 RESGROUP_INV_STATECHK Invalid state check
40 RESGROUP_INV_FORCEINS Invalid force install
41 RESGROUP_INV_NOTIFY Invalid notify
42 RESGROUP_INV_OVERTYPE Invalid overtype
43 RESGROUP_INV_OVRBLOCK Invalid override block
44 RESGROUP_INV_FILTER Invalid filter
45 RESGROUP_INV_ORSTRING Invalid override string
46 RESGROUP_INV_STRNGTERM Invalid string terminator
47 RESGROUP_INV_EMBEDTERM Invalid embedded terminator
48 RESGROUP_INV_ATTRIBUTE Invalid attribute
49 RESGROUP_INV_OPERATOR Invalid operator
50 RESGROUP_INV_LITERAL Invalid literal
51 RESGROUP_INV_ORSTGNA Override string not allowed
52 RESGROUP_RSCOPE_REQUIRED Related scope required
53 RESGROUP_TSCOPE_REQUIRED Target scope required
54 RESGROUP_USAGE_CONFLICT Usage conflict
55 RESGROUP_REFASSGN_REQ Referenced resource assignment required
56 RESGROUP_REFASSIGN_NOTFND Referenced resource assignment not found
57 RESGROUP_RESTYPE_NOTINSTL Resource type not installed
58 RESGROUP_NODEFS_SELECTED No definitions selected
59 RESGROUP_INCOMPATIBLE_OVR Incompatible override
60 RESGROUP_INCOMPATIBLE_FILTER Incompatible filter
61 RESGROUP_MORE_THAN_1_RELSYS More than one related system
62 RESGROUP_MISSING_RELSYSID Missing related system identifier
63 RESGROUP_SCOPE_CONFLICT Scope conflict
64 RESGROUP_INV_ACTION Invalid action
65 RESGROUP_INCONSISTENT_SET Inconsistent set
Table 3. RESGROUP resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Offset GraphQL Field
 RESGROUP-1  CHAR CPSM 8 Yes DIFF Name     36 name
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     8 changeAgent
CHANGEAGENT Input/output valid values
  • DREPAPI
  • N_A
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     32 changeAgentRelease
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification     0 changeTime
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     24 changeUserID
CREATETIME DATETIME CPSM 8 Yes MAX Time created     16 createTime
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 104 desccodepage
DESCRIPTION CHAR CPSM 58 No DIFF Description     44 description