The MultiNet FTP utility uses the Internet-standard FTP (File Transfer Protocol) to transfer files between the local host and a remote host. This appendix lists the commands you can use during an FTP session.
The below table lists the MultiNet FTP commands:
Command |
Description |
ACCOUNT |
Sends an account name to the remote FTP server. |
AGET |
Appends a remote file to a file on the local host. |
APPEND GET |
Appends remote_file from the remote host to local_file on the local host. |
APPEND PUT |
Appends local_file on the local host to remote_file on the remote host. |
APPEND RECEIVE |
Appends remote_file from the remote host to local_file on the local host. |
APPEND SEND |
Appends local_file on the local host to remote_file on the remote host. |
APUT |
Appends local_file on the local host to remote_file on the remote host. |
ASCII |
Sets the transfer type to ASCII for transferring text files. |
ATTACH |
Detaches the terminal from the calling process and reattaches it to another process. |
AUTHENTICATE |
Requests the FTP server to enter into TLS authentication mode as defined in RFC 4217. This can be done after connecting to the remote server and before sending the USER command. |
BELL |
Turns on, off, or toggles the sounding of a bell when a file transfer completes. |
BINARY |
Sets the transfer type for transferring binary files. |
BLOCK |
Reads files of TYPE I, STRUCTURE FILE using block I/O. |
BYE |
Closes the current FTP connection, but remains in the FTP command interpreter. |
BYTE |
Sets the transfer byte size to size. |
CCC |
Changes an encrypted command connection back to clear text. This command is provided so that an encrypted command connection can be put in clear text mode allowing firewalls and NAT devices to recognize and process PORT/PASV commands and their responses. The file transfer protection level should be established before setting the command channel to clear text mode. |
CD |
Changes the current working directory on the remote host to dir. |
CDUP |
Changes the current working directory on the remote host by moving up one level in the directory system. |
CLOSE |
Closes the current FTP connection, but remains in the FTP command interpreter. |
CONFIRM |
Turns on, off, or toggles (the default) interactive confirmation of each command in a MULTIPLE command. |
CONNECT |
Establishes a connection to the FTP server on host. |
CPATH |
Changes the current working directory on the remote host to dir. |
CREATE-DIRECTORY |
Creates the directory dir on the remote host. |
CWD |
Changes the current working directory on the remote host to dir. |
DEFLATE |
Specifies the amount of compression for MODE DEFLATE data compression. |
DELETE |
Deletes a file on the remote host. |
DIRECTORY |
Obtains an annotated listing of the files on the remote host. |
DISCONNECT |
Closes the current FTP connection without waiting for a confirming response from the remote host, but remains in the FTP command interpreter. |
EXIT |
Closes the current FTP connection and exits FTP. |
EXIT-ON-ERROR |
Turns on, off, or toggles (the default) whether or not FTP automatically exits when an error occurs. |
GET |
Copies remote_file from the remote host to local_file on the local host. |
HASH |
Turns on, off, or toggles (the default) the display of hash marks (#) for each data buffer transferred. |
HELP |
Displays FTP help information. |
LCD |
Changes the current working directory on the local host to dir. |
LDIR |
Displays the contents of your local working directory. LDIR is the same as LOCAL-DIRECTORY. |
LIST |
Displays automatic login information for host. |
LOCAL-CD |
Changes the current working directory on the local host to dir. |
LOCAL-DIRECTORY |
Displays the contents of your local working directory. |
LOCAL-PWD |
Displays the current working directory on the local host. |
LOGIN |
Identifies you to a remote FTP server. |
LPWD |
Displays the current working directory on the local host. |
LS |
Displays a names-only listing of files on the remote host. |
MDELETE |
Deletes multiple files on the remote host. |
MGET |
Copies multiple files from the remote host to the local host. |
MKDIR |
Creates the directory dir on the remote host. |
MPUT |
Copies multiple files from the local host to the remote host. |
MULTIPLE DELETE |
Deletes multiple files on the remote host. |
MULTIPLE GET |
Copies multiple files from the remote host to the local host. |
MULTIPLE PUT |
Copies multiple files from the local host to the remote host. MULTIPLE PUT is a synonym for MULTIPLE SEND. See MULTIPLE SEND for more information. |
MULTIPLE RECEIVE |
Copies multiple files from the remote host to the local host. |
MULTIPLE SEND |
Copies multiple files from the local host to the remote host. |
OPEN |
Establishes a connection to a host system. |
PASSIVE |
Enables or disables "passive" mode for file transfers with FTP servers on the opposite side of "firewall" gateways. |
PASSWORD |
Sends a password to the remote FTP server explicitly, which normally happens automatically during login. |
PORT |
Specifies a TCP port number to use for the FTP control connection. |
PROMPT-FOR-MISSING-ARGUMENTS |
Turns on, off, or toggles (the default) whether or not FTP prompts for missing command arguments automatically. |
PROMPT-ON-CONNECT |
Turns on, off, or toggles (the default) whether or not FTP prompts for a user name and password after making a connection automatically. |
PROTECTION |
Sets the protection level for data transfers as specified in RFC 4217. Use CLEAR to transfer files over a clear text connection. This is the default after specifying the username and password to an authenticated connection. Use PRIVATE to transfer files over an encrypted connection with data integrity checking. |
PUSH |
Starts and attaches a DCL subprocess. |
PUT |
Copies local_file on the local host to remote_file on the remote host. |
PWD |
Displays the current working directory on the remote host. |
QUIT |
Closes the current FTP connection and exits FTP. |
QUOTE |
Sends a string to the FTP server verbatim. |
RECEIVE |
Copies remote-file from the remote host to local-file on the local host. |
RECORD-SIZE |
Sets or displays the record size for IMAGE mode transfers. |
REMOTE-HELP |
Displays information about commands available on the FTP server. |
REMOVE-DIRECTORY |
Deletes a directory on the remote host. REMOVE-DIRECTORY is the same as RMDIR. |
RENAME |
Renames files on the remote host. |
RETAIN |
Turns on, off, or toggles (the default) the retention of OpenVMS version numbers in file transfers. |
RM |
Deletes a file on the remote host. |
RMDIR |
Deletes a directory on the remote host. |
SEND |
Copies local_file on the local host to remote_file on the remote host. |
SET |
Sets automatic login information for host. |
SHOW-DIRECTORY |
Displays the current working directory on the remote host. SHOW DIRECTORY is the same as PWD. |
SITE |
Specifies commands that are interpreted by the MultiNet FTP server for use on the server host. |
SPAWN |
Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. |
STATISTICS |
Turns on, off, or toggles (the default) STATISTICS mode. |
STATUS |
Displays the status of the FTP server. |
STREAM |
Turns on, off, or toggles (the default) the creation of binary output files as Stream_LF files. |
STRUCTURE |
Sets the transfer structure to structure. |
TAKE |
Interprets FTP commands in a file. |
TENEX |
Changes the byte size for transferring binary files to or from a TOPS-20 system. |
TYPE |
Sets the transfer type to type. |
USER |
Identifies you to the remote FTP server. |
VERBOSE |
Turns on, off, or toggles (the default) VERBOSE mode. |
VERSION |
Prints information about the FTP program version. |
Sends an account name to the remote FTP server. Use this command when connecting to hosts that require account specifications in addition to a user name.
ACCOUNT account
account
Specifies the name of the account to be sent to the remote FTP server.
Use this command only when connected to a remote host.
EXAMPLE.COM> account sales
<Account “sales" accepted
EXAMPLE.COM>
Appends a remote file to a file on the local host. AGET is a synonym for APPEND GET.
AGET remote_file [local_file]
Appends remote_file from the remote host to local_file on the local host. APPEND uses the current settings for type, mode, and structure during file transfers. APPEND GET is the same as AGET and APPEND RECEIVE.
APPEND GET remote-file [local-file]
remote_file
Specifies the name of the file on the remote host from which to copy.
local_file
Specifies the name of a file on the local host to which the file is to be appended.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the GET command.
· You cannot use the APPEND GET command in STRUCTURE VMS mode. If you try to do this, FTP toggles temporarily into STRUCTURE FILE mode for the transfer.
This example shows how to append a remote file to a file on the local host.
EXAMPLE.COM> append get login.com
To local file: RETURN
<ASCII retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Appends local_file on the local host to remote_file on the remote host. APPEND PUT is a synonym for APPEND SEND.
APPEND PUT local_file remote_file
Appends remote_file from the remote host to local_file on the local host. APPEND RECEIVE is a synonym for APPEND GET.
APPEND RECEIVE remote_file [local_file]
Appends local_file on the local host to remote_file on the remote host. APPEND SEND uses the current settings for type, mode, and structure during file transfers. APPEND SEND is the same as APUT and APPEND PUT.
APPEND SEND local_file remote_file
local_file
Specifies the name of the file on the local host to be copied.
remote_file
Specifies the destination file name on the remote host.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the APPEND SEND command.
· The MultiNet FTP Server cannot APPEND to a file in STRUCTURE VMS mode.
This example shows how to append the LOGIN.COM file to the remote file FOO.COM.
EXAMPLE.COM>append send login.com foo.com
<ASCII Store of ST_ROOT:[TMP]FOO.COM;12 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Appends local_file on the local host to remote_file on the remote host. APUT is a synonym for APPEND PUT and APPEND SEND.
APUT local_file remote_file
Sets the transfer type to ASCII for transferring text files. ASCII is a synonym for TYPE.
ASCII
Detaches the terminal from the calling process and reattaches it to another process. Use the SPAWN SHOW PROCESS /SUBPROCESSES command to list the names of subprocesses. Use the DCL LOGOUT command to return to the original process. If the MULTINET_DISABLE_SPAWN logical is enabled, ATTACH does not work.
ATTACH process-name
process_name
Specifies the name of a process to which you want your terminal attached. (Not all subprocesses can be attached; some testing may be required.)
Turns on, off, or toggles the sounding of a bell when a file transfer completes.
BELL mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to toggle the bell feature.
FTP>bell
[Bell will now ring when operations complete]
FTP>
Sets the transfer type for transferring binary files. BINARY is a synonym for TYPE.
BINARY
Reads files of TYPE I, STRUCTURE FILE using block I/O.
BLOCK
Use this command only when connected to a remote host.
Closes the current FTP connection, but remains in the FTP command interpreter.
BYE
Use this command only when connected to a remote host.
This example shows how to disconnect an FTP connection.
EXAMPLE.COM>bye
<QUIT command received. Goodbye.
FTP>
Sets the transfer byte size to size.
BYTE size
size
Specifies the size to which to set the transfer byte size. The only permitted value is 8 bits.
This example shows how to set the transfer byte size to 8 bits.
EXAMPLE.COM>byte
Type: Logical-Byte (Byte Size 8), Structure: VMS, Mode: Stream
EXAMPLE.COM>
Changes the current working directory on the remote host to dir. CD is the same as CPATH and CWD.
CD dir
dir
Specifies the name of the directory to use as the current working directory.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the CD command.
This example shows how to change the default directory on the remote host to USERS:[ANONYMOUS].
EXAMPLE.COM>cd [anonymous]
<Connected to USERS:[ANONYMOUS].
EXAMPLE.COM>
Changes the current working directory on the remote host by moving up one level in the directory system.
CDUP
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the CDUP command.
This example shows how to move up one directory on the remote host.
EXAMPLE.COM>cdup
<Connected to USERS:[000000].
EXAMPLE.COM>
Closes the current FTP connection, but remains in the FTP command interpreter. CLOSE is a synonym for BYE.
CLOSE
Turns on, off, or toggles (the default) interactive confirmation of each command in a MULTIPLE command.
CONFIRM mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to enable CONFIRM mode and use it with MGET to prompt for each file name.
EXAMPLE.COM>confirm
[You will be asked to confirm each transaction in a multiple transaction]
EXAMPLE.COM>mget *.com
<List started.
<Transfer completed.
GET copy.com? [YES] n
GET login.com? [YES] y
<VMS retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Establishes a connection to the FTP server on host. CONNECT is the same as OPEN.
CONNECT host
host
Specifies the name of the host to which to establish a connection. host is specified as either a symbolic host name or as a dotted Internet address.
Do not use this command when connected to a remote host.
This example shows how to connect to the EXAMPLE.COM host.
FTP>connect
example.com
Connection opened (Assuming 8-bit connections)
<EXAMPLE.COM MultiNet FTP Server Process
<5.5 (nnn) at Fri 9-Apr-2019 7:42am-PST
EXAMPLE.COM>
Changes the current working directory on the remote host to dir. CPATH is a synonym for CD.
CPATH dir
Creates the directory dir on the remote host. CREATE DIRECTORY is the same as MKDIR.
CREATE-DIRECTORY dir
dir
Specifies the name of the directory to create.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the CREATE-DIRECTORY command.
This example shows how to create the subdirectory test.
EXAMPLE.COM>create-dir test
<“USERS:[HOLMES.TEST]” Directory created
EXAMPLE.COM>
Changes the current working directory on the remote host to dir. CWD is a synonym for CD.
CWD dir
Specifies how much mode Z compression to use for data transfers.
DEFLATE LEVEL n
n
Specifies the level of compression. The default level is -1, which is a balances compute intensity and data compression. 0 is no compression, 1 is best speed, 9 is best compression.
· Use this command after logging in
This example shows how to set the deflation (compression).
EXAMPLE.COM>deflate level 1
<MODE Z LEVEL set to 1.
EXAMPLE.COM>
Deletes a file on the remote host. DELETE is the same as RM.
DELETE file
file
Specifies the name of the file to delete.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the DELETE command.
This example shows how to delete the file FOO.BAR from the remote host.
EXAMPLE.COM>del foo.bar
<File deleted ok, file USERS:[HOLMES]FOO.BAR;1.
EXAMPLE.COM>
Obtains an annotated listing of the files on the remote host.
DIRECTORY [file_spec] [output_file]
file_spec
Specifies the file specification to use in the directory lookup on the remote host. If you do not specify file_spec, the current working directory on the remote host is used. Any wildcards you specify are interpreted in the context of the remote host operating system.
output_file
Specifies the name of the file to which to write the directory listing. If you do not specify output_file, the list is directed to SYS$OUTPUT:.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the DIRECTORY command.
This example shows how to retrieve list of files that match the wildcard *.COM.
EXAMPLE.COM>dir *.com
<List started.
USERS: [HOLMES]
COPY.COM;4 2 1-APR-2019 08:49 [HOLMES] (RWD,RWD,R,R)
LOGIN.COM;1 5 1-APR-2019 01:25 [HOLMES] (RWD,RWD,R,R)
Total of 7 blocks in 2 files.
<Transfer completed.
EXAMPLE.COM>
Closes the current FTP connection without waiting for a confirming response from the remote host, but remains in the FTP command interpreter.
DISCONNECT
Use this command only when connected to a remote host.
EXAMPLE.COM>disc
FTP>
Closes the current FTP connection and exits FTP. QUIT is the same as EXIT.
EXIT
EXAMPLE.COM>exit
<QUIT command received. Goodbye.
$
Turns on, off, or toggles (the default) whether or not FTP exits automatically when an error occurs.
If EXIT-ON-ERROR is enabled, FTP exits automatically if an error occurs. After exiting, the DCL symbol $STATUS contains the status code of the last error to occur. If the last error was reported by the FTP server, it contains the value %X1000002C + (%X10000 * ftp_error_code).
EXIT-ON-ERROR mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to use EXIT-ON-ERROR to exit automatically when an error occurs. Here the error was not an FTP error.
FTP>exit-on-error
[Will exit when an error occurs]
FTP>connect 10.1.1.4
10.1.1.4: %MULTINET-F-ETIMEDOUT, Connection timed out
$ sho symbol $status
$STATUS == "%X100081E4"
This example shows how EXIT-ON-ERROR exits when an error occurs automatically. Here the FTP server responded as follows to the command user unknown password:
FTP>exit-on-error
[Will exit when an error occurs]
FTP>connect somehost
Connection opened (Assuming 8-bit connections)
<Somehost MultiNet FTP Server Process V5.6(15) at Thu 4-Mar-19 2:37PM-EDT
SOMEHOST>user unknown password
<%SYSTEM-F-INVLOGIN, login information invalid at remote node
$ show symbol $status
$STATUS == "%X1212002C"
$ write sys$output ($status-%X1000002C)/%X10000
530
530 %SYSTEM-F-INVLOGIN, login information invalid at remote node
Sets or displays the file facts that will be set to match the facts of the source file after transfer. The only fact currently supported is the file modification time.
FACT [MFMT]
MFMT
File modification time will be set after transferring files provided the FTP server supports the necessary commands.
FTP>FACT
MFMT
FTP>PUT FILE.EXE
Copies remote_file from the remote host to local_file on the local host. The current settings for type, mode, and structure are used during file transfers. GET is the same as RECEIVE.
GET remote-file [local-file]
remote-file
Specifies the name of the file on the remote host.
local-file
Specifies the name of the file on the local host.
/FDL
Obtains a file previously saved with the PUT /FDL command. When you create a file with the PUT /FDL qualifier, a file description language (FDL) file is created at the same time as the original file. The output file is converted to raw block format. When you retrieve a file with GET /FDL, the original format is restored using the attributes stored in the FDL file. If you don't use the /FDL qualifier with the GET command, the new raw block format is retained. In any case, the FDL file is retained and must be deleted independently. The /FDL qualifier provides compatibility with HP TCP/IP Services for OpenVMS (formerly UCX). The FDL file has the same name except the string FDL is appended to the end.
/RESTART
For STREAM mode transfers restart the transfer where it was interrupted. The client verifies that the server supports the RFC 3659 SIZE and REST commands, and ignores the qualifier if it does not.
This does NOT work for VMS mode transfers (STRU VMS), and if the remote system is a VMS system it is
recommended that a STRU FILE be done before the
transfer command and to include
/NOVMS on the command line when starting FTP.
GET/RESTART is not supported in ASCII mode to systems that support VMS mode transfers due to problems with properly concatenating a possibly broken line of text. It is recommended that the file be ZIPped and then transfer the .zip file in binary mode.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the GET command.
This example shows how to transfer a file to the local host.
EXAMPLE.COM>get login.com
To local file: RETURN
<VMS retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Turns on, off, or toggles (the default) the display of hash marks (#) for each data buffer transferred.
HASH mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to display hash marks during a GET file transfer.
EXAMPLE.COM>hash
[Hash marks will be printed during transfers]
EXAMPLE.COM>get login.com login.com
<VMS retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
###
Transfer completed. 2498 (8) bytes transferred.
Displays FTP help information. Type HELP ? to see a list of HELP topics. Type HELP without an argument to display general help information.
HELP [command]
command
Specifies the name of the command about which you want help.
FTP>help
The HELP command prints
on-line help for the FTP user program. The argument to HELP selects the particular
FTP command about which help is desired. In addition to the FTP commands,
several control characters can be typed while file transfers are in progress:
Control-A shows the progress of a data transfer.
Control-G aborts the file transfer and returns to FTP command level.
Control-P spawns a new command interpreter.
FTP>
Changes the current working directory on the local host to dir. LCD is a synonym for LOCAL-CD.
LCD dir
Displays the contents of your local working directory. LDIR is the same as LOCAL-DIRECTORY.
LDIR
FTP>ldir
*.com
USERS:[EXAMPLE.DOC.V32]
DOC.COM;2 1 1-APR-2019 01:36 FLOWERS_FILES (RWED,RWED,,)
LOGIN.COM;3 5 1-APR-2010 19:07 FLOWERS_FILES (RWED,RWED,,)
LOGIN.COM;2 5 1-APR-2019 19:04 FLOWERS_FILES (RWED,RWED,,)
LOGIN.COM;1 5 1-APR-2019 18:49 FLOWERS_FILES (RWED,RWED,,)
Total of 16 blocks in 4 files.
FTP>
Displays automatic login information for host. See the SET command for information about setting automatic login information for a host.
LIST [host]
host
Specifies the host whose automatic login information you are trying to display. If you do not specify host, LIST displays automatic login information for all hosts for which login information has been set.
Do not use this command when connected to a remote host.
This example shows how to set and list information for the DS.INTERNIC.NET host.
FTP>set
ds.internic.net /user=anonymous /pass=guest
FTP>list
DS.INTERNIC.NET
User: anonymous
Password: guest
FTP>
Changes the current working directory on the local host to dir. LOCAL-CD is the same as LCD.
LOCAL-CD dir
dir
Specifies the name of the directory to which to change the current working directory.
FTP>lcd
[-]
Connected to USERS:[EXAMPLE.DOC].
FTP>
Displays the contents of your local working directory. LOCAL-DIRECTORY is a synonym for LDIR.
LOCAL-DIRECTORY
Displays the current working directory on the local host. LOCAL-PWD is a synonym for LPWD.
LOCAL-PWD
Identifies you to a remote FTP server. LOGIN is the same as USER.
LOGIN user [password]
user
Specifies your user name on the remote server.
password
Specifies your password on the remote server. If you do not specify password and the remote site requires one, you are prompted for it. In either case, the password is not echoed.
· Use this command only when connected to a remote host.
· Most remote hosts do not allow you to use LOGIN once you have already logged in.
This example shows how to connect to a remote host and log in.
$ ftp
example.com
Connection opened (Assuming 8-bit connections)
<EXAMPLE.COM MultiNet FTP Server Process 5.6(nn) at Fri 9-Apr-2019 7:42 am EDT
EXAMPLE.COM>login HOLMES password
<User HOLMES logged into U1:[HOLMES] at Fri 9-Apr-2019, 19:13, job 433.
EXAMPLE.COM>
Displays the current working directory on the local host. LPWD is the same as LOCAL-PWD.
LPWD
FTP>lpwd
Connected to USERS:[EXAMPLE.DOC].
FTP>
Displays a names-only listing of files on the remote host. You can use wildcard specifications.
LS [file_spec] [output_file]
file_spec
Specifies the file specification to use in the directory lookup on the remote host. If you do not specify file_spec, the current working directory on the remote host is used. Any wildcards used are interpreted in the context of the remote host operating system.
output_file
Specifies the name of the file to which to write the directory listing. If output_file is not specified, the list is directed to SYS$OUTPUT:.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the LS command.
This example shows how to retrieve the directory listing of the files matching the wildcard character *.
EXAMPLE.COM>ls *.
<List started.
$mailinterface.
mymail.
todo.
<Transfer
completed.
EXAMPLE.COM>
Deletes multiple files on the remote host. MDELETE is a synonym for MULTIPLE DELETE.
MDELETE files
Copies multiple files from the remote host to the local host. MGET is a synonym for MULTIPLE GET.
MGET files
Creates the directory dir on the remote host. MKDIR is a synonym for CREATE-DIRECTORY.
MKDIR dir
Sets the transfer mode to COMPRESSED, DEFLATE (MODE Z compression), or STREAM (the default).
MODE mode
PARAMETERS
mode
Specifies one of three values: COMPRESSED, DEFLATE, or STREAM (the default).
· The MODE command can only be used when connected to a remote host.
· Not all modes are supported by all remote hosts.
This example shows how to enable COMPRESSED mode.
EXAMPLE.COM>mode c
Type: Ascii (Non-Print), Structure: VMS, Mode: Compression
EXAMPLE.COM>
Copies multiple files from the local host to the remote host. MPUT is a synonym for MULTIPLE-SEND.
MPUT files
Deletes multiple files on the remote host. If you have turned on CONFIRM, (to confirm multiple transactions interactively), you are asked to confirm the deletion of each file. MULTIPLE DELETE is the same as MDELETE.
MULTIPLE DELETE files
files
Specifies which files to delete. Wildcard characters in files are expanded on the remote host.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the MULTIPLE DELETE command.
This example shows how to delete all files matching the remote wildcard * character.
EXAMPLE.COM>multiple delete *.com;*
< List started
<Transfer completed.
<File deleted ok, file USERS:[EXAMPLE.DOC.V32]LOGIN.COM;3.
<File deleted ok, file USERS:[EXAMPLE.DOC.V32]LOGIN.COM;2.
<File deleted ok, file USERS:[EXAMPLE.DOC.V32]LOGIN.COM;1.
Copies multiple files from the remote host to the local host. If you have turned on CONFIRM (to confirm multiple transactions interactively), you are asked to confirm the transfer of each file. MULTIPLE GET is the same as MGET and MULTIPLE RECEIVE.
MULTIPLE GET files
files
Specifies the names of the files to be copied. Wildcard characters are expanded on the remote host.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the MULTIPLE GET command.
This example shows how to transfer all files matching the * wildcard character.
EXAMPLE.COM>multiple get *.com
<List started.
<Transfer completed.
<VMS retrieve of USERS:[HOLMES]COPY.COM;4 started.
<Transfer completed. 732 (8) bytes transferred.
<VMS retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
<Transfer completed. 2498 (8) bytes transferred.
Copies multiple files from the local host to the remote host. MULTIPLE PUT is a synonym for MULTIPLE SEND.
MULTIPLE PUT files
Copies multiple files from the remote host to the local host. MULTIPLE RECEIVE is a synonym for MULTIPLE GET.
MULTIPLE RECEIVE files
Copies multiple files from the local host to the remote host. If you have turned on CONFIRM (to confirm multiple transactions interactively), you are asked to confirm the transfer of each file. MULTIPLE SEND is the same as MULTIPLE PUT and MPUT.
MULTIPLE SEND files
files
Specifies which files to copy. Wildcard characters in files are expanded on the local host.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the MULTIPLE SEND command.
This example shows how to transfer the files which match the *.COM wildcard.
EXAMPLE.COM>multiple send *.com
<VMS Store of ST_ROOT:[TMP]COPY.COM;4 started.
<Transfer completed. 732 (8) bytes transferred.
<VMS Store of ST_ROOT:[TMP]FIX.COM;3 started.
<Transfer completed. 496 (8) bytes transferred.
<VMS Store of ST_ROOT:[TMP]FOO.COM;11 started.
<Transfer completed. 436 (8) bytes transferred.
<VMS Store of ST_ROOT:[TMP]LOGIN.COM;4 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Establishes a connection to a host system. OPEN is a synonym for CONNECT.
OPEN host
Enables or disables passive mode for file transfers with FTP servers on the opposite side of firewall gateways.
PASSIVE [state]
state
Specifies a value of ON, OFF, or TOGGLE.
Typically, when an FTP client requests data from an FTP server, the server attempts to establish a connection with the client over which it transfers the data. If a firewall gateway separates the FTP client and server, the gateway may prohibit incoming connections. The solution is to enable passive mode transfers, in which the FTP server asks the FTP client to initiate the connection.
Note: Not all FTP servers support passive mode transfers.
|
The PASSIVE command lets you enable or disable passive mode explicitly. When you do not specify a state, the current state is toggled.
This example uses PASSIVE to allow the server to transfer a directory listing across a connection established by the FTP client rather than the server.
HQ.EXAMPLE.COM>passive on
[Passive mode is ON for transfers]
HQ.EXAMPLE.COM>dir
<List started.
FTP_ANON:[000000]
UNZIP.EXE;3 155 27-MAR-2004 10:29 [WEBMASTER] R,RWED,RWED,R)
UNZIP_ALPHA.EXE;1 163 27-MAR-2004 10:29 [WEBMASTER] (R,RWED,RWED,R)
VMSIO.H;12 7 27-MAR-2004 10:29 [WEBMASTER] (R,RWED,RWED,R)
WHATS_NEW.TXT;1 1 5-MAR-2004 16:31 [WEBMASTER] (R,RWED,RWED,R)
<Transfer completed.
HQ.EXAMPLE.COM>
Sends a password to the remote FTP server explicitly, which happens automatically during login.
PASSWORD password
password
Specifies the password to send to the remote server. The password is not echoed when typed.
· Use this command only when connected to a remote host.
· Most remote hosts require that the password be sent as part of the login procedure only.
This example shows how to send a password to the remote host.
EXAMPLE.COM>pass airplane
<Password accepted, thank you.
EXAMPLE.COM>
Specifies a TCP port number to use for the FTP control connection. Use this command only when connecting to an FTP server that provides a nonstandard FTP control connection port number.
PORT port
port
Specifies the port to use when establishing the FTP control connection with the remote server system.
This example shows how to explicitly specify a port number for the FTP control connection with the remote host.
EXAMPLE.COM>port 1099
EXAMPLE.COM>
Turns on, off, or toggles (the default) whether or not FTP prompts for missing command arguments automatically.
PROMPT-FOR-MISSING-ARGUMENTS mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to use the PROMPT-FOR-MISSING-ARGUMENTS command.
FTP>prompt-for-missing-arguments
[Will NOT prompt for missing arguments];
SALES.EXAMPLE.COM>get
?Missing remote filename
SALES.EXAMPLE.COM>
Turns on, off, or toggles (the default) whether or not FTP prompts for a user name and password automatically after making a connection.
PROMPT-ON-CONNECT mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to use PROMPT-ON-CONNECT to automatically prompt for a user name and password when a connection is made.
FTP>prompt-on-connect
[Will automatically prompt for username and password]
FTP>connect ftp.example.com
Connection opened (Assuming 8-bit connections)
<FTP.EXAMPLE.COM MultiNet FTP Server Process 5.6(nn) at Fri 9-Apr-2019
7:42am PST
Username: HOLMES
Password: ******
<User HOLMES logged into USERS:[HOLMES] at Fri 9-Apr-2019 14:42, job
2060011f.
FTP.EXAMPLE.COM>
Starts and attaches a DCL subprocess. If a parent process exists, attach to it. To return from DCL, use the ATTACH or the LOGOUT command. To switch back from a DCL subprocess, use the ATTACH command. If the MULTINET_DISABLE_SPAWN logical is set, PUSH does not work.
PUSH
Copies local_file on the local host to remote_file on the remote host. The current settings for type, mode, and structure are used during file transfers. PUT is the same as SEND.
PUT local_file remote_file
local_file
Specifies the name of the file on the local host.
remote_file
Specifies the name of the file on the remote host.
/FDL
Puts a file in FDL format. When you create a file with the PUT /FDL qualifier, a file description language (FDL) file is created at the same time as the original file. The output file is converted to raw block format. When you retrieve a file with GET /FDL, the original format is restored using the attributes stored in the FDL file. If you do not use the /FDL qualifier with the GET command, the new raw block format is retained. In any case, the FDL file is retained and must be deleted independently. The /FDL qualifier provides compatibility with HP TCP/IP Services. The FDL file has the same name except the string FDL is appended to the end of the file name.
/RESTART
For STREAM mode transfers restart the transfer where it was interrupted. The client verifies that the server supports the RFC 3659 SIZE and REST commands, and ignores the qualifier if it does not.
This does NOT work for VMS mode transfers (STRU VMS), and if the remote system is a VMS system it is recommended that a STRU FILE be done before the transfer command and to include /NOVMS on the command line when starting FTP.
GET/RESTART is not supported in ASCII mode to systems that support VMS mode transfers due to problems with properly concatenating a possibly broken line of text. It is recommended that the file be ZIPped and then transfer the .zip file in binary mode.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the PUT command.
This example copies the file LOGIN.COM to the remote file FOO.COM.
EXAMPLE.COM>put login.com foo.com
<VMS Store of ST_ROOT:[TMP]FOO.COM;12 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
This example copies AFILE.TXT to BFILE.TXT and creates the additional BFILE.TXTFDL file. The BFILE.TXTFDL file is in ASCII format and is an appropriate FDL description of AFILE.TXT.
EXAMPLE.COM>PUT /FDL AFILE.TXT BFILE.TXT
<ASCII Store of USERS:[HOLMES]BFILE.TXTFDL;1 started.
<Transfer completed. 888 (8) bytes transferred.
<IMAGE Store of USERS:[HOLMES]BFILE.TXT;1 started.
<Transfer completed. 6 (8) bytes transferred.
EXAMPLE.COM>
Displays the current working directory on the remote host. PWD is a synonym for SHOW_DIRECTORY.
PWD
Closes the current FTP connection and exits FTP. QUIT is a synonym for EXIT.
QUIT
Sends a string to the FTP server verbatim. You can use QUOTE to access non-standard commands on the FTP server.
QUOTE string
string
Specifies a string to send to the server.
Use this command only when connected to a remote host.
This example shows how to send a NOOP command to the remote host.
EXAMPLE.COM>quote noop
<NOOP command successful.
EXAMPLE.COM>
Copies remote-file from the remote host to local-file on the local host. The current settings for type, mode, and structure are used during file transfers. RECEIVE is a synonym for GET.
RECEIVE remote-file [local-file]
remote-file
Specifies the name of the file on the remote host.
local-file
Specifies the name of the file on the local host.
/FDL
Gets a file previously saved with the PUT /FDL command. When you create a file with the PUT /FDL qualifier, a file description language (FDL) file is created at the same time as the original file. The output file is converted to raw block format. When you retrieve a file with RECEIVE /FDL, the original format is restored using the attributes stored in the FDL file. If you do not use the /FDL qualifier with the RECEIVE command, the new raw block format is retained. In any case, the FDL file is retained and must be deleted independently. The /FDL qualifier provides compatibility with HP TCP/IP Services. The FDL file has the same name except the string FDL is appended to the end of the file name.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the GET command.
This example shows how to transfer a file to the local host.
EXAMPLE.COM>receive login.com
To local file: RETURN
<VMS retrieve of USERS:[HOLMES]LOGIN.COM;1 started.
<Transfer completed. 2498 (8) bytes transferred.
EXAMPLE.COM>
Sets or displays the record size for IMAGE mode transfers.
RECORD-SIZE [size]
size
Specifies the record size for IMAGE mode transfers. Values range from 1 to 32767. When omitted, the current setting is displayed. The default record size is 512 bytes.
$ ftp ftp.example.com
FTP.EXAMPLE.COM MultiNet FTP user process 5.6(nnn)
Connection opened (Assuming 8-bit connections)
<FTP.EXAMPLE.COM MultiNet FTP Server Process 5.6(nnn) at Fri 9-Apr-2019
7:42am-PST
FTP>record 1024
FTP>record
Record size for IMAGE files: 1024
FTP>
Displays information about commands available on the FTP server.
REMOTE-HELP
Use this command only when connected to a remote host.
This example shows how to retrieve help from a remote host.
UNIX.EXAMPLE.COM>remote-help
<The following commands are recognized (* =>'s unimplemented).
< USER PORT STOR MSAM* RNTO NLST MKD CDUP
< PASS PASV APPE MRSQ* ABOR SITE XMKD XCUP
< ACCT* TYPE MLFL* MRCP* DELE SYST RMD STOU
< SMNT* STRU MAIL* ALLO CWD STAT XRMD SIZE
< REIN* MODE MSND* REST XCWD HELP PWD MDTM
< QUIT RETR MSOM* RNFR LIST NOOP XPWD
<Direct comments to ftp-bugs@ucbarpa.Berkeley.EDU.
UNIX.EXAMPLE.COM>
Deletes a directory on the remote host. REMOVE-DIRECTORY is the same as RMDIR.
REMOVE-DIRECTORY dir
dir
Specifies the name of the directory to be removed.
· Use this command only when connected to a remote host.
· Most remote hosts require that you be logged in before using the REMOVE-DIRECTORY command.
This example shows how to delete the test subdirectory from the remote host.
EXAMPLE.COM>remove-directory test
<“USERS:[HOLMES.TEST]” Directory deleted
EXAMPLE.COM>
Renames files on the remote host.
RENAME file1 file2
file1
Specifies the name of the file to be renamed.
file2
Specifies the new name of file1.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the RENAME command.
This example shows how to rename COPY.COM to NEWCOPY.COM on the remote host.
EXAMPLE.COM>rename copy.com newcopy.com
<Old FILE renamed to USERS:[HOLMES]NEWCOPY.COM;1.
EXAMPLE.COM>
Turns on, off, or toggles (the default) the retention of OpenVMS version numbers in file transfers. By default, version numbers are stripped from OpenVMS file names before they are sent over the network.
RETAIN mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to enable retention of OpenVMS version numbers.
FTP>retain
[Transferred files will retain their version numbers]
FTP>
Deletes a file on the remote host. RM is a synonym for DELETE.
RM file
Deletes a directory on the remote host. RMDIR is a synonym for REMOVE-DIRECTORY.
RMDIR dir
Copies local_file on the local host to remote_file on the remote host. The current settings for type, mode, and structure are used during file transfers. SEND is the same as PUT.
SEND local_file remote_file
local_file
Specifies the name of the file on the local host to be copied.
remote_file
Specifies the destination file name on the remote host.
/FDL
Sends a file in FDL format. When you create a file with the SEND /FDL qualifier, a file description language (FDL) file is created at the same time as the original file. The output file is converted to raw block format. When you retrieve a file with GET /FDL, the original format is restored using the attributes stored in the FDL file. If you do not use the /FDL qualifier with the GET command, the new raw block format is retained. In any case, the FDL file is retained and must be deleted independently. The /FDL qualifier provides compatibility with HP TCP/IP Services. The FDL file has the same name except the string FDL is appended to the end of the file name.
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the SEND command.
This example shows how to transfer the file LOGIN.COM to the remote file FOO.COM.
EXAMPLE.COM>send login.com foo.com
<VMS Store of ST_ROOT:[TMP]FOO.COM;12 started.
<Transfer completed. 2498 (8) bytes transferred.
Sets automatic login information for host.
SET host
host
Specifies the host for which you want to set automatic login information.
/USER:username
Specifies the user name sent when a connection is made to host.
/PASSWORD:password
Specifies the password sent when a connection is made to host.
/ACCOUNT:account
Specifies the account is sent when a connection is made to host.
When a connection to host is made, FTP uses the information set to automatically log in. This command is usually used in the FTP.INIT file to specify a list of hosts and their login information. If FTP.INIT contains passwords in clear text, it is imperative that you protect the file from access by other users. If you specify /USER but not /PASSWORD, an automatic login is attempted and, if necessary, a password prompt displayed.
Do not use this command when connected to a remote host.
If you do not specify any qualifiers, any automatic login information is cleared.
This example sets the user name and password for the host DS.INTERNIC.NET.
FTP>SET HOST ds.internic.net /user:anonymous /pass:guest
Displays the current working directory on the remote host. SHOW DIRECTORY is the same as PWD.
SHOW-DIRECTORY
· Use this command only when connected to a remote host.
· Most remote hosts require that you log in before using the SHOW-DIRECTORY command.
This example shows how to retrieve the remote default directory.
EXAMPLE.COM>show
<ST_ROOT: [TMP] is current directory.
EXAMPLE.COM>
Specifies commands that are interpreted by the MultiNet FTP server for use on the server host.
SITE command
command
Selects a command from the following:
RMS RECSIZE n |
Indicates a non-default record size for files transferred in IMAGE mode to the FTP server. Record size values can range from 1 to 32767; the default is 512 bytes. |
SPAWN |
Allows users to execute commands on the server host. The command must not require a terminal device, and must exit on completion. You cannot use this command during an anonymous FTP session. |
Executes a single DCL command, or if entered without options, starts a subprocess with the same effect as PUSH. To return from DCL, use the LOGOUT command. If the MULTINET_DISABLE_SPAWN logical is set, SPAWN does not work.
SPAWN [command]
command
Specifies a command to execute. If you omit command, a DCL command line subprocess is created.
/INPUT=file-spec
Specifies an input file to the command you enter with SPAWN.
/LOGICAL_NAMES
/NOLOGICAL_NAMES
Specifies that logical names and logical name tables are not copied to the subprocess.
/SYMBOLS
/NOSYMBOLS
Specifies that global and local names are not passed to the subprocess.
/WAIT
/NOWAIT
Returns control without waiting for the command to complete. Do not use this qualifier with commands that have prompts or screen displays.
/OUTPUT=file-spec
Specifies a file that retains the output of the command invoked with SPAWN. This qualifier only works when a single command is entered without creating a DCL subprocess. In addition, this qualifier is positional; you must enter it immediately after SPAWN or other qualifiers.
Turns on, off, or toggles (the default) STATISTICS mode. In STATISTICS mode, FTP displays, upon completion of file transfers, timing statistics about the transfer.
If the logical MULTINET_FTP_STATISTICS_IN_HHMMSS is defined with either 1, T, or Y, then the elapsed time displays in HH:MM:SS format if statistics are requested using the STATISTICS mode.
STATISTICS mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to enable STATISTICS mode.
FTP>statistics
[Transfer statistics printing is ON]
FTP>
Displays the status of the FTP server.
STATUS [data]
data
Sends this command data to the FTP server; data depends on the implementation of the FTP server. This parameter is optional.
Use this command only when connected to a remote host.
EXAMPLE.COM>status
<EXAMPLE.COM MultiNet FTP Server Process 5.6(nnn)
<User HOLMES is logged into directory ST_ROOT:[TMP]
<The current transfer parameters are:
< MODE S
< Stru O VMS
< TYPE A N
<A connection is open to host EXAMPLE.COM
<The data connection is CLOSED.
EXAMPLE.COM>
Turns on, off, or toggles (the default) the creation of binary output files as Stream_LF files.
STREAM mode
mode
Specifies ON, OFF, or TOGGLE.
EXAMPLE.COM>stream
[ IMAGE files will be written as Stream_LF format]
EXAMPLE.COM>
Sets the transfer structure to structure.
STRUCTURE structure
structure
Specifies a value of FILE, RECORD, or VMS.
· Use FILE (the default) when connecting to systems that do not support VMS structure negotiation.
· Use RECORD to transfer files when you want to preserve the record boundaries.
· Use VMS to transfer files with arbitrary RMS attributes transparently. Transparent transfer is negotiated automatically between systems that support it. RMS semantics are passed along with the data.
Use this command only when connected to a remote host.
EXAMPLE.COM>stru r
Type:Ascii (Non-Print), Structure: Record, Mode: Stream
EXAMPLE.COM>
Interprets FTP commands in a file. When the end of the file is encountered, the FTP command interpreter returns to its previous input source. You can nest TAKE commands up to ten levels deep.
TAKE file
file
Specifies the name of the file that contains commands to be interpreted.
This example shows how to take commands from the file FTP.COMMANDS.
FTP>take ftp.commands
Changes the byte size for transferring binary files to or from a TOPS-20 system.
TENEX
Use this command only when connected to a remote host.
This example shows how to set the transfer type to TENEX.
EXAMPLE.COM>tenex
Type: Logical-Byte (Byte Size 8), Structure: File, Mode: Stream
EXAMPLE.COM>
Sets the transfer type to type.
TYPE type
type
Specifies a value of ASCII, BACKUP, BINARY, IMAGE, or LOGICAL-BYTE.
· Use TYPE ASCII (the default) for transferring text files.
· Use TYPE BACKUP to set the transfer type to IMAGE and write the local file with 2048-byte fixed length records. Use this command to transfer VMS BACKUP save sets.
· Use TYPE BINARY to transfer binary files (same as TYPE IMAGE).
· Use TYPE IMAGE to transfer binary files (for example, .EXE).
· Use TYPE LOGICAL-BYTE to transfer binary files to or from a TOPS-20 machine.
Use this command only when connected to a remote host.
This example shows how to set the type to transfer an image file.
EXAMPLE.COM>type i
Type: Image, Structure: File, Mode: Stream
EXAMPLE.COM>
Identifies you to the remote FTP server. USER is a synonym for 5.
USER user [password]
Turns on, off, or toggles (the default) VERBOSE mode. VERBOSE mode causes FTP to display all responses from the remote FTP server as they are received.
VERBOSE mode
mode
Specifies a value of ON, OFF, or TOGGLE.
This example shows how to enable VERBOSE mode.
FTP>verbose
[Verbose reply printing is ON]
FTP>
Prints information about the FTP program version.
VERSION
This example shows how to print the FTP program version number.
EXAMPLE.COM>version
EXAMPLE.COM MultiNet FTP user process 5.6(nnn)
EXAMPLE.COM>
Displays or sets the TCP window size to be used on data transfers.
WINDOW-SIZE [size]
size
Integer value to use for TCP window size.
This example shows how to display the current TCP window size.
EXAMPLE.COM>window-size
TCP window size: 32768
EXAMPLE.COM>