Distributed Name Service (DNS) Management Programming Manual

ALTER GROUP Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–59
ZDNS-MAP-ALTER-GROUP-MEMB
is an optional token that describes a member to be added to or deleted from the
group. Any number of occurrences of this token may appear in the request buffer.
It has the token number ZDNS-TNM-ALTER-GROUP-MEMB and the definition
ZDNS-DDL-ALTER-GROUP-MEMB. It contains the following fields:
ZDELETE
If a member is to be added to the group, this field should be left null or set to
ZDNS-VAL-ADD (0). If a member is to be deleted from the group, the field
should contain ZDNS-VAL-DELETE (-1). If a value other than null, 0, or -1 is
supplied, the command is rejected with ZDNS-ERR-INV-BOOLEAN.
ZMEMBER
specifies the name of the member to be added or deleted. If a request is made
to add a member that is already in the group, the response buffer contains an
error list with ZDNS-ERR-DUP-MEMBER. A request to delete a name from a
group where the name is not currently in the group causes an error list, with
ZDNS-ERR-MEMBER-NOTFOUND appearing in the response buffer.
If this filed is supplied with “*” and ZDELETE = ZDNS-VAL-DELETE, all
group members are deleted.
Other possible errors referring to this field are:
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-ERR-REQD-FIELD
ZDNS-ERR-ILL-MEMBER
ZDEFNODE
If the member to be added or deleted is defined on a remote system, the name
of that system must be specified here.
If supplied with “*” and ZDELETE = ZDNS-VAL-DELETE, all group members
are deleted.
A possible error referring to this field is:
ZDNS-ERR-INV-NAME
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the group that is altered by the
command. This token is present in every response record. ZDNS-TKN-
OBJNAME is described in Section 4 under the heading “Simple Tokens.”