Distributed Name Service (DNS) Management Programming Manual

Overview of DNS Programmatic Commands
Using DNS in Programs: The DNS Commands
5–2 46958 Tandem Computers Incorporated
Table 5-2. Object Types for Programmatic Commands
Object Type Description
ZDNS-OBJ-DNS (0) Used when the command pertains to DNS itself.
ZDNS-OBJ-NAME (1) Used when the DNS-defined type of a name is unknown or when names
of many types are involved in the command. For example; the DNSCOM
command “INFO X” is implemented using the INFO programmatic
interface command (ZDNS-CMD-INFO) with object type ZDNS-OBJ-
NAME (X’s type is unknown by DNSCOM).
ZDNS-OBJ-ALIAS (2) Used when the command pertains to an ALIAS. For example; the ADD
ALIAS DNSCOM command is implemented using the ADD
programmatic-interface command (ZDNS-CMD-ADD) with object type
ZDNS-OBJ-ALIAS.
ZDNS-OBJ-ATYPE (3) Used when the command pertains to an ALIASTYPE or a set of alias
types.
ZDNS-OBJ-COMP (4) Used when the command pertains to a COMPOSITE object or set of
composite objects.
ZDNS-OBJ-CTYPE (5) Used when the command pertains to a COMPOSITE TYPE or set of
composite types.
ZDNS-OBJ-FILE (6) Indicates the command pertains to a DNS-FILE.
ZDNS-OBJ-PROC (7) Indicates the command pertains to a DNS-PROCESS.
ZDNS-OBJ-DOM (8) Indicates the command pertains to a DNSDOMAIN or all domains
defined on the local system.
ZDNS-OBJ-GROUP (9) Indicates the command is to refer to a GROUP or set of groups.
ZDNS-OBJ-SS (10) Used for commands that refer to a SUBSYSTEM or to all subsystems
defined on the local system.
ZDNS-OBJ-SSMGR (11) Commands that refer to subsystem managers should use this value.
ZDNS-OBJ-SSOBJ (12) Used for commands that refer to a subsystem object or a set of
subsystem objects.
ZDNS-OBJ-SSTYPE (13) Indicates the command refers to a subsystem-object type or a set of
subsystem-object types.
The combination of command and object type determines the required parameter
tokens that must appear in the request buffer and, in some cases, the parameter tokens
that may optionally be supplied. Some command and object-type combinations
neither require nor accept parameter tokens.
All parameter tokens defined by DNS are structured tokens. Most response tokens are
structured tokens. All tokens appearing in error lists are simple tokens.
Commands that update the DNS database return no response tokens other than ZSPI-
TKN-RETCODE, ZSPI-TKN-OBJNAME (the name that was updated), and error lists.
Inquiry commands (GETVERSION, INFO, LISTOPENS and STATUS) return response
tokens in addition to ZSPI-TKN-RETCODE and error lists.