Using the CICSPlex SM dump formatting routine

You can use the CICSPlex® SM dump formatting routine with the IPCS VERBEXIT command to analyze an SDUMP taken for a CMAS or MAS. The formatting routine lets you process a dump selectively by identifying one or more CMAS or MAS components as parameters to the exit.

The routine is supplied as module EYU9D210, but can also be identified to IPCS as CPSM210 when member CICSTS31.CPSM.SEYUPARM(EYUIPCSP) is installed. You can specify either name with the VERBEXIT command.

Usage Notes

Formatting a CICSPlex SM SDUMP

To format an SDUMP, use the following VERBEXIT command:

VERBEXIT CPSM210 'JOB=jobname,compid1,...,compidn,option,DLCT=nn...n,QID=nn...n'

where:

JOB=
Identifies which CICSPlex SM address space in the dump is to be formatted. If this parameter is omitted, the first CICSPlex SM address space found is formatted.

If no additional parameters are specified, the formatting routine does the following:

The ESRs created by this routine can be used to display data space storage by the ALET value and offset found in any CICSPlex SM control block. ESRs for the ALETs are in the form EYURECnnnnnnnn, where nnnnnnnn is the ALET value. To browse storage, use standard IPCS commands, such as L EYURECnnnnnnnn+yyyy, where yyyy is the offset into the data space.

compid1,...,compidn
Identifies one or more specific CICSPlex SM components for which dump data is to be formatted. If no component IDs are specified, only the CICSPlex SM Kernel Linkage anchor block (XLWA) is formatted. For a list of component identifiers, see Major components of CICSPlex SM.

For individual components, you can control the level of information that is produced by specifying compid=n, where n is one of the following:

1
Displays summary information, including a summary of CICS tasks for the component.
Note:
For the Trace Services (TRC) component, this option formats only the exception trace records.
2
Displays detailed information, including the MODB, the MOEB, and all kernel linkage information for the component.
3
Displays both summary and detailed information for the component.

If no level is specified, both summary and detailed information are produced (or, in the case of Trace Services, all trace records are formatted).

option
Requests additional noncomponent related information. The following options are supported:
ESSS
Displays the ESSS address space control blocks.
LOCKS
Displays a summary of resource locks.
Start of changeQLISTEnd of change
Start of changeDisplays a summary of all allocated queues. Requires that the QUE dataspace(s) be present in the dump.End of change
TASKS
Displays a summary of CICS tasks for all CICSPlex SM components.
DCLT=nn...n
Identifies the DCLT to be displayed. DCLT identifiers, which are defined by the CPSM210 formatting routine as ESRs, can be from 12 to 16 bytes in length. (When the DCLT identifier is less than 16 bytes long, leading zeroes are assumed).

The DCLT control block and all elements associated with the DCLT are displayed. Each DCLT element is displayed as a separate block of storage.

Note:
Both the data cache data space (DMDSxxxx) and the component data spaces containing cache list elements must be included in the dump for this routine to work properly. If the dump was produced by CICSPlex SM as the result of an abend, the required data spaces may not be present. If, however, the data spaces are explicitly requested by a user, rather than by CICSPlex SM, the processing should complete successfully. For more information on dumping data spaces, see User-requested dumps.
QID=nn...n
Formats the selected data queue, showing the data queue service blocks, data queue record locate blocks, and the data queue record areas. The value nn...n is the 16-character data queue identifier.

The following is an example of a VERBEXIT command used to format dump data for specific components of a CMAS:

VERBEXIT CPSM210 'JOB=EYUCMS1A,TOP,RTA,MON=1,ESSS'

In this example, the address space to be formatted is EYUCMS1A. Dump data is produced for the Topology Services (TOP), real-time analysis (RTA), and Monitor Services (MON) components. For the Monitor Services component, only summary information is displayed. In addition to the component information, the ESSS control blocks are displayed.

CICSPlex SM SDUMP summaries

When the CPSM210 VERBEXIT is submitted to run in background, the following summaries are produced:

Formatting output for specific components

You can specify the components for which you want to obtain SDUMP output.

[[ Contents Previous Page | Next Page Index ]]