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, normally in SYS1.PARMLIB, has
the following entry for CICS:
IMBED MEMBER(DFHIPCSP) ENVIRONMENT(ALL) /*CICS */
Ensure that the CICS-supplied DFHIPCSP member can be found by your
IPCS job. You can either copy DFHIPCSP into SYS1.PARMLIB (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=CICSTS54.CICS.SDFHPARM,DISP=SHR For DFHIPCSP
Figure 1 shows the release-specific
entries specified in DFHIPCSP.
Figure 1. Release-specific entries in DFHIPCSP for DFHPDnnn
routines
/* ================================================================ */
EXIT EP(DFHPD660) VERB(CICS660) ABSTRACT(+
'CICS Transaction Server for z/OS V4 R1 analysis')
EXIT EP(DFHPD670) VERB(CICS670) ABSTRACT(+
'CICS Transaction Server for z/OS V4 R2 analysis')
EXIT EP(DFHPD680) VERB(CICS680) ABSTRACT(+
'CICS Transaction Server for z/OS V5 R1 analysis')
EXIT EP(DFHPD690) VERB(CICS690) ABSTRACT(+
'CICS Transaction Server for z/OS V5 R2 analysis')
EXIT EP(DFHPD700) VERB(CICS700) ABSTRACT(+
'CICS Transaction Server for z/OS V5 R3 analysis')
EXIT EP(DFHPD710) VERB(CICS710) ABSTRACT(+
'CICS Transaction Server for z/OS V5 R4 analysis')
/* ================================================================ */
To use the DFHIPCSP member as it is, rename the CICS-supplied version
of DFHPDX for earlier releases to the names shown in the table.
- The IPCS dump analysis subcommands enable you to format and analyze
CICS-produced SDUMPs, which you can either view at a terminal or print.
You can:
- Examine the data in a dump
- Locate and verify control blocks associated with certain functions or system components
- Trace and verify chains of control blocks
- Perform contention analysis on key MVS resources
- Locate modules and unit control blocks
- Execute user-written exits for certain control blocks
- Keep a list of names and locations of control blocks and areas of the dump that you consider important.
- The CICSnnn dump exit (where nnn is
the CICS release identifier) enables you to format a dump selectively
by specifying one or more CICS component identifiers as parameters
to the exit. Thus, the CICS710 dump
exit enables you to process a CICS® TS for z/OS®, Version 5.4 dump
selectively. You can:
- Specify which job in the dump data set is to be formatted (JOB parameter).
- Specify which component storage areas are to be formatted, and at what level of detail, by using formatting keywords and level numbers (keyword parameter). You do this using the IPCS command: VERBEXIT CICS710 'keyword,...'.
- Specify the default level of detail for components that are not explicitly identified by keyword (DEF parameter).
- Specify whether the output is to be printed in uppercase characters (UPPERCASE parameter).
The use of formatting keywords enables you to format those parts of the dump that interest you at any particular time, at specific levels of detail. You have the option of formatting other parts later for further investigation by you or by the IBM® service organizations. It is advisable to copy your dumps so that you can save the copy and free the dump data set for subsequent use.