DSM Template Services Manual

Display-Text Procedures
DSM Template Services Manual—427187-004
2-9
SPI_BUFFER_FORMATNEXT_
General Appearance of a Simple Token
Typically, each simple token is represented on a separate line. A column of colons (:)
divides labels from values. Labels are on the left. Values are on the right.
Three simple tokens look something like this:
xxx(label-1)xxxx: xxx(value-1)xxxxxx
xx(label-2)xxx: xxxxx(value-2)xxxxxx
x(label-3)x: xxxxxxx(value-3)xxxxxx
If a token is qualified, its subsystem ID is included, beginning in column one, followed
by the token label and value. If necessary, an extra line is used.
These devices identify special lines:
•
An asterisk (*) after the colon indicates the token is at the current position in the
message buffer.
•
A minus sign (-) after the colon indicates the token is at the last position in the
message buffer.
•
If the token is nested within a list, the entire line is shifted right two columns for
each level of nesting.
General Appearance of a Structured Token
If field-label-len is nonzero, a structured token looks like a simple token with a
multiple-line value.
A structured token with three fields looks something like this:
lbl-token: xxx(lbl-fld-1)xxx xxx(val-1)xxxxxx
xx(lbl-fld-2)xx xxxxx(val-2)xxxxxx
x(lbl-fld-3)x xxxxxxx(val-3)xxx
lbl-token is the label for the token, and lbl-fld-1 is the label for field one, which
is followed by its value. If a field label is longer than field-label-len, the value of
the field is dropped to the next line.
If the structure contains a group, the group label appears as a field label with no value.
Fields within the group are represented normally except their lines are indented two
columns:
lbl-token: lbl-fld-1 value-1
lbl-fld-2 value-2
lbl-grp
lbl-fld-3 value-3
lbl-fld-4 value-4
lbl-fld-5 value-5
lbl-fld-6 value-6