Distributed Name Service (DNS) Management Programming Manual

DNS Definitions

Common Definitions

4–16 46958 Tandem Computers Incorporated

The optional var suffix indicates the type of structure as follows:

indicates that the token is the normal parameter for the command. For example,

ZDNS-MAP-INFO-SSOBJ-P is the parameter for requesting information about a

subsystem object or set of subsystem objects. Where used, such parameters must

appear exactly once in the request buffer.

PF1, PF2

are alternative forms of a single parameter. These are used in commands that deal

with type names where the type may be specified either by name or by using

OWNER/ subsystem number /TYPENUM.

Only one “-PFn” parameter may appear in a request buffer, and it may not appear

multiple times.

is used to indicate the basic response to a command. ZDNS-CMD-INFO, ZDNS-

CMD-LISTOPENS, and ZDNS-CMD-STATUS are the only commands that return

response tokens (other than ZSPI-TKN-RETCODE, ZDNS-TKN-OBJNAME, and

error lists). For example, ZDNS-MAP-INFO-COMP-BR is the basic response to an

INFO COMPOSITE command.

is used to indicate the detailed response to a ZDNS-CMD-INFO command. For

example, ZDNS-MAP-INFO-COMP-DR is the detailed response to an INFO

COMPOSITE command. The choice as to whether detailed response tokens are

returned is determined by the value of the ZDETAIL field in the request

structured token. ZDETAIL must be set to TRUE (-1) to obtain detailed responses.

Type abbreviation (as in Table 4-8) is used to indicate a var suffix for a request. For

example, to obtain a list of aliases for a subsystem object, the ZDNS-CMD-INFO

command is used with object type = ZDNS-OBJ-SSOBJ; rather than the normal

ZDNS-MAP-INFO-SSOBJ-P parameter, the management application supplies

ZDNS-MAP-INFO-SSOBJ-ALIAS to signal that ALIAS information is requested

rather than the basic information about the object.

When a variant (var) parameter is used, the response buffer for the command

contains the basic response for the variant rather than for the command object.

Continuing the above example, a request passing ZDNS-MAP-INFO-SSOBJ-

ALIAS returns ZDNS-MAP-INFO-ALIAS-BR rather than ZDNS-MAP-INFO-

SSOBJ-BR.

MEMB

is a variant used to indicate that the command is to act on group members rather

than the group itself. For example, to change a group’s membership, requesters

supply ZDNS-MAP-ALTER-GROUP-MEMB.