Distributed Name Service (DNS) Management Programming Manual

Message Elements for the DNS Subsystem
SPI Programming Considerations for DNS
3–4 46958 Tandem Computers Incorporated
Programmatic commands for the DNS subsystem are identified by command numbers
with symbolic names of the form ZDNS-CMD- name , where name identifies the
command. For example, the name used by application programs for the ALTER
command is ZDNS-CMD-ALTER. These names represent the values that can be
assigned to the command number header token, ZSPI-TKN-COMMAND. (The
separator character varies with the language; hyphens are shown throughout this and
other DSM manuals because hyphens are used in DDL.)
These commands and the DNS subsystem’s responses to them are described in
Section 5.
Object Types The DNS subsystem supports the following programmatic object types:
ALIAS
ATYPE
COMP
CTYPE
DNS
DOM
FILE
GROUP
NAME
null
PROC
SS
SSMGR
SSOBJ
SSTYPE
SYSTEM
All commands and responses contain an object-type token in the header. For the DNS
subsystem, object types are identified in programs by symbolic names of the form
ZDNS-OBJ- name , where name identifies the object type. For example, the NAME
object type is represented by the name ZDNS-OBJ-NAME. The object-type header
token, ZSPI-TKN-OBJECT-TYPE, always has one of these values.
A response consists of a number of response records, which are groupings of tokens
giving response information about a particular object. In addition to the object-type
header token, some DNS response records contain an object-type token that identifies
the type of the object described in the response record. The name of this token is
ZDNS-TKN-OBJTYPE, and the symbolic names of its possible values are also of the
form ZDNS-OBJ- name .
Object Names Many DNS commands and responses contain object-name tokens that, when
combined with object-type information, designate which objects are to be or were
affected by the command.
In the management programming interface to the DNS subsystem, the form of an
object name depends on the object type. Object types and object names are discussed
in more detail in Section 4 under “DNS Definitions.”