Suspend a BTS process or activity.

SUSPEND (BTS)
>>-SUSPEND--+-ACQACTIVITY ---------+---------------------------><
+-ACQPROCESS-----------+
'-ACTIVITY(data-value)-'
Conditions: ACTIVITYBUSY, ACTIVITYERR, INVREQ, IOERR,
LOCKED, PROCESSERR
Description
SUSPEND (BTS) prevents a BTS process or activity being reattached when
events in its event pool are fired.
The only process a program can suspend is the one that it has acquired
in the current unit of work.
The only activities a program can suspend are as follows:
- If it is running as the activation of an activity, its own child activities.
It can suspend several of its child activities within the same unit of work.
- The activity it has acquired, by means of an ACQUIRE ACTIVITYID command,
in the current unit of work.
To resume a suspended process or activity, a RESUME command must be issued.
Options
- ACQACTIVITY
- specifies that the activity to be suspended is the one that the current unit of work has
acquired by means of an ACQUIRE ACTIVITYID command.
- ACQPROCESS
- specifies that the process that is currently acquired by the requestor
is to be suspended.
- ACTIVITY(data-value)
- specifies the name (1–16 characters) of the child activity to
be suspended.
Conditions
- ACTIVITYBUSY
- RESP2 values:
- 19
- The request timed out. It may be that another task using this activity-record
has been prevented from ending.
- ACTIVITYERR
- RESP2 values:
- 8
- The activity named on the ACTIVITY option could not be found.
- INVREQ
- RESP2 values:
- 4
- The ACTIVITY option was used to name a child activity, but the command
was issued outside the scope of a currently-active activity.
- 14
- The activity is in COMPLETE or CANCELLING mode, and therefore cannot
be suspended.
- 15
- The ACQPROCESS option was used, but the unit of work that issued the request
has not acquired a process.
- 24
- The ACQACTIVITY option was used, but the unit of work that issued the request
has not acquired an activity.
- IOERR
- RESP2 values:
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- LOCKED
- The request cannot be performed because a retained lock exists against
the relevant record on the repository file.
- PROCESSERR
- RESP2 values:
- 5
- The process could not be found.