DUMP= Producing Dumps

DBOC: Controlling Local Resources with Operational Commands › DUMP= Producing Dumps

DUMP= Producing Dumps

Reviewing dumps often aids in debugging a problem. Use this transaction to dump a CA Datacom CICS Services module, a URT, or a control table into a CICS dump data set with the following transaction:

                    ┌──,────┐
►►─ DBOC ─ DUMP= ─┬─▼─ urt ─┴─────┬───────────────────────────────────────────►◄
                  ├─ modname ─────┤
                  └─ control-tbl ─┘

Note: The DBOC DUMP= command is not available from the console.

DBOC

(Required) Specify the transaction ID used with Operational commands to control system resources. Leave a space between the transaction ID and the command.

DUMP=

(Required) Specifies to produce a dump.

urt

Specify one or more URTs by the four-digit suffix, with or without leading zeros, where the range of valid values is 0001 to the active MAXURTS= value. Use the wildcard symbol (?) to accept any valid value between 0 and 9 for any (or all) of the digits. To specify a series, separate the identifiers with commas.

Example	Description
1	URT 0001
?,20	URTs 0001 through 0009, and 0020
?,1?,2?,30	URTs 0001 through 0030
??	URTs 0001 through 0099
1??,20?,21?	URTs 100 through 219
????	All valid URTs

modname

Designates the name of the module on which CA Datacom CICS Services is to act. Valid entries include: ???????? (all CA Datacom CICS Services modules plus the CA Datacom/DB modules DBSGMPR and DBINRPR, URTs, TCBs, DEBUG criteria, and the trace table) and the CA Datacom CICS Services modules

Note: If you use the command DBOC DUMP=????????, it is important to understand that your dump dataset in CICS/TS is defined in a way that can handle all the dumps that are produced, with the appropriate formatting required by CICS/TS. The code modules are approximately 32K. The TCBS could be 17M at the maximum USERS of 255. URT modules could be significant with the increase to 9999 modules, depending on the tables defined. DEBUG can be approximated at around 600 bytes. TRACE (80 bytes each) is user-defined.

control-tbl

Designates the name of the control table on which CA Datacom CICS Services is to act. Valid entries:

TCBS: Internal TCB storage
DBUG: Debugging intercept criteria storage
TRACE: Internal trace entries