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

Commands
Safeguard Management Programming Manual—422086-028
7-125
ALTER TERMINAL (LU) Command
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 ALTER TERMINAL
command:
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to
perform the ALTER TERMINAL command. The rules for who can manage
terminal security are defined in the Safeguard Reference Manual.
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.
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-OBJ-NOT-FOUND
is returned if the specified terminal ZCOM-TKN-OBJNAME does not exist.
ZCOM-ERR-NO-MEM-SPACE
is returned when the Security Manager Process (SMP) cannot obtain memory
to service the ALTER 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-SSID-INV
is returned if the subsystem ID is in error. The error list identifies the invalid
subsystem ID.
ZCOM-ERR-TKN-CODE-INV
is returned if an invalid, foreign, or unsupported token was found. The error list
identifies the invalid token.