Reset a BTS activity to its initial state.
RESET ACTIVITY
>>-RESET--ACTIVITY(data-value)---------------------------------><
Conditions: ACTIVITYBUSY, ACTIVITYERR, INVREQ, IOERR,
LOCKED, NOTAUTH
Description
RESET ACTIVITY resets a BTS child activity to its initial state. Its completion
event is added to the parent's event pool, with the fired status set to
NOTFIRED. If the activity has children of its own, they are deleted.
Note: RESET has no effect on the contents of the activity's
data containers, which are unchanged.
Issue this command, before a second RUN command, when an activity needs
to be retried. When the activity is re-run, it is sent a DFHINITIAL event.
To be eligible to be reset, an activity must:
- Be a child of the activity that issues the RESET command.
- Be in one of the following modes:
- COMPLETE. This is the usual case. Perhaps the activity has completed abnormally,
and needs to be reset before being retried.
- INITIAL. The activity has not yet been run.
Options
- ACTIVITY(data-value)
- specifies the name (1–16 characters) of the activity to be reset.
This must be a child of the current activity.
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 in the ACTIVITY option is not a child of the current
activity.
- 14
- The activity to be reset is not in COMPLETE or INITIAL mode.
- 16 INVREQ
- RESP2 values:
- 4
- The RESET 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.
- 70 NOTAUTH
- RESP2 values:
- 101
- The user associated with the issuing task is not authorized to reset
the activity.