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

Commands
Safeguard Management Programming Manual—422086-012
7-33
ADD GROUP Command
ZCOM-TKN-OBJNAME
is a required token that contains the group name of the new group to be added.
ZSFG-MAP-OWNERID
is an optional structured token that specifies the owner of the group record being
added. It contains these fields:
ZTYPEID
specifies the type of user ID defined by ZGROUPNUM and ZUSERNUM. This
field must contain one of these values:
ZSFG-VAL-TYPEID-LOCALSPECIFIC
ZSFG-VAL-TYPEID-REMOTESPECIFIC
ZGROUPNUM
is the group number portion of the owner ID.
ZUSERNUM
is the member number portion of the owner ID.
ZSFG-TKN-GROUPID
is a required token that contains the group number associated with the group name
to be added. The number must be in the range from 0 through 65,535 and must
not belong to any existing group.
ZSFG-TKN-DESC
is an optional token that contains a text description of the group, up to 255
characters.
ZSFG-TKN-MEMBERNAME
is an optional token that contains a user name or user alias to be added to the
group.
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