GETNEXT EVENT

Browse the events known to a BTS activity. Start of changeAlthough 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.End of change

Read syntax diagramSkip visual syntax diagram
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.