INQUIRE EVENT
Retrieve the attributes of a BTS event.
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.