Distributed Name Service (DNS) Management Programming Manual

INFO DOM Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–143
ZSPI-TKN-RETCODE
is the standard SPI return token described in the Distributed Systems Management
(DSM) Programming Manual. This token is present in every response record. If its
value is zero (ZDNS-ERR-NOERR), this token indicates that the information is
successfully retrieved. If ZSPI-TKN-RETCODE is not zero, the information is not
successfully retrieved. Where a non-zero return code is present, the response
buffer may contain one or more error lists. Even if the return code is zero, the
response may still contain error lists that describe warnings.
ZSPI-TKN-ERRLIST
is a standard SPI error list, as described in the Distributed Systems Management
(DSM) Programming Manual. The list ends with the token ZSPI-TKN-ENDLIST.
ZSPI-TKN-CONTEXT
is the standard SPI context token described in the Distributed Systems Management
(DSM) Programming Manual.
Operational Notes
One response with format ZDNS-DDL-INFO-DOM-BR is returned for each
domain.
If ZDETAIL is supplied with a value of TRUE, one ZDNS-MAP-INFO-DOM-DR
for each system in the domain is also returned.
When information about multiple domains is returned in a single response buffer,
each ZDNS-MAP-INFO-DOM-BR token (and corresponding ZDNS-MAP-INFO-
DOM-DR tokens, if requested) is enclosed in a standard SPI data list.
[ZSPI-TKN-DATALIST]
[ZDNS-MAP-INFO-DOM-BR] (first domain)
[ZDNS-MAP-INFO-DOM-DR] (first domain, first system)
[ZDNS-MAP-INFO-DOM-DR] (first domain, second system)
[ZSPI-TKN-RETCODE] = 0
[ZSPI-TKN-DATALIST]
[ZDNS-MAP-INFO-DOM-BR] (second domain)
[ZDNS-MAP-INFO-DOM-DR] (second domain, first system)
[ZDNS-MAP-INFO-DOM-DR] (second domain, second system)
[ZSPI-TKN-RETCODE] = 0
[ZSPI-TKN-CONTEXT] (if more responses are available)