DUMP - IBM Mainframe

The DUMP command generates a transaction dump. The command can be used to dump all, a series, or any single main storage area related to a task. It can dump any one or all of the CICS tables. (DCT, FCT, PCT, PPT, SIT, or TCT) A transaction dump is automatically generated on a program check, and is the default for most exceptional conditions except where a HANDLE CONDITION is specified unless the ERROR option is specified.

Note that if you issue a DUMP TRANSACTION for a DUMPCODE that is defined in the transaction dump table with SYSDUMP, you also get a system dump. If the DUMPCODE entry is missing the system dump table then a temporary entry is inserted into the table, which is then deleted on the next CICS startup. Caution should be used when taking a system dump, because the entire CICS regions suspend all transaction processing while the system dump is processing. The syntax of the command is given below:

DUMP

DUMP

The various options of the DUMP command are:

  • COMPLETE - Includes in the dump the following: all CICS tables, all main storage areas relating to the task, and any DL/I control blocks relating to the task.
  • DUMPCODE (name) - Alphanumeric field (1-4 characters) identifying the name of the dump, the name cannot contain any leading or imbedded blanks. If all options except DUMPCODE are omitted, then the dump produced is the equivalent to specifying TASK, but without the DL/I control blocks.
  • DUMPID (dataarea) - A CICS number returned which identifies the particular dump.
  • FLENOTH (datavalue) - Fullword binary value that specifies the length of the storage area (specified in the FROM option) that is to be dumped. The maximum size in length that can be specified is 16,777,215 bytes. FLENGTH and LENGTH are mutually exclusive in the same command.
  • FROM (dataarea) - The valid specified data_area is dumped. (Valid storage is allocated within the CICS region allocated by the operating system). Additionally, the following areas are also dumped:
    1. Task control area (TCA), and the transaction work area (TWA), where applicable.
    2. Common system area (CSA), which includes the user's portion of the CSA common work area (CWA)
    3. Internal trace table entries, which is relate to the task when the CICS trace facility, is active. (This assumes the trace table is large enough to contain all entries for the duration of the task before the table wraps around and starts reusing the entries again)
    4. Terminal Control Table Terminal Entry (TCTTE) or the destination control table entry associated with the requesting task. If the TCTTE is dumped, and if either or both the terminal control table user area (TCTUA) and the message control blocks are found and are associated with the TCTTE then they are dumped. The message control blocks are used by basic mapping support.
  • LENGTH (data_value) - Halfword binary field specifying the length of the data area in the FROM option. The safe upper limit value is 24KB. FLENGTH and LENGTH are mutually exclusive in the same command.
  • LENGTHLIST (data_area) - Contains the list of values, which correspond to the lengths of the storage areas to be dumped which correlate to the segments specified. The SECMENTLIST and NUMSECMENTS options must be used in conjunction with this option.
  • NUMSEGMENTS (dataarea) - Fullword binary field containing the number of areas to be dumped.
  • PROGRAM - The following program storage areas related to the task are dumped:
    1. Task control area (TCA), and the transaction work area (TWA) where applicable.
    2. Common system area (CSA), which includes the user's portion of the CSA common work area (CWA)
    3. Internal trace table entries, which relate to the task when the CICS trace facility, is active. (This assumes the trace table is large enough to contain all entries for the duration of the task before the table wraps around and starts reusing the entries again)
    4. All program storage areas containing user-written application programs active on behalf of the requesting task
    5. Register save areas (RSAs) indicated by the RSA chain off the TCA
    6. General purpose registers contents at the point in time when the requesting task enters dump control.
    7. Terminal Control Table Terminal Entry (TCTTE) or the destination control table entry associated with the requesting task. If the TCTTE is dumped, and if either or both the terminal control table user area (TCTUA) and the message control blocks are found and are associated with the TCTTE then they are dumped. The message control blocks are used by basic mapping support.
  • SEGMENTLIST (data-value) - Address list containing the starting points of all the segments to be dumped. Each individual segment is a task related storage area. The NUMSECMENTS and LENCTHLIST options must be used in conjunction with this option.
  • STORAGE - Specifies that storage areas associated with this task are to be dumped, as follows:
    1. Task control area (TCA), and the transaction work area (TWA) where applicable.
    2. Common system area (CSA), which includes the user's portion of the CSA common work area (CWA)
    3. Internal trace table entries, which relate to the task when the CICS trace facility, is active. (This assumes the trace table is large enough to contain all entries for the duration of the task before the table wraps around and starts reusing the entries again)
    4. All transaction storage areas
    5. Terminal Control Table Terminal Entry (TCTTE) or the destination control table entry associated with the requesting task. If the TCTTE is dumped, and if either or both the terminal control table user area (TCTUA) and the message control blocks are found and are associated with the TCTTE then they are dumped. The message control blocks are used by basic mapping support.
  • TASK - Specifies that storage areas associated with this task are to be dumped, as follows:
  • TERMINAL - Specifies that storage areas associated with this terminal are to be dumped, as follows:
    1. Task control area (TCA), and the transaction work area (TWA) where applicable.
    2. Common system area (CSA), which includes the user's portion of the CSA common work area (CWA)
    3. Internal trace table entries, which relate to the task when the CICS trace facility, is active. (This assumes the trance table is large enough to contain all entries for the duration of the task before the table wraps around and starts reusing the entries again)
    4. Terminal Control Table Terminal Entry (TCTTE) or the destination control table entry associated with the requesting task. If the TCTTE is dumped, and if either or both the terminal control table user area (TCTUA) and the message control blocks are found and are associated with the TCTTE then they are dumped. The message control blocks are used by basic mapping support.
    5. All terminal input/output areas (TIOAs) chained off the Terminal Control Table Terminal Entry (TCTTE) for the terminal associated with the requesting task
  • TRT - The internal trace table entries for the related task is dumped.
  • TABLES - The following tables are dumped DCT, FCT, PCT, PPT, SIT, and the TCT.
  • DCT - Destination control table is dumped.
  • FCT - File control table is dumped.
  • PCT - Program control table is dumped.
  • PPT - Processing program table is dumped.
  • SIT - System initialization table is dumped.
  • TCT - Terminal control table is dumped. Handle Conditions:
  • INVREQ - Incorrect DUMPCODE entered. DUMPCODE cannot contain any leading or imbedded blanks.
  • IOERR - Occurs for one of the following reasons:
    1. Unauthorized SDUMP process.
    2. Error occurred during system dumping.
  • NOSPACE - Transaction dump incomplete due to a lack of space.
  • NOSTC - CICS ran out of working storage.
  • NOTOPEN - CICS dump routine is not currently open.
  • OPENERR - Error occurred" on the opening, closing, or writing to the current CICS dump routine.
  • SUPPRESSED - Occurs for one of the following reasons:
    1. Transaction dump is suppressed by MAXIMUM in table
    2. Transaction dump is suppressed by NOTRANDUMP in table
    3. Transaction dump is suppressed by a user exit program

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics