Distributed Name Service (DNS) Management Programming Manual

Overview of the INFO Commands
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–111
Some ZDNS-CMD-INFO parameters contain a detail flag (ZDETAIL) that has a default
value of FALSE (0). If ZDETAIL is FALSE, only the basic response token (name ends
in -BR) is returned for each name. If TRUE, a single detain token (name ends in -DR) is
returned for each response. For example, if ZDNS-CMD-INFO is used with object
type ZDNS-OBJ-COMP, and the ZDETAIL field of ZDNS-MAP-INFO-COMP-P is
FALSE or left null, only ZDNS-MAP-INFO-COMP-BR is returned. If ZDETAIL is
TRUE, ZDNS-MAP-INFO-COMP-DR is also returned.
The value of ZDETAIL can also control the presence of variant (var) tokens in the
response buffer. Again, if the object type is ZDNS-OBJ-COMP and ZDETAIL is
supplied with a value of TRUE, one ZDNS-MAP-INFO-SSOBJ-BR is returned for each
component of the composite object.
Variant tokens are included in detailed responses in those cases where DNS has a
defined limit on the number of such tokens that might be returned:
Components in a composite (8)
Component types in a composite type (8)
Subsystems managed by a subsystem manager (128)
Systems in a domain (254)
In cases where there is no maximum number of potential responses (members in a
group, groups in which an object is a member of, subsystem-object types that are valid
for an alias, aliases of a name, and so on), variant requests must be used. For example,
to identify the members in a group, ZDNS-CMD-INFO is used with object type ZDNS-
OBJ-GROUP and parameter ZDNS-MAP-INFO-GROUP-MEMB. The name manager
responds with one ZDNS-MAP-INFO-MEMB-BR for each member of the group.
Basic responses are designed so that they result in the minimum number of I/O
operations in the name manager. Detailed responses, in general, require additional
I/O operations. Those cases where detailed information is available without
additional I/O are pointed out in the subsections that follow.
The value of ZDETAIL corresponds closely with the LIST and INFO commands in
DNSCOM; in general, DNSCOM specifies ZDETAIL TRUE on INFO commands and
FALSE on LIST commands.
Additional considerations for the use of ZDETAIL are described in each of the
subsections that follow.