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

Commands
Safeguard Management Programming Manual—422086-012
7-60
ADD USER Command
ZSFG-TKN-DESC-BIN
is an optional token that specifies a binary description to be associated with the
user authentication record. This token is provided for documentation purposes and
has no effect on the record. 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 USER
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 USER 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 user name ZCOM-TKN-OBJNAME has already
been defined.
ZCOM-ERR-OBJNAME-INV
is returned if the specified user name ZCOM-TKN-OBJNAME is invalid.
ZCOM-ERR-SECUR-VIOL
is returned if the requestor's process access ID does not have authority to
perform the ADD USER. For the rules for who can manage user security, see
the Safeguard Reference Manual.