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

Commands
Safeguard Management Programming Manual—422086-028
7-36
ADD GROUP Command
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ADD GROUP
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. For
the ADD GROUP command, an error list containing a warning can be returned
even when ZSPI-TKN-RETCODE has the value ZCOM-ERR-OK.
These errors or warnings can occur in response to the ADD GROUP command:
ZCOM-ERR-OBJ-ALRDY-DEF
is returned if the specified group name ZCOM-TKN-OBJNAME has already
been defined.
ZCOM-ERR-OBJNAME-INV
is returned if the specified group name ZCOM-TKN-OBJNAME is invalid.
ZCOM-ERR-TKN-VAL-INV
is returned when a token's value is invalid. For example, the group number is
out of range, or the member name does not specify an existing user.
ZCOM-ERR-TKN-REQ
is returned when a required token is missing.
ZSFG-ERR-GROUP-MAX
is returned when a specified member name already belongs to 32 groups. The
offending ZSFG-TKN-MEMBERNAME is returned in the error list.
ZSFG-ERR-GROUP-ID-EXISTS
is returned when the specified group ID already exists.
ZSFG-ERR-GROUP-NAME-EXISTS
is returned if an internal error occurs while attempting to update a member's
group list.
ZSFG-ERR-MEMBER-UPDATE
is returned if an attempt to update the group list for one or more group
members fails. This warning indicates the command was only partially
successful.