Distributed Name Service (DNS) Management Programming Manual

Overview of the RESTORE Commands
Using DNS in Programs: The DNS Commands
5–200 46958 Tandem Computers Incorporated
Overview of the
RESTORE Commands
ZDNS-CMD-RESTORE deletes locally updateable copies of remotely defined names
and is analogous to the RESTORE command in DNSCOM. ZDNS-CMD-RESTORE
may be used with the following object types:
ZDNS-OBJ-ALIAS (write authority required)
ZDNS-OBJ-COMP (write authority required)
ZDNS-OBJ-GROUP (write authority required)
The considerations for commands formed by using ZDNS-CMD-RESTORE with each
of these object types are presented in the following subsections.
The response to ZDNS-CMD-RESTORE always contains ZSPI-TKN-RETCODE which,
if zero, indicates that the name is successfully restored. If ZSPI-TKN-RETCODE is not
zero, the name is not restored. 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 which describe warnings. The only warning returned is ZDNS-
ERR-NOT-COPIED, which is returned in response to a request to restore a name that
has not been previously copied.
Provided that the parameter containing the name to be restored is supplied, the
response also contains ZDNS-TKN-OBJNAME, whose value is the name being
restored. No response tokens other than ZSPI-TKN-RETCODE, ZSPI-TKN-
OBJNAME, and error lists are returned by ZDNS-CMD-RESTORE.
All variations of the DNSCOM RESTORE command that restore names are
implemented with a combination of the ZDNS-CMD-INFO command and ZDNS-
CMD-RESTORE.