CMAS Resource Table

A CPSM Kernel Manager object that describes an active CMAS. Since a CMAS is itself a CICS® system, selected CICS attributes are also provided. CMAS instances and actions can be accessed by setting the context of the request to the required CMAS. CRITERIA and filters may not be used to select multiple instances of the CMAS resource table. If you want to perform actions on more than one CMAS at a time, or use CRITERIA or filters to select the CMAS on which to act, use the CMASLIST resource table.

The Primary key field for this resource class is CMASNAME.

The following actions are supported:
SHUTDOWN
Shutdown the CMAS
PURGE
Purge incore ESM security profiles
SECREBUILD
Rebuild the ESM Security profiles

These actions require no unique parameter data.

External resource name
CICSCICSManagingAddressSpace
Length
344
Usage
API 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 Manager
Copybook identifier
EYUt2451
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
SET   None N/A
PERFORM SET SHUTDOWN None N/A
  PURGE None N/A
  SECREBUILD None N/A
  RESET USERID(value) Yes
  RESETTIME None N/A
  CPSMDUMP ASID(value) No
    BAS No
    CHE No
    COM No
    DAT No
    KNL No
    MAS No
    MON No
    MSG No
    QUE No
    RTA No
    SIM No
    SLM No
    SRV No
    TOP No
    TRC No
    WLM No
  COMMAND CMDTEXT(value) Yes
Table 2. CMAS FEEDBACK error codes
Value Code Description
1 CMAS_INV_DATA Attribute data invalid
2 CMAS_REC_NOT_FOUND Requested resource not found
5 CMAS_REC_CHANGED Resource definition already changed
21 CMAS_NO_ACTION_TO_PERFORM No action to perform
22 CMAS_SECURITY_NOT_ACTIVE Security not active
23 CMAS_INV_USERID User ID missing or invalid
24 CMAS_INV_CMDTEXT Command text invalid
Table 3. CMAS resource table attributes
Name Datatype Source Len Sum Set Description Get Invalid Attr ID
AMAXTASK BINARY STAT 2 AVG No Maximum number of active tasks   30
APPLID CHAR CPSM 8 DIFF No Application ID   6
AUXSTATUS CVDAS INQ 4 LIKE Yes Auxiliary trace status   24
AUXSTATUS Input/output valid values AUXSTART, AUXSTOP, AUXPAUSE
AUXSWITCH CVDAS INQ 4 LIKE Yes Auxiliary trace switch status   25
AUXSWITCH Input/output valid values NOSWITCH, SWITCHALL, SWITCHNEXT
BASTRACE BITSTRIP CPSM 4 LIKE Yes Business Application Services (BAS) trace flags   3
CASID CHAR CPSM 4 DIFF No Local coordinating address space (CAS) ID   9
CASSTATUS EYUDA CPSM 4 LIKE No Coordinating address space (CAS) connection status   27
CASSTATUS Output valid values ACTIVE, INACTIVE, WAITING, LOSTCON, NOTAPPLIC
CHETRACE BITSTRIP CPSM 4 LIKE Yes Cache services trace flags   37
 CMASNAME-1  CHAR CPSM 8 DIFF No CMAS   4
