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 for information about using dumps.

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 Working with displays in CEMT).
Use the CEMT SET TRDUMPCODE command.

(value): A 4-byte transaction dump code.
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(              )
   Installtime(19/07/22  09:01:00)
   Installuserid(userid)
   Installagent(Csdapi)
   Definesource(TEMP)
   Definetime(19/07/22  09:02:00)
   Changetime(19/07/22  09:04:00)
   Changeusrid(userid)
   Changeagent(Csdapi)
   Changeagrel(0730)

CEMT INQUIRE TRDUMPCODE

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.

CHANGEAGENT(value)

Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DYNAMIC: The resource was last changed by a SET TRANDUMPCODE command.
OVERRIDE: The resource definition was last changed by application of an override rule in the resource overrides file.
SYSTEM: The resource definition was last changed by CICS.

CHANGEAGREL(value)

Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(date time)

Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

CHANGEUSRID(value)

Displays the 8-character user ID that ran the change agent.

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.

DEFINESOURCE(value)

Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.

DEFINETIME(date time)

Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

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.

INSTALLAGENT(value)

Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

AUTOINSTALL: The resource was autoinstalled.
CREATESPI: The resource was installed by an EXEC CICS CREATE command.
CSDAPI: The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
DYNAMIC: The resource was installed by a SET TRANDUMPCODE ADD command.
GRPLIST: The resource was installed by GRPLIST INSTALL.
SYSTEM: The resource was installed by CICS.

INSTALLTIME(date time)

Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLUSRID(value)

Displays the 8-character user ID that installed the resource.

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.