DIGITAL TCP/IP Services for OpenVMS
User's Guide


Previous Contents Index


DISCONNECT

Terminates your session with the remote host and returns to the FTP prompt.

DCL-Style Format

DISCONNECT


UNIX Style Formats

close

disconnect


ENABLE (DISABLE) LOG

Enables or disables the display of all protocol commands sent to the remote host.

Default: DISABLE LOG.


DCL-Style Format

ENABLE LOG

DISABLE LOG


UNIX Style Format

debug


Example


FTP> ENABLE LOG 
Bell off.
Debugging on (debug=1).
FTP> ENABLE REPLY 
Reply on.
Verbose mode on.
FTP> PUT PRICES.TXT YEAR.PRICES
---> PORT 1,2,3,4,7,138
200 PORT command successful.
---> STOR PRICES.TXT
150 Opening ASCII mode data connection for small.txt (1,2,3,4,7,138).
226 Transfer complete.
local: WORK1$:[samson]prices.txt;1  remote: year.prices
609 bytes sent in 00:00:00.02 seconds (179.36 Kbytes/s) 
FTP> GET LAKE.IBIS LAKE_IBIS.DAT 
---> PORT 1,2,3,4,7,138
200 PORT command successful
---> RETR lake.ibis
150 Opening ASCII mode data connection for lake.ibis (1.2.3.4,193)
226 Transfer complete
local: LAKE_IBIS.DAT remote:lake.ibis
4 bytes received in 00:00:00.03 seconds (0.13 Kbytes/s)
FTP> 
 
      

Turns on the display of commands sent to the remote host. Shows all the commands sent to the remote host during the execution of PUT and GET.


ENABLE (DISABLE) PARSE

Enables or disables the expansion of remote file names during file transfers.

During GET operations, an expansion of a directory name might be different from the expansion of other file names. The result depends on the operating systems of the remote and local hosts.


DCL-Style Format

ENABLE PARSE

DISABLE PARSE


UNIX Style Format

glob


Examples

#1

FTP> ENABLE PARSE 
FTP> PUT BIRDS*.TXT 
      

Enables parsing and the expansion of wildcards. Copies all the files starting with the characters BIRDS to the remote host.

#2

FTP> ENABLE PARSE 
FTP> GET *.DOC 
      

Because parsing is enabled, the remote host expands the wildcard. All remote files ending in ".doc" are copied to the local system.

The command is equivalent to:


FTP> ENABLE PARSE 
FTP> MGET *.DOC 


ENABLE (DISABLE) PORT_COMMAND

Enables or disables the sending of the FTP protocol PORT command to the remote host.

By default, FTP sends a PORT command when establishing a connection. If this command fails, FTP uses the default data port (20).

Disable the sending of the PORT command when you communicate with remote hosts that ignore PORT commands.

Default: ENABLE PORT_COMMAND.


DCL-Style Format

ENABLE PORT_COMMAND

DISABLE PORT_COMMAND


UNIX Style Format

sendport


Example


FTP> ENABLE PORT_COMMAND 
FTP> PUT CODE.TXT 
200 PORT command successful
150 Opening data connection for CODE.TXT (130.180.10.8,1182)
226 Transfer complete
local: DISK$PROJECT6:[MANAGEMENT]CODE.TXT;9  remote: CODE.TXT
3634 bytes sent in 00:00:00.04 seconds (88.72 Kbytes/s)
      

FTP enters a PORT command before the file transfer.


ENABLE (DISABLE) REPLY

Enables or disables the display of all the responses from the remote host.

Default: ENABLE REPLY.


DCL-Style Format

ENABLE REPLY

DISABLE REPLY


UNIX Style Format

debug


Example


