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
| Operations | Actions | Parameters | Required |
|---|---|---|---|
| Not applicable | |||
| 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 | |||||