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

SPI Concepts and Protocol

SPI Programming Manual—427506-006

2-30

Multirecord Responses

When a command is applied to more than one object, the server returns multiple

response records (unless the requester suppresses response records; see

Suppressing Response Records

on page 2-43). In this case, message traffic can be

reduced by having the server return more than one response record in each response

message. The requester controls the number of response records in each response by

assigning a value to the header token ZSPI-TKN-MAXRESP.

The value of ZSPI-TKN-MAXRESP indicates the maximum number of response

records the requester will accept in a single response message. The requester can

specify these values:

Not all subsystems support multirecord response messages. However, all NonStop

Kernel subsystems recognize the MAXRESP parameter to SSINIT and the MAXRESP

token.

Each command message carries its own MAXRESP value; the server does not retain

this value for use with subsequent commands.

Each response record contains its own return code.

Warning information that pertains to the command itself, rather than to the action of the

command on a particular object, is not repeated in every response record if there are

multiple response records per response. Any command-related warnings appear only

in the first response record in the sequence.

0 Lets the server return one response record per response message,

with the record not enclosed in a data list. (Default)

Figure 2-8

n > 0 Lets the server return as many as n response records in the response

message, with each record enclosed in a data list. This is a limit and

not an absolute value—the server might return fewer than n records in

the message.

Figure 2-9

–1 Lets the server return as many response records as will fit in the

buffer, with each record enclosed in a data list.

Figure 2-10