8 sasvscriptengine object, 1 ivscriptengine interface – Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual User Manual

Page 71

Advertising
background image

LeCroy Corporation

Automation API for SAS/SATATracer/Trainer

Manual Version 1.11

71

8 SASVScriptEngine Object

The SASVScriptEngine object allows you to run verification scripts over the recorded trace.
It extends the functionality of the ISASVerificationScript interface of a SASTrace object. The
main advantage of a SASVScriptEngine object is that it allows clients implementing
_IVScriptEngineEvents a callback interface to receive notifications when a verification script
is running.

The SASVScriptEngine object can be created by calling

ISASVerificationScript:: GetVScriptEngine

.


The SASVScriptEngine object supports the following interfaces:

Interfaces

Description

IVScriptEngine

Provides advanced control over the verification script and
allows you to execute the script asynchronously.

_ISASAnalyzerEvents

Events from SASVScriptEngine object

The IVScriptEngine interface is a primary interface for the SASVScriptEngine object.

Remarks

Verification scripts are scripts written in a special manner using the CATC Script Language
(CSL). These scripts can be “run” over a recorded trace to “verify” the trace for some
verification conditions or to extract more advanced information from the trace. Such scripts
utilize a special feature of the SASTracer application, its Verification Script Engine.

Please refer to the SASTracer Manual, SASTracer Verification Script Engine Manual, and
SASTracer File Based Decoding Manual for more details.

8.1 IVScriptEngine Interface

The IVScriptEngine interface is the primary dual interface for the SASVScriptEngine object.

It implements the following properties and methods:

VscriptName
Tag
RunVScript
RunVScriptEx
LaunchVScript
Stop
GetScriptVar
SetScriptVar

Advertising