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

SPI Concepts and Protocol
SPI Programming Manual—427506-006
2-44
Subsystem IDs (SSIDs)
The two possible values for ZSPI-TKN-RESPONSE-TYPE are:
•
ZSPI-VAL-ERR-WARN-AND-NORM directs the server to return a response record
for every object in the set of objects specified in the command. This action is the
default if the response-type token is not included in the command.
•
ZSPI-VAL-ERR-AND-WARN directs the server to return response records only for
objects for which something unusual occurred—that is, response records
containing at least one error list (regardless of the value of the return token). If
ZSPI-VAL-ERR-AND-WARN is specified and the command encounters no errors
or warnings on any object, the subsystem returns an empty response record. If
ZSPI-VAL-ERR-AND-WARN is specified and there are warnings about the
command itself, the server holds these command-related warnings until it
generates a response record due to an error or warning on one of the objects. If no
warnings or errors are generated on any of the objects, the server places the
command warnings in an empty response record.
Subsystems that support the response-type feature do so for all commands that can
change the state or configuration of an object and can accept the specification of more
than one object in a single command. Subsystems that do not support this feature
always return a response record for each object.
Some subsystems support the response-type feature even for informational
commands. In most situations, you will not want your application to suppress normal
responses for such commands.
Subsystem IDs (SSIDs)
A subsystem ID (SSID) is a structure that uniquely identifies a subsystem. SPI, the
Event Management Service (EMS), and the Distributed Name Service (DNS) all use
the same SSID format.
In SPI commands and responses, SSIDs identify both the subsystem that is to process
a command and the subsystems that put each token in the message. All tokens in an
SPI message are associated with a subsystem ID so that it is always possible to
determine who put the token in the message. An SSID is a 12-byte structure with the
format shown in Figure 2-14
on page 2-46.
The subsystem owner field (Z-OWNER) contains an eight-character string that
identifies the company or organization providing the subsystem. For all NonStop
Kernel subsystems, this field contains the string value “TANDEMbb
” (with two trailing
blanks).
The subsystem number field (Z-NUMBER) is a 16-bit signed integer value that
identifies the subsystem within the set of subsystems provided by the subsystem
owner. The SPI standard definition files include subsystem-number declarations for all
NonStop Kernel subsystems that have programmatic command interfaces based on
SPI, report EMS events, or define errors to be passed through by other subsystems in
SPI error lists. (For a list of these subsystems and their symbolic abbreviations, see
Appendix D, NonStop Kernel Subsystem Numbers and Abbreviations
.)