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 420  CICSPlex SM Connection Information ------------
  CMAS      Job/User   CICS      MAS      Job/User  CICSPlex
 --------   --------   -----   --------   --------  --------
 CMASPROD   CMASPROD   PROD    PRODMAS1   PRODMAS1  PLEXPROD
                               PRODMAS2   PRODMAS2  PLEXPROD
 CMASTEST   CMASTEST   TEST    TESTMAS1   TESTMAS1  PLEXTEST
Version 420  CICSPlex SM ESSS Program Information ----------
 Program Name     Version     Load Point       Date     Time
  EYU9X420         420        07C00AD0       12/21/10  19.59
  EYUTXEPC         420        06755F90       12/21/10  19.49
  EYU9XEER         420        00C1E158       09/21/10  10.55
  EYU9XEEM         420        06A465D8       09/21/10  10.55
  EYU9XEET         420        06A46170       07/01/10  12.32
  EYU9XEEE         420        06753B10       07/21/10  19.59
Version 420  CICSPlex SM ESSS Resource Usage Information ---