MAS Resource Table

A CPSM Topology Manager object that describes the attributes of a managed application system. A MAS is the run-time representation of a CICS® system definition. MAS objects can be referenced even if the CICS system is not active.

The Primary key field for this resource class is CICSNAME.

The CICSNAME attribute key field is ignored when named in an EVALDEF. The object instances returned are a function of the current scope in effect when the request is made.

When the EVALDEF is used by MRM, the scope is that of the CICS system for which the RTADEF is being installed.

When the EVALDEF is used by APM, the scope is that established when the RTADEF was associated with the APSPEC.

The following action is supported:
STOP
Terminate the CICSPlex® SM MAS agent component.

The STOP action requires no unique parameter data.

External resource name
CICSManagedRegion
Length
472
Usage
API or WUI or CICS Management Client Interface or EVALDEF
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Object type
CICSPlex SM Manager
Copybook identifier
EYUt2443
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
SET   None N/A
PERFORM SET STOP None N/A
  STOPUNCON None N/A
  FORCEDISCON None N/A
  CPSMDUMP 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
Table 2. MAS FEEDBACK error codes
Value Code Description
1 MAS_INV_DATA Attribute data invalid
21 MAS_MONSPEC_MISSING Monitor specification missing
22 MAS_RTASPEC_MISSING RTA specification missing
23 MAS_WLMSPEC_MISSING WLM specification missing
24 MAS_TOR_PARTICIPANT TOR participant
25 STOPUNCON_REQUIRED Issue StopUncon before ForceDiscon
Table 3. MAS resource table attributes
Name Datatype Source Len Sum Set Description Value Range Get Invalid Attr ID
ACTVTIME CHAR CPSM 8 DIFF Yes Period definition name     51
AINSFAIL EYUDA CPSM 4 LIKE Yes Autoinstall failure action     58
AINSFAIL Input/output valid values CONTINUE, PROMPT, SHUTDOWN, TERMINATE, N_A
AUTOINST EYUDA CPSM 4 LIKE Yes Autoinstall request type     57
AUTOINST Input/output valid values NEVER, ALWAYS, COLDONLY, WARMONLY, N_A
BASTRACE BITSTRIP CPSM 4 AVG Yes Business Application Services (BAS) trace flags     34
BOTRSUPD BINARY CPSM 1 AVG Yes RS server bottom tier 1-25   66
CHETRACE BITSTRIP CPSM 4 AVG Yes Cache services trace flags     26
 CICSNAME-1  CHAR CPSM 8 DIFF No CICS system name     4
