DSM Template Services Manual

Display-Text Procedures
DSM Template Services Manual—427187-004
2-10
SPI_BUFFER_FORMATNEXT_
If the structure contains a group with an OCCURS clause, the group label and all items
within it are repeated once for each occurrence of the group. The occurrence number
is placed in parentheses after the group label:
lbl-token: lbl-fld-1 value-1
lbl-fld-2 value-2
lbl-grp(0)
lbl-fld-3 value-3
lbl-fld-4 value-4
lbl-fld-5 value-5
lbl-grp(1)
lbl-fld-3 value-3
lbl-fld-4 value-4
lbl-fld-5 value-5
lbl-grp(2)
lbl-fld-3 value-3
lbl-fld-4 value-4
lbl-fld-5 value-5
lbl-fld-6 value-1
If the field-label-len parameter of the SPI_BUFFER_FORMATSTART_
procedure is zero, the field labels are shifted left to fall under the token labels, as
shown in this schematic sketch:
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
Field labels are right-justified to end two spaces after the token label (lbl-token:).
If there is no label information for a token, this numeric information is displayed in place
of the token label:
(tdt,len,tnm)
This information gives you the token data type, the length of the data in bytes, and the
token number.
If there is no label information, the representation of a simple token value is
unchanged. But the representation of a structured token with no label information is
greatly changed. The structured value is represented as an array of 8-bit numeric
values rather than as individual fields.