Teledyne LeCroy SATracer 3G Verification Script Engine manual - Manual (Page 52)

LeCroy Corporation Verification Script Engine Reference Manual Version 1.01
16 Navigation Functions
16.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 - the transaction level of the event to jump to (possible values: _LINK, _ATA)
index - the transaction index of the event to jump to
segment - the segment index of the event to jump to. If omitted, the current segment index will
be 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 (like 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 );
}
47