Distributed Name Service (DNS) Management Programming Manual

Overview of the ALTER Commands
Using DNS in Programs: The DNS Commands
5–38 46958 Tandem Computers Incorporated
Overview of the
ALTER Commands
ZDNS-CMD-ALTER changes the definition of a name and is analogous to the ALTER
command in DNSCOM. ZDNS-CMD-ALTER may be used with the following object
types:
Object Type Definition
ZDNS-OBJ-ALIAS Write authority required
ZDNS-OBJ-ATYPE Definition authority required
ZDNS-OBJ-COMP Write authority required
ZDNS-OBJ-CTYPE Definition authority required
ZDNS-OBJ-DOM Write authority required
ZDNS-OBJ-GROUP Write authority required
ZDNS-OBJ-SSMGR Write authority required
ZDNS-OBJ-SSOBJ Write authority required
ZDNS-OBJ-SSTYPE Definition authority required
The considerations for each object type are described in subsections that follow.
The response to ZDNS-CMD-ALTER always contains ZSPI-TKN-RETCODE, which, if
zero, 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. If the return code is zero, the response may
still contain error lists that describe warnings.
Provided that the parameter containing the name to be altered is supplied, the
response contains ZDNS-TKN-OBJNAME, whose value is the name being altered.
No other response tokens except ZSPI-TKN-RETCODE, ZDNS-TKN-OBJNAME, and
error lists are returned by ZDNS-CMD-ALTER.