Distributed Name Service (DNS) Management Programming Manual

INFO FILE Command
Using DNS in Programs: The DNS Commands
46958 Tandem Computers Incorporated 5–145
Tokens in Command Buffer
ZDNS-MAP-INFO-FILE-P
is a required structured token that describes the DNS file for which information is
requested. It has the token number ZDNS-TNM-INFO-FILE-P and the definition
ZDNS-DDL-INFO-FILE-P. It contains the following field:
ZFILENO
contains the logical file number for the file for which information is desired. If
this field is supplied as zero (or left null), information about all database files
is returned. A possible error referring to this field is:
ZDNS-ERR-INV-FILENO
Tokens in Response Buffer
ZDNS-MAP-INFO-FILE-BR
is the return token for supplying information about the file. It has the token
number ZDNS-TNM-INFO-FILE-BR and the definition ZDNS-DDL-INFO-FILE-
BR. It contains the following fields:
ZFILENO
contains the logical file number.
ZFILENAME
contains the Guardian 90 file name.
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.