Requests a transaction dump.

Sintaxe

Descrição:

DUMP causes a transaction dump that contains the following areas:

• Any or all of the main storage areas that are related to a task (except task-shared storage areas, such as CWA).

  Note:

  To obtain a dump of the CWA storage area, you must first retrieve the address of the CWA storage area by using the ADDRESS command (see ADDRESS for details).
  Then specify the resulting address as the argument to the FROM option of the DUMP command.

• Any or all of the following CICS resource definitions:
• Transient Data Definitions (TDD)
• File Definitions (FD)
• Transaction Definitions (TD)
• Program Definitions (PD)
• Region Definitions (RD)
• Terminal Definitions (WD)
• Communications Definitions (CD)
• User Definitions (UD)

The DUMP command can also dump any specified data area to which the application program has access (see the FROM option below).

For compatibility with IBM mainframe-based CICS, the dump options that are used for TXSeries for Multiplatforms resource definitions have the same names as those that are used for CICS tables elsewhere.

The correspondence between the IBM mainframe-based CICS tables and the TXSeries for Multiplatforms resource definitions is as follows:

Table 21. Correspondence between IBM mainframe-based CICS tables and TXSeries for Multiplatforms resource definitions

For further details about transaction dumps, see the TXSeries for Multiplatforms Problem Determination Guide.

Opções:

You can specify the dump options in any combination; only one copy of each area or set of definitions is dumped, even if you have specified it more than once.

If you omit all the options except DUMPCODE, you get the same dump as if you specified TASK.

COMPLETE
• Dumps all main storage areas that are related to a task (except task-shared storage areas, such as CWA) and all the CICS resource definitions.

DCT
• Dumps the Transient Data Definitions (TDD).

DUMPCODE(name)
• Specifies a name that identifies the dump.
• The name can consist of a maximum of four alphanumeric characters and must not contain any embedded blanks.

FCT
• Dumps the File Definitions (FD).

FLENGTH(data-value)
• Specifies, as a 32-bit binary value, the length of the storage area (specified in the FROM option) that is to be dumped.
• You can specify any value up to 65535.
• FLENGTH and LENGTH are mutually exclusive.

FROM(data-area)
• Dumps the specified data area, which must be storage to which the application program has access.
• In addition, the following areas are dumped:
  • The task control area (TCA) and, if applicable, the transaction work area (TWA)
  • The WD, CD, or TDD that is associated with the requesting task
• Nota:
  • To obtain a dump of the CWA storage area, you must first retrieve the address of the CWA storage area by using the ADDRESS command (see ADDRESS for details).
  • Then specify the resulting address as the argument to the FROM option of the DUMP command.
• Whenever the TD is dumped, the Terminal User Area (if any) is dumped.

LENGTH(data-value)
• Specifies, as a 16-bit binary value, the length of the storage area (specified in the FROM option) that is to be dumped.
• LENGTH and FLENGTH are mutually exclusive.
• See LENGTH for more information about using this option.

PCT
• Dumps the Transaction Definitions (TD).

PPT
• Dumps the Program Definitions (PD).

PROGRAM
• Specifies that program storage areas that are associated with this task are to be dumped, as follows:
  • The task control area (TCA) and, if applicable, the transaction work area (TWA)
  • All program storage areas that contain user-written application programs that are active on behalf of the requesting task
  • The WD, CD, or TDD that is associated with the requesting task
• Whenever the TD is dumped, the Terminal User Area (if any) is dumped.

SIT
• Dumps the Region Definitions (RD).

STORAGE
• Specifies that storage areas that are associated with this task are to be dumped, as follows:
  • The task control area (TCA) and, if applicable, the transaction work area (TWA)
  • All transaction storage areas that are associated with the requesting task
  • The WD, CD, or TDD that is associated with the requesting task
• Whenever the TD is dumped, the Terminal User Area (if any) is dumped.

TABLES
• Dumps all the CICS resource definitions; that is, the TDD, FD, TD, PD, RD, UD, WD, and CD.

TASK
• Specifies that storage areas that are associated with this task are to be dumped, as follows:
  • The task control area (TCA) and, if applicable, the transaction work area (TWA)
  • All program storage areas that contain user-written application programs that are active on behalf of the requesting task
  • All transaction storage areas that are associated with the requesting task
  • The WD, CD, or TDD that is associated with the requesting task
  • Any Terminal Input/Output Area (TIOA) for a terminal that is associated with the requesting task
• Whenever the TD is dumped, the Terminal User Area (if any) is dumped.

TCT
• Dumps the WD and the CD.

TERMINAL
• Specifies that storage areas that are associated with the terminal are to be dumped, as follows:
  • Task Control Area (TCA) and, if applicable, the Transaction Work Area (TWA)
  • Any Terminal Input/Output Area (TIOA) for a terminal that is associated with the requesting task
  • The WD, CD, or TDD that is associated with the requesting task
• Whenever the TD is dumped, the Terminal User Area (if any) is dumped.

Informações relacionadas:

• TXSeries for Multiplatforms Problem Determination Guide
• TXSeries for Multiplatforms Administration Reference