Library /sys$common/syshlp/TCPIP$UCP_HELP.HLB  —  SET  CONFIGURATION  NAME_SERVICE
    When TCP/IP Services starts up, configures the BIND resolver and
    designates a BIND server. All settings are systemwide.

    Related commands: SET NAME_SERVICE,
    SHOW CONFIGURATION NAME_SERVICE

    Format

      SET CONFIG [NO]NAME_SERVICE   [ /[NO]SERVER=host]

                                    [ /[NO]DOMAIN=domain ]

                                    [ /[NO]PATH=domain ]

                                    [ /RETRY=number of retries ]

                                    [ /TIMEOUT=seconds ]

                                    [ /TRANSPORT=protocol ]

1  –  Qualifiers

1.1    /CLUSTER

       /CLUSTER=dev:[directory]

    Optional.

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

1.2    /DOMAIN

       /DOMAIN=domain
       /NODOMAIN

    Optional. Default: The local domain.

    Defines the default domain.

    /NODOMAIN deletes the definition of the domain.

1.3    /PATH

       /PATH=domain
       /NOPATH=domain

    Optional. SYSNAM privilege is required for this command.

    Defines the BIND resolver domain search list. The /NOPATH
    qualifier removes domains from the 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).

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

    If a search list is not 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.

1.4    /RETRY

       /RETRY=number of retries

    Optional. Default: Four retries.

    Number of times that the BIND resolver attempts to contact a BIND
    server if previous tries failed.

1.5    /SERVER

       /SERVER=host
       /NOSERVER=host

    Optional.

    Host name or address of the BIND server or servers that the BIND
    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 CONFIGURATION NAME_SERVICE /SERVER command, TCP/IP Services
    appends the new servers to the end of the list.

1.6    /TIMEOUT

       /TIMEOUT=seconds

    Optional. Default: 4 seconds.

    Timeout interval for the BIND resolver's requests to a BIND
    server. Represents the length of time to wait for a reply after
    each retry attempt.

    The total timeout period will be:

    timeout_value * retry_value * number_servers

1.7    /TRANSPORT

       /TRANSPORT=protocol

    Optional. Default: UDP.

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

    o  UDP

    o  TCP

    o  SCTP

2  –  Examples

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

      When TCP/IP Services starts, defines hosts PARROT, SORA, and
      JACANA as BIND servers.

    2.TCPIP> SET CONFIGURATION NAME_SERVICE /SERVER=OSPREY -
      _TCPIP> /PATH=(abc.dec.com,xyz.dec.com)

      When TCP/IP Services starts, defines host OSPREY as the BIND
      server. The BIND resolver searches the abc.dec.com domain
      first, and then searches the xyz.dec.com domain.
Close Help