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

Commands
Safeguard Management Programming Manual—422086-012
7-21
ADD ALIAS Command
ZSFG-TKN-DESC-BIN
is an optional token that specifies a binary description to be associated with the
alias record. This token is provided for documentation purposes only and has no
affect on the alias. The binary description field can be up to 2048 bytes long. The
binary description field is structured so that it can be shared by multiple vendors.
See Appendix B, Example of Sharing a Binary Description Field, for an example.
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ADD ALIAS
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 ADD ALIAS 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 ADD request. Normally, this error should not occur, and it should
be transient if it does occur.
ZCOM-ERR-OBJ-ALRDY-DEF
is returned if the specified alias name ZCOM-TKN-OBJNAME has already
been defined.
ZCOM-ERR-OBJNAME-INV
is returned if the specified alias name ZCOM-TKN-OBJNAME is invalid.
ZSFG-ERR-ALIASGUARDIANID
is returned if the underlying user ID does not exist.
ZSFG-ERR-ALIASGUARDNAME
is returned if the specified alias name (unshifted or case-insensitive) matches
an existing user name.