CICSSAMP BINARY CPSM 4 AVG Yes Sample interval for CICS region monitoring     12
CICSSTATE EYUDA CPSM 4 LIKE No MAS status     7
CICSSTATE Output valid values ACTIVE, INACTIVE, LOSTCON, LOSTCMAS, LOSTMAS
CMASNAME CHAR CPSM 8 DIFF No CMAS name     5
COMTRACE BITSTRIP CPSM 4 AVG Yes Communications trace flags     28
CONNSAMP BINARY CPSM 4 AVG Yes Sample interval for connection monitoring     15
CPSMVER CHAR CPSM 4 DIFF No CPSM version of MAS     72
DATTRACE BITSTRIP CPSM 4 AVG Yes Data repository services trace flags     33
DAYLGHTSV EYUDA CPSM 4 LIKE Yes Daylight saving time in effect     55
DAYLGHTSV Input/output valid values YES, NO, N_A
DBXSAMP BINARY CPSM 4 AVG Yes Sample interval for DB2/DBCTRL monitoring     14
DESC CHAR CPSM 58 DIFF No CICS system description     52
FILESAMP BINARY CPSM 4 AVG Yes Sample interval for file monitoring     16
GLBLSAMP BINARY CPSM 4 AVG Yes Sample interval for global region monitoring     13
HOST CHAR CPSM 116 DIFF No Host Name   E640 E650 60
JRNLSAMP BINARY CPSM 4 AVG Yes Sample interval for journal monitoring     17
KNLTRACE BITSTRIP CPSM 4 AVG Yes Kernel linkage trace flags     22
MASTRACE BITSTRIP CPSM 4 AVG Yes MAS services trace flags     29
MASTYPE EYUDA CPSM 4 LIKE No MAS type     6
MASTYPE Output valid values N_A, LOCAL, REMOTE
MONSTATUS EYUDA CPSM 4 LIKE Yes Monitoring status     8
MONSTATUS Input/output valid values YES, NO, FORCE, N_A
MSGTRACE BITSTRIP CPSM 4 AVG Yes Message services trace flags     24
MXTACTION CHAR CPSM 8 DIFF Yes Action for CICS-at-maximum-tasks event     48
MXTSEV EYUDA CPSM 4 LIKE Yes Severity for CICS-at-maximum-tasks event     42
MXTSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
NETWORKID CHAR CPSM 8 DIFF No Network ID   E640 E650 61
NRMACTION CHAR CPSM 8 DIFF Yes Action for Non-responsive-MAS event     71
NRMSEV EYUDA CPSM 4 LIKE Yes Severity for Non-responsive-MAS event     70
NRMSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
PORT CHAR CPSM 8 DIFF No Port number 1-65535 E640 E650 62
PRICMAS CHAR CPSM 8 DIFF Yes Primary CMAS name     50
PROGSAMP BINARY CPSM 4 AVG Yes Sample interval for program monitoring     18
QUETRACE BITSTRIP CPSM 4 AVG Yes Queue services trace flags     27
READRS BINARY CPSM 2 DIFF Yes RS server read interval 0-2000   63
RETENTION BINARY CPSM 4 AVG Yes Monitoring data retention period     11
RTASTATUS EYUDA CPSM 4 LIKE Yes Real time analysis status     9
RTASTATUS Input/output valid values YES, NO, SAM, MRM, N_A
RTATRACE BITSTRIP CPSM 4 AVG Yes Real time analysis (RTA) trace flags     32
SAMACTION CHAR CPSM 8 DIFF Yes Action for system availability monitoring event     44
SAMSEV EYUDA CPSM 4 LIKE Yes Severity for system availability monitoring event     38
SAMSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
SDMACTION CHAR CPSM 8 DIFF Yes Action for system dump event     46
SDMSEV EYUDA CPSM 4 LIKE Yes Severity for system dump event     40
SDMSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
SECBYPASS EYUDA CPSM 4 LIKE Yes Simulated security exemption check     37
SECBYPASS Input/output valid values YES, NO, N_A
SECCMDCHK EYUDA CPSM 4 LIKE Yes Simulated security command check     35
SECCMDCHK Input/output valid values YES, NO, N_A
SECRESCHK EYUDA CPSM 4 LIKE Yes Simulated security resource check     36
SECRESCHK Input/output valid values YES, NO, N_A
SOSACTION CHAR CPSM 8 DIFF Yes Action for short on storage (SOS) event     45
SOSSEV EYUDA CPSM 4 LIKE Yes Severity for short on storage (SOS) event     39
SOSSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
SRVTRACE BITSTRIP CPSM 4 AVG Yes Common services trace flags     25
STLACTION CHAR CPSM 8 DIFF Yes Action for CICS-stalled event     49
STLSEV EYUDA CPSM 4 LIKE Yes Severity for CICS-stalled event     43
STLSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
TDMACTION CHAR CPSM 8 DIFF Yes Action for transaction dump event     47
TDMSEV EYUDA CPSM 4 LIKE Yes Severity for transaction dump event     41
TDMSEV Input/output valid values VLS, LS, LW, HW, HS, VHS, N_A, NO
TDQSAMP BINARY CPSM 4 AVG Yes Sample interval for TDQ monitoring     20
TERMSAMP BINARY CPSM 4 AVG Yes Sample interval for terminal monitoring     19
TMEZONE CHAR CPSM 1 DIFF Yes Time zone     54
TMEZONEO BINARY CPSM 1 AVG Yes Time zone offset     53
TOPRSUPD BINARY CPSM 1 AVG Yes RS server top tier 1-25   65
TOPTRACE BITSTRIP CPSM 4 AVG Yes Topology trace flags     31
TRANSAMP BINARY CPSM 4 AVG Yes Sample interval for transaction monitoring     21
TRATRACE BITSTRIP CPSM 4 AVG Yes Trace services trace flags     23
UPDATERS BINARY CPSM 1 AVG Yes RS server update frequency 0-25   64
WLMOPTEN EYUDA CPSM 4 LIKE Yes WLM optimization enablement     69
WLMOPTEN Input/output valid values ENABLED, DISABLED, N_A
WLMQMODE EYUDA CPSM 4 DIFF Yes Task load queue mode     68
WLMQMODE Input/output valid values ALL, MAXTASK, N_A
WLMSTATUS EYUDA CPSM 4 LIKE Yes Workload manager status     10
WLMSTATUS Input valid values YES
WLMSTATUS Output valid values YES, NO, N_A
WLMTHRSH BINARY CPSM 1 AVG Yes Task load health threshold 1-100   67
WLMTRACE BITSTRIP CPSM 4 AVG Yes Workload management trace flags     30