Examples of PUt, MPut and MVSPut subcommands

Results:

If the LISTSUBdir option is not specified on the LOCSITE subcommand and the LISTSUBDIR statement is not specified in the client FTP.DATA file, the default is as if the LISTSUBdir option was specified on the LOCSITE subcommand.
If the z/OS® FTP client has the NOLISTSUBDIR option on the LOCSITE subcommand or LISTSUBDIR FALSE in the client FTP.DATA file, an mput * stores only the files that are in the current directory.

Restriction: The LISTSUBDIR statement applies to z/OS UNIX file operations only; MVS™ data set operations are not affected.

Example 1: PUT and MPUT subcommands enable you to send files from a local host to a remote host. In this example, FTP subcommands are issued from MVSXA2 to MVSVIC03. The data set USER121.FTP.EXAMPLE on MVSXA2 contains the following members:

APPEND01
XA2FILE1
XA2FILE2
XA2FILE3

The data set USER121.FTP.EXAMPLE on MVSVIC03 contains the following members:

XA3FILE1
XA3FILE2
XA3FILE3

The following is displayed when entering the FTP environment:

  User:   ftp 1.1.2.3
System:     IBM FTP CS V1R5
            FTP: using TCPCS
            Connecting to 1.1.2.3, port 21
            220-FTPD1 IBM FTP CS V1R2 at MVS164, 20:12:38 on 2003-01-02.
            220 Connection will close if idle for more than 5 minutes.
            NAME (<host>:tsouserid):
  User:   user121
System:     >>>USER user121
            331 Send password please.
            Password:
            >>>PASS ********
            230 user121 is logged on.  Working directory is "/u/user121"
            Command:

   User:  put 'user121.ftp.example(xa2file1)' 'user121.ftp.example(f1from2)'
 System:    >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
            200 Site command was accepted
            >>>PORT 1,1,2,2,4,48
            200 Port request OK.
            >>>STOR 'user121.ftp.example(f1from2)'
            125 Storing data set USER121.FTP.EXAMPLE(F1FROM2)
            250 Transfer completed successfully.
            390 bytes transferred in 1.117 seconds.
            Transfer rate 0.35 Kbytes/sec.
            Command:
  User:   put 'user121.ftp.example(xa2file1)' 'user121.ftp.example(f1from2)'
System:     >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
            200 Site command was accepted
            >>>PORT 1,1,2,2,4,49
            200 Port request OK.
            >>>STOR 'user121.ftp.example(f1from2)'
            125 Storing data set USER121.FTP.EXAMPLE(F1FROM2)
            250 Transfer completed successfully.
            390 bytes transferred in 0.680 seconds.
            Transfer rate 0.57 Kbytes/sec.
            Command:

  User:   sunique
System:     Store unique is ON
            Command:
  User:   put 'user121.ftp.example(xa2file1)' 'user121.ftp.example(f1from2)'
System:     >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
            200 Site command was accepted
            >>>PORT 1,1,2,2,4,50
            200 Port request OK.
            >>>STOU 'user121.ftp.example(f1from2)'
            125 Storing data set USER121.FTP.EXAMPLE(F1FROM21) ( unique name )
            250 Transfer completed successfully.
            390 bytes transferred in 1.085 seconds.
            Transfer rate 0.36 Kbytes/sec.
            Command:
  User:   sunique
System:     Store unique is OFF
            Command:
  User:   cd 'user121.ftp.example.'
System:     >>>CWD 'user121.ftp.example.'
            257 "'USER121.FTP.EXAMPLE.'" is working directory name prefix.
            Command:
  User:   lpwd
System:     Local directory is USER121.
            Command:
  User:   lcd 'user121.ftp.example'
System:     Local directory name set to PDS USER121.FTP.EXAMPLE.
            Command:
  User:   lpwd
System:     Local directory is partitioned data set USER121.FTP.EXAMPLE.
            Command:

  User:   mput xa2file2 xa2file3
System:     >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
            200 Site command was accepted
            >>>PORT 1,1,2,2,4,51
            200 Port request OK.
            >>>STOR XA2FILE2
            125 Storing data set USER121.FTP.EXAMPLE.XA2FILE2
            250 Transfer completed successfully.
            390 bytes transferred in 1.437 seconds.
            Transfer rate 0.27 Kbytes/sec.
            >>>SITE FIXrecfm 128 Lrecl=128 Recfm=FB BlockSize=6144
            200 Site command was accepted
            >>>PORT 1,1,2,2,4,52
            200 Port request OK.
            >>>STOR XA2FILE3
            125 Storing data set USER121.FTP.EXAMPLE.XA2FILE3
            250 Transfer completed successfully.
            390 bytes transferred in 1.091 seconds.
            Transfer rate 0.36 Kbytes/sec.
            Command:
  User:   quit
System:     >>>QUIT
            221 Quit command received. Goodbye.
            READY

The data set USER121.FTP.EXAMPLE on MVSVIC03 now contains the following members:

F1FROM2
F1FROM21
XA3FILE1
XA3FILE2
XA3FILE3

MVSVIC03 now also has the following data sets:

USER121.FTP.EXAMPLE.XA2FILE2
USER121.FTP.EXAMPLE.XA2FILE3

Restriction: The MPUT command is not applicable for generation data groups (GDGs).

Example 2: MPUT with LOCSITE LISTSUBDIR

Following is an example of mput * with the LOCSITE LISTSUBDIR option. The LISTSUBDIR option specifies that not only the current subdirectory, but also the next subdirectory should be searched for files to be sent from the client to the server. In this example, the current directory has a file x and a subdirectory y and subdirectory y has a file x.

