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

Commands
Safeguard Management Programming Manual—422086-012
7-77
ALTER GROUP Command
ZSFG-TKN-REMOVE-MEMBERNAME
is an optional token that contains a user name or user alias to be removed from the
group.
Tokens in Response Buffer
For a description of the tokens present in the response buffer for the ALTER 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 ALTER 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 ALTER GROUP command:
ZCOM-ERR-OBJNAME-INV
is returned if the specified group name (ZCOM-TKN-OBJNAME) is invalid or
the group number is out of range.
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.
ZCOM-ERR-OBJ-NOT-FOUND
is returned if the specified group ZCOM-TKN-OBJNAME does not exist.
ZSFG-ERR-GROUP-DERIVED
is returned when an attempt is made to remove a member from the member's
administrative group.
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.