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

Page 68

Advertising
background image

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 );
}

Advertising