DISCARD TRANSACTION
Remove a transaction definition.
DISCARD TRANSACTION >>-DISCARD 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 transactions supplied by CICS (names that start with the letter C), transactions defined by the CICS system initialization table (for example, paging transactions), 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).
- 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.
