Compaq TCP/IP Services for OpenVMS
User's Guide


Previous Contents Index


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 Format

LOGIN user_name


UNIX 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 (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:                     
230 User evt logged in. 
FTP> 
      

While trying to connect and log in to remote UNIX host bygnet , user evt enters 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.


PUT

The PUT command does the following:

File names are copied in lowercase without version numbers.

To use this command, you must have an FTP session with a remote host. For information about file version numbers, see Section 2.8.3.1.


DCL Format

PUT [ /CONFIRM | /CONVERT | /FDL | /RAW]

(local_file [ remote_file ] )


UNIX Format

put local_file [ remote_file ]

send local_file [ remote_file ]

mput local_files


Parameters

local_file

Required.

Name of the local file to copy.

remote_file

Optional. Default: same name, same case, no version number on UNIX systems.

Name of the new file on the remote host. You cannot use wildcards.


Qualifiers

/CONFIRM

Optional. Default: immediate execution. The /CONFIRM qualifier must immediately follow the PUT command, without a preceding space.

This qualifier asks you for confirmation before copying the file.

/CONVERT

Optional.

Translates the internal file-formatting characters of Variable Forms Control (VFC) files. The /CONVERT qualifier must immediately follow the PUT command, without a preceding space.

/FDL

Optional. Default: no secondary file created. The /FDL qualifier must immediately follow the PUT command, without a preceding space.

Creates a secondary file with the file's OpenVMS record attributes. The SET TYPE command determines the type of file.

/RAW

Optional.

Maintains block mode of files regardless of the TCPIP$FTP_RAW_BINARY logical name definition. The /RAW qualifier must immediately follow the PUT command, without a preceding space.


Examples

#1

FTP> PUT SALES.LIS;* 
200 PORT command successful 
150 Opening ASCII mode data connection for sales.lis.2 (130.180.4.8,1028) 
226 Transfer complete 
local: DISK3$:[TRANS]SALES.LIS;2  remote:  sales.lis.2 
3634 bytes sent in 00:00:00.01 seconds (394.31 Kbytes/s) 
200 PORT command successful 
150 Opening ASCII mode data connection for sales.lis.1 (130.180.4.8,1029) 
226 Transfer complete 
local: DISK3$:[TRANS]SALES.LIS;1  remote:  sales.lis.1 
3634 bytes sent in 00:00:00:01 seconds (394.31 Kbytes/s) 
FTP>
 
      

Copies all versions of the local file SALES.LIS to the remote UNIX host.

#2

FTP> PUT/FDL STAT.BCK "cygnet.bck" 
200 PORT command successful 
150 Opening data connection for cygnet.bckfdl (130.180.4.8,1028) 
226 Transfer complete 
local: cygnet.bckfdl  remote: cygnet.bckfdl 
21700 bytes sent in 00:00:00.03 seconds (662.23 Kbytes/s) 
200 TYPE set to IMAGE 
200 PORT command successful 
150 Opening data connection for cygnet.bck (130.180.4.8,1029) 
226 Transfer complete 
local: STAT.BCK  remote: cygnet.bck 
8152 bytes sent in 00:00:00.12 seconds 
FTP> 
      

Copies the local file STAT.BCK to a UNIX host, giving the copy the name cygnet.bck . Also creates a secondary file with the RMS record attributes of file cygnet.bckfdl .


QUOTE

Sends your input directly to the remote host. Lets you use FTP commands that are implemented by the remote host but not known to the local host.

To use the QUOTE command, you must have an FTP session with a remote host. The QUOTE command is not valid for file transfer.

For a list of commands implemented by the remote host, enter:


FTP> HELP/REMOTE 


DCL Format

QUOTE command_line


UNIX Format

quote command_line


Parameters

command_line

Required.

Remote command you want to execute.


Example


FTP> QUOTE CDUP 
250 CWD command successful. 
FTP>
      

FTP sends the cdup command to the UNIX host to change the remote directory up one level.


RENAME

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

DCL Format

RENAME old_name new_name


UNIX Format

rename old_name new_name


Parameters

old_name

Required.

File name on the remote host to rename.

new_name

Required.

New name for the remote file.


Examples

#1

FTP> rename STUDENTS.LIS TEST_STUDENTS.LIS
350 File exists, ready for destination name 
250 RNTO command successful. 
FTP>
      

Renames a file on a UNIX system.

#2

FTP> RENAME STUDENT.LIS TEST_STUDENT.LIS
350 File WORK1$:[VANA[STUDENT.LIS; will be renamed. 
250 File WORK1$:[VANA]STUDENT.LIS;1 renamed to WORK1$:[VANA]TEST_STUDENT.LIS;1 
FTP>
      

Renames a file on an OpenVMS system.


SET DEFAULT

Sets your default directory on either the remote host or the local host. To set the default directory on a remote host, you must have an FTP session with a remote host.

DCL Format

SET DEFAULT [ /LOCAL ] directory


UNIX Formats

cd directory

lcd directory


Parameters

directory

Required.

Name of the directory to which to change the default.


Qualifiers

/LOCAL

Optional. Default: remote.

Changes the working directory on the local host.


Examples

#1

FTP> SET DEFAULT "/USR/USERS/ROLLINGS"
250 CWD command successful.
      

Changes the remote working directory to /usr/users/rollings .

#2

FTP> SET DEFAULT ~
250 CWD command successful.
250 New default directory is /USR/USERS
 
      

Changes the remote working directory back to the default login directory.

#3

FTP> SET DEFAULT /LOCAL USER$1:[PRESS.CHECK] 
Local Directory now USER$1:[PRESS.CHECK]
 
      

Changes your local working directory to USER$1:[PRESS.CHECK].


SET ERROR_LEVEL

Sets maximum tolerance level for errors:

DCL Format

SET ERROR_LEVEL error_level


UNIX Format

There is no UNIX equivalent for the SET ERROR_LEVEL command.

Parameters

error_level

Required.

Severity of errors tolerated. Specify ERROR, SUCCESS, or WARNING. The default is SUCCESS.


Example


FTP> SET ERROR_LEVEL ERROR 
Error level is ERROR.
      

Sets the error level tolerance to ERROR.


SET PASSIVE

Controls whether the FTP client or server initiates data connections.

DCL Format

SET PASSIVE keyword


UNIX Format

passive keyword


Parameters

keyword

The FTP client program starts with the value AUTO. All keyword comparisons are done without regard for typographical case (case-blind).

Example


FTP> SET PASSIVE ON
Passive is ON
 
      

Sets passive mode to ON. The FTP client always initiates the data connection.


FTP> PASSIVE AUTO
Passive is AUTO (IPv4: OFF, IPv6: ON).
 
      

Sets passive mode back to AUTO.


SET TYPE

Defines the data representation type:

DCL Format

SET TYPE type


UNIX Format

type type


Parameters

type

Required.

Data representation type. Specify ASCII or IMAGE. If you do not use the SET TYPE command, the default is SET TYPE ASCII.


Example


FTP> SET TYPE IMAGE 
200 Type set to I.
      

Sets the data representation type to IMAGE for files you transfer during the current FTP session.


SHOW DEFAULT

Displays the name of the working directory on the remote host or the local host. To use the SHOW DEFAULT command to display the working directory on the remote host, you must have an FTP session with a remote host.

DCL Format

SHOW DEFAULT [ /LOCAL ]


UNIX Format

pwd


Qualifiers

/LOCAL

Optional. Default: remote directory.

Displays the local working directory.


Examples

#1

FTP> SHOW DEFAULT 
257 "/usr/staff/hurry/items" is current directory.
      

Displays the name of the working directory on the connected remote host.

#2

FTP> SHOW DEFAULT /LOCAL 
Local directory is WORKS$:[CROWE].
      

Displays the name of the working directory on the local host.


SHOW PASSIVE

Displays the current setting of the FTP client passive parameter.

Format

SHOW PASSIVE


Examples

#1

FTP> SHOW PASSIVE
Passive is AUTO (IPv4: OFF, IPv6: ON).
 
      

Shows that passive mode is on for IPv6.


SHOW STATUS

Displays the current FTP parameter settings and, if you have an open connection, the name of the connected host and parameter settings relative to the connection.

DCL Format

SHOW STATUS

STATUS


UNIX Format

status

rstatus


Examples

#1

FTP> SHOW STATUS 
211-FTP Server Status. 
211-SITE set to +VMS+. 
211-TYPE set to ASCII. 
211-STRU set to FILE. 
211-MODE set to STREAM. 
211 Multiline responses are enabled. 
Connected to: HANKS.ABC.UCB.EDU 
VMS Plus mode enabled 
Mode = stream, Type = ascii, Form = non_print, Structure = file 
Error level is SUCCESS 
Passive is AUTO (IPv4: OFF, IPv6: ON)
 
      

Displays the status of the connection with remote OpenVMS host HANKS. By default, FTP sets VMS Plus Mode for rapid file transfers between two OpenVMS systems running TCP/IP Services for OpenVMS.

#2

FTP> status 
 
211-FTP Server Status. 
211-SITE set to +VMS+. 
211-TYPE set to ASCII. 
211-STRU set to FILE. 
211-MODE set to STREAM. 
211 Multiline responses are enabled. 
Local client's status: 
Connected to:HANKS.ABC.UCB.EDU 
VMS Plus mode enabled 
Mode = stream, Type = ascii, Form = non_print, Structure = file 
Error level is SUCCESS 
Passive is AUTO (IPv4: OFF, IPv6: ON) 
Reply display is on 
Parsing is on 
Prompting is off 
Port command is on 
Case: MPUT will preserve typographical case in destination filenames, if 
possible 
 
      

Is a superset of the SHOW STATUS command. The output is consistent with running the status command on other platforms.

#3

FTP> show status 
211-eagle.store1.equip.com FTP server status: 
     Version 5.60 
     Connected to eagle.store1.equip.com 
     Logged in as jones 
     TYPE: Image; STRUcture: File; transfer MODE: Stream 
   211- No data connection 
211 End of status 
Connected to: eagle 
VMS Plus mode disabled 
Mode = stream , Type = image, Form = non_print, Structure = file 
Error level is SUCCESS 
Passive is AUTO (IPv4: OFF, IPv6: ON)  
 
      

Displays the current FTP parameters, which control data transfers with the connected UNIX host eagle .


SPAWN

Suspends the current FTP session and runs the DCL command that you type.

DCL Format

SPAWN [ command ]


UNIX Format

! [ command ]


Examples

#1

FTP> SPAWN SHOW DEFAULT 
SYS$LOGIN_DEVICE:[PERCY.DISTR]
      

Interrupts the FTP process to display your default directory.

#2

FTP> ! SHOW DEFAULT 
  WORK1$:[VANA.FTP] 
  FTP>
      

You can also use the exclamation point (!) to spawn a command.


VIEW

Displays the contents of a file on your current output device.

DCL Format

VIEW [ /PAGE ] filespec


UNIX Format

view filespec


Parameters

filespec

Required.

Specifies the file to be displayed. Wildcard characters (*, %) are not allowed in place of the directory name, file name, file type, or file version number.


Qualifiers

/PAGE

Optional.

Displays one screen at a time until the end of file (EOF) is reached. You can terminate the display at any time by pressing Ctrl/Z.


Examples

#1

FTP> VIEW FUNDING.TXT 
      

Scrolls through the contents of the FUNDING.TXT file in the current working directory, and displays the contents on the current output device.

#2

FTP> VIEW/PAGE FUNDING.TXT
      

Displays the contents of the FUNDING.TXT file, one screen at a time, on the current output device.


Previous Next Contents Index