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

SPI Concepts and Protocol
SPI Programming Manual—427506-006
2-32
Multirecord Responses
Figure 2-9 shows how a requester returns response records when the MAXRESP
header token is set to a positive integer,
n. The server returns as many as n response
records in each response message, with each record enclosed in a data list. If more
than one message is needed to return all the response records, the server follows the
standard protocol for command continuation until all records are returned.
Figure 2-9. ZSPI-TKN-MAXRESP > 0
VST013.vsd
The server returns as many as n response records in each response message. Each response record is
contained in a separate data list.
H [ Ra T1a T2a ]
Example: MAXRESP = -1 and one object qualifies for processing:
The server returns one message containing one response record in a datalist.
Example: MAXRESP = -1 and five objects (a through e) qualify for processing:
H [ Ra T1a T2a ] [ Rb T1b T2b ] C
H
[ Rc T1c T2c ] [ Rd T1d T2d ] C
H
[ Re T1e T2e ]
The server returns two response records in the first response message, two in the
second and the fifth response record in the third message.
Legend
R x ZSPI-TKN-RETCODE for object x
H Message header
T
nx Token n describing object x
C ZSPI-TKN-CONTEXT
[ ZSPI-TKN-DATALIST
] ZSPI-TKN-ENDLIST