DISCARD TRANSACTION
Remove a transaction definition.
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.
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.
- 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.