Distributed Name Service (DNS) Management Programming Manual

Overview of the STATUS Commands
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–209
Tokens in Response Buffer
ZDNS-MAP-STATUS-DNS-BR
is the return token that provides DNS status information. It has the token number
ZDNS-TNM-STATUS-DNS-BR and the definition ZDNS-DDL-STATUS-DNS-BR.
It contains the following fields:
ZSTATE
contains the DNS state (1 = RUNNING, 2 = STOPPING).
ZDNSCONF
contains the configuration file name (local format).
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 was
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.