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 /SSL
/SSL=option
Controls whether the FTP client uses secure SSL sockets for the
connection. The following table describes the /SSL options:
Option Description
CCC Clear Control Channel connection option is useful
when the copy must pass through a firewall. The
Control Channel data is not encrypted so the
firewall knows which port to open for the Data
Channel.
DATA All transmission data is encrypted.
(default)
The underlying TCP/IP Networking product must recognize this
qualifier and must support SSL encryption in order for this
qualifier to have an effect.
2.9 /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.