CEMT INQUIRE TRDUMPCODE

Retrieve information about transaction dump codes.

Description

The INQUIRE TRDUMPCODE command shows the current settings of the entries in the transaction dump table. See Using dumps in problem determination.

Note: Do not use both the SHUTDOWN and MAXIMUM options in the same command.

This command returns entries that were added to the dump table by a user application program or CEMT command, and also entries that CICS® added to the dump table through dump requests. Be aware that the entries that CICS added to the dump table are temporary, and they are not restored during a warm start, or during a cold or initial start. Entries added by a user application program or CEMT command are restored during a warm start, but not during a cold or initial start.

Input

Press the Clear key to clear the screen. You can start this transaction in two ways:
  • Type CEMT INQUIRE TRDUMPCODE (or suitable abbreviations for the keywords). The resulting display lists the current status.
  • Type CEMT INQUIRE TRDUMPCODE (or suitable abbreviations for the keywords), followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i trd sy sh, the resulting display shows the details of only those transaction dump codes for which system dumps are taken and for which the CICS system shuts down.
you can change various attributes in the following ways:
  • Overtype your changes on the INQUIRE screen after tabbing to the appropriate field (see Overtyping a display).
  • Use the CEMT SET TRDUMPCODE command.
(value)
A 4-byte transaction dump code. See CICS Messages and Codes Vol 1 for information on transaction dump codes.
ALL
The default.

Sample screen

Figure 1. CEMT INQUIRE TRDUMPCODE screen
 IN TRDU
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Trd(ATNI) Tra         Loc Max( 999 ) Cur(0002)
  Trd(ERRS) Tra         Loc Max( 999 ) Cur(0001)
Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against a specific entry in the list and press ENTER, CICS displays an expanded format as shown in Figure 2.

Figure 2. The expanded display of an individual entry
 IN TRDU
 RESULT - OVERTYPE TO MODIFY
   Trdumpcode(ATNI)
   Trandumping( Trandump )
   Sysdumping( Nosysdump )
   Shutoption( Noshutdown )
   Dumpscope( Local )
   Maximum( 999 )
   Current(0002)
   Action(              )

CEMT INQUIRE TRDUMPCODE

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE TRDUMPCODE ALL( value)RESETRMOVEADDTRANDUMPNOTRANDUMPSYSDUMPNOSYSDUMPSHUTDOWNNOSHUTDOWNDUMPSCOPERELATEDLOCALMAXIMUM( value)CURRENT( value)

Displayed fields

ACTION (input only field)
Displays whether the specified transaction dump code is reset, removed from the dump code table, or added to the dump code table. The values are as follows:
RESET
Reset the current count of dump calls for this dump code to zero.
REMOVE
Remove the specified transaction dump code from the dump code table.
ADD
Add the specified transaction dump code to the dump code table.
CURRENT(value)
Displays the number of dump calls that have been made for this transaction dump code since the number was last reset to zero. The value of CURRENT is limited to four characters; if there were more than 9999 dump calls for this transaction dump code since it was last reset, CURRENT contains only the four least-significant figures of the value.
The CURRENT value can be reset explicitly by using a SET SYDUMPCODE RESET command, or automatically when CICS shuts down.

You can reset this value by overtyping it with a different value.

DUMPSCOPE
Displays whether a system dump request is sent to MVS™ images in the sysplex that are running XCF/MRO connected CICS regions related to the CICS region on which the dump is initiated.
Note: A related CICS region is one in which the unit of work identifiers, in the form of APPC tokens, of one or more tasks match those in the CICS region that issued the dump request.
RELATED
A system dump request is sent to other MVS images in the sysplex for this system dump code.
LOCAL
A system dump request is not sent to other MVS images in the sysplex for this system dump code.

You can reset this value by overtyping it with a different value.

MAXIMUM(value)
Displays the largest number of dump calls for this dump code that result in dumps being produced. The value is in the range 0 - 999 and can be specified by using TRDUMAX in the SIT parameter. A value of 999 means the default, no limit.
SHUTOPTION
Displays whether the CICS system shuts down after an error that corresponds to this dump code occurs. The values are as follows:
SHUTDOWN
The CICS system shuts down.
NOSHUTDOWN
The CICS system does not shut down.

You can reset this value by overtyping it with a different value.

SYSDUMPING
Displays whether a system dump is produced for this transaction dump code. The values are as follows:
SYSDUMP
Produce a system dump.
NOSYSDUMP
Do not produce a system dump.

You can reset this value by overtyping it with a different value.

TRANDUMPING
Displays whether a transaction dump is produced for this transaction dump code. The values are as follows:
TRANDUMP
Produce a transaction dump.
NOTRANDUMP
Do not produce a transaction dump.

You can reset this value by overtyping it with a different value.

TRDUMPCODE(value)
Indicates that this panel relates to a TRDUMPCODE inquiry and displays a 4-character transaction dump code. See CICS Messages and Codes Vol 1 for information on transaction dump codes.