CPLEXDEF Resource Table

A CPSM Communications Definition that describes a CICSplex. CPLEXDEF instances can be accessed only when you are connected to the CMAS that is the CICSplex Maintenance Point.

The Primary key field for this resource class is CICSPLEX.

Note: The value for the DAYLGHTSV attribute in the CPLEXDEF definition is stored for documentation purposes, but it is not used in time zone calculations.
The following actions are supported:
ASSIGN
Assign CMAS to manage CICSplex.
The parameter data for the ASSIGN action is: 
   PARM('CICSPLEX(plex) CMAS(cmas).')

     where:

     plex = (Required) Name of a CICSplex to which the CMAS
            is assigned.
     cmas = (Required) Name of a CMAS.
UNASSIGN
Unassign CMAS from CICSplex management role.
The parameter data for the UNASSIGN action is: 
   PARM('CICSPLEX(plex) CMAS(cmas) [FORCE].')

     where:

     plex = (Required) Name of a CICSplex from which the CMAS
            is unassigned.
     cmas = (Required) Name of a CMAS.

External resource name
CICSCICSplexDefinition
Length
152
Usage
API or Batch Utility or WUI or CICS Management Client Interface
API view
No
CMAS context
Yes
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICSPlex SM Definition
Copybook identifier
EYUt2736
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   CICSPLEX(value) No
CREATE   None N/A
UPDATE   None N/A
REMOVE   None N/A
PERFORM SET ASSIGN CICSPLEX(value) No
    CMAS(value) Yes
  UNASSIGN CICSPLEX(value) No
    CMAS(value) Yes
    FORCE No
Table 2. CPLEXDEF FEEDBACK error codes
Value Code Description
1 CPLEXDEF_INV_DATA Attribute data invalid
2 CPLEXDEF_REC_NOT_FOUND Requested resource not found
4 CPLEXDEF_REC_EXISTS Resource already exists
5 CPLEXDEF_REC_CHANGED Resource definition already changed
8 CPLEXDEF_REPOSITORY_FAILURE Error in data repository
21 CPLEXDEF_REMOTE_METH_FAIL Attempt to run program in remote system failed
22 CPLEXDEF_REM_EYUDREP_CORRUPT Error updating remote data repository
23 CPLEXDEF_DIRECTORY_ERROR Directory error
24 CPLEXDEF_ALL_COUNTS_ZERO All counts zero
25 CPLEXDEF_DELETE_PENDING CICSplex delete pending
26 CPLEXDEF_MAS_ACTIVE MAS active
27 CPLEXDEF_LCL_EYUDREP_CORRUPT Error updating local data repository
28 CPLEXDEF_INV_CMASNAME Invalid CMAS name
29 CPLEXDEF_CMAS_IS_MP CMAS is maintenance point
30 CPLEXDEF_DELETING_MP Removing maintenance point
31 CPLEXDEF_DEL_PENDING Removal pending
32 CPLEXDEF_CMAS_LEVEL CMAS at higher level
33 CPLEXDEF_LCL_EYUDREP_FAILURE Error in local repository
34 CPLEXDEF_LCL_REP_INV_LENGTH Record length error in local repository
Table 3. CPLEXDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Attr ID
BOTRSUPD BINARY CPSM 1 Yes DIFF RS server bottom tier 1 1-25 38
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     32
CHANGEAGENT Input/output valid values DREPAPI, DREPBATCH
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     35
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification     1
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     34
 CICSPLEX-1  CHAR CPSM 8 Yes DIFF CICSplex name     5
CREATETIME DATETIME CPSM 8 Yes MAX Time created     33
DAYLGHTSV EYUDA CPSM 4 Yes LIKE Daylight saving time NO   17
DAYLGHTSV Input/output valid values YES, NO
DESC CHAR CPSM 58 No DIFF Description     8
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 28
INTVL BINARY CPSM 2 Yes AVG Monitor interval (minutes) 480 15-1440 9
READRS BINARY CPSM 2 Yes DIFF RS server read interval 200 0-2000 30
RODMPOP EYUDA CPSM 4 Yes LIKE Resource status facility population NO   27
RODMPOP Input/output valid values YES, NO
RSPOOLID CHAR CPSM 8 Yes DIFF RS server pool name DFHRSTAT   39
SECBYPASS EYUDA CPSM 4 Yes LIKE Security checking exemption NO   10
SECBYPASS Input/output valid values YES, NO
SECCMDCHK EYUDA CPSM 4 Yes LIKE Simulated CICS-command security checking NO   6
SECCMDCHK Input/output valid values YES, NO
SECRESCHK EYUDA CPSM 4 Yes LIKE Simulated CICS-resource security checking NO   7
SECRESCHK Input/output valid values YES, NO
STATE EYUDA CPSM 4 No DIFF State of CICSplex     29
STATE Input/output valid values ACTIVE, PENDING, RECREATED
STATUS BINARY CPSM 1 Yes AVG Status of attempt to delete CICSplex     13
STATUS Input/output valid values 1 (ACTIVE) - CICSplex Active, 2 (DELPEND) - Removal pending, 3 (UNDELETE) - Definition re-created
TMEZONE CHAR CPSM 1 Yes DIFF Time zone B   15
TMEZONEO BINARY CPSM 1 Yes AVG Time zone offset 0 1-59 14
TOPRSUPD BINARY CPSM 1 Yes DIFF RS server top tier 5 1-25 37
UPDATERS BINARY CPSM 1 Yes DIFF RS server update frequency 15 0-25 31