Teledyne LeCroy SATracer 3G Verification Script Engine manual - Manual (Page 57)

LeCroy Corporation Verification Script Engine Reference Manual Version 1.01
18 COM/Automation Communication Functions
This group of functions covers VSE capabilities to communicate with COM/Automation clients
connected to the SASTracer/SATracer application. (Please refer to the SASTracer/SATracer
Automation manual for the details on how to connect to the SASTracer/SATracer application and
VSE).
18.1 NotifyClient()
This function allows you to send information to COM/Automation client applications in a
custom format. The client application will receive a VARIANT object which it is supposed to parse.
Format :
NotifyClient( event_id, param_list )
Parameters:
event_id - event identifier
param_list - the list of parameters to be sent to the client application. Each parameter might be
an integer, string or list.
(See CSL Manual for details about data types available in CSL ).
Because the list itself may contain integers, strings, or other lists it is possible
to send complicated messages.
(lists should be treated as arrays of VARIANTs)
Example:
…
if( SomeCondition() )
{
NotifyClient( 2, [ in.Index, in.Level,
TimeToText( in.Time )] );
}
…
# Here we sent 2 parameters to clients applications :
# 2 ( integer ),
# [ in.Index, in.Level, TimeToText( in.Time )] ( list )
Remark:
See an example of handling this notification by client applications and parsing code in the
SASTracer/SATracer Automation document.
52