Distributed Name Service (DNS) Management Programming Manual

ALTER ALIAS Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–41
ZSSMGR
If ZREFTYPE = ZDNS-OBJ-SSMGR, the name of the manager must be placed
in this field. If ZREFTYPE = ZDNS-OBJ-SSOBJ, the manager of the object
named in SSOBJ must be placed here (provided the object has a manager).
Possible errors referring to this field are:
ZDNS-ERR-INV-NAME
ZDNS-ERR-REQD-FIELD
ZDNS-ERR-NOTFOUND
ZDOMAIN
contains the new domain name, if the domain of the alias is to be changed. If
all replicated copies of the alias’s definition are to be deleted, this field should
be set to all spaces. If the field is left null, the domain of the alias is not
changed. The domain of an alias defined on a remote system may not be
altered. Possible errors referring to this field are:
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-ERR-REMOTENAME
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the alias 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.”
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.