COMTRACE BITSTRIP CPSM 4 AVG Yes Communications trace flags   40
CPSMVER CHAR CPSM 4 DIFF No CPSM version of CMAS   10
CPUTIME INTUSEC CPSM 8 MAX No Total CPU time used   12
CURRTASKS BINARY STAT 2 AVG No Current number of tasks   29
DATTRACE BITSTRIP CPSM 4 LIKE Yes Data repository services trace flags   38
DAYLIGHT EYUDA CPSM 4 LIKE Yes Daylight saving time   58
DAYLIGHT Input/output valid values YES, NO
DREPDSN CHAR CPSM 44 DIFF No Data repository data set name   48
DREPSTATUS CVDAS INQ 4 LIKE No Data repository status   21
DREPSTATUS Output valid values OPEN, CLOSED, OPENING, CLOSING, CLOSEREQUEST
FREEOSSBCNT BINARY CPSM 4 AVG No Number of CPSM program-working-storage blocks free   16
FREEOSSBUSE BINARY CPSM 4 AVG No Number of times free working-storage blocks used   17
GETMAINOSSB BINARY CPSM 4 AVG No Number of GETMAINs for working-storage blocks   18
GTFSTATUS CVDAS INQ 4 LIKE Yes Generalized trace facility (GTF) trace status   26
GTFSTATUS Input/output valid values GTFSTART, GTFSTOP
IRCSTATUS CVDAS INQ 4 LIKE Yes Interregion communication status   20
IRCSTATUS Input/output valid values OPEN, CLOSED
IRCSTATUS Input valid values IMMCLOSE
IRCSTATUS Output valid values CLOSING, IMMCLOSING
JOBID CHAR CPSM 8 DIFF No MVS job ID   71
JOBNAME CHAR CPSM 8 DIFF No MVS job name   5
KNLTRACE BITSTRIP CPSM 4 LIKE Yes Kernel linkage trace flags   33
MAXSTCB BINARY CPSM 4 AVG No Maximum number of STCBs allocated   57
MAXTASK BINARY STAT 4 AVG Yes Maximum number of active and suspended tasks   45
MAXTCNT BINARY STAT 2 AVG No Number of times maximum task limit reached   32
MEMLIMIT CNUMERIC INQ 8 LIKE No Maximum amount of storage above the bar E640 67
MONMCONN BINARY CPSM 4 AVG No Number of pending connection-monitoring queues   49
MONMFILE BINARY CPSM 4 AVG No Number of pending file-monitoring queues   50
MONMJRNL BINARY CPSM 4 AVG No Number of pending journal-monitoring queues   51
MONMPROG BINARY CPSM 4 AVG No Number of pending program-monitoring queues   52
MONMSYS BINARY CPSM 4 AVG No Number of pending global-monitoring queues   56
MONMTDQ BINARY CPSM 4 AVG No Number of pending TD-monitoring queues   55
MONMTERM BINARY CPSM 4 AVG No Number of pending terminal-monitoring queues   53
MONMTRAN BINARY CPSM 4 AVG No Number of pending transaction-monitoring queues   54
MONTRACE BITSTRIP CPSM 4 LIKE Yes Monitoring trace flags   42
MSGTRACE BITSTRIP CPSM 4 LIKE Yes Message services trace flags   35
MVSLOC CHAR CPSM 4 DIFF No MVS system ID   7
NETALERT BINARY CPSM 8 AVG No Number of Netview alerts sent   60
NETVPPI EYUDA CPSM 4 LIKE Yes Netview PPI to be used   59
NETVPPI Input/output valid values YES, NO
PAGEIN BINARY CPSM 4 AVG No Number of page-in requests   13
PAGEOUT BINARY CPSM 4 AVG No Number of page-out requests   14
PEAKAMAX BINARY STAT 2 AVG No Peak number of user tasks eligible for dispatch   31
QUETRACE BITSTRIP CPSM 4 LIKE Yes Queue services trace flags   39
REALSTG BINARY CPSM 4 AVG No Real storage in use   15
RODMNAME CHAR CPSM 8 DIFF No Resource status facility name   63
RTATRACE BITSTRIP CPSM 4 LIKE Yes Real time analysis (RTA) trace flags   43
SDUMP EYUDA CPSM 4 LIKE Yes System dump option   62
SDUMP Input/output valid values YES, NO, NEVER
SOSABOVEBAR CVDAS INQ 4 LIKE No Short on storage status above the bar E640 68
SOSABOVEBAR Output valid values SOS, NOTSOS
SOSABOVELINE CVDAS INQ 4 LIKE No Short on storage status above the line E640 69
SOSABOVELINE Output valid values SOS, NOTSOS
SOSBELOWLINE CVDAS INQ 4 LIKE No Short on storage status below the line E640 70
SOSBELOWLINE Output valid values SOS, NOTSOS
SRVTRACE BITSTRIP CPSM 4 LIKE Yes Common services trace flags   36
STRTTIME TIMESTP CPSM 8 MAX No Local time at which CMAS was started   11
SYSID CHAR CPSM 4 DIFF No CICS system ID   8
SYSTEMSTATUS CVDAS INQ 4 LIKE Yes System trace status   22
SYSTEMSTATUS Input/output valid values SYSTEMON, SYSTEMOFF
TIMEZONE CHAR CPSM 1 DIFF Yes CMAS time zone   46
TOPTRACE BITSTRIP CPSM 4 LIKE Yes Topology trace flags   41
TOTLTASKS BINARY STAT 4 AVG No Total number of CICS tasks run in CMAS   28
TRATRACE BITSTRIP CPSM 4 LIKE Yes Trace services trace flags   34
USERSTATUS CVDAS INQ 4 LIKE Yes User trace status   23
USERSTATUS Input/output valid values USERON, USEROFF
VTAMACB CVDAS INQ 4 LIKE Yes VTAM ACB open status   19
VTAMACB Input/output valid values OPEN, CLOSED
VTAMACB Input valid values IMMCLOSE, FORCECLOSE
VTAMACB Output valid values CLOSING, IMMCLOSING, FORCECLOSING
WLMTRACE BITSTRIP CPSM 4 LIKE Yes Workload management trace flags   44
XCFGROUP CHAR INQ 8 LIKE No XCF group ID E640 65
ZONEOFFS BINARY CPSM 1 DIFF Yes CMAS time zone offset   47