1  PUT
   The PUT command does the following:

   o  Copies local files to a remote host.

   o  Copies files to a DECnet node.

   File names are copied in lowercase without version numbers.

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

   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
 

2  Parameters
 

local_file

   Required.

   Name of the local file to copy.

   o  To specify multiple files, separate the names with commas.

   o  To use wildcards, first enable parsing (see the ENABLE PARSE
      command).

         put file_name.ext - Copies the latest version
         put file_name.ext;* - Copies all versions

   o  To copy a file to a remote DECnet node, use the full
      specification:
      node name, device, directory, and file name.
 

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.
 

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

   o  Specifying ASCII results in a sequential file with variable-
      length records. Select this type when transferring ASCII text
      files.

   o  Specifying IMAGE results in a sequential file with fixed-
      length records of 512 bytes. Select this type when
      transferring non-ASCII files, such as executable image files.
 

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

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

     o  File names are copied in lowercase.

     o  OpenVMS file version numbers become the last element of the
        copied files.

     o  Semicolons are converted to periods.

     o  If the Store Unique feature is toggled on (sunique), when
        you copy a file to an OpenVMS host, the host FTP server
        gives the file a new, unique version number. When you
        specify the version number of a file to be copied (PUT)
        to a remote UNIX host, the file retains the version number
        on the remote host, with the semicolon (;) replaced by a
        period (.). The UNIX host adds another version number to
        the file name as well. For example, if you copy (PUT) file
        BASES.TMP;2 to a UNIX host, the file name on the UNIX host
        will be bases.tmp.2.1.

   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.