SPI Common Extensions Manual

Glossary
SPI Common Extensions Manual—427508-001
Glossary-10
return token
return token. The response token that indicates whether a command was successful and
why it failed if it did. Every response record in a response from a Compaq subsystem
contains a return token. A response record can also contain error lists that include
error tokens. The token code for the return token is ZSPI-TKN-RETCODE. Its value
consists of a single integer field. Compare with error token.
SCF. See Subsystem Control Facility (SCF).
SCP. See Subsystem Control Point (SCP).
segment list. An SPI list used in segmented responses to group the repeating tokens in the
response record. A segment list starts with ZSPI-TKN-SEGLIST and ends with
ZSPI-TKN-ENDLIST.
segmented response. A response in which a response record spans more than one
response message. Segmented responses can be constructed when the response
contains repeating groups of tokens. The response record contains the nonrepeating
tokens followed by the repeating groups in segment lists. All but the last segment of
the response record contain ZSPI-TKN-MORE-DATA, indicating that the response
record is incomplete.
sensitive command. A command that can be issued only by a restricted set of users, such
as the super group, because the subsystem restricts access to the command. For
extended SPI subsystems, the sensitive commands are those that can change the
state or configuration of objects. For these subsystems, the sensitive commands are
also action commands. Compare with nonsensitive command.
server. An SPI server. A subsystem process that accepts SPI commands from management
applications.
server version. The software release version of the server to which a requester using SPI
(such as a management application) is sending a command. If the server version is
older than the maximum field version in a request, the server rejects the request. SPI
puts the maximum field version into the command buffer. The server puts its own
version into each response buffer. See maximum field version
.
short read. An operation in which the application reads fewer bytes than are available in a
message. In the context of SPI, the term implies that the number of bytes requested by
the application is smaller than the number of used bytes in the SPI buffer or that the
application furnished a buffer too small to contain the response data produced by the
subsystem.
simple token. A token consisting of a token code and a value that is either a single
elementary field, such as an integer or a character string, or a fixed (nonextensible)
structure. Compare with extensible structured token
.