Table of Contents
Advertisement
Message syntax
Each command name contains the name of the server that the request is targeted for,
followed by the request itself. These elements are separated by a period. Requests for
VTel are preceded by VTel. For example:
[VTel.Exit()]
Arguments
All arguments are either strings or sequences of couples (also called name-value pairs).
A sequence of couples is enclosed in curly brackets ({}) and includes a maximum number
of elements (couples), actual element count, and the couples. Each couple is further
enclosed in curly brackets and contains a name and a value, each of which is a string
enclosed in quotation marks, separated by a comma:
{max,n,{"name1","value1"},{"name2","value2"},{"name3","value3"}}
The maximum number of elements (max) limits the number of couples that will be returned
in response to a request. The maximum number must be a positive integer or zero. It is
often set to zero (0) to indicate that the response size is unlimited (that is, any number of
values may be returned). If the numbers is not zero, then a response to the request can be
truncated. For example, the size of the response from a request to get the values in an
EDU can be limited to five elements:
{5,1,{"vdu_id","2df5d9e6003b00007800002a1f430002"}}
The actual number of couples (n) is the count of the elements in the sequence. An empty
sequence has zero in the element count, for example:
{0,0} or {5,0}
Note:
Note:
Strings
Strings are enclosed in quotation marks. Strings may contain any characters; however,
quotation marks and backslash characters must be written with a backslash in front of
them (that is, \ and \\).
38 VTel Programmer Guide
Couples in a sequence are not positional. The couples may appear in any
order. The ordering may change at any time.
Advertisement
Table of Contents
