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

Commands
Safeguard Management Programming Manual—422086-028
7-91
ALTER PROTECTIONRECORD Command
ZSFG-TKN-TRUST
is an optional token that is valid only for ZSFG-VAL-TYPE-DISKFILE. This token
specifies the TRUST attribute setting of a program object file. It is supported in the
H-series product version only. The field must contain one of these values:
If this token is not specified, the value in the protection record is not changed.
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 ALTER
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 ALTER PROTECTION
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 ALTER request. Normally, this error should not occur, and it
should be transient if it does occur.
ZSFG-VAL-TRUST-ME The TRUST setting is ME; that is, the program
file is to be trusted to not access the buffers
private to the process before I/O completion.
ZSFG-VAL-TRUST-SHARED The TRUST setting is SHARED; that is, the
program file is to be trusted to not access the
buffers that are private to the process or are
shared with another process that also has
TRUST SHARED set, before I/O completion.
ZSFG-VAL-TRUST-OFF The TRUST setting is OFF; that is, the program
file is not to be trusted with process buffer
access.