SET TRANDUMPCODE

Change an entry in the transaction dump table.

Read syntax diagramSkip visual syntax diagramSET TRANDUMPCODE
 
>>-SET TRANDUMPCODE(data-value)--+--------------+--------------->
                                 +-ACTION(cvda)-+
                                 +-ADD----------+
                                 +-REMOVE-------+
                                 '-RESET--------'
 
>--+-----------------+--+---------------------+----------------->
   +-DUMPSCOPE(cvda)-+  '-MAXIMUM(data-value)-'
   +-LOCAL-----------+
   '-RELATED---------'
 
>--+------------------+--+------------------+------------------->
   +-SHUTOPTION(cvda)-+  +-SYSDUMPING(cvda)-+
   +-NOSHUTDOWN-------+  +-NOSYSDUMP--------+
   '-SHUTDOWN---------'  '-SYSDUMP----------'
 
>--+-------------------+---------------------------------------><
   +-TRANDUMPING(cvda)-+
   +-NOTRANDUMP--------+
   '-TRANDUMP----------'
 

Conditions: DUPREC, INVREQ, IOERR, NOSPACE,
NOTAUTH, NOTFND

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

Description

The SET TRANDUMPCODE command allows you to change the transaction dump table entry for a particular dump code, to add a new dump code to the table, or to delete one.

The table entry tells CICS the actions to take when a transaction dump request with this code is received. Possible actions include taking a transaction dump, taking a system dump (an MVS SDUMP), initiating requests for SDUMPs of related CICS regions, and shutting down CICS. The table entry also indicates how many times this set of actions is to be taken (the MAXIMUM value); after the maximum is reached, requests are counted but otherwise ignored.

Table updates are recorded in the CICS global catalog and preserved over executions of CICS until an initial or cold start occurs, except in the case of temporary table entries. CICS creates a temporary entry when it receives a dump request with a code for which there is no table entry; these entries, and any changes to them, last only for the current execution of CICS. If you want preserve changes to a temporary entry over restarts, you need to remove the dump code from the table and then add it back.

For information about transaction dumps, see the CICS® Problem Determination Guide.

Options

ACTION(cvda)
specifies the action to be taken for the dump code. CVDA values are:
ADD
An entry for this code is to be added to the table.
REMOVE
The entry for this code is to be removed from the table. No other options can be specified on a REMOVE request.
RESET
The current number of dump requests for this dump code is to be set to zero. (See the CURRENT option of the INQUIRE TRANDUMPCODE command.)
DUMPSCOPE(cvda)
specifies whether a request for a dump with this dump code should cause CICS to initiate requests for SDUMPs (system dumps) of "related" CICS regions.

A related CICS region is one in the same sysplex, connected by MRO/XCF and 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 this task.

This propagation of SDUMP requests occurs only when the table entry for this code also specifies a SYSDUMPING value of SYSDUMP, and only in a sysplex environment executing under MVS/ESA 5.1 and the MVS workload manager. In other systems, specifying RELATED causes an exception condition.

CVDA values are:

LOCAL
SDUMP requests are not to be sent.
RELATED
SDUMP requests are to be sent.

LOCAL is the default for entries you add, if you do not specify a DUMPSCOPE value.

MAXIMUM(data-value)
specifies, as a fullword binary value, the maximum number of times CICS should take the set of actions indicated in the dump table entry. After the maximum is reached, CICS counts but otherwise ignores dump requests with this code. The valid range is 0-999. A value of 999 means there is no limit, and is the default used if you omit this option from an ADD request.
SHUTOPTION(cvda)
specifies whether the CICS system is to be shut down after a request for a dump with this dump code. CVDA values are:
NOSHUTDOWN
The system is not to be shut down.
SHUTDOWN
The system is to be shut down.

If this option is omitted from an ADD request, NOSHUTDOWN is assumed.

SYSDUMPING(cvda)
specifies whether a system dump (an MVS SDUMP) should be taken when a transaction dump request with this code is received. CVDA values are:
NOSYSDUMP
A system dump is not to be taken.
SYSDUMP
A system dump is to be taken.
Even when SYSDUMP is specified, CICS takes a dump only if the number of requests for this code is less than the MAXIMUM and system dumps are not suppressed globally (see the DUMPING option of the INQUIRE SYSTEM command).

If this option is omitted from an ADD request, NOSYSDUMP is assumed.

TRANDUMPCODE(data-value)
specifies 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.
TRANDUMPING(cvda)
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.

Conditions

DUPREC
RESP2 values:
10
ADD is specified for a dump code already in the transaction dump table.
INVREQ
RESP2 values:
2
ACTION has an invalid CVDA value.
3
TRANDUMPING has an invalid CVDA value.
4
SYSDUMPING has an invalid CVDA value.
5
The MAXIMUM value is out of range.
6
SHUTOPTION has an invalid CVDA value.
7
REMOVE is specified with other options.
9
The dump code is invalid.
13
DUMPSCOPE has an invalid CVDA value.
14
RELATED requires MVS/ESA 5.1.
IOERR
RESP2 values:
11
An error occurred updating the CICS catalog. The entry is changed for the current run, but is not recorded for restarts.
NOSPACE
RESP2 values:
12
The CICS catalog is full. The entry is changed for the current run, but is not recorded for restarts.
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 ]]