FORCE TIMER

Force the early expiry of a BTS timer.

FORCE TIMER

Read syntax diagramSkip visual syntax diagramFORCETIMER( data-value)ACQACTIVITYACQPROCESS

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

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.