FTP> ENABLE REPLY
Reply on.
Verbose mode on.
FTP> get birds.txt dogs.txt
200 PORT command successful.
150 Opening ASCII mode data connection for birds.txt (130,180,10,8,1570) (2405 
bytes). 
226 Transfer complete.
local: WORK1$:[SAMSON]DOGS.TXT;1  remote: birds.txt 
2405 bytes received in 00:00:00.03 seconds (60.22 Kbytes/s) 
 
 
FTP> DISABLE REPLY 
Bell off. 
Reply off. 
Verbose off. 
FTP> get birds.txt dogs.txt 
FTP>
      

Enables the display of all the responses from the remote host. Copies birds.txt from the remote host, showing all the executed FTP commands in progress.


ENABLE (DISABLE) TRANSFER_VERIFICATION

Enables or disables the display of # for each 1000 bytes of transferred data.

Default: DISABLE TRANSFER_VERIFICATION.


DCL-Style Format

ENABLE TRANSFER_VERIFICATION

DISABLE TRANSFER_VERIFICATION


UNIX Style Format

hash


Example


FTP> ENABLE TRANSFER_VERIFICATION 
Bell off.
Hash mark printing on (1024/hash mark). 
FTP> GET FUTURES.DIS FUTURES_H2.DIS 
200 PORT command successful 
150 Opening data connection for futures.dis (11.20.99.100,26) 
############### 
226 Transfer complete. 
local: FUTURES_H2.DIS remote: futures.dis 
15596 bytes received in 00:00:00.11 seconds (138.45 Kbytes/s) 
FTP> 
      

Enables the display of # for each 1000 bytes of transferred data. Copies futures.dis to FUTURES_H2.DIS, showing when 1000 bytes are transferred.


ENABLE (DISABLE) VMS_PLUS

Enables or disables VMS Plus Mode. This lets you specify a transfer mode based on file type, for example, ASCII or image.

With VMS Plus Mode disabled, FTP does not send the FTP SITE command. (Older implementations of the FTP server do not support this command.) The FTP client uses the FTP SITE command to identify itself (its SITE type) to the remote host. The SITE type of an FTP client can be either:

Defaults:


Format

ENABLE VMS_PLUS

DISABLE VMS_PLUS


EXIT

Closes an open connection and exits FTP. Entering Ctrl/Z is equivalent to the EXIT command.

DCL-Style Format

EXIT


UNIX Style Format

quit


FTP

At the DCL prompt, the FTP command starts an FTP session. For information about the FTP command, enter:


$ FTP 
FTP> HELP 
 
  Information available: 
 
  APPEND     CONNECT    CREATE     DELETE     DIRECTORY  DISABLE 
  DISCONNECT ENABLE     EXIT       GET        HELP       LOGIN      PUT 
  QUOTE      RENAME     SET        SHOW       SPAWN      VIEW 
 
Topic? 

or


$HELP FTP 
FTP 
 
     Starts an FTP session and does one of the following: 
 
     o  Displays the FTP prompt. You can issue FTP commands to 
        customize your environment and FTP command processing. 
 
     o  Establishes a connection to the specified remote host. 
 
     For help with individual FTP commands, enter: 
 
     $ FTP 
     FTP> HELP 
 
     DCL-Style Format 
 
       FTP  [ host ] [ /USERNAME=remote_user_name ] 
 
            [ /PASSWORD=password ] 
 
 
Press RETURN to continue ... 
 
            [ /INPUT=file ] 
 
     UNIX Style Format 
 
       ftp  [ host ] 
 
  Additional information available: 
 
  Parameters Qualifiers 
  /INPUT     /PASSWORD  /USERNAME 
  Examples 
 
FTP Subtopic? 
 


FTP

The DIGITAL TCP/IP Services for OpenVMS software includes the File Transfer Protocol (FTP) service. The FTP command starts an FTP session and does one of the following:

DCL-Style Format

FTP [ host [ port ] ] [ /USERNAME=remote_user_name ]
[ /PASSWORD=password ]
[ /INPUT=input_filespec ]


UNIX Style Format

ftp [ host [ port ] ]


Parameters

host

Optional.

Remote host to which you want to connect.

port

Optional.

Specifies the port to use.


Qualifiers

/INPUT=input-filespec

