Distributed Name Service (DNS) Management Programming Manual

Overview of the COPY Commands
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–71
Overview of the COPY
Commands
ZDNS-CMD-COPY makes locally updateable copies of remotely defined names and is
analogous to the COPY command in DNSCOM. ZDNS-CMD-COPY may be used
with the following object types:
Object Type Definition
ZDNS-OBJ-ALIAS Write authority required
ZDNS-OBJ-COMP Write authority required
ZDNS-OBJ-GROUP Write authority required
The considerations for each object type are described in the subsections that follow.
The response to ZDNS-CMD-COPY always contains ZSPI-TKN-RETCODE, which, if
zero, indicates that the name is successfully copied. If ZSPI-TKN-RETCODE is not
zero, the name is not copied. 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. The only warning returned is ZDNS-
ERR-ALREADY-COPIED, which is returned in response to a request to copy a name
already copied.
Provided that the parameter containing the name to be copied is supplied, the
response also contains the ZDNS-TKN-OBJNAME, whose value is the name being
copied. No response tokens other than ZSPI-TKN-RETCODE, ZDNS-TKN-
OBJNAME, and error lists are returned by ZDNS-CMD-COPY.
All variations of the DNSCOM COPY command that copy names are implemented
with a combination of the ZDNS-CMD-INFO command and ZDNS-CMD-COPY. See
“TMF Considerations” in Section 3 if you are going to perform a large number of copy
operations.