SPI Common Extensions Manual

Commands and Responses

SPI Common Extensions Manual—427508-001

5-5

Common Command Tokens

ZSPI-TKN-RESPONSE-TYPE

specifies the type of response returned when a command can return more than

one response record. Valid values are:

The token code and token value are assigned to the command message using

SSPUTTKN. This token is optional. If the token is not present, ZSPI-VAL-ERR-

WARN-AND-NORM is assumed.

ZSPI-TKN-ALLOW-TYPE

specifies the conditions under which command processing should continue. Valid

values are:

ZSPI-TKN-ALLOW

specifies a subsystem behavior allowed by the requester. The valid value is:

ZSPI-TKN-COMMENT

contains as many as 80 bytes of information determined by your application. The

comment is sent in the command message. It is not returned in the response. The

token code and token value are assigned using SSPUTTKN. This token is optional.

ZSPI-TKN-CONTEXT

in a command, tells the subsystem to continue processing objects not completed

by a previous command. Another response message must be retrieved because

not all of the response records fit in the previous response message. To retrieve

the response continuation, your application copies the context token from the

previous response to a copy of the original command message and sends it again.

For more information, see the

SPI Programming Manual

ZSPI-VAL-ERR-AND-WARN Only response records containing errors or

warnings should be returned.

ZSPI-VAL-ERR-WARN-AND-NORM All response records should be returned.

ZSPI-VAL-NORM-ONLY Processing continues with the next object only if

the response for the previous object was normal.

An error or warning terminates processing. This is

the default value if the token is omitted from the

request.

ZSPI-VAL-WARN-AND-NORM Processing continues with the next object if the

response for the previous object was normal or a

warning. An error terminates processing.

ZSPI-VAL-ERR-WARN-AND-

NORM

Processing continues with the next object in spite

of errors and warnings.

ZSPI-VAL-ALLOW-SEGMENTS Allow segmented responses.