DSM Template Services Manual

Display-Text Procedures
DSM Template Services Manual—427187-004
2-5
SPI_BUFFER_FORMATSTART_
buffer-values-only
INT:value
indicates whether token values that SPI_BUFFER_FORMATNEXT_ is to represent
come strictly from the SPI buffer or can be overridden by site-specified values:
A site provides override values through override templates in the template file.
token-label-len
INT:value
is the number of spaces that you decide to reserve for the token label. This
parameter must be at least 20.
field-label-len
INT:value
is the number of spaces that you decide to reserve for the field label. This
parameter must be 0 or at least 10. For more information, see Display-Text
Appearance on page 2-8.
status-1
INT .EXT:ref:1
supplements status on page 2-2. For a list of values, see Supplementary Status
Values on page 2-18.
status-2
INT .EXT:ref:1
supplements status on page 2-2. For a list of values, see Supplementary Status
Values on page 2-18.
Limit on Internal Storage
The program must release the storage for one SPI buffer (by calling
SPI_BUFFER_FORMATFINISH_) before allocating storage for another buffer (by
calling SPI_BUFFER_FORMATSTART_). Otherwise, a subsequent call to
SPI_BUFFER_FORMATSTART_ fails with error -27: no format ID available. A program
is restricted to a single format ID.
Zero From the HEADING or AS attribute if available; otherwise, from the DDL
name of the token or field.
Nonzero From the DDL name of the token or field.
Zero Use override values when present.
Nonzero Use only the actual values of tokens in the SPI buffer.