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=CICSTS56.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 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 CICS730 dump exit enables you to process a CICS TS for z/OS®, Version 5.6 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 CICS730 'keyword,...'.
- Specify the default level of detail for components that are not explicitly identified by keyword (DEF parameter). See The default SDUMP formatting levels.
- 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.