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 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   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
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
PORT CHAR CPSM 8 DIFF No Port number 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   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
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
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
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
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
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   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   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   67
WLMTRACE BITSTRIP CPSM 4 AVG Yes Workload management trace flags   30


MAStab.html | Timestamp icon Last updated: Sunday, 4 June 2017