Retrieve the attributes of a BTS event.
INQUIRE EVENT
>>-INQUIRE--EVENT(data-value)--+------------------------+------->
'-ACTIVITYID(data-value)-'
>--+-----------------+--+------------------+-------------------->
'-EVENTTYPE(cvda)-' '-FIRESTATUS(cvda)-'
>--+----------------------+--+-----------------+---------------->
'-COMPOSITE(data-area)-' '-PREDICATE(cvda)-'
>--+------------------+----------------------------------------><
'-TIMER(data-area)-'
Conditions: ACTIVITYERR, EVENTERR, INVREQ, IOERR,
NOTAUTH
Description
INQUIRE EVENT returns the attributes of a named BTS event.
To inquire upon an event associated with the current activity, omit the
ACTIVITYID option. To inquire upon an event associated with another activity,
specify the ACTIVITYID option. (The activity identifier specified on the ACTIVITYID
option may, for example, have been returned on a GETNEXT ACTIVITY command
during a browse operation.)
Options
- ACTIVITYID(data-value)
- specifies the identifier (1–52 characters) of the activity which
the event is associated with.
If this option is omitted, the current activity
is assumed.
- COMPOSITE(data-area)
- returns, if the named event is a sub-event, the 16-character name of
the composite event that it is part of.
- EVENT(data-value)
- specifies the name (1–16 characters) of the event being inquired
upon.
- EVENTTYPE(cvda)
- indicates the type of the named event. CVDA values are:
- ACTIVITY
- Activity completion
- COMPOSITE
- Composite
- INPUT
- Input
- SYSTEM
- System
- TIMER
- Timer.
- FIRESTATUS(cvda)
- indicates the state of the named event. CVDA values are:
- FIRED
- The event has fired normally.
- NOTFIRED
- The event has not fired.
- PREDICATE(cvda)
- indicates, if the named event is composite, the Boolean operator applied
to its predicate. CVDA values are:
- AND
- The Boolean operator applied to the predicate is AND.
- OR
- The Boolean operator applied to the predicate is OR.
- TIMER(data-area)
- returns, if the named event is a timer event, the 16-character name
of the timer.
Conditions
- 109 ACTIVITYERR
- RESP2 values:
- 3
- The activity indicated by the ACTIVITYID option could not be found.
- 29
- The repository file is unavailable.
- 30
- An input/output error has occurred on the repository file.
- 111 EVENTERR
- RESP2 values:
- 1
- The event specified on the EVENT option could not be found.
- 16 INVREQ
- RESP2 values:
- 1
- There is no current activity within the scope of this task.
- 17 IOERR
- RESP2 values:
- 30
- An input/output error has occurred on the repository file.
- 70 NOTAUTH
- RESP2 values:
- 101
- The user associated with the issuing task is not authorized to access
this resource in the way requested.