Formatting system dumps

You can process system dumps from the dump data set using an invocation of the interactive problem control system (IPCS).

In prior releases, the CICS formatting routine for use under the MVS™ interactive problem control system (IPCS) is supplied as DFHPDX. This standard name is not suitable for those users running more than one release of CICS, because the dump formatting process in each version of DFHPDX is release-specific, and you must use the correct version for the system dump you are formatting. The module is named with the release identifier as part of the name - DFHPD640 is the formatting routine you must define to IPCS when formatting CICS® Transaction Server for z/OS®, Version 3 Release 1 system dumps.

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=CICSTS31.CICS.SDFHPARM,DISP=SHR     For DFHIPCSP

Figure 34 shows the release-specific entries specified in DFHIPCSP.

Figure 34. 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') 
/* ================================================================ */

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 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.

For guidance about using the formatting keywords and levels, see CICS Operations and Utilities Guide.

A summary of system dump formatting keywords and levels

The component keywords specify which areas of CICS you want the CICS640 exit to format dump data for, and the level number operand specifies the amount of data you want formatted.

If you omit all of the component keywords, and you do not specify DEF=0, the CICS dump exit formats dump data for all components.

The CICS dump component keywords, and the levels you can specify for each of them, are as follows:

AI [={0|2}]
Autoinstall model manager.
AI=0
Suppress formatting of AI control blocks.
AI=2
Format AI control blocks.
AP [={0|1|2|3}]
Application domain.
AP=0
Suppress formatting of AP control blocks.
AP=1
Format a summary of addresses of the AP control blocks for each active transaction.
AP=2
Format the contents of the AP control blocks for each active transaction.
AP=3
Format level-1 and level-2 data.
APS=<TASKID=Task identifier>
Application selection. The APS component keyword allows you to limit the formatting of system dumps to only those storage areas relating to the task identifier specified. Contents of the application domain control blocks for the specified transaction will be listed along with language environment storage areas for the same transaction.
Note:
You must use angled brackets around the specified parameter.
BA [={0|1|2|3}]
Business application manager domain.
BA=0
Suppress formatting of business application manager domain control blocks.
BA=1
Format the BA unit of work context (BAUW) and BA activity (BAACT) summaries.
BA=2
Format the anchor block (BADMANC), BA unit of work context (BAUW), and BA activities (BAACT).
BA=3
Format level-1 and level-2 data.
BR [={0|1|2|3}]
The 3270 bridge domain
BR=0
Suppress formatting of bridge domain control blocks.
BR=1
Format bridge facility summary information.
BR=2
Format all control blocks and bridge messages in the system.
BR=3
Format level-1 and level-2 data.
CC [={0|2}]
The CICS catalog domain.
CC=0
Suppress formatting of CC control blocks.
CC=2
Format the CC control blocks.
CP [={0|2}]
The common programming interface.
CP=0
Suppress formatting of CP control blocks.
CP=2
Format the CPI static storage.
CQ [={0|1|2}]
Autoinstall model manager.
CQ=0
suppresses formatting of console queue control blocks
CQ=1
formats the console queue summary
CQ=2
formats the console queue control blocks and CQ trace table
CSA[={0|2}]
The CICS common system area.
CSA=0
Suppress formatting of the CSA.
CSA=2
Format the CSA and its extension, the optional features list (CSAOPFL).
DB2® [={0|1|2|3}]
The CICS DB2 interface.
DB2=0
Suppress formatting of DB2 control blocks.
DB2=1
Format the summary of tasks currently using the CICS DB2 interface.
DB2=2
Format the control blocks.
DB2=3
Format level-1 and level-2 data.
DD[={0|1|2|3}]
The directory manager domain.
DD=0
Suppress formatting of DD control blocks.
DD=1
Format the directory manager summary.
DD=2
Format the directory manager control blocks, including the anchor block, directory headers, and AVL tree headers.
DD=3
Format level-1 and level-2 data.
DH[={0|1|2|3}]
The document handler domain.
DH=0
Suppress formatting of DH control blocks.
DH=1
Format document handler summary information.
DH=2
Format the domain anchor block, document anchor block, document control record, document data block and document bookmark block.
DH=3
Format level-1 and level-2 data.
DLI[={0|2}]
CICS DL/I interface.
DLI=0
Suppress formatting of DLI control blocks.
DLI=2
Format DLI control blocks.
DM[={0|1|2|3}]
The domain manager.
DM=0
Suppress formatting of DM control blocks.
DM=1
Format the wait queue.
DM=2
Format the anchor block.
DM=3
Format level-1 and level-2 data.
DP[={0|1|2|3}]
The debugging profiles domain.
DP=0
Suppress formatting of DP control blocks.
DP=1
Format a summary of the DP control blocks.
DP=2
Format the DP control blocks.
DP=3
Format level-1 and level-2 data.
DS[={0|1|2|3}]
The dispatcher domain.
DS=0
Suppress formatting of DS control blocks.
DS=1
Format the dispatcher dump summary.
DS=2
Format the anchor block.
DS=3
Format level-1 and level-2 data.
DU[={0|2}]
The dump domain.
DU=0
Suppress formatting of DU control blocks.
DU=2
Format the DU anchor block.
EJ[={0|1}]
The enterprise Java™ domain.
EJ=0
Suppress formatting of EJ control blocks.
EJ=1
Format the EJ control blocks
EM[={0|1|2}]
The event manager.
EM=0
Suppress formatting of EM control blocks.
EM=1
Format a summary of the active event pools.
EM=2
Format the content of the EM control blocks.
FCP[={0|2}]
The file control program.
FCP=0
Suppress formatting of the file control table.
FCP=2
Format the file control table.
FT[={0|1|2|3}]
The feature domain.
FT=0
Suppress formatting of the feature table.
FT=1
Provide a system dump summary.
FT=2
Provide a dump for the feature table.
FT=3
Provide a summary and dump for the feature table.
ICP[={0|2}]
The interval control program.
ICP=0
Suppress formatting of the interval control elements (ICEs).
ICP=2
Format the ICEs.
II[={0|1|2}]
The IIOP domain.
II=0
Format a summary of the II control blocks.
II=1
Format the contents of the II control blocks
II=2
Format level-0 and level-1 data.
IE[={0|1|2}]
The ECI over TCP/IP domain.
IE=0
Suppress formatting of the IE control blocks.
IE=1
Format a summary of the IE control blocks.
IE=2
Format the content of the IE control blocks.
IND[={0|1|2|3}]
The page number indexes for the formatted output.
IND=0
Suppress formatting of the page number indexes.
IND=1
Provide a control block index sorted by address.
IND=2
Provide a control block index sorted by block name.
IND=3
Format level-1 and level-2 data.
Note:
IPCS does not produce page numbers if formatting directly to the terminal.
JCP [={0|2}]
The journal control area.
JCP=0
Suppress formatting of the JCA.
JCP=2
Format the JCA.
KE[={0|1|2|3}]
The CICS kernel.
KE=0
Suppress formatting of the kernel control blocks.
KE=1
Format the stack and a summary of tasks.
KE=2
Format the anchor block.
KE=3
Format level-1 and level-2 data.
LD[={0|1|2|3}]
The loader domain.
LD=0
Suppress formatting of loader domain control blocks.
LD=1
Format a program status and module summary.
LD=2
Format the anchor block, the current program elements (CPEs), and the active program elements (APEs)
LD=3
Format level-1 and level-2 data.
LG[={0|1|2|3}]
The log manager domain.
LG=0
Suppress formatting of log manager domain control blocks.
LG=1
Format the log manager summary.
LG=2
Format all log manager control blocks.
LG=3
Format level-1 and level-2 data.
LM[={0|1|2|3}]
The lock manager domain.
LM=0
Suppress formatting of lock manager domain control blocks.
LM=1
Format the lock status and allocated locks summary.
LM=2
Format the anchor block and quickcells.
LM=3
Format level-1 and level-2 data.
ME[={0|2}]
The message domain.
ME=0
Suppress formatting of the ME anchor block.
ME=2
Format the anchor block.
MN[={0|1|2|3}]
The monitoring domain.
MN=0
Suppress formatting of monitoring domain control blocks.
MN=1
Format the monitoring status and monitoring dictionary summary.
MN=2
Format the anchor block and monitoring control table.
MN=3
Format level-1 and level-2 data.
MRO[={0|2}]
CICS multiregion operation.
MRO=0
Suppress formatting of all MRO control blocks.
MRO=1
Format MRO control block summary
MRO=2
Format MRO control blocks, APPC URDs, and any associated DWE chains.
MRO=3
Format level-1 and level-2 data.
NQ [={0|2}]
The enqueue manager domain.
NQ=0
Suppress formatting of NQ control blocks.
NQ=2
Format NQ control blocks.
OT[={0|1|2}]
The object transaction domain.
OT=0
Suppress formatting of OT control blocks.
OT=1
Format a summary of OT control blocks
OT=2
Format the contents of the OT control blocks
PA[={0|2}]
The parameter manager domain.
PA=0
Suppress formatting of the PA anchor block.
PA=2
Format the PA anchor block.
PCT[={0|2}]
The program control table.
PCT=0
Suppress formatting of the transaction definitions.
PCT=2
Format the transaction definitions.
PG[={0|1|2|3}]
The program manager domain.
PG=0
Suppress formatting of program manager domain control blocks.
PG=1
Format the program manager summary.
PG=2
Format the program manager control blocks, including the anchor block, the LLEs, the PGWEs, the PPTEs, the PLCBs, and the HTBs.
PG=3
Format level-1 and level-2 data.
PR [={0|2}]
Partner resource management.
PR=0
Suppress formatting of PR areas.
PR=2
Format the PR static storage and the partner resource table.
PT [={0|1|2|3}]
The partner domain
PT=0
Suppress formatting of partner domain control blocks.
PT=1
Format summary information.
PT=2
Format all control blocks.
PT=3
Format level-1 and level-2 data.
RD [={0|2}]
Resource definition.
RD=0
Suppress formatting of RD areas.
RD=2
Format the RD recovery and locking blocks.
RM [={0|2}]
The recovery manager domain.
RM=0
Suppress formatting of RM control blocks.
RM=2
Format RM control blocks.
RX [={0|2|3}]
The recoverable resource manaagement services (RRMS) domain.
RX=0
Suppress formatting of RRMS control blocks.
RX=1
Format summary of unit-of-recovery information.
RX=2
Format all RRMS domain storage.
RX=3
Format level-1 and level-2 data.
RZ[={0|1|2}]
The request streams domain.
RZ=0
Suppress formatting of EJ control blocks.
RZ=1
Format a summary of RZ control blocks
RZ=2
Format the contents of the RZ control blocks
RZ=3
Format level-1 and level-2 data.
SH [={0|1|2|3}]
The scheduler services manager domain.
SH=0
Suppress formatting of the scheduler services manager domain control blocks.
SH=1
Format the SH unit of work pending queue (SHPQUEUE), the bound, pending and committed SH request (SHREQUES) summaries.
SH=2
Format the anchor block (SHDMANC), SH unit of work pending queue, (SHPQUEUE), the bound, pending and committed SH requests (SHREQUES).
SH=3
Format level-1 and level-2 data.
SJ[={0|1|2}]
The JVM domain.
SJ=1
Format a summary of SJ control blocks
SJ=2
Format the contents of the SJcontrol blocks
SJ=3
Format level-1 and level-2 data.
SM[={0|1|2|3}]
The storage manager domain.
SM=0
Suppress formatting of storage manager domain control blocks.
SM=1
Format the dynamic storage areas (DSAs), task and domain storage subpools, transaction areas (SMXs), suspend queue, and subspace area (SUA) summaries.
SM=2
Format the anchor block (SMA), subpool control areas (SCAs), pagepool areas (PPAs), pagepool extent areas (PPXs), storage manager transaction areas (SMXs), subspace areas (SUAs), suspend queue elements (SQEs), page allocation maps (PAMs), DSA extent descriptors (DXEs), and DSA extent getmain descriptors (DXGs).
SM=3
Format level-1 and level-2 data.
SSA[={0|2}]
The static storage areas.
SSA=0
Suppress formatting of the static storage areas address list.
SSA=2
Format the static storage areas address list.
SO[={0|1|2|3}]
The socket domain.
SO=0
Suppress formatting of the socket domain control blocks.
SO=1
Format a summary of the socket domain control blocks.
SO=2
Format the contents of the socket domain control blocks in full.
SO=3
Format both the level-1 and level-2 data. Specifying SO is the same as SO=3.
ST[={0|1|2|3}]
The statistics domain.
ST=0
Suppress formatting of statistics domain control blocks.
ST=1
Format statistics collection details.
ST=2
Format the anchor block.
ST=3
Format level-1 and level-2 data.
SZ[={0|1}]
Front end programming interface (FEPI).
SZ=0
Suppress formatting of the FEPI static area.
SZ=1
Format the FEPI static area. Nothing is printed unless you have installed FEPI. See CICS Front End Programming Interface User’s Guide for further information on this feature.
TCP[={0|1|2|3}]
The terminal control program.
TCP=0
Suppress formatting of TCP control blocks.
TCP=1
Format the terminal control summary.
TCP=2
Format the terminal control table, the terminal input/output areas, and the AIDs.
TCP=3
Format level-1 and level-2 data.
TDP[={0|1|2|3}]
The transient data program.
TDP=0
Suppress formatting of transient data control blocks.
TDP=1
Format the summary of transient data destinations.
TDP=2
Format the transient data static storage areas and the multiple strings control blocks (MRCBs).
TDP=3
Format level-1 and level-2 data.
TI[={0|1|2|3}]
The timer domain.
TI=0
Suppress formatting of timer domain control blocks.
TI=1
Format outstanding request details.
TI=2
Format the anchor block.
TI=3
Format level-1 and level-2 data.
TMP[={0|2}]
The table manager program.
TMP=0
Suppress formatting of table manager static storage and control blocks.
TMP=2
Format table manager static storage and control blocks.
TR[={0|1|2|3}
The trace domain.
TR=0
Suppress formatting of trace.
TR=1
Format abbreviated trace.
TR=2
Format full trace.
TR=3
Format level-1 and level-2 data.
TRS[={<trace selectivity parameter(s)>}]
Trace entry selectivity.

This keyword is effective only if the TR keyword value is 1, 2, or 3.

The TRS component keyword allows you to exercise much the same selectivity over the formatting and printing of trace entries written in a trace internal to a system dump, as you may exercise over the formatting and printing of trace entries in an auxiliary trace.

The trace selectivity parameter may be any valid trace selectivity parameter available to DFHTU640 for the formatting of CICS auxiliary trace entries except the parameters PAGESIZE, ABBREV, and FULL. You may, as with DFHTU640, select any number of parameters from those available.

Note, however, that you must use angled brackets around the parameter, or sequence of parameters, that you specify. The format and default values of parameters used to select trace entries from an internal SDUMP trace, are the same as those that apply when you use DFHTU640 to format auxiliary trace entries.

TS[={0|1|2|3}]
Temporary storage domain.
TS=0
Suppress formatting of temporary storage control blocks.
TS=1
Format a summary of temporary storage control blocks and temporary storage control block checking.
TS=2
Format temporary storage control blocks.
TS=3
Format level-1 and level-2 data.
You can also specify the options for TS with angled brackets, for:
TS=<1>
Summary
TS=<2>
Format control blocks
TS=<3>
Consistency checking of the TS buffers with the TS control blocks
You can specify more than one of these values between angled brackets. For example, TS=<1,2> gives summary and formatting of control blocks without consistency checking.
UEH[={0|2}]
The user exit handler.
UEH=0
Suppress formatting of control blocks.
UEH=2
Format control blocks.
US[={0|1|2|3}]
The user domain.
US=0
Suppress formatting of user domain control blocks.
US=1
Format the user domain summary.
US=2
Format the control blocks.
US=3
Format level-1 and level-2 data.
WB[={0|1|2}]
The web interface.
WB=0
Suppress formatting of web interface control blocks.
WB=1
Format the web interface summary. This displays the current state of the CICS web interface, followed by a summary of the state blocks controlled by the state manager.
WB=2
Format the control blocks. This displays the current state of the CICS web interface, followed by the web anchor block, the global work area and associated control blocks, and the web state manager control blocks.
XM[={0|1|2|3}]
The transaction manager.
XM=0
Suppress formatting of transaction manager control blocks.
XM=1
Format the domain summary, global state summary, transaction summary, transaction class summary, and MXT summary.
XM=2
Format the control blocks including the transaction domain anchor block, transactions (TXn), and transaction class control blocks (TCL).
XM=3
Format level-1 and level-2 data.
XRF[={0|2}]
The extended recovery facility.
XRF=0
Suppress formatting of control blocks.
XRF=2
Format control blocks.
XS[={0|2}]
The security domain.
XS=0
Suppress formatting of anchor block and supervisor storage.
XS=2
Format anchor block and supervisor storage.

For a more detailed list of the contents of SDUMPs for each of the VERBEXIT keywords, see Appendix A. SDUMP contents and IPCS CICS VERBEXIT keywords.

The default SDUMP formatting levels

The DEF dump exit parameter specifies the default level of formatting you want for data from the dump data set. Note that the DEF parameter is only effective for components that are not included in a list of component keywords.

The levels that you can specify are as follows:

Level
Meaning
0
For those components not included in a specified list of keywords, suppress all component formatting. Note that if you specify DEF=0, but do not specify any component keywords, you still get the dump summary and, if appropriate, the error message index.
1
For those components not included in a specified list of keywords, and where applicable, format the summary information only. (A summary is not available for all components; see the level numbers available for the individual keywords for those for which a summary of dump information is available.)
2
For those components not included in a specified list of keywords, format the control block information only.
3
For those components not included in a specified list of keywords, format the control block information and also (where applicable) the summary information.

Effects of omitting the DEF parameter

Exceptions to the scope of the DEF parameter

There are two parts of a CICS system dump that are not governed by component keywords, and are therefore outside the scope of the DEF parameter. These are:

  1. The dump summary
  2. The error message index.

These parts of a CICS system dump are always formatted, even if you specify DEF=0 and no component keywords.

Related Concepts
Dump utility program (DFHDU630)
Where dumps are written
Events that can cause dumps to be taken
The dump code options you can specify

Related Tasks
Enabling system dumps for some CICS messages

Related References
The system dump table
[[ Contents Previous Page | Next Page Index ]]