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.
