Teledyne LeCroy SAS_SATA Protocol Suite Verification Script Engine Reference Manual - Manual (Page 64)

64
Chapter 17: Navigation Functions
17.1 GotoEvent()
This function forces the application to jump to some trace event and show it in the main trace
view.
Format :
GotoEvent( level, index, segment )
GotoEvent()
Parameters
level
Transaction level of the event to jump to
index
Transaction index of the event to jump to
segment
Segment index of the event to jump to.
If omitted, the current segment index is used.
Remarks
If no parameters were specified, the application will jump to the current event being processed
by VSE.
The segment parameter is used only when the verification script is running over a
multi-segmented trace (extensions: *.smt, *.samt). For regular traces, it is ignored.
If wrong parameters were specified (such as an index exceeding the maximum index for the
specified transaction level), the function will do nothing, and an error message will be sent to
the output window.
Example
…
if( Something == interesting ) GotoEvent(); # Go to the current event.
…
if( SomeCondition )
{
interesting_segment = GetEventSegNumber();
interesting_level = in.Level;
interesting_index = in.Index;
}
…
OnFinishScript()
{
…
# Go to the interesting event.
GotoEvent( interesting_level, interesting_index,
interesting_segment );
}