INQUIRE TRANDUMPCODE

Retrieve information about a transaction dump code.

Read syntax diagramSkip visual syntax diagramINQUIRE TRANDUMPCODE
 
>>-INQUIRE TRANDUMPCODE(data-value)----------------------------->
 
   .------------------------.
   V                        |
>----+--------------------+-+----------------------------------><
     +-CURRENT(data-area)-+
     +-DUMPSCOPE(cvda)----+
     +-MAXIMUM(data-area)-+
     +-SHUTOPTION(cvda)---+
     +-SYSDUMPING(cvda)---+
     '-TRANDUMPING(cvda)--'
 

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

The INQUIRE TRANDUMPCODE command allows you to look at some of the information in the transaction dump table entry for a particular transaction dump code.

The table entry tells CICS what actions to take when a transaction dump request with this code is received. Possible actions are: taking a transaction dump, taking a system dump (an MVS SDUMP), forwarding an SDUMP request to related MVS images, and shutting down CICS. The table entry also indicates how many times this set of actions is to be taken (the MAXIMUM option), and the number of requests received after the maximum are counted (the CURRENT option), but otherwise ignored.

CICS provides a transaction dump table with default actions for CICS transaction abend codes (those beginning with the letter A). These can be changed and others can be added with the SET TRANSDUMPCODE command or the CEMT transaction; such changes are preserved over executions of CICS, until an initial or cold start occurs.

CICS builds table entries, using default values, when it receives a dump request with a code for which it does not have an entry. You can also add your own entries with the SET TRANDUMPCODE command or a CEMT transaction.

Entries you add remain over executions of CICS until an initial or cold start occurs, but the entries CICS builds are considered temporary and are discarded at shutdown.

Consequently, if you enquire about a code that is not explicitly defined before it appears in a dump request, you get a "not found" response.

Browsing

You can also browse through all of the entries in the transaction dump table by using the browse options (START, NEXT, and END) on INQUIRE TRANDUMPCODE commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

CURRENT(data-area)
returns a fullword binary field giving the number of dump requests with this dump code made since the count was last reset. (The count is reset automatically at CICS shutdown and can be reset explicitly with a SET SYSDUMPCODE RESET command or its CEMT equivalent.) The count 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.
DUMPSCOPE(cvda)
returns a CVDA value indicating whether a request for a dump with this dump code should cause an SDUMP (system dump) request to be sent to related MVS images.

A related image is one which contains a CICS region doing work on behalf of the task that caused the dump request-specifically, a region that has a task doing work under the same APPC token as the task causing the dump.

The sending of SDUMP requests occurs only when the table entry for this code specifies a system dump (that is, the SYSDUMPING value is SYSDUMP), and only in a sysplex environment executing under MVS/ESA 5.1 and the MVS workload manager.

CVDA values are:

LOCAL
SDUMP requests are not to be sent.
RELATED
SDUMP requests are to be sent.
MAXIMUM(data-area)
returns a fullword binary field giving the maximum number of times CICS will take the set of actions indicated in the transaction dump table entry when a dump request with this code is received. A value of 999 means the default, ‘no limit’.
SHUTOPTION(cvda)
returns a CVDA value indicating whether the CICS system is to be shut down after a request for a dump with this dump code. CVDA values are:
NOSHUTDOWN
The CICS system is not to shut down.
SHUTDOWN
The CICS system is to shut down.
SYSDUMPING(cvda)
returns a CVDA value indicating whether a system dump should be taken when a transaction dump request with this code is received. Even when the dump table entry specifies a system dump, however, one is taken only when the CURRENT value is no greater than the MAXIMUM, and system dumps are not suppressed system-wide (see the DUMPING option in the INQUIRE SYSTEM command). CVDA values are:
NOSYSDUMP
A system dump is not to be taken.
SYSDUMP
A system dump is to be taken.
TRANDUMPCODE(data-value)
specifies the 4-character transaction dump code about which you are inquiring. A valid transaction dump code has no leading or imbedded blanks.
TRANDUMPING(cvda)
returns a CVDA value indicating whether a transaction dump should be taken when a transaction dump request with this code is received. Even when the dump table entry specifies a transaction dump, however, one is taken only when the CURRENT value is no greater than the MAXIMUM. CVDA values are:
NOTRANDUMP
The transaction dump is to be suppressed.
TRANDUMP
The transaction dump is to be taken.

Conditions

END
RESP2 values:
2
There are no more resource definitions of this type.
ILLOGIC
RESP2 values:
1
You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
NOTFND
RESP2 values:
1
The dump code cannot be found.
[[ Contents Previous Page | Next Page Index ]]