Optional. If you do not specify the /INPUT qualifier, FTP takes input from SYS$INPUT. If you specifiy this qualifier, you must also supply an input_filespec. FTP continues to prompt until it has a valid input_filespec.

Runs a DCL command file with FTP commands.

/PASSWORD=password

Optional. Default: your password on the local system.

Password for the remote user account to which you want to connect.

/USERNAME=remote_user_name

Optional. Default: your user name on the local system.

Name of the remote user account to which you want to connect.


Examples

#1

$ FTP 
FTP> 
      

Starts an FTP user session without establishing a connection.

#2

$ FTP WKSITE [Return] 
220 wksite.texts.wrights.com FTP Server (DIGITAL UNIX 13:34:28 EDT) ready 
Connected to wren.nest.willow.com. 
Name (wksite:parks) [Return] 
331 Password required for parks. 
Password:            (password not echoed) [Return] 
230 User parks logged in. 
FTP> 
      

User PARKS starts an FTP session and connects to UNIX host wksite.

#3

$ FTP NEWY /USERNAME=BENSON /PASSWORD=WMSWMS 
220 NEWY.LINK1.MOA.COM FTP Server (Version 5.0) ready 
Connected to NEWY.LINK1.MOA.COM. 
331 Username BENSON requires a password. 
230 User logged in. 
FTP> 
      

Starts an FTP session and connects to remote OpenVMS host NEWY, in user account BENSON.


GET

The GET command does the following:

To use this command, you must have an FTP session with a remote host.


DCL-Style Format

GET [ /CONFIRM | /FDL ] remote_file [ local_file ]


UNIX Style Formats

get remote_file [ local_file ]

mget remote_files


Parameters

remote_file

Required.

Name of the remote file to copy.

local_file

Optional. Default: Same name (without any device or directory names).

New name for the copied file. You cannot specify a local file name if you specify:


Qualifiers

/CONFIRM

Optional. Default: immediate execution.

Asks you for confirmation before executing the copy operation.

/FDL

Optional. Default: no secondary file created.

Uses a secondary file with the copied file's OpenVMS RMS record attributes (if you previously entered a PUT/FDL command). The SET TYPE command determines the type of file:


Examples

#1

FTP> GET "/seasons/standings/spring.deliveries" SPORTS.TXT 
200 PORT command successful 
150 Opening ASCII mode data connection for spring.stats. 
   .
   .
   .
      

Copies the UNIX file spring.deliveries to the OpenVMS host, where it is named SPORTS.TXT.

#2

FTP> GET spring.deliveries SPORTS.TXT 
      

Copies the same file (spring.deliveries) when it is in your remote working directory.

#3

FTP> MGET *.DOC 
200 PORT command successful 
150 Opening ASCII mode data connection for cast.doc;1 (130.180.4.8,27) 
226 Transfer complete. 
local:cast.doc;1   remote: cast.doc;1 
1222 bytes received in 00:00:00.01 seconds (70.19 Kbytes/s) 
200 PORT command successful 
150 Opening ASCII mode data connection for director.doc;3 (130.180.4.8,28) 
226 Transfer complete. 
local: director.doc;1   remote: director.doc;3 
90 bytes received in 00:00:00.01 seconds (5.49 Kbytes/s) 
FTP>
      

Copies all the UNIX files ending with doc.

#4

FTP> GET/CONFIRM  *.*;* 
Get EDTINI.EDT ? [Y or N] [Y]: Y 
   .
   .
   .
      

Before executing the copy operation for every file in the remote default directory, FTP asks, one-by-one, to confirm that you want to copy each file.

To confirm MPUT, MGET, and MDELETE operations, use the FTP prompt command before entering the MPUT, MGET, and MDELETE commands.


FTP> prompt 
Interactive mode on. 
FTP> mget C* 
Get CHRONOS ? [Y or N or Q or G] [Y]: y 
200 PORT command successful. 
150 Opening ASCII mode data connection for CHRONOS (130.180.4.8,2150) (1596 
bytes). 
226 Transfer complete. 
local: WORK1$:[VANA]CHRONOS.;2  remote: CHRONOS 
1596 bytes received in 00:00:00.04 seconds (31.80 Kbytes/s) 

