Teledyne LeCroy SierraFC Verification Script Engine Reference Manual - Manual (Page 48)

Verification Script Engine Reference Manual
43
21 Navigation functions
21.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 ( possible values : _FRM, _SEQ )
index - the transaction index of the event to jump
segment - the segment index of the event to jump. If omitted 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 verification script is running over multi-
segmented trace ( extension : *.mlt ). For regular traces it is ignored.
If wrong parameters were specified ( like index exceeding the maximal index for specified
transaction level ) – the function will do nothing and 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 );
}