Safeguard Management Programming Manual (G06.29+, H06.08+, J06.03+)

Commands
Safeguard Management Programming Manual—422086-028
7-193
LISTOBJECTS Command
Tokens in the Response Buffer
ZSPI-TKN-CONTEXT
is a special token that indicates (by its presence or absence) whether or not there
are more reply messages to come. This token is only returned when the request
generated more responses than fit in one buffer. For a description of this token,
see the SPI Programming Manual.
Error-Handling Notes
ZSPI-TKN-RETCODE
is the standard SPI return code token, whose value is a number identifying
successful completion (ZCOM-ERR-OK), an informational warning, or an error.
Errors or warnings that can occur in response to the LISTOBJECTS command
follow:
ZCOM-ERR-SPI-ERR
is returned if one of the procedures (for example, SSGETTKN) returns an error.
The SPI error list defines the procedure in error, the error status, and the token
involved.
ZCOM-ERR-TKN-CODE-INV
is returned if an invalid, foreign, or unsupported token was found. The error list
identifies the invalid token.
ZSFG-ERR-PAT-MISSING-ALL
is returned if the ZCOM-TKN-SUB token value is not ZCOM-VAL-SUB-ALL for
a diskfile-pattern protection record ALTER, DELETE, SUSPEND(FREEZE),
INFO, LISTOBJECTS, or ACTIVATE(THAW) command that contains a
wildcard in the pattern-spec volume name.
ZSFG-ERR-PAT-BAD-PATNAME
is returned if the pattern-spec does not include at least one wildcard in either
the subvolume or file name for a diskfile-pattern protection record command.