Manualshelf

Distributed Name Service (DNS) Management Programming Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series
211212213214215216217218219220
INFO ALIAS Command
Using DNS in Programs: The DNS Commands
5–118 46958 Tandem Computers Incorporated
Operational Notes
If ZDNS-MAP-INFO-DNSOBJ-P is supplied, ZDNS-MAP-INFO-ALIAS-BR is
returned for each alias specified.
The uniqueness of the name supplied in ZNAME is determined by the presence of
multiple responses and/or a context token in the response buffer.
For example, if ZSPI-TKN-MAXRESP is not supplied, ZNAME is supplied as an
A, and ZDEFNODE is supplied as “*”. Then if A is found and is unique, the
response buffer contains ZDNS-MAP-LIST-BR and ZSPI-TKN-RETCODE. If A is
found but is not unique, the response buffer also contains ZSPI-TKN-CONTEXT.
On the initial request, if the alias is not found in the DNS database, the response
buffer contains ZSPI-TKN-RETCODE = ZDNS-ERR-NOTFOUND, and the error
list points to ZNAME.
When the ZDETAIL field is specified as TRUE (-1) in the ZDNS-MAP-INFO-
DNSOBJ-P structured token, the INFO ALIAS command normally returns ZDNS-
MAP-INFO-ALIAS-BR and ZDNS-MAP-INFO-ALIAS-DR. In the case where an
imported group has a member that has not been exported to the local system, the
name manager only has enough information to respond with ZDNS-MAP-INFO-
ALIAS-BR. Consequently the name manager will only return the token for which
it has the necessary information. Where tokens normally expected in the response
are not returned, the name manager will include a warning error list as follows:
ZSPI-TKN-ERRLIST
ZSPI-TKN-ERR (Error number 30, name not found)
ZSPI-TKN-TYPE (Type 6, qualified DNS name)
ZSPI-TKN-OBJNAME (Name of group member)
ZSPI-TKN-ENDLIST
For more information on the ZDETAIL field, see “Overview of the INFO
Commands” earlier in this section.
If the ZDETAIL field of ZDNS-MAP-INFO-DNSOBJ-P is TRUE, the response
buffer also contains a ZDNS-MAP-INFO-ALIAS-DR token for each alias. Detailed
information results in an additional logical database READ if:
1. ZNAME = “*” and ZDEFNODE does not contain “*”.
2. ZTYPE is non-null.
3. ZGROUP is non-null.