8 sasvscriptengine object, 1 ivscriptengine interface – Teledyne LeCroy SAS_SATA Tracer_Trainer Automation API Manual User Manual
Page 71
![background image](/manuals/353616/71/background.png)
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