Reset a BTS process to its initial state.
Description
RESET ACQPROCESS resets the currently-acquired BTS process to its initial state. Any descendant activities of the root activity are deleted.
Note: RESET has no effect on the process containers, nor on the
root activity's containers, the contents of which are unchanged.
Issue this command, before a second RUN command, when a process needs to be retried. When the process is re-run, the root activity is sent a DFHINITIAL event.
To be eligible to be reset, a process must:
- Have been acquired in the current unit of work—that is, it must be the currently-acquired process.
- Be in one of the following modes:
- COMPLETE. This is the usual case. Perhaps the process has completed abnormally, and needs to be reset before being retried.
- INITIAL. The process has not yet been run.
Options
- ACQPROCESS
- specifies that the process that is currently acquired by the requestor is to be reset.
Conditions
- 16 INVREQ
- RESP2 values:
- 15
- The unit of work that issued the request has not acquired a process.
- 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 process.
- 106 PROCESSBUSY
- RESP2 values:
- 13
- The request timed out. It may be that another task using this process-record has been prevented from ending.
- 108 PROCESSERR
- RESP2 values:
- 14
- The process to be reset is not in COMPLETE or INITIAL mode.
