Transaction dump codes - TRANDUMP

The CICS transaction dump codes (TRANDUMP) views display information about transaction dump codes for active CICS systems.

Supplied views

To access from the main menu, click:

CICS operations views > CICS region operations views > Transaction dump codes

Table 1. Views in the supplied Transaction dump codes (TRANDUMP) view set
View Notes
Transaction dump codes

EYUSTARTTRANDUMP.ADD

 Display the CICS transaction dump code Add view in order to create a new transaction dump code. Specify the scope, the code, the maximum number of dumps allowed, whether or not you want a CICS system to shut down if it gets an error related to this code, and whether or not you want CICSPlex SM to take a transaction or system dump following an occurrence of this dump code.
Transaction dump codes

EYUSTARTTRANDUMP.DELETE

 Remove the dump code from the transaction dump code table in each CICS system where it is listed.
Transaction dump codes

EYUSTARTTRANDUMP.DETAIL1

 Detailed information about the resource signature.
Transaction dump codes

EYUSTARTTRANDUMP.DETAILED

 Detailed information about a selected transaction dump code.
Transaction dump codes

EYUSTARTTRANDUMP.RESET

 Reset the number of dump calls for the transaction dump code to 0.
Transaction dump codes

EYUSTARTTRANDUMP.SET

 Display the CICS transaction dump code Set view in order to change the attributes of a selected dump code.
Transaction dump codes

EYUSTARTTRANDUMP.TABULAR

 Tabular information about transaction dump codes for active CICS systems.

Actions

Table 2. Actions available for TRANDUMP views
Action Description
ADD Display the CICS transaction dump code Add view in order to create a new transaction dump code. Specify the scope, the code, the maximum number of dumps allowed, whether or not you want a CICS system to shut down if it gets an error related to this code, and whether or not you want CICSPlex SM to take a transaction or system dump following an occurrence of this dump code.
DELETE Remove the dump code from the transaction dump code table in each CICS system where it is listed.
RESET Reset the number of dump calls for the transaction dump code to 0.
SET Display the CICS transaction dump code Set view in order to change the attributes of a selected dump code.

Fields

Table 3. Fields in TRANDUMP views
Field Attribute name Description
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • DYNAMIC - The resource was last changed dynamically.
  • SYSTEM - The resource was last changed by CICS.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
  • OVERRIDE - Resource was last changed by resource overrides.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
Number of dump calls since last reset CURRENT The number of dump calls that have been made for this transaction dump code since the value was last reset to 0. This value can be reset using the INITIALIZE action command.

This also includes requests that do not result in dumps, either because they are suppressed for this code or because the number for this code has reached its maximum.

Note that it is possible for this value to be higher than the value in the Transaction Dumps Taken field, which is reset by CICS end-of-day. If this value was initialized shortly before the end-of-day statistics reset, the number of current dumps could exceed the total number of dumps taken.

Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • DYNAMIC - The resource was installed dynamically.
  • SYSTEM - The resource was installed by CICS.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
Maximum number of dump calls MAXIMUM The maximum number of dump calls for this transaction dump code that result in a dump being taken.

Input Values: 0 - 999 (TRANDUMP only)

Number of system dumps suppressed SDMPSUPP The number of system dumps requested for this transaction dump code (by CICS or a user) that were suppressed by one of the following:
  • a user exit
  • the dump table
  • a global system dump suppression
Number of system dumps taken SDMPTOTL The number of system dumps taken for this transaction dump code since the last CICS end-of-day statistics reset. This number does not include suppressed dumps.
Shutdown option SHUTOPTION Indicates whether the CICS system is to be shut down after a call to this transaction dump code.

Input Values: SHUTDOWN, NOSHUTDOWN

System dump option SYSDUMPING Indicates whether a system dump is to be taken for this transaction dump code.

Input Values: SYSDUMP, NOSYSDUMP

Number of transaction dumps suppressed TDMPSUPP The number of transaction dumps requested for this transaction dump code (by CICS or a user) that were suppressed by one of the following:
  • a user exit
  • the dump table
Number of transaction dumps taken TDMPTOTL The number of transaction dumps taken for this transaction dump code since the last CICS end-of-day statistics reset. This number does not include suppressed dumps.
Transaction dump scope type TDUMPSCOPE Indicates whether SDUMP requests with this transaction dump code are sent to other MVS images in the sysplex. The MVS images would be those that are running XCF/MRO connected CICS systems related to the CICS system that initiated the dump request.
  • LOCAL - SDUMP requests are not sent to related CICS systems.
  • RELATED - SDUMP requests are sent to related CICS systems. The CICS systems must be running under MVS/ESA 5.1 or later with the MVS workload manager.

Input Values: LOCAL, RELATED

Transaction dump code TRANDUMPCODE The 4-character transaction dump code for which the transaction dump table entry is to be changed. A valid transaction dump code has no leading or imbedded blanks.
Transaction dump option TRANDUMPING Specifies whether a transaction dump should be taken when a transaction dump request with this code is received. CVDA values are:
  • NOTRANDUMP - A transaction dump is not to be taken.
  • TRANDUMP - A transaction dump is to be taken.
Even when TRANDUMP is specified, CICS will dump only when the count of requests for this code is no greater than the MAXIMUM. If this option is omitted from an ADD request, TRANDUMP is assumed.