RESET ACTIVITY

Reset a BTS activity to its initial state.

RESET ACTIVITY

Read syntax diagramSkip visual syntax diagramRESETACTIVITY( 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:
  1. Be a child of the activity that issues the RESET command.
  2. 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.