CHECK TIMER

Check the status of a BTS timer.

Read syntax diagramSkip visual syntax diagram
CHECK TIMER

>>-CHECK--TIMER(data-value)--STATUS(cvda)----------------------><

Conditions: INVREQ, IOERR, TIMERERR

Description

CHECK TIMER returns the status of a BTS timer. It allows the requestor to discover whether a timer has expired and, if so, whether it expired normally or whether its expiry was forced by means of a FORCE TIMER command.

On return from this command, if the timer has expired its associated event is deleted from the current activity's event pool.

The only timers a program can check are those owned by the current activity.

Options

STATUS(cvda)
indicates the status of the timer. CVDA values are:
EXPIRED
The timer expired normally.

Its associated event is deleted from the current activity's event pool.

FORCED
The timer expired because a FORCE TIMER command was issued against it.

Its associated event is deleted from the current activity's event pool.

UNEXPIRED
The timer has not yet expired.

Its associated event is not deleted from the current activity's event pool.

TIMER(data-value)
specifies the name (1–16 characters) of the timer to be checked.

Conditions

16 INVREQ
RESP2 values:
1
The command was issued outside the scope of a currently-active activity.
17 IOERR
An input/output error has occurred on the repository file.
115 TIMERERR
RESP2 values:
13
The timer specified on the TIMER option does not exist.


dfhp4_checktimer.html | Timestamp icon Last updated: Thursday, 27 June 2019