DISCARD TRANSACTION

Remove a transaction definition.

Read syntax diagramSkip visual syntax diagramDISCARD TRANSACTION
 
>>-DISCARD TRANSACTION(data-value)-----------------------------><
 

Conditions: INVREQ, NOTAUTH, TRANSIDERR

Description

The DISCARD TRANSACTION command removes the definition of a transaction from the local CICS system. That is, it revokes the earlier installation of a TRANSACTION resource definition of the same name.

You cannot delete transactions supplied by CICS (names beginning with the letter C), transactions defined by the CICS system initialization table (paging transactions, for example), or transactions that are scheduled to execute at a future time or when required resources are available. Transactions already in flight are not affected; they continue to execute under the definition in force at the time they were attached.

See Discarding resource definitions for general information about discards.

Options

TRANSACTION(data-value)
specifies the 4-character name of the transaction that is to be removed.

Conditions

INVREQ
RESP2 values:
4
The transaction cannot be discarded because its name begins with C.
13
The transaction is defined in the SIT.
14
The transaction is scheduled to run at a future time (in use by an interval control element).
15
The transaction is scheduled to run when required resources are available (in use by an automatic initiate descriptor).
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
TRANSIDERR
RESP2 values:
1
The transaction cannot be found.
[[ Contents Previous Page | Next Page Index ]]