EMSTATUS Resource Table

A CPSM Notification resource. Interest in this notification can be registered by issuing an API LISTEN command and naming this resource in the EVENT option.

CPSM Notifications have no key fields and do not support object specific actions.

EMSTATUS is emitted by a MAS agent to identify the current health of the MAS. This is a periodic notification that is often referred to as the MAS heartbeat. EMSTATUS contains all currently active MAS sickness indicators as reported by previous EMASSICK notifications. Other critical data of interest to various CPSM management applications is also provided.

The frequency of EMSTATUS emissions is not an externally documented value and is subject to change. It is important to note that every MAS generates multiple EMSTATUS notifications every minute. If an API program registers interest in EMSTATUS, the program must be prepared to recieve the asynchronous output on a regular and frequent basis. A program should assume that each MAS generates an EMSTATUS notification at least every 15 seconds for as long as it is connected to the CICSplex. In a CICSplex with 50 active MAS instances, this can result in 200 EMSTATUS notifications every minute in every CMAS managing the CICSplex. If a program registers interest in EMSTATUS, but does not process the notifications in a timely manner, large amounts of data space storage will be used to hold copies of these notifications.

External resource name
Length
240
Usage
API
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Object type
CICSPlex SM Notification
Copybook identifier
EYUt2507
Table 1. Valid CPSM operations
Operations Actions Parameters Required
Not applicable
Table 2. EMSTATUS resource table attributes
Name Datatype Source Len Sum Description Attr ID
AMAXTASKS BINARY INQ 4 LIKE Maximum number of active tasks 35
CSYSNAME CHAR CPSM 8 LIKE CICS system name 5
CURRTASKS BINARY INQ 4 LIKE Current number of tasks 36
CURSTALL1 BIT CPSM 1 LIKE First stall indicator flag 46
CURSTALL1 Input/output valid values 128 (ENQUEUE) - Enqueue suspended, 64 (TASKWAIT) - Task wait suspended, 32 (DLI) - DLI suspended, 16 (DBCTRL) - DB control suspended, 8 (STORAGE) - Storage suspended, 4 (UNKNOWN) - Unknown suspended, 2 (DISPABLE) - Dispatched-unused, 1 (RUNNING) - Running-unused
CURSTALL2 BIT CPSM 1 LIKE Second stall indicator flag 45
CURSTALL2 Input/output valid values 128 (DISP) - Dispatcher suspended, 64 (ALLCSESS) - Allocate session suspended, 32 (TERM) - Terminal control suspended, 16 (INTV) - Interval control suspended, 8 (FILE) - File I/O suspended, 4 (TEMPSTOR) - Temporary storage suspend, 2 (TSDATA) - Transient data suspended, 1 (JOURNAL) - Journal suspended
CURSTALL3 BIT CPSM 1 LIKE Third stall indicator flag 44
CURSTALL3 Input/output valid values 128 (EJB) - Enterprise java suspended, 64 (LOGGER) - Log manager suspended, 32 (IRLINK) - Interregn link suspended, 16 (DB2) - DB2 suspended, 8 (LOCK) - Lock manager suspended, 4 (XRF) - XRF suspended, 2 (PROGRAM) - Program manager suspended, 1 (TRANSACT) - Transaction Manager suspended
CURSTALL4 BIT CPSM 1 LIKE Fourth stall indicator flag 43
CURSTALL4 Input/output valid values 128 (ASYNC) - Asynchronous API task suspended, 64 (IPIC) - IP interconnectivity suspended, 32 (RMI) - Resource manager suspended, 16 (CONSOLE) - Console suspended, 8 (SOCKETS) - Sockets domain suspended, 4 (MQSERIES) - MQSeries suspended, 2 (USERWAIT) - User suspended, 1 (WEBSERV) - Web services suspended
DUMP_CODE CHAR CPSM 8 LIKE Last dump code 31
DUMP_PROGRAM CHAR CPSM 8 LIKE Last dump abending program 30
DUMP_TERMID CHAR CPSM 4 LIKE Last dump terminal ID 27
DUMP_TRANID CHAR CPSM 4 LIKE Last dump transaction ID 28
DUMP_USERID CHAR CPSM 8 LIKE Last dump user ID 29
IRCSTAT CVDAS INQ 4 LIKE Interregion communication status 38
IRCSTAT Output valid values OPEN, CLOSED, CLOSING, IMMCLOSING
LASTTYPE EYUDA CPSM 4 LIKE Last sick/well identification 10
LASTTYPE Output valid values SYSDUMP, TRANDUMP, MAXTASK, STALLED, SOSUDSA, SOSCDSA, SOSEUDSA, SOSECDSA, SOSERDSA, SOSSDSA, SOSESDSA, SOSRDSA, SOSMVS, SOSBELOW, SOSABOVE, SOSGCDSA, LOSTMAS
LOSTCON_TIM TIMESTP CPSM 8 LIKE MAS lost contact time 50
MASTYPE BIT CPSM 1 LIKE Status 6
MASTYPE Input/output valid values 128 (LOCAL) - Local MAS, 64 (REMOTE) - Remote MAS, 32 (CPSMWRAM) - Using CPSM WRAM program, 16 (RSFAILED) - RS Domain reporting problems, 08 (RSTRACED) - RS Domain trace issued, 04 (NOMVSWLM) - No MVS/WLM Support, 02 (MVSSRM) - MVS/WLM in SRM Mode, 01 (MVSGOAL) - MVS/WLM in GOAL Mode
MAXTASKS BINARY INQ 4 LIKE Maximum number of active and suspended tasks 34
MAXTASK_TIM TIMESTP CPSM 8 LIKE Last sick/well time 13
MEXPANSION BINARY CPSM 20 LIKE Stall condition indications 42
PLEXNAME CHAR CPSM 8 LIKE CICSplex name 4
SOSABOVE_TIM TIMESTP CPSM 8 LIKE Last sick/well time 24
SOSBELOW_TIM TIMESTP CPSM 8 LIKE Last sick/well time 25
SOSCDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 17
SOSCONDS BIT CPSM 1 LIKE Storage health indicators 8
SOSCONDS Input/output valid values 128 (SOSUDSA) - UDSA SOS, 64 (SOSCDSA) - CDSA SOS, 32 (SOSEUDSA) - EUDSA SOS, 16 (SOSECDSA) - ECDSA SOS, 8 (SOSERDSA) - ERDSA SOS, 4 (SOSSDSA) - SDSA SOS, 2 (SOSESDSA) - ESDSA SOS, 1 (SOSRDSA) - RDSA SOS
SOSCONDS2 BIT CPSM 1 LIKE Storage health indicators 9
SOSCONDS2 Input/output valid values 128 (SOSABOVE) - SOS above 16M, 64 (SOSBELOW) - SOS below 16M, 32 (SOSMVS) - Short of MVS storage, 16 (SOSGCDSA) - SOS above bar
SOSECDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 19
SOSERDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 20
SOSESDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 22
SOSEUDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 18
SOSGCDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 49
SOSMVS_TIM TIMESTP CPSM 8 LIKE Last sick/well time 48
SOSRDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 23
SOSSDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 21
SOSUDSA_TIM TIMESTP CPSM 8 LIKE Last sick/well time 16
STALL_TIM TIMESTP CPSM 8 LIKE Last sick/well time 14
SYSCONDS BIT CPSM 1 LIKE System health indicators 7
SYSCONDS Input/output valid values 128 (SYSDUMP) - System dumping, 64 (TRANDUMP) - Transaction dumping, 32 (MAXTASK) - At max tasks, 16 (STALLED) - Stalled, 08 (NRM) - Non-responsive, 01 (MODEOK) - CICS V3 modename Queue OK
SYSDUMP_TIM TIMESTP CPSM 8 LIKE Last sick/well time 11
TRANDUMP_CNT BINARY CPSM 4 LIKE Last transaction dump use count 32
TRANDUMP_TIM TIMESTP CPSM 8 LIKE Last sick/well time 12
VTAMACB CVDAS INQ 4 LIKE VTAM ACB open status 37
VTAMACB Output valid values OPEN, CLOSED, CLOSING, IMMCLOSING, FORCECLOSING, N_A


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