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

Commands
Safeguard Management Programming Manual—422086-028
7-8
ACTIVATE TERMINAL (LU) Command
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ACTIVATE
TERMINAL command, see Section 6, Common Definitions.
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.
These errors or warnings can occur in response to the ACTIVATE TERMINAL
command:
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 ACTIVATE request. Normally, this error should not occur, and it
should be transient if it does occur.
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to do
the ACTIVATE TERMINAL. For the rules for terminal security management,
see the Safeguard Reference Manual.
ZCOM-ERR-SPI-ERR
is returned if one of the procedures (for example, SSGETTKN) returned an
error. The SPI error list identifies 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-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.