FORCE TIMER
Force the early expiry of a BTS timer.
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
- 16 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.
- 115 TIMERERR
- RESP2
values:
- 13
- The timer named on the TIMER option does not exist.