User's Manual

Engineering Test Software Operation
Rev 28_A Sept 2005
56 VIA Telecom, Inc. Proprietary
Call this function to add a string to the event filter list. Only those messages that are in the event filter
list will generate events. The string that is provided must match the leading characters of the message
text.
EnableEvents as boolean
Set this to true or false to enable or disable message event generation.
EvFilterClear()
Call this function to remove all entries from the event filter list. When the event filter is cleared all
received messages will generate an event.
Events
OnCommand( Message as string )
OnResponse( Message as string )
OnError( Message as string )
Each of these event calls is made when the Command, Response, or Error occurs.
5.5.5 Field Data Functions
Recall that the name-value pair format is used for field and field content specification. An example is:
Aname1=Avalue1, Aname2=Avalue2, etc.
The functions GetField and SetField support this format.
GetField( Response as string, Field as string ) as string
Use this function to extract field values from a response message. The Response parameter is the response as
received from ETSMain. The Field parameter is the field name as it appears in the response message. The
value of the selected field is returned.
SetField( Command as string, Field as string, Value as string ) as string
The easiest way to send command messages is to manually generate the command, copy the command string,
and save it in a string variable. Then use this function to modify the command string to set the fields to the
specific values desired.
The returned string is the modified command string.
5.5.6 Array Field Functions
Arrays are logged as a space delimited list of numbers that are either in decimal, hex, or double-precision
floating point format. The ArrayMgr is an ActiveX object within ETSIF. It contains the following functions to
support VB in accessing and generating array string fields:
Load( Field as string )
LoadDouble( Field as string )
Internally an ArrayMgr object contains a list of numbers. This function interprets the array field value and
translates it into the list of numeric values.
MakeField( Hex as boolean, ByteCount as integer, Signed as boolean ) as
string
MakeFieldDouble() as string
The function above generates an array field string from the internal numeric list. The Hex parameter determines
if the list will be in hex or decimal format. The ByteCount parameter determines the number of bytes in each
numeric value generated. When the Hex parameter is false the Signed parameter determines if the numeric
values will be signed or unsigned decimal.