Distributed Name Service (DNS) Management Programming Manual

ALTER ATYPE Command
Using DNS in Programs: The DNS Commands
5–46 46958 Tandem Computers Incorporated
Tokens in Response Buffer
ZDNS-TKN-OBJNAME
is an object-name token that contains the name of the alias type 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.
Operational Notes
If the requester does not have DNS definition authority, the command is rejected
with ZDNS-ERR-SECURITY.
If a request is made to add a subsystem-object type that is already valid, the
response buffer contains ZDNS-ERR-DUP-SSTYPE.
If a request is made to delete a subsystem-object type that is not currently valid,
the response buffer contains ZDNS-ERR-SSTYPE-NOTFOUND.
If a request is made to delete a subsystem-object type where there are instances
that subsystem object’s the alias type being changed, the buffer contains ZDNS-
ERR-SSTYPE-INUSE, and the indicated subsystem-object type is not removed
from the list.
The DNSCOM command “ALTER CIRCUIT, DOMAIN LOCAL, SSTYPES + LINE
IN *” supplies ZDNS-MAP-ALTER-DNSTYPE and ZDNS-MAP-ALTER-ATYPE-
SSTYPE as follows:
ZDNS-MAP-ALTER-DNSTYPE
ZNAME = "CIRCUIT "
ZDOMAIN = " "
ZDNS-MAP-ALTER-ATYPE-SSTYPE[1]
ZDELETE = ZDNS-VAL-ADD (0)
ZSSTYPE = "LINE "
ZSS = "* "