Distributed Name Service (DNS) Management Programming Manual

ALTER DOM Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–55
Tokens in Command Buffer
ZDNS-MAP-ALTER-DOM
is a structured token that describes the domain to be altered. This token is
required. It has the token number ZDNS-TNM-ALTER-DOM and the definition
ZDNS-DDL-ALTER-DOM. It contains the following field:
ZNAME
contains the name of the domain changed. Possible errors referring to this
field are:
ZDNS-ERR-REQD-FIELD
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-MAP-ALTER-DOM-SYS
is a structured token that describes a system that is to be added to or deleted from
the domain. At least 1 but no more than 254 occurrences of this token must be
supplied. It has the token number ZDNS-TNM-ALTER-DOM-SYS and the
definition ZDNS-DDL-ALTER-DOM-SYS. It contains the following fields:
ZDELETE
If a system is to be added to the domain, this field should be left null or set to
ZDNS-VAL-ADD (0). If a system is to be deleted from a domain, 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.
ZSYSTEM
must name a Guardian 90 system that is currently defined to the Expand
network (ZDNS-VAL-ADD) or is a current member of the domain being
altered. The system need not be currently accessible. If the field names the
local system, ZDNS-ERR-LOCAL-SYSTEM is returned, and the occurrence of
this parameter is not used. If ZSYSTEM = * and ZDELETE = -1, all systems are
deleted from the domain.
If a request is made to add a system that is already in the domain, the response
buffer contains an error list with ZDNS-ERR-DUP-SYSTEM. A request to
delete a system that is not currently in the domain results in an error list with
ZDNS-ERR-SYSTEM-NOTFOUND. Other possible errors referring to this
field are:
ZDNS-ERR-INV-NAME
ZDNS-ERR-UNKNOWN-SYSTEM
ZDNS-ERR-REQD-FIELD