DISCARD TRANSACTION

Remove a transaction definition.

DISCARD TRANSACTION

Read syntax diagramSkip visual syntax diagramDISCARD TRANSACTION( data-value)

Conditions: INVREQ, NOTAUTH, TRANSIDERR

This command is threadsafe.

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 the following transactions:
  • CICS-supplied transactions, which have names that start with the letter C and have an initial program name starting with DFH, EYU, or CJx (where x is A through J)
  • Transactions defined by the CICS system initialization table (for example, paging transactions)
  • 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.

Note: You cannot directly discard a TRANSACTION resource that is created by a BUNDLE resource. An INVREQ with a RESP2 value of 300 is issued if you attempt to do so. To discard such a transaction, you must use the bundle resource.

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 and the transaction has an initial program with a name beginning with DFH, EYU, or CJx (where x is A through J).
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).
300
A DISCARD TRANSACTION SPI command was issued against a TRANSACTION resource that was installed through a CICS bundle (BUNDLE).
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.