Delete a BTS child activity.

DELETE
>>-DELETE--ACTIVITY(data-value)--------------------------------><
Conditions: ACTIVITYBUSY, ACTIVITYERR, INVREQ, IOERR,
LOCKED
Description
DELETE ACTIVITY removes a child activity from the BTS repository data
set on which it is defined. The child activity's completion event is removed
from the parent's event pool. Any descendants of the child activity are
also deleted.
The activity to be deleted must be a child of the activity that issues
the DELETE command. To be eligible for deletion, the child activity must be
in one of the following processing states (modes):
- COMPLETE—completed normally, abnormally, or previously canceled.
- INITIAL—not yet run, or reset by means of a RESET ACTIVITY command.
For a description of all possible processing states, see the CICS® Business Transaction Services manual.
Note: A child activity that is not deleted explicitly by means of
a DELETE ACTIVITY command is deleted automatically by CICS when its parent
completes.
Options
- ACTIVITY(data-value)
- specifies the name (1–16 characters) of the child activity to
be deleted.
Conditions
- ACTIVITYBUSY
- RESP2 values:
- 19
- The request timed out. It may be that another task using this activity-record
has been prevented from ending.
- ACTIVITYERR
- RESP2 values:
- 8
- The activity named on the ACTIVITY option could not be found.
- 14
- The child activity named on the ACTIVITY option is not in COMPLETE or
INITIAL mode, and is therefore ineligible for deletion.
- INVREQ
- RESP2 values:
- 4
- The DELETE ACTIVITY command was issued outside the scope of a currently-active
activity.
- IOERR
- RESP2 values:
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- LOCKED
- The request cannot be performed because a retained lock exists against
the relevant record on the repository file.