HP 3000 Manuals HP 3000 Manuals
Chapter 2
FTP User Commands:Quick Reference
This chapter provides a quick reference of the syntax and usage of the
FTP user commands. The commands are listed in alphabetic order.
FTP user commands can be entered in upper case or lower case letters.
Abbreviations for user commands are not supported.
To stop a file transfer or directory listing in progress, you can use
CTRL-Y. You are prompted to exit FTP, cancel the transfer, or continue.
From the FTP prompt you can exit by entering QUIT or pressing the Break
key.
: mpecommand From within an FTP session you can execute
an MPE XL command or program by entering a
colon (:) followed by the command or
program name. After the command is
executed, or the program is exited, you are
returned to your FTP session.
? A synonym for the HELP command.
ASCII Sets the FTP file transfer type to ASCII.
This is the default when you first enter
the FTP program.
BINARY Sets the FTP file transfer type to binary.
CD remotedirectory Changes the working directory on the remote
host to the directory specified.
BYE A synonym for the QUIT command.
CASE When using the MPUT command, turns on or
off the feature to force resulting
filenames to lower case. When case is off,
resulting file names are all upper case.
The default is off.
CLOSE Closes the remote connection but remains in
the FTP program.
DEBUG Turns on or off the terminal screen display
of the commands and parameters that are
sent to the remote host. The default is
off.
DELETE remotefilename Deletes the remote file specified. A
directory path may be included with
remotefilename.
DIR [ remotedirectory [ localfile ]] Writes the requested remotedirectory
listing to the terminal, or to a local file
if specified. If remotedirectory is not
specified, the current remote working
directory contents are listed.
DISCONNECT A synonym for the CLOSE command.
EXIT A synonym for the QUIT command.
EXITONERROR Turns on or off the feature to exit an FTP
session when an error is detected. The
last error and message are saved in system
variables (enter SHOWVAR FTP@ to display).
Useful for batch jobs using FTP commands.
The default is off.
Table 2-0. (cont.)
FORM [NONPRINT] Sets the FTP file transfer form to the
specified format. The only supported form
is NONPRINT. Entering FORM without a
parameter displays the supported format.
GET remotefile [ localfile ][; buildparms] Transfers the remote file specified to a
local file. Build parameters may be used
to change how the file is stored on MPE XL.
If a local file name is not specified, the
file is saved with the same name as the
remote file name (assuming a legal file
name).
HELP [ ftpcommand] Displays a list of the valid FTP user
commands. If an FTP user command is
specified with HELP, a brief description of
the command is displayed. You can also use
the HELP command for information on
specific FTP messages and errors, and the
supported build parameters (buildparms).
LS [ remotedirectory [ localfile] ] Displays the contents of a remote
directory, one file per line. If a
localfile name is specified, the listing
will be saved to the file specified. If
remotedirectory is not specified, the
current remote working directory contents
are listed.
MDELETE remotefiles Delete multiple files on the remote system.
MGET remotefiles [; buildparms] Retrieve multiple files from the remote
system. Build parameters can be specified
and apply to all files in the transfer.
The resulting local files will have the
same name as the remote files. Note that
MPE XL file names are exclusively upper
case.
MODE [STREAM] Sets the FTP file transfer mode to the
specified mode. The only supported mode is
STREAM. Entering MODE without a parameter
displays the supported format.
MPUT localfiles Transfer multiple files using wildcard
characters in the localfiles parameter.
Optionally, build parameters can be
specified if the remote system is an MPE XL
system. The build parameters affect each
file in the transfer. Non-MPE XL FTP
servers will not interpret the build
parameters as intended. The resulting file
names are in upper case letters unless you
use the CASE command to force the resulting
file names to all lower case letters.
Table 2-0. (cont.)
OPEN remotehostname Opens a connection to the remote host
specified. Must be either an IP address or
an NS node name.
PROMPT Toggle interactive prompting. Interactive
prompting is used during multiple file
transfers to allow the user to selectively
retrieve or restore files, and during
multiple file deletes to selectively
delete. If prompting is turned off, the
default for MGET and MPUT is to transfer
all files, and the default for MDELETE is
to delete all files.
PUT localfile [ remotefile] Transfers a local file to a file on the
remote system. If the remote file name is
not specified, the file is saved with the
local file name (assuming a legal file
name). Optionally, build parameters can be
specified if the remote system is an MPE XL
system.
PWD Displays the name of the remote working
directory on the terminal.
QUIT Closes the connection to the remote system
and exits from FTP.
RECV remotefile [ localfile ][; buildparms] A synonym for the GET command.
QUOTE string Sends server commands to the remote host.
Used for troubleshooting.
REMOTEHELP [servercommand] Displays the remote host FTP server
commands supported. If a server command is
specified with the REMOTEHELP command, a
brief description of the command is
displayed. (Implementation dependent).
RENAME remotefile newname Renames a remote file.
SEND localfile [remotefile] A synonym for the PUT command.
STRUCT [FILE] Sets the FTP file transfer structure to the
specified structure. The only supported
structure is FILE. Entering STRUCT without
a parameter displays the supported
structure type.
TYPE [ transfertype] Sets the FTP file transfer type to the
specified type. If a transfer type is not
included, the current file transfer type is
displayed. The supported transfer types
are ASCII and BINARY. The default is ASCII.
USER username Used to enter a logon name in order to
establish a session on the remote host. A
connection to the remote host must already
have been established using OPEN.
VERBOSE Turns on or off the display of responses
from the remote host. The default is on.