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

Commands
Safeguard Management Programming Manual—422086-028
7-44
ADD PROTECTIONRECORD Command
ZSFG-TKN-DESC
is an optional token that specifies a text string to be associated with the protection
record. The text must consist of printable characters. The default value is no
descriptive text. The maximum length of the string is 255 characters.
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ADD
PROTECTIONRECORD 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 PROTECTION
command:
ZCOM-ERR-FS-ERR
is returned when a file-system error occurs while accessing the
$volume.SAFE.GUARD file, accessing the $SYSTEM.SAFE.OTHER file,
accessing the file being protected, or updating the audit file. 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 protection record (ZCOM-TKN-OBJNAME) has
already been defined.
ZCOM-ERR-OBJNAME-INV
is returned if the specified protection record (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 object security, see
the Safeguard Reference Manual.