SPI Reference Summary

SPI Standard Definitions
SPI Reference Summary—427507-006
1-5
Error Number
A token type (subsys-TYP-desc) describes the structure of the token value. It has two
parts:
•
Token data type (ZSPI-TDT-desc) is a SPI-defined data type of the token
value; no other token data types can be defined.
•
Token length (subsys-TLN-desc) indicates the length of the token value.
A token number (subsys-TNM-name) is a signed integer value that identifies the
token. Token numbers 1 through 9998 can be used by subsystems. Numbers -512
through 0 are used by SPI. The remaining numbers are reserved for use by HP.
Token Map (subsys-MAP-desc)
A variable-length integer array that identifies an extensible structured token and is
used by subsystems to maintain compatibility between different versions of the same
token. A token map is not provided as a SPI-standard definition.
A token type (subsys-TYP-MAP) is always type MAP. It has two parts:
•
Token data type (subsys-TDT-MAP), which is always data type MAP.
•
Token length (ZSPI-TLN-VARIABLE), which is always variable (value is 255).
A token number (subsys-TNM-name), which is subsystem defined.
A structure DEF (subsys-DDL-name) is a definition structure of the extensible
structured token value.
Version is an optional 3-character string to indicate the version of the map value. It has
the form ann, where a is an alphabetic letter and nn is an integer.
Token Value (subsys-VAL-name)
A named value whose length and format is defined by a token code or by a field in the
structure definition of a token map or structured token code.
Error Number
A 16-bit signed integer value that identifies an error returned by the SPI procedures or
by a subsystem that supports SPI.
Error numbers have the form subsys-ERR-name, where subsys and name together
identify the error. For errors returned by SPI procedures, subsys is ZSPI.