Preparing to use z/OS IPCS to format CICS SDUMPs

Before you can use z/OS® IPCS to format CICS® SDUMPs, you must ensure that certain SDUMP options are in force when the dump is taken, that the DFHIPCSP member can be found by your IPCS job, and that the CICS-supplied dump exit routines can be found by your IPCS job.

Procedure

The CICS dump exit is unable to format a CICS dump successfully unless the minimum SDUMP options are in force at the time the dump is written. Ensure that the options listed in Table 1 are in force.

CICS issues an SDUMP macro request specifying a number of SDUMP options. The options listed in Table 1 must not be overridden. If you set the dump mode for SDUMP to override mode (using the z/OS CHNGDUMP SET OVER command), you must ensure that at least these options are set in the system’s SDUMP options list.

Table 1. The SDUMP options needed to support the CICS dump exit
Option	Description
ALLPSA	All prefixed storage area for all processors
COUPLE	Cross-system coupling facility (XCF) information
CSA	Common service area
GRSQ	Global Resource Serialization control blocks
LPA	Link pack area modules
NUC	Non-page-protected areas of the DAT-on nucleus
RGN	Private area of the address space being dumped (this includes the LSQA and SWA)
SQA	System queue area
SUMDUMP	Summary dump
TRT	GTF, system trace, and main trace data
WLM	Workload Manager areas

Specify DFHIPCSP CICS exit control data needed. For details, see The DFHIPCSP CICS exit control data.
IPCS provides an exit control table with IMBED statements to enable other products to supply exit control information. The IPCS default table, BLSCECT, is usually in the SYS1.PARMLIB library, and it has the following entry for CICS:
```
IMBED MEMBER(DFHIPCSP)  ENVIRONMENT(ALL) /* CICS                  */
```
- You must ensure that the DFHIPCSP member can be found by your IPCS job. You can either copy the DFHIPCSP member into the SYS1.PARMLIB library so that it is in the same default library as BLSCECT, or provide an IPCSPARM DD statement to specify the library containing the IPCS control tables.
  Example based on CICS TS beta
  //IPCSPARM DD DSN=SYS1.PARMLIB,DISP=SHR For BLSCECT // DD DSN=CICSTS64.CICS.SDFHPARM,DISP=SHR For DFHIPCSP
- You must ensure that the names of the IPCS exit routines, specified by the EP(name) operands in the DFHIPCSP member, match the names of the CICS-supplied release-specific IPCS exit routines.
  The CICS-supplied DFHIPCSP member contains the CICS release-specific entries for the IPCS exit control table. The DFHIPCSP member installed in the CICSTSnn.CICS.SDFHPARM library, where CICSTSnn reflects the CICS release. For example, the library is CICSTS64.CICS.SDFHPARM for CICS TS beta.
Make the required CICS dump exit routines available.

The dump exit routine for the supplied version of CICS, DFHPDnnn is installed, along with other modules needed in the MVS linklist, in the SYS1.CICSTSnn.SDFHLINK library, where CICSTSnn reflects the CICS release. For example, the library is SYS1.CICSTS64.SDFHLINK for CICS TS beta. The DFHPDnnn routine has a release identifier as part of its name; for example, it is DFHPD760 for CICS TS beta.

Add the library containing the dump exit routine to the MVS linklist. This ensures that your IPCS job can find the appropriate dump exit routine to format the CICS system dump data.