locsite listsubdir
prompt
Interactive mode is off
Command:
mput *
>>> PORT 127,0,0,1,4,11
200 Port request OK.
>>> STOR x
125 Storing data set /u/user1/x
250 Transfer completed successfully.
5 bytes transferred in 0.070 seconds.  Transfer rate 0.07 Kbytes/sec.
>>> PORT 127,0,0,1,4,12
200 Port request OK.
>>> STOR x
125 Storing data set /u/user1/x
250 Transfer completed successfully.
5 bytes transferred in 0.020 seconds.  Transfer rate 0.25 Kbytes/sec.
Command:

Example 3: MPUT with LOCSITE NOLISTSUBDIR

Following is an example of mput * with the LOCSITE NOLISTSUBDIR option. The NOLISTSUBDIR option specifies that only the current directory should be searched for files to be sent from the client to the server. In this example, the current directory has a file x and a subdirectory y and subdirectory y has a file x.

 
locsite NOlistsubdir
prompt
Interactive mode is off
Command:
mput *
>>> PORT 127,0,0,1,4,11
200 Port request OK.
>>> STOR x
125 Storing data set /u/user1/x
250 Transfer completed successfully.
5 bytes transferred in 0.070 seconds.  Transfer rate 0.07 Kbytes/sec.
Command:

Example 4: MVSPut with a physical sequential data set transferred

Following is a sample entry and response that is displayed after the MVSPut subcommand is used to transfer a physical sequential data set:

mvsput 'user1.ps.source' 'user1.ps.target' (REAllocate                          
EZA1701I >>> XDSS 'user1.ps.target'                                             
200-LASTREF=2011/12/07 DSEMPTY=FALSE                                            
200 SITE DSNTYPE=BASIC RECFM=VB BLKSIZE=6233 LRECL=256 PRIMARY=1 SECONDARY=1 TRA
CKS EATTR=SYSTEM                                                                
EZA1701I >>> DELE 'user1.ps.target'                                             
250 USER1.PS.TARGET deleted.                                                    
EZA1701I >>> SITE DSNTYPE=BASIC RECFM=VB BLKSIZE=6233 LRECL=256 PRIMARY=1 SECOND
ARY=1 TRACKS EATTR=SYSTEM                                                       
200 SITE command was accepted                                                   
EZA1701I >>> PORT 127,0,0,1,4,4                                                 
200 Port request OK.                                                            
EZA1701I >>> STOR 'user1.ps.target'                                             
125 Storing data set USER1.PS.TARGET                                            
250 Transfer completed successfully.    
EZA2108I Confidence=High for MVSPUT of USER1.PS.TARGET                                           
EZA1617I 2331 bytes transferred in 0.005 seconds.  Transfer rate 466.20 Kbytes/sec.

Restriction: For more restrictions about the MVSPut subcommand, see MVSPut subcommand – Copy a local data set into a remote data set name with the local data set attributes

Example 5: MVSPut with a PDS data set transferred

Following is a sample entry and response that is displayed after the MVSPut subcommand is used to transfer a PDS data set:

mvsput 'user1.local.pds''user1.remote.pds'(REAllocate
EZA1701I >>> PWD                                                                
257 "'USER1.'" is working directory.                                            
EZA1701I >>> XDSS 'user1.remote.pds'                                             
200-LASTREF=2011/12/16 DSEMPTY=FALSE                                            
200 SITE PDSTYPE=PDS RECFM=VB BLKSIZE=6233 DIRECTORY=27 LRECL=256 PRIMARY=1 SECO
NDARY=1 TRACKS EATTR=SYSTEM                                                     
EZA1701I >>> DELE 'user1.remote.pds'                                             
250 USER1.REMOTE.PDS deleted.                                                    
EZA1701I >>> SITE PDSTYPE=PDS RECFM=VB BLKSIZE=6233 DIRECTORY=27 LRECL=256 PRIMA
RY=1 SECONDARY=1 TRACKS EATTR=SYSTEM                                            
200 SITE command was accepted                                                   
EZA2081I Local directory name set to partitioned data set USER1.LOCAL.PDS      
EZA1701I >>> MKD 'user1.remote.pds'                                              
257 "'USER1.REMOTE.PDS'" created.    
EZA1701I >>> CWD 'user1.remote.pds'                                              
250 The working directory "USER1.REMOTE.PDS" is a partitioned data set           
EZA1701I >>> PORT 127,0,0,1,4,11                                                
200 Port request OK.                                                            
EZA1701I >>> STOR NEW1                                                          
125 Storing data set USER1.REMOTE.PDS(NEW1)                                      
250 Transfer completed successfully.                                               
EZA1617I 134 bytes transferred in 0.005 seconds.  Transfer rate 26.80 Kbytes/sec.  
EZA1701I >>> PORT 127,0,0,1,4,12                                                
200 Port request OK.                                                            
EZA1701I >>> STOR NEW2                                                          
125 Storing data set USER1.REMOTE.PDS(NEW2)                                      
250 Transfer completed successfully.                                                
EZA1617I 134 bytes transferred in 0.005 seconds.  Transfer rate 26.80 Kbytes/sec.
EZA2581I Local HFS directory is /u/user1.                                      
EZA1701I >>> CWD 'USER1.'                                                       
250 "USER1." is working directory name prefix 
EZA2108I Confidence=High for MVSPUT of USER1.LOCAL.PDS

Restriction: For more restrictions about the MVSPut subcommand, see MVSPut subcommand – Copy a local data set into a remote data set name with the local data set attributes.