DIGITAL TCP/IP Services for OpenVMS
User's Guide


Previous Contents Index


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.


DCL-Style Format

PUT

[ /qualifier(s)* ] local_file [ remote_file])

*Choose from the following qualifiers:
[ /CONFIRM ]
[ /CONVERT ]
[ /FDL ]
[ /RAW] ] )

UNIX Style Formats

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 (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 follow immediately after the PUT command without a space.

Asks you for confirmation before executing the copy operation.

/CONVERT

Optional.

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

/FDL

Optional. Default: no secondary file created. The /FDL qualifier must follow immediately after the PUT command without a 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 follow immediately after the PUT command without a 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-Style Format

QUOTE command_line


UNIX Style 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-Style Format

RENAME old_name new_name


UNIX Style 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>ls 
BEARS 
bears 
your.doc.1 
sports.txt.txt 
STUDENTS.LIS 
 
226 Transfer complete. 
265 bytes received in 00:00:00.00 seconds (64.69 Kbytes/s) 
FTP> RENAME STUDENTS.LIS TEST_STUDENTS.LIS 
350 File exists, ready for destination name 
250 RNTO command successful. 
FTP> 
      

This example shows how to use the RENAME command to rename 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_STU 
DENT.LIS;1 
FTP> 
      

This example shows how to rename a file that exists 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-Style Format

SET DEFAULT [ /LOCAL ] directory


UNIX Style 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:

Format

SET ERROR_LEVEL error_level


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 TYPE

Defines the data representation type:

DCL-Style Format

SET TYPE type


UNIX Style 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-Style Format

SHOW DEFAULT [ /LOCAL ]


UNIX Style 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 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-Style Format

SHOW STATUS


UNIX Style Format

status


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 
Reply display is on 
Parsing is on 
Prompting is off 
Port command is on 
Case: Filenames will be transferred in lowercase
      

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-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  ) 
 
      

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


SPAWN

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

DCL-Style Format

SPAWN [ command ]


UNIX Style Format

! [ command ]


Examples

#1

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

Interrupts your FTP process to display your default directory.

#2

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

You can also use the ! to spawn a command.


VIEW

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

DCL-Style Format

VIEW [ /PAGE ] filespec


UNIX Style 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 field.


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.


Chapter 3
Using Remote (R) Commands

The Remote (R) commands provided by the DIGITAL TCP/IP Services for OpenVMS software allow you to work in accounts on remote internet systems also supporting the Remote (R) protocols. You can also enter commands, shell scripts, and command procedures to these remote host systems without logging in to the hosts. These R commands include RCP (Remote Copy), RLOGIN (Remote Login), RSH (Remote Shell), and REXEC (Remote Execute, invoked by RSH). You enter these commands at your system command line prompt.

What You Can Do

The following table lists the Remote (R) commands and services, the functions you can perform, and the sections that explain how to use them.
Capability Section
Remote copy (RCP command):
Copy a file between the local host and a remote internet host
Copy a file between two remote internet hosts
3.4
Remote login (RLOGIN): Log in to an account on a remote host 3.5
Remote command or shell execution (RSH): Send a command to, or invoke a shell script or command procedure on a remote host 3.6
Remote command or shell execution with authentication (REXEC facility (using RSH/PASSWORD)): Using your user name and password for authentication, execute a command, shell script, or command procedure at a remote host 3.7

What You Need

To use the Remote (R) commands, you need access to an account on the remote host, which is granted by either of the following:

Command Summary

Table 3-1 summarizes the Remote (R) commands (for complete command descriptions, see Section 3.8).

Table 3-1 Remote (R) Commands: Summary
Function/Command Description
RCP Copies files between the local host and a remote host or between two remote hosts. Authentication is performed on the remote host or hosts using the user name supplied by RCP or authentication or proxy files.
RLOGIN Connects to the remote host, which starts an interactive login session. Authentication is performed on the remote host using the user name supplied by RLOGIN.
RSH Connects to the remote host, which executes the command you specified. Authentication is performed on the remote host using the user name supplied to RSH.
RSH/PASSWORD Uses the REXEC facility to connect to the remote host, which executes the command you specified. Authentication is performed on the remote host using the user name and password supplied by RSH.

3.1 Providing Account and Password Information

To use a remote command on your OpenVMS system, remote hosts need to know the user name that you want to use on the host. You can provide the user name in either of two ways:

The remote host must also know your password or know you as a trusted user on your local system through a proxy or authentication:

Notes

  • To use the REXEC feature, you must always use the /PASSWORD qualifier.
  • The RLOGIN command does not recognize the /PASSWORD qualifier. If you are a trusted user, you are automatically logged in to the remote system.
  • If you are not a trusted user, the remote host (REXEC) prompts you to enter a user name and password on the remote system.


Previous Next Contents Index