SPI Common Extensions Manual

Commands and Responses
SPI Common Extensions Manual—427508-001
5-3
Common Command Tokens
ZSPI-TKN-MAXRESP
is a header token used by the requester to specify the maximum number of
response records that can be accepted in the response buffer. Use the SSINIT
procedure to assign one of these values:
ZSPI-TKN-MANAGER
specifies the name of the subsystem process to which SCP forwards the
command. If you omit this token from the command, SCP tries to derive the
manager name from the object name in ZCOM-TKN-OBJNAME. For the correct
method for a specific subsystem, see the subsystem management programming
manual. Only one ZSPI-TKN-MANAGER token is allowed in a command.
ZCOM-TKN-XMGR (D-series)
specifies the name of the target subsystem manager process when routing
requests through D-series SCP processes.
ZCOM-MAP-REQID
is an extensible structured token that identifies the originating requester to the
target subsystem. If this structure is not provided in a command by a qualified
requester, SCP adds it before forwarding the command to the subsystem.
An application must include ZCOM-MAP-REQID (or the ZCOM-TKN-REQID-desc
tokens) if it funnels messages between requesters and an SCP or subsystem
process. The originator of the request must be identified. However, SCP only
accepts ZCOM-MAP-REQID in a request from an application that belongs to the
super ID.
Either ZCOM-MAP-REQID or ZCOM-TKN-REQID-desc tokens must be present in
requests delivered to subsystems by intermediate routing processes such as SCP.
ZCOM-TKN-REQID-desc (D-series)
represents a set of requester identification tokens:
ZCOM-TKN-REQID-CPU
ZCOM-TKN-REQID-PAID
ZCOM-TKN-REQID-PHANDLE
ZCOM-TKN-REQID-PIN
ZCOM-TKN-REQID-PPROGXFILE
ZCOM-TKN-REQID-PROC-DESC
ZCOM-TKN-REQID-PSTRING
The ZCOM-TKN-REQID-desc tokens must be present in requests delivered to
subsystem processes by intermediate routing processes such as SCP.
-1 The response can contain as many response records as fit in the buffer.
0 The response can contain only one response record (default).
n > 0 The response can contain up to n response records.