Before you can use IPCS to format CICS® SDUMPs, you must:
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. CICS issues an SDUMP macro request specifying a number of SDUMP options, of which the following must not be overridden:
If you set the dump mode for SDUMP to override mode (using the MVS™ CHNGDUMP SET OVER command), you must ensure that at least these options are set in the system’s SDUMP options list.
IPCS provides an exit control table with imbed statements to enable other products to supply exit control information. The IPCS default table, BLSCECT, normally in the SYS1.PARMLIB library, has the following entry for CICS:
IMBED MEMBER(DFHIPCSP) ENVIRONMENT(ALL) /* CICS */
The CICS-supplied DFHIPCSP member, installed in the CICSTS31.CICS.SDFHPARM library, contains the CICS release-specific entries for the IPCS exit control table. These entries are listed in Figure 29.
/* ================================================================== */
EXIT EP(DFHPD212) VERB(CICS212) ABSTRACT(+
'CICS Version 2 Release 1.2 analysis')
EXIT EP(DFHPD321) VERB(CICS321) ABSTRACT(+
'CICS Version 3 Release 2.1 analysis')
EXIT EP(DFHPD330) VERB(CICS330) ABSTRACT(+
'CICS Version 3 Release 3 analysis')
EXIT EP(DFHPD410) VERB(CICS410) ABSTRACT(+
'CICS Version 4 Release 1 analysis')
EXIT EP(DFHPD510) VERB(CICS510) ABSTRACT(+
'CICS Transaction Server for OS/390 Release 1 analysis')
EXIT EP(DFHPD520) VERB(CICS520) ABSTRACT(+
'CICS Transaction Server for OS/390 Release 2 analysis')
EXIT EP(DFHPD530) VERB(CICS530) ABSTRACT(+
'CICS Transaction Server for OS/390 Release 3 analysis')
EXIT EP(DFHPD610) VERB(CICS610) ABSTRACT(+
'CICS Transaction Server for z/OS V2 R1 analysis')
EXIT EP(DFHPD620) VERB(CICS620) ABSTRACT(+
'CICS Transaction Server for z/OS V2 R2 analysis')
EXIT EP(DFHPD630) VERB(CICS630) ABSTRACT(+
'CICS Transaction Server for z/OS V2 R3 analysis')
EXIT EP(DFHPD640) VERB(CICS640) ABSTRACT(+
'CICS Transaction Server for z/OS V3 R1 analysis')
/* =================================================================== */
You must ensure that this 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. For example:
//IPCSPARM DD DSN=SYS1.PARMLIB,DISP=SHR For BLSCECT
// DD DSN=CICSTS31.CICS.SDFHPARM,DISP=SHR For DFHIPCSP
The names of the IPCS exit routines specified by the EP(name) operands in the DFHIPCSP member must match the names of the CICS-supplied release-specific IPCS exit routines.
The dump exit routine that you use to format CICS system dump data must be the routine that was supplied with the release of CICS that produced dump data.
To ensure that your IPCS job can find the appropriate dump exit routine to format the CICS system dump data, you should add the library containing the dump exit routine to the MVS linklist. The dump exit routine for CICS Transaction Server for z/OS®, Version 3 Release 1, DFHPD640, is installed in the SYS1.CICSTS31.CICS.SDFHLINK library along with other modules needed in the MVS linklist. This routine is named with the release identifier as part of the name; that is, DFHPD640.