Using the ESSS Information Display Utility (EYU9XENF)

The Environment Services System Services (ESSS) information display utility is a TSO/E command processor that can be used to display information about a CICSPlex® SM ESSS.

It is typically used to ensure that no CICSPlex SM address spaces (for example, CMASes, MASes, and CICSPlex SM API programs) are connected to the ESSS. Before EYU9XENF can be used, it needs to be defined as a TSO/E authorized command, and available to the TSO user as follows:
  • Add EYU9XENF to the 'AUTHCMD NAMES' section of the IKJTSOxx SYS1.PARMLIB member used by the MVS™ image.
  • Issue from TSO a 'PARMLIB UPDATE(xx)' command to implement the changes made to the IKJTSOxx member.
  • Ensure that the SEYUAUTH library that is specified in the TSO user STEPLIB concatenation matches the version of CICSPlex SM that is specified in the EYU9XENF command.
For details of IKJTSOxx and defining an authorized command see the z/OS® MVS Initialization and Tuning Reference.
The format of the EYU9XENF command is :
EYU9XENF nnn
where:
nnn
Identifies the version of CICSPlex SM for which the ESSS information is to be displayed. This version must match the version of CICSPlex SM specified in the STEPLIB concatenation.
Figure 1 shows an extract from a report produced by the EYU9XENF TSO command. From this figure we can see that two CMASes are active (in the ESSS), CMASPROD and CMASTEST. In addition three MASes are active PRODMAS1, PRODMAS2, and TESTMAS1.
Note: The CMAS information will only be removed after the CMAS has shutdown and all associated MASes and CICSPlex SM API programs have stopped.
Figure 1. Extract from ESSS information report from EYU9XENF
Version 530  CICSPlex SM Connection Information ------------------------
  CMAS      Job/User   CICS   Job/Task    MAS       Job/User  CICSPlex  Job/Task 
  Name        Name     Sysid    ID        Name      Name      Name      ID
 --------   --------   -----   --------   --------  --------  --------  --------
 CMASC002   CMASC002   C002    Inactive   <<SUR>>   APIPRG1             JOB70001
                                          MASM005   MASM005   PLEX2     JOB60001
                                          MASM004   MASM004   PLEX2     JOB50001
 CMASC001   CMASC001   C001    JOB00001   MASM003   MASM003   PLEX1     JOB40001
                                          MASM002   MASM002   PLEX1     JOB30001
                                          MASM001   MASM001   PLEX1     JOB20001
                                          WUIW001   WUIW001   PLEXW     JOB10001

Version 530  CICSPlex SM ESSS Program Information ------------------------------
 
 Program Name     Version     Load Point       Date     Time  Level
 
  EYU9X530         530        1F100810       01/20/15  19.55  JCI700M
  EYUTXEPC         530        1B9C4C80       01/20/15  19.54  JCI700M
  EYU9XEER         530        00CB9BF0       01/30/15  20.13  UI12345
  EYU9XEEM         530        1ECF7208       01/12/15  14.23  UI23456
  EYU9XEET         530        1ECEB9C8       01/12/15  14.23  UI23456
  EYU9XEEE         530        1BBEDA48       01/20/15  19.55  JCI700M

Version 530  CICSPlex SM ESSS Resource Usage Information -----------------------

Resource Name                           Origin     Length     Number     In Use

Connected ASID Table Elements          1F104F60   00050014   00000500   0000000B  
Dynamic Work Area Elements             1F154F74   00140014   00000500   00000000
Lock Manager Resource Queues           20494F9C   00B00014   00040000   000004E3
Lock Manager Holder/Waiter Elements    1F294F88   01200014   00080000   00000000
CICSplex Name Blocks                   20F94FBO   00003014   00000400   00000012
Signal Blocks                          20F97FC4   00080014   00001000   00000000
Thread Elements                        21017FD8   00020014   00002000   00000001
Target Interest Elements               21037FEC   00001014   00000100   00000000
Requestor Interest Elements            21039000   00001014   00000100   00000000


eyus1c0025.html | Timestamp icon Last updated: Monday, 5 June 2017