#5

FTP> GET/FDL FEATHERS.DIS 
      

Copies and preserves the record attributes of feathers.dis. (A PUT/FDL command was previously entered.)


HELP

Displays information about how to type FTP commands. Provides help for both DCL-style and UNIX Style commands, as follows:

DCL-Style Format

HELP [ /REMOTE ] [ command ]


UNIX Style Formats

help [ command ]

? [ command ]


Parameters

command

Optional.

FTP command about which you would like information.


Qualifiers

/REMOTE

Optional. Default: local host.

The remote host displays the FTP help information. If the remote host is a UNIX host, the FTP help is all UNIX style. If you want to display information about a specific command, the /REMOTE qualifier must follow the HELP command and precede the name of any command for which you want information, as shown in the second example.


Examples

#1

FTP> HELP 
 
  Information available: 
 
  APPEND     CONNECT    CREATE     DELETE     DIRECTORY  DISABLE 
  DISCONNECT ENABLE     EXIT       GET        HELP       LOGIN      PUT 
  QUOTE      RENAME     SET        SHOW       SPAWN      VIEW 
 
Topic? 
      

The local system displays the FTP DCL-style commands.

#2

FTP> HELP/REMOTE 
214-The following commands are recognized (* =>'s) 
 
USER   PORT    RETR    MSND*    ALLO     DELE   SITE*    XMKD  CDUP 
PASS   PASV    STOR    MSOM*    REST*    CWD    STAT*    RMD   XCUP 
ACCT*  TYPE    APPE    MSAM*    RNFR     XCWD   HELP     XRMD  STOU 
REIN*  STRU    MLFL*   MRSQ*    RNTO     LIST   NOOP     PWD   QUIT 
MODE   MAIL*   MRCP*   ABOR     NLST     MKD    XPWD 
FTP> 
      

The remote host, a UNIX system, displays the FTP commands you can use in your FTP session with this system.

#3

FTP> HELP/REMOTE USER
214 Syntax: USER <sp> username 
FTP> 
      

The remote host displays information about the FTP USER command.

#4

FTP> ? 
Commands may be abbreviated.  Commands are: 
 
append          disconnect      mkdir           remotehelp      view 
ascii           form            mls             rename          view/p 
bell            get             mode            reset           view/pa 
binary          glob            mput            rmdir           view/pag 
bye             hash            open            rstatus         view/page 
case            image           prompt          send            vms 
cd              lcd             sendport        status          ? 
cdup            ls              put             struct          ! 
close           lpwd            pwd             sunique 
delete          mdelete         quit            type 
debug           mdir            quote           user 
dir             mget            recv            verbose 
FTP> 
      

This example shows you how to obtain FTP HELP on UNIX Style commands.


LOGIN

Initiates the login process and completes it if no password is required. If a password is required, enter it at the password prompt.

Use this command if the connection is active but the login procedure fails when you request a connection.


DCL-Style Format

LOGIN user_name


UNIX Style Format

user user_name


Parameters

user_name

Required.

Your account on the connected remote host.


Example


$ FTP 
FTP> open bygnet 
220 bygnet.band2.stat.com FTP server (Digital UNIX Version 5.60) ready 
Connected to bygnet. 
Name (bygnet:vana): evt 
331 Password required for evt. 
Password: 
530 Login incorrect. 
%TCPIP-E-FTP_LOGREJ, login request rejected 
FTP> LOGIN "evt" 
331 Password required for evt. 
Password:                      (password not echoed) 
230 User evt logged in. 
FTP> 
      

While trying to connect and log in to remote UNIX host bygnet, user evt entered an incorrect passsword. Although host bygnet completes the connection, bygnet rejects the login request. The LOGIN command successfully completes the login to the remote host.


Previous Next Contents Index