SPI Programming Manual (G06.24+, H06.03+, J06.03+)

SPI Concepts and Protocol
SPI Programming Manual—427506-006
2-10
Data Definitions
•
The values of header tokens can be retrieved at any time using SSGET, without
changing and regardless of the current position of the buffer pointers.
•
Certain special SSGET operations, such as ZSPI-TKN-ADDR and ZSPI-TKN-
OFFSET, cannot be performed on header tokens.
The header tokens in Table 2-1
are described in Token Codes on page 4-31. For their
use in procedure calls, see Section 3, The SPI Procedures
.
Data Definitions
Tokens and related data elements (token numbers, token types, values, structures,
fundamental data types, token maps, token codes, and subsystem IDs, for example)
are originally defined using the DDL. The DDL compiler translates these definitions into
each of the programming languages that support SPI (C, COBOL, TACL, and TAL).
HP supplies these files to its customers as part of the operating system.
Table 2-1. SPI Header Tokens
Header Token Contents
ZSPI-TKN-BUFLEN Buffer length
ZSPI-TKN-CHECKSUM Checksum flag
ZSPI-TKN-COMMAND Command number
ZSPI-TKN-HDRTYPE Header type
ZSPI-TKN-LASTERR Error number of the last nonzero SPI procedure
error
ZSPI-TKN-LASTERRCODE Token code from the last SPI call with a nonzero
error
ZSPI-TKN-LASTPOSITION Position of last token added by SSPUT
ZSPI-TKN-MAX-FIELD-VERSION Most recent version of any non-null extensible
structure field
ZSPI-TKN-MAXRESP Maximum response records per message
ZSPI-TKN-OBJECT-TYPE Object-type number
ZSPI-TKN-POSITION Current token position for SSGET
ZSPI-TKN-SERVER-VERSION Server version
ZSPI-TKN-SSID Subsystem ID specified in SSINIT call
ZSPI-TKN-USEDLEN Number of bytes used in the buffer