RESET ACTIVITY
Reset a BTS activity to its initial state.
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.