Distributed Name Service (DNS) Management Programming Manual

ADD ALIAS Command
Using DNS in Programs: The DNS Commands
5–6 46958 Tandem Computers Incorporated
ZSSOBJ
is interrelated with ZREFTYPE. If ZREFTYPE = ZDNS-OBJ-SSOBJ, this field
must contain the name of the subsystem object to which the new alias refers.
If ZREFTYPE = ZDNS-OBJ-SSMGR, this field must be left null. Possible errors
referring to this field are:
ZDNS-ERR-ILL-FIELD-COMB
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-ERR-REQD-FIELD
ZSSMGR
is also interrelated with ZREFTYPE. If ZREFTYPE = ZDNS-OBJ-SSMGR, the
name of the manager must be placed in this field. If ZREFTYPE = ZDNS-OBJ-
SSOBJ, the manager (if any) of the object named in ZSSOBJ must be placed
here. Possible errors referring to this field are:
ZDNS-ERR-INV-NAME
ZDNS-ERR-NOTFOUND
ZDNS-ERR-REQD-FIELD
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the alias added 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 added. If ZSPI-TKN-RETCODE is not zero, the name is not added.
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 that 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.