User's Manual

Engineering Test Software Operation
Rev 28_A Sept 2005
30 VIA Telecom, Inc. Proprietary
F2, uint8
F3, uint8
#endexistif
F4, uint8
End
In this example fields F2 and F3 would have the existence parameter applied to them exist=(F1==2).
If the #endexistif statement is left out then #existif will be applied to all fields from the #existif until the end
statement for the message.
3.3.9.11 Field Parameter: fields
The fields parameter function is used with large numeric fields. Large is defined as numeric field with a bytes
parameter set to more than 8 bytes. The fields parameter is used to establish multiple subfields that the primary
field should be divided into. This parameter is set to multiple space-separated numbers that identify the quantity
of bytes to be applied to each subfield. The number of entries defines the number of subfields to create. The
summation of the subfield byte counts must equal the value of the bytes parameter of the primary field.
The name of each subfield is created by appending a numeric offset, starting at zero, to the primary field name.
Example:
TestField, uint8, bytes=7, fields= 2 1 4
The example results in the following subfields:
TestField0 2 bytes
TestField1 1 bytes
TestField2 4 bytes
3.3.9.12 Field Parameter: Format
The displayed format of a numeric can be specified. This is intended to be used primarily with scaled values in
order to get the floating point value correct.
Example:
Num, uint16, scale=Q3, format=%g”
3.3.9.13 Field Parameter: indent
When a message is displayed in a log window, the entire message will be displayed on a single line unless the
indent parameter is specified. When the indent parameter is used, in a field definition, it specifies that the
field will be printed on the next line down with the specified number of tabs before it. Each tab represents about
one inch. An example of the indent field being used is:
Example:
Afield, uint8, indent=2
3.3.9.14 Field Parameter: length
The length parameter is used to specify the number of characters (bytes) used in a fixed-length string field.
Example:
Name,string, length=13
where the string will always be 13 characters (bytes) long.