onslookup options

The configuration options of onslookup determine the operation and results of name server queries. These options can be specified in command-mode queries, interactive-mode queries, or by the methods described in onslookup configuration.

When you include onslookup options with the initial onslookup command, the hyphen (-) operand must immediately precede the option. If you specify onslookup options while in interactive mode, the SET subcommand must precede the option.

For example, to specify a name server (NS) type record lookup for the domain name fourex.oz in command mode you enter:

onslookup -querytype=ns fourex.oz

To submit the same request using interactive mode, enter the following sequence:

onslookup
set querytype=ns
fourex.oz

Format


|--+--------------------------------------+---------------------|
   +-all----------------------------------+   
   |           .-IN-----.                 |   
   +-class--=--+-ANY----+-----------------+   
   |           +-CHAOS--+                 |   
   |           '-HESIOD-'                 |   
   | .-nod2-.                             |   
   +-+-d2---+-----------------------------+   
   | .-nodebug-.                          |   
   +-+-debug---+--------------------------+   
   | .-defname---.                        |   
   +-+-nodefname-+------------------------+   
   +-domain--=--name----------------------+   
   +-h------------------------------------+   
   |       .-53-----------.               |   
   +-port--+-=port_number-+---------------+   
   |            .-A---------------------. |   
   +-querytype--+-=resource_record_type-+-+   
   | .-recurse---.                        |   
   +-+-norecurse-+------------------------+   
   +-retry--=--limit----------------------+   
   | .-search---.                         |   
   +-+-nosearch-+-------------------------+   
   +-sil----------------------------------+   
   +-timeout--=--interval-----------------+   
   '-V--=--+----+-------------------------'   
           '-v9-'

Parameters

-all

Prints the current values of the frequently used options to set. Information about the current default server and host is also printed.

-class=query_class

The class specifies the protocol group of the information. Changes the class to query class. See the z/OS Communications Server: IP Configuration Reference for detailed information about valid classes. The default class is IN. The option class can be abbreviated as cl.

-[no]d2

Turn exhaustive debugging mode on (d2) or off (nod2). You will not see any difference between debug, d2, and trace resolver. This turns on nslookup internal trace. The default is nod2.

-[no]debug

Turn basic debugging mode on (debug) or off (nodebug). Information is printed about the packet sent to the server and the resulting answer. The default is nodebug. The option debug can be abbreviated as deb.

-[no]defname

If set, append the default domain name to a single-component lookup request (one that does not contain a period). The default is defname. The option defname can be abbreviated as def.

-domain=name

The default domain name is appended to a lookup request depending on the state of the defname and search options. The domain search list contains the parents of the default domain if it has at least two components in its name. For example, if the default domain is CC.Berkeley.EDU, the search list is CC.Berkeley.EDU and Berkeley.EDU. Use the set srchlist command to specify a different list. Use the set all command to display the list. The option domain can be abbreviated as do.

-h

Prints a brief summary of commands.

-port=port_number

Change the default TCP/UDP name server port to port_number. The default port number is 53. The option port can be abbreviated as po.

-querytype=resource_record_type

The option querytype can be abbreviated as type.
The option querytype can also be abbreviated as qu.

Change the type of information query resource_record_type. See the z/OS Communications Server: IP Configuration Reference for detailed information about valid query types. The default resource_record_type is A.

-[no]recurse

Tell the name server to query other servers if it does not have the information. The default is recurse. The option recurse can be abbreviated as rec.

-retry=limit

Set the number of retries to limit. When a reply to a request is not received within a certain amount of time (changed with the command set timeout), the timeout period is doubled and the request is resent. The retry value controls how many times a request is sent before giving up. The default is 4. The option retry can be abbreviated as ret.

-[no]search

If the lookup request contains at least one period but does not end with a trailing period, append the domain names in the domain search list to the request until an answer is received. The default is search. The option search can be abbreviated as sea.

-sil

Suppress deprecation message.

-timeout=interval

Change the initial timeout interval for waiting for a reply to interval seconds. Each retry doubles the timeout period. The default is 5 seconds. The keyword timeout can be abbreviated as t.

-V

Sets BIND 9 mode.

-[no]vc

Always use a virtual circuit (TCP) when sending requests to the server. The default is novc. The option vc can be abbreviated as v.