TCPIP$UCP_HELP.HLB  —  SET  NAME_SERVICE
    Configures the BIND resolver and designates a BIND server. By
    default, all settings are process specific.

    o  To make modifications that are systemwide, use the /SYSTEM
       qualifier.

    o  The local host's domain is used as the default domain unless
       you also specify /DOMAIN.

    o  To reload the BIND server databases, use the /INITIALIZE
       qualifier.

    o  /NOSERVER does not require any options.

    Related commands: SHOW NAME_SERVICE,
    SET CONFIGURATION NAME_SERVICE

    Format

      SET NAME_SERVICE   [ /CLUSTER=dev:[directory] ]

                         [ /DISABLE ]

                         [ /[NO]DOMAIN=domain ]

                         [ /ENABLE ]

                         [ /INITIALIZE ]

                         [ /[NO]PATH=domain ]

                         [ /RETRY=number of retries ]

                         [ /[NO]SERVER=host ]

                         [ /SYSTEM ]

                         [ /TIMEOUT=seconds ]

                         [ /TRANSPORT=protocol ] )

1  –  Restrictions

    The /SYSTEM qualifier requires the the SYSPRV or BYPASS and
    SYSNAM privileges. The /INITIALIZE qualifier requires the BYPASS,
    READALL, or SYSPRV privileges.

2  –  Qualifiers

2.1    /CLUSTER

       /CLUSTER=dev:[directory]

    Optional.

    Specifies the common BIND directory. By default, the clusterwide
    common directory is common-disk:[TCPIP$BIND_COMMON]. This
    qualifier reloads the BIND database on every master BIND server
    running in the OpenVMS Cluster.

    This qualifier must be used with the /INITIALIZE qualifier.

2.2    /DISABLE

    Optional.

    Disables the BIND resolver. All name and address lookups are now
    directed to the local hosts database. Use with /SYSTEM.

2.3    /DOMAIN

       /DOMAIN=domain
       /NODOMAIN=domain

    Optional.

    Defines the default domain. The default domain is appended to
    host name references made from the local process.

    /NODOMAIN deletes the process-specific definition of the domain.
    Do not use with /SYSTEM.

2.4    /ENABLE

    Optional. Default: Not enabled.

    Enables the BIND resolver. Must be used with /SYSTEM.

2.5    /INITIALIZE

    Optional. Default: No reloading.

    Reloads all BIND server databases and the BIND configuration
    file. Either TCPIP$ETC:RNDC.CONF or TCPIP$ETC:RNDC.KEY must be
    set up to allow for secure communication between the user and
    the BIND server. For more information, refer to the HP TCP/IP
    Services for OpenVMS Management manual.

2.6    /PATH

       /PATH=domain
       /NOPATH=domain

    Optional. Requires the SYSNAM privilege.

    Defines the BIND resolver's domain search list.

    To specify multiple domains, list them by search preference.
    The resolver starts with the first domain on the list, and
    continues to search each domain until the name is found or until
    all domains have been exhausted and the lookup fails.

    /NOPATH removes domains from the list.

    If you define a domain list and then issue another SET NAME_
    SERVICE /PATH command, TCP/IP Services appends the new domains to
    the end of the list.

    If no search list is defined, the default behavior of the BIND
    resolver is to do a lookup on the name as you typed it. If that
    lookup fails, then the default domain is appended and the lookup
    is attempted again.

2.7    /RETRY

       /RETRY=number of retries

    Optional. Default: four retries.

    Specifies the number of times that the BIND resolver attempts to
    contact a BIND server if previous tries fail.

2.8    /SERVER

       /SERVER=host
       /NOSERVER=host

    Optional.

    Specifies the host name or address of the BIND server or servers
    that the resolver will query.

    To specify multiple hosts, list them by request preference. The
    resolver sends the first lookup request to the first host on the
    list.

    /NOSERVER removes hosts from the list.

    If you define a server list and then issue another
    SET NAME_SERVICE /SERVER command, TCP/IP Services appends the
    new servers to the end of the list.

    Do not use /NOSERVER with /SYSTEM.

2.9    /SYSTEM

    Optional. Default: Changes are process specific.

    Makes your settings systemwide.

2.10    /TIMEOUT

       /TIMEOUT=seconds

    Optional. Default: 4 seconds.

    Specifies the timeout interval for the BIND resolver's requests
    to a server.

    When the BIND resolver is used by the auxiliary server, the
    following conditions are true:

    o  The number of retries is one.

    o  The timeout interval is 1 second.

    o  The timeout interval increases by the power of two for each
       retry, as shown in the following table:

                       If Retries=4
    Current settings:  and Timeout=4

    Retry              Timeout interval is:

    First              4 seconds
    Second             8 seconds
    Third              16 seconds
    Last               32 seconds
                       Total = 1 minute for one server
                       If a second BIND server exists and both
                       servers time out, total = 2 minutes

2.11    /TRANSPORT

       /TRANSPORT=protocol

    Optional. Default: UDP.

    Protocol used for communicating with a BIND server. Specify one
    of the following:

    o  UDP

    o  TCP

    o  SCTP

3  –  Examples

    1.TCPIP> SET NAME_SERVICE /SERVER=(PARROT,SORA,JACANA) /SYSTEM /ENABLE

      Defines hosts PARROT, SORA, and JACANA as systemwide BIND
      servers. Also enables the BIND resolver.

    2.TCPIP> SET NAME_SERVICE /SERVER=OSPREY

      For your process, defines host OSPREY as the BIND server. The
      servers that are defined systemwide will not be queried.
Close Help