SUSPEND (BTS)

Suspend a BTS process or activity.

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.

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.

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:

16 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.

17 IOERR

RESP2 values:

100 LOCKED

The request cannot be performed because a retained lock exists against the relevant record on the repository file.

108 PROCESSERR

RESP2 values: