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.

FLOWERS.COM>del foo.bar
FLOWERS.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".

FLOWERS.COM>dir *.com
USERS: [HOLMES]
COPY.COM;4 2 1-APR-1996 08:49 [HOLMES] (RWD,RWD,R,R)
LOGIN.COM;1 5 1-APR-1996 01:25 [HOLMES] (RWD,RWD,R,R)
Total of 7 blocks in 2 files.
FLOWERS.COM>

Closes the current FTP connection without waiting for a confirming response from the remote host, but remains in the FTP command interpreter.

DISCONNECT

FLOWERS.COM>disc
FTP>

Closes the current FTP connection and exits FTP. QUIT is the same as EXIT.

EXIT

FLOWERS.COM>exit
$

Turns on, off, or toggles (the default) whether or not FTP automatically exits when an error occurs.
If EXIT-ON-ERROR is enabled, FTP automatically exits 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 automatically exit when an error occurs. Here the error was not an FTP error.

FTP>exit-on-error [Will exit when an error occurs]
FTP>connect 1.2.3.4
1.2.3.4: %MULTINET-F-ETIMEDOUT, Connection timed out
$ sho symbol $status
$STATUS == "%X100081E4"

This example shows how EXIT-ON-ERROR exits automatically when an error occurs. 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>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

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 DEC TCP/IP Services for OpenVMS (formerly UCX). The FDL file has the same name except the string FDL is appended to the end.

• 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.

FLOWERS.COM>get login.com
To local file: Return
FLOWERS.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.

FLOWERS.COM>hash
[Hash marks will be printed during transfers]
FLOWERS.COM>get login.com login.com
###
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>