Distributed Name Service (DNS) Management Programming Manual

ALTER GROUP Command
Using DNS in Programs: The DNS Commands
5–60 46958 Tandem Computers Incorporated
ZSPI-TKN-RETCODE
is the standard SPI return token described in the Distributed Systems Management
(DSM) Programming Manual. This token is present in every response record. If its
value is zero (ZDNS-ERR-NOERR), this token indicates that the name is
successfully altered. If ZSPI-TKN-RETCODE is not zero, the name is not altered.
Where a non-zero return code is present, the response buffer may contain one or
more error lists. Even if the return code is zero, the response may still contain
error lists which describe warnings.
ZSPI-TKN-ERRLIST
is a standard SPI error list, as described in the Distributed Systems Management
(DSM) Programming Manual. The list ends with the token ZSPI-TKN-ENDLIST.
Operational Notes
If the requester does not have DNS write authority, the command is rejected with
ZDNS-ERR-SECURITY.
All DNSCOM commands that change the membership of groups are implemented
using ZDNS-CMD-ALTER with ZDNS-OBJ-GROUP.
The DNSCOM command “ALTER GROUP G, MEMBERS + (A, B, C)” passes
ZDNS-MAP-ALTER-GROUP and ZDNS-MAP-ALTER-GROUP-MEMB as follows:
ZDNS-MAP-ALTER-GROUP
ZNAME = "G "
ZDEFNODE = null
ZDOMAIN = null
ZDNS-MAP-ALTER-GROUP-MEMB[1]
ZDELETE = ZDNS-VAL-ADD (0)
ZMEMBER = "A "
ZDEFNODE = null
ZDNS-MAP-ALTER-GROUP-MEMB[2]
ZDELETE = ZDNS-VAL-ADD (0)
ZMEMBER = "B "
ZDEFNODE = null
ZDNS-MAP-ALTER-GROUP-MEMB[3]
ZDELETE = ZDNS-VAL-ADD (0)
ZMEMBER = "C "
ZDEFNODE = null