Preparing to use IPCS to format CICS SDUMPs

Before you can use IPCS to format CICS® SDUMPs, you must:

The SDUMP options needed to support the CICS dump exit

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:

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 master trace data
WLM
Workload Manager areas

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.

Specifying DFHIPCSP CICS exit control data needed

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.

Figure 29. Release-specific entries in DFHIPCSP for DFHPDnnn routines
 /* ================================================================== */
   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.

Making available CICS dump exit routines needed

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.

Related reference
Dump utility program (DFHDU640)
Using IPCS to format and analyze CICS dumps: Overview
Selecting parts of the CICS internal trace table
Using CICS-supplied dump exit routines to format CICS SDUMPs
The dump summary and error index
Sample jobs to process a CICS SDUMP using the CICS dump exit
[[ Contents Previous Page | Next Page Index ]]