DELETE ACTIVITY
Delete a BTS child activity.
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 Processing modes .
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
- 107 ACTIVITYBUSY
- RESP2
values:
- 19
- The request timed out. It may be that another task using this activity-record has been prevented from ending.
- 109 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.
- 16 INVREQ
- RESP2
values:
- 4
- The DELETE ACTIVITY command was issued outside the scope of a currently-active activity.
- 17 IOERR
- RESP2
values:
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- 100 LOCKED
- The request cannot be performed because a retained lock exists against the relevant record on the repository file.