Subsystem Control Point (SCP) Management Programming Manual

Commands and Responses
Subsystem Control Point (SCP) Management Programming Manual—520619-001
5-3
Common Command Tokens
ZSPI-TKN-SSID
is a header token that identifies the subsystem expected to process the command. To
specify an SCP process, assign the value ZSCP-VAL-SSID.
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 process to which the command is directed. If you omit this
token from the command, SCP tries to derive the name from the object name in the
first occurrence of ZCOM-TKN-OBJNAME. To direct a command to an SCP process,
assign the name of the SCP process to this token.
ZCOM-TKN-XMGR
specifies the name of the target subsystem manager process. For more information,
see Command-Message Routing on page 3-3.
ZCOM-MAP-REQID
is an extensible structured token that identifies the originating requester to the
subsystem manager process.
If the originating requester is communicating directly with the SCP process to which
the command is directed, this token should not be included.
If the originating requester is sending the command by way of an intermediate SCP
process or other routing process, the intermediate process must append the REQID
information before forwarding the command. SCP routinely does this when it
forwards commands from management applications to subsystems.
A custom routing application must include ZCOM-MAP-REQID (or the ZCOM-
TKN-REQID tokens) in any command messages it forwards from a requester to an
SCP process. However, an SCP process accepts ZCOM-MAP-REQID only in a
request from an application that belongs to the super ID.
ZCOM-TKN-REQID-desc
represents a set of four new requester identification tokens:
ZCOM-TKN-REQID-PAID
ZCOM-TKN-REQID-PHANDLE
ZCOM-TKN-REQID-PPROGXFILE
ZCOM-TKN-REQID-PSTRING
-1 The response contains as many response records as fit in the buffer.
0 The response contains only one response record (default).
n>0 The response contains up to n response records.