Browse the events known to a BTS activity.
Although this command appears in the Application Programming set
of topics, to use it you must specify the system programming (SP) parameter
in the EXEC statement of the translate step of your compile job. See Technote
1265081 for further information.

GETNEXT EVENT
>>-GETNEXT--EVENT(data-area)--BROWSETOKEN(data-value)----------->
>--+----------------------+--+-----------------+---------------->
'-COMPOSITE(data-area)-' '-EVENTTYPE(cvda)-'
>--+------------------+--+-----------------+-------------------->
'-FIRESTATUS(cvda)-' '-PREDICATE(cvda)-'
>--+------------------+----------------------------------------><
'-TIMER(data-area)-'
Conditions: END, TOKENERR
Description
GETNEXT EVENT returns the attributes
of the next event, or sub-event, that is within the scope of a BTS activity.
Options
- BROWSETOKEN(data-value)
- specifies,
as a fullword binary value, a browse token returned on a previous STARTBROWSE
EVENT command.
- 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-area)
- returns
the 16-character name of the next event. This may be:
- An atomic event. An atomic event returned on this command may or may not
be a sub-event.
- A composite event.
- A system event.
- 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 its associated
timer.
Conditions
- END
- RESP2
values:
- 2
- There are no more resource definitions of this type.
- TOKENERR
- RESP2
values:
- 3
- The browse token is not valid.