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

Commands
Safeguard Management Programming Manual—422086-028
7-48
ADD REMOTEPASSWORD Command
ALIAS:KEVINB\FOXII.
ZSFG-TKN-REMOTEPASSWORD
is a required token that specifies the remote password being added.
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ADD
REMOTEPASSWORD 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 RMTPASSW
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-NOT-FOUND
is returned if the specified user portion of ZCOM-TKN-OBJNAME does not
exist.
ZCOM-ERR-OBJNAME-INV
is returned if the specified user name and system (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 REMOTEPASSWORD. For the rules for who can manage
user records, see the Safeguard Reference Manual.
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.