 |
HP OpenVMS DCL Dictionary
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
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.
Description
The COPY/FTP command copies files to and from remote nodes using the
File Transfer Protocol (FTP). The services provided by this command are
a subset of the architected features of FTP (see vendor documentation
for usage of their supplied FTP program).
For OpenVMS to OpenVMS
Transfers
If both machines support OpenVMS structured transfers, the /BINARY,
/ASCII, and /FDL qualifiers will be ignored. The cooperating OpenVMS
FTP client and server will automatically transfer the file with proper
OpenVMS attributes.
|
COPY/FTP commonly supports the asterisk wildcard character (*) in
remote file specifications.
Qualifiers
/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".
/ASCII
Used to identify an ASCII file (text file). /ASCII is the default.
/BINARY
Required to identify binary files.
/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.
/LOG
Displays a message at SYS$OUTPUT when a file is transferred.
/NOSTRUVMS
Used to explicitly disable the negotiation of STRU OpenVMS transfers.
Otherwise, some servers will immediately abort when negotiating the
feature.
/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 (default)
|
The FTP client initiates the data connection.
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.
/VERBOSE
/NOVERBOSE
Specifies whether all messages (including banner messages) are to be
displayed on the terminal. By default, disables the display of the
messages.
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.
|
