HELPLIB.HLB  —  COPY  /FTP
    Transfers files between hosts with possibly dissimilar file
    systems over a TCP/IP connection by invoking the FTP utility.

    Format

      COPY/FTP  input-filespec output-filespec

1  –  Parameters

 input-filespec

    Specifies the name of an existing file (the source file) to be
    copied.

 output-filespec

    Specifies the name of the output file (the destination file) into
    which the input file is copied.

2  –  Qualifiers

2.1    /ANONYMOUS

    Causes an anonymous access to the remote node or nodes.
    /ANONYMOUS is the default remote access. The password
    passed to the remote node should be in the form of
    "user@fullyqualifiednodename".

2.2    /ASCII

    Used to identify an ASCII file (text file). /ASCII is the
    default.

2.3    /BINARY

    Required to identify binary files.

2.4    /FDL

    This qualifier is optional. Causes interaction with an FDL (file
    definition language) file. If the file is being copied to the
    local OpenVMS system, a remote FDL file is sought and interpreted
    for the operation. If the file is being copied outside the local
    OpenVMS system, an FDL file is generated and copied in addition
    to the requested file. If the /FDL qualifier is specified and the
    vendor application does not support it, a warning message may be
    issued.

2.5    /LOG

    Displays a message at SYS$OUTPUT when a file is transferred.

2.6    /NOSTRUVMS

    Used to explicitly disable the negotiation of STRU OpenVMS
    transfers. Otherwise, some servers will immediately abort when
    negotiating the feature.

2.7    /PASSIVE

       /PASSIVE=option

    Controls whether the FTP client or server initiates the data
    connection. If you do not specify this qualifier, the Internet
    Protocol appropriate value is used. The values are: OFF for IPv4,
    ON for IPv6.

    The following table describes the /PASSIVE options:

    Option      Description

    OFF         The FTP server initiates the data connection.
    ON          The FTP client initiates the data connection.
    (default)
                This is often used where a firewall between the FTP
                client and server prevents the server from making an
                outbound connection.

                ON is the default value only if /PASSIVE is
                specified.

    The underlying TCP/IP Networking product must recognize this
    qualifier and must support FTP passive in order for this
    qualifier to have an effect.

    Note that the /PASSIVE qualifier is equivalent to the FTP PASV
    command.

2.8    /VERBOSE

       /VERBOSE
       /NOVERBOSE

    Specifies whether all messages (including banner messages) are to
    be displayed on the terminal. By default, disables the display of
    the messages.

3  –  Examples

    1.$ COPY/FTP/FDL/ANON rms_indexed_file.idx -
          remotehst5::"/public/rms.idx.file"

      This example transfers the OpenVMS RMS file rms_indexed_
      file.idx to the remote file public/rms.idx.file on remotehst5
      over a TCP/IP connection. Access to the remote host is
      anonymous and an FDL file is generated and copied along with
      rms_indexed_file.idx.

    2.$ COPY/FTP/VERBOSE sys$login:login.com -
          xdelta.zko.dec.com"username password"::sys$login:login.tmp

      This example transfers the OpenVMS RMS file sys$login:login.com
      to the remote file sys$login:login.tmp over a TCP/IP connection
      while specifying the user name and password on the remote
      system.

    3.$ COPY/FTP/LOG RESULTS.LOG -
      _To: grad.uq.edu.au"JONES BYRONBAY"::DKA200$:[JONES.DATA]

      In this example, the COPY/FTP command copies the file
      RESULTS.LOG to the file DKA200$:[JONES.DATA]RESULTS.LOG using
      the user account JONES, with password BYRONBAY on node grad,
      that is located in the uq.edu.au internet domain.
Close Help