The EYU9XEUT options

The EYU9XEUT batch utility program supports these options:

You specify the option you want to use on the SYSIN statement of the program’s JCL, as described in The EYU9XEUT JCL.

Dumping data structures (DUMP)

The DUMP option reports on the contents of data structures in both the ESSS and the MVS™ subsystem at the time the program is run.

The format of the DUMP option is:

DUMP  VERSION(nnn|ALL) [SUBSYSTEM] [ESSS] [LOCKS] [NOCML]

where:

VERSION
Identifies the version of CICSPlex® SM for which a report is to be generated. nnn is a specific version of CICSPlex SM, such as 210 for CICSPlex SM for CICS® Transaction Server for z/OS®, Version 3 Release 1. ALL reports on each version of ESSS that has been created at your enterprise.
SUBSYSTEM
Limits the report to the MVS subsystem data structures.
ESSS
Limits the report to the ESSS data structures.
LOCKS
Produces a summary of the ESSS data structures used by CICSPlex SM locks.
NOCML
Prevents EYU9XEUT from trying to obtain the MVS cross-memory local lock (CML), which may be held by a program call routine.
Note:
No CICSPlex SM lock summary is produced when NOCML is requested.

By default, the DUMP option generates a report containing MVS subsystem and ESSS data structures.

Reloading broadcast functions (RELOAD)

CICSPlex SM uses two MVS subsystem broadcast functions, end-of-task (EOT) and end-of-memory (EOM). As a result of program maintenance, it may be necessary to reload these functions in an existing ESSS address space.

The RELOAD option loads new broadcast functions from the utility library into the extended common system area (ECSA). You specify the location of the new functions on the UTILLIB statement of the program’s JCL, as described in The EYU9XEUT JCL.

The format of the RELOAD option is:

RELOAD  VERSION(nnn)  EOT|EOM|ALL

where:

nnn
Identifies the version of CICSPlex SM for which broadcast functions are to be replaced. For example, specify 210 for CICSPlex SM for CICS Transaction Server for z/OS, Version 3 Release 1.
EOT|EOM|ALL
Identifies the broadcast function to be replaced as end-of-task (EOT), end-of-memory (EOM), or both (ALL).

Stopping the ESSS (TERMINATE)

The ESSS address space may occasionally need to be stopped to pick up changes made by CICSPlex SM maintenance (PTFs), or when directed by IBM® support personnel. The TERMINATE option requests that the ESSS address space is stopped. It may only be used when no other address spaces (for example, CMASes, MASes, CPSM API programs) are connected to the ESSS. To check that no address spaces are connected to the ESSS address space, use the EYU9XENF utility.

Note:
Before using the TERMINATE option, all CICSPlex SM CMASes, MASes, and CICSPlex SM API programs using the same version of CICSPlex SM as the ESSS MUST be stopped.

The format of the TERMINATE option is :

TERMINATE VERSION(nnn)

where:

nnn
Identifies the version of CICSPlex SM for which the ESSS is to be stopped. For example specify 220 for CICSPlex SM Version 2 Release 2.
[[ Contents Previous Page | Next Page Index ]]