16 navigation functions, 1 gotoevent(), Vent – Teledyne LeCroy Verification Script Engine for Teledyne LeCroy PETracer Reference Manual User Manual
Page 68

Teledyne LeCroy
Verification Script Engine Reference Manual
Version 6.6x
63
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
Transaction level of the event to jump to (possible values: _PACKET, _LINK, _SPLIT)
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 jumps 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 (extension:
*.pem ). 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 does nothing and an error message is 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 );
}