Safeguard Management Programming Manual (G06.24+, H06.03+)

Commands
Safeguard Management Programming Manual—422086-012
7-184
STATUS PROTECTIONRECORD Command
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 returned only when the request
contained a wild card name and the responses generated do not 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 STATUS
PROTECTIONRECORD command follow:
ZCOM-ERR-FS-ERR
is returned when a file-system error occurs. The file-system error list describes
the file-system error, the file-system procedure, and the file in question.
ZCOM-ERR-NO-MEM-SPACE
is returned when the Security Manager Process (SMP) cannot obtain memory
to service the STATUS request. Normally, this error should not occur, and it
should be transient if it does occur.
ZCOM-ERR-SPI-ERR
is returned if one of the procedures (for example, SSGETTKN) returned 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.
ZCOM-ERR-SSID-INV
is returned if the subsystem ID is in error. The error list identifies the invalid
subsystem ID.
ZCOM-ERR-VSN-INCOMP
is returned when the version of the command is greater than the subsystem
version and the command contains unknown tokens. Or a field in a structured
token is greater than the subsystem version. The error list contains the
subsystem version.