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.
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 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 CICS640
dump exit enables you to process a CICS Transaction Server for z/OS, Version 3 Release 1 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 CICS640 '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.
For guidance about using the formatting keywords and levels, see CICS Operations and Utilities Guide.
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 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
- If you omit the DEF parameter and do not specify any
component keywords, the result is as if you specified DEF=3.
- If you omit the DEF parameter and specify one or more
component keywords, the result is as if you specified DEF=0.
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:
- The dump summary
- The error message index.
These parts of a CICS system dump are always formatted, even if
you specify DEF=0 and no component keywords.
[[ Contents Previous Page | Next Page Index ]]