Force the early expiry of a BTS timer.

FORCE TIMER
>>-FORCE--TIMER(data-value)--+-------------+-------------------><
+-ACQACTIVITY-+
'-ACQPROCESS--'
Conditions: INVREQ, TIMERERR
Description
FORCE TIMER forces a BTS timer that has not yet expired to expire immediately.
This causes the event associated with the timer to fire.
If the timer has already expired, the command has no effect.
The activity that owns the timer can be identified:
- Explicitly, by specifying either the ACQPROCESS or ACQACTIVITY option.
- Implicitly, by omitting the ACQPROCESS and ACQACTIVITY options. If these
are omitted, the current activity is implied.
Options
- ACQACTIVITY
- specifies either of the following:
- If the program that issues the command has acquired a process, that the
timer is owned by the root activity of that process.
- Otherwise, that the timer is owned by the activity that the program has
acquired by means of an ACQUIRE ACTIVITYID command.
- ACQPROCESS
- specifies that the timer is owned by the process that the program that
issues the command has acquired in the current unit of work.
- TIMER(data-value)
- specifies the name (1–16 characters) of the timer to be forced.
Conditions
- INVREQ
- RESP2 values:
- 1
- The command was issued outside the scope of a currently-active activity.
- 16
- The ACQPROCESS option was specified, but there is no acquired process.
- 17
- The ACQACTIVITY option was specified, but there is no acquired activity.
- TIMERERR
- RESP2 values:
- 13
- The timer named on the TIMER option does not exist.