TCPIP$UCP_HELP.HLB  —  CONVERT  /UNIX
    The CONVERT/UNIX commands read a TCP/IP Services database and
    convert the information to a UNIX-formatted (sequential) database
    file.

1  –  BIND

    Creates a BIND server database and populates it with records
    from the local host and MX databases. This command will create
    either a forward translation file or a reverse translation file.
    If you specify a domain.name that ends in IN-ADDR.arpa, a reverse
    translation file is created.

    Related commands: SET HOST, SET MX_RECORD

    Format

      CONVERT/UNIX BIND   /DOMAIN=domain.name

                         [ /[NO]LOG ]

1.1  –  Qualifiers

1.1.1    /DOMAIN

       /DOMAIN=domain.name

    Required.

    Domain for which to extract data. Determines whether to perform
    forward translation or reverse translation. The following
    restrictions and instructions apply:

    o  The domain name must be fully qualified.

    o  The closing dot is not required.

    o  Do not use wildcards.

    o  Specify up to four parts of the IP address for varying degrees
       of selectivity. For example:

       /DOMAIN=16.IN-ADDR.arpa is less selective.

       /DOMAIN=8.20.16.IN-ADDR.arpa is more selective.

    The end of domain.name determines whether a forward or reverse
    translation is performed. For example:

    o  If the domain name ends in IN-ADDR.arpa:

       -  Reverse translation is performed.

       -  The domain is some part of an IP address, reversed, and
          added to IN-ADDR.arpa.

       -  The selection includes the contents of the hosts database
          in the output.

    o  If the domain name ends in anything else (for example,
       /DOMAIN=DAW.MAG.COM):

       -  Forward translation is performed.

       -  All hosts in domain.name or in any of its subdomains are
          selected for the output file.

       -  CONVERT/UNIX BIND does a forward translation and selects
          hosts in DAW.MAG.COM and in its subdomains.

1.1.2    /LOG

       /LOG
       /NOLOG

    Optional. Default: /NOLOG.

    Shows records as they are processed.

1.2  –  Examples

    1.TCPIP> CONVERT/UNIX BIND /DOMAIN=KESTREL.SMALL.FALCON

      On host KESTREL, creates a BIND server database with default
      file name SYS$SPECIFIC:[TCPIP$BIND]KESTREL_SMALL_FALCON.DB.

      BIND and MX records for the host's domain,
      kestrel.small.falcon, are extracted, converted, and written
      to KESTREL_SMALL_FALCON.DB.

    2.TCPIP> CONVERT/UNIX BIND /LOG /DOMAIN=ABC.COM

      Creates a BIND server database. The /LOG qualifier indicates
      that records will be displayed as they are processed.

2  –  HOST

    Reads the hosts database and converts the information to an ASCII
    file formatted for use as a hosts file on a UNIX system.

    The name and location of the hosts database is specified by the
    logical name TCPIP$HOST. If this name is not defined, the command
    looks for TCPIP$HOST.DAT in your current directory.

    Related commands: CREATE HOST, SET HOST, SHOW HOST

    Format

      CONVERT/UNIX HOST  [ destination_file ]

                         [ /BYADDRESS ]

                         [ /LOG ]

2.1  –  Restrictions

    Requires:

    o  Read access to the hosts database.

    o  Write access to []ETC.HOSTS.

2.2  –  Parameters

 destination_file

    Optional. Default: []ETC.HOSTS (UNIX formatted)

    Allows you to specify the name for the new file.

2.3  –  Qualifiers

2.3.1    /BYADDRESS

    Optional. Default: Sorts by name.

    Sorts entries in the converted file by IP address.

2.3.2    /LOG

    Optional. Default: No display.

    Interactively displays the processing.

2.4  –  Examples

    1.TCPIP> CONVERT/UNIX HOST

      Converts the hosts database TCPIP$HOST to an ASCII file that
      is formatted for use as a hosts file on a UNIX system. The
      resulting file is named (default) ETC.HOSTS in the current
      directory and can be used on a UNIX system as the file
      /etc/hosts.

3  –  NETWORK

    Converts the networks database to an ASCII file formatted for use
    on a UNIX system.

    The name and location of the networks database is specified by
    the logical name TCPIP$NETWORK. If this name is not defined, the
    command looks for TCPIP$NETWORK.DAT in your current directory.

    Related commands: CREATE NETWORK, SET NETWORK, SHOW NETWORK

    Format

      CONVERT/UNIX NETWORK  [ destination_file ]

                            [ /BYADDRESS ]

                            [ /LOG ]

3.1  –  Restrictions

    Requires:

    o  Read access to the hosts database.

    o  Write access to the file []ETC.NETWORKS.

3.2  –  Parameters

 destination_file

    Optional. Default: []ETC.NETWORKS (UNIX formatted).

    Specifies the name of the new UNIX formatted file.

3.3  –  Qualifiers

3.3.1    /BYADDRESS

    Optional. Default: Sorts by name.

    Sorts the converted file by network number.

3.3.2    /LOG

    Optional. Default: No display.

    Displays messages generated during processing.

3.4  –  Examples

    1.TCPIP> CONVERT/UNIX NETWORK /LOG

      Converts the networks database (TCPIP$NETWORK) to the ASCII
      file []ETC.NETWORKS. This resulting file can be used as a
      networks database file /etc/networks on a UNIX system. The
      /LOG qualifier displays each record as it is converted.

    2.TCPIP> CONVERT/UNIX NETWORK NETWORKS.TXT

      Converts the networks database (TCPIP$NETWORK) to the ASCII
      file []NETWORKS.TXT. The resulting file may be used as the
      networks database file /etc/networks on a UNIX system.
Close Help