|
Purpose Use the MPut subcommand to copy
multiple data sets from your local host to the remote host.
Format
.----------------.
V |
>>-MPut----local_data_set-+------------------------------------><
Parameters - local_data_set
- Specifies the name of the file on your local host being sent to
the remote host.
Because more than one data set can be copied
with the MPut subcommand, the local_data_set parameter of this subcommand can be repeated many times, with each local_data_set separated by a blank space. You
can use the asterisk (*) character for pattern matching when specifying
the local_data_set with the MPut subcommand.
When the wildcard symbol (*) is used in the filename parameter,
and the GLOB subcommand is set to expand metacharacters in file names,
the LISTSUBdir option affects the result of MPut. For more information
about the LISTSUBdir option, see LOCSIte subcommand—Specify site information to the local host, or the LISTSUBDIR statement (FTP client
and server) details in z/OS Communications Server: IP Configuration
Reference.
Examples The following is a sample entry
and response that displays after using the MPut subcommand to send
selected files. Command:
mput file*
Mput FILE1 (Yes|No|Quit|Stop prompting)? yes
>>>PORT 9,67,113,57,5,128
200 Port request OK.
>>>STOR FILE1
125 Storing data set /u/user31/temp/FILE1
250 Transfer completed successfully.
164 bytes transferred in 0.010 seconds. Transfer rate 16.40 Kbytes/sec.
Mput FILE2 (Yes|No|Quit|Stop prompting)? no
Mput FILE3 (Yes|No|Quit|Stop prompting)? yes
>>>PORT 9,67,113,57,5,129
200 Port request OK.
>>>STOR FILE3
125 Storing data set /u/user31/temp/FILE3
250 Transfer completed successfully.
164 bytes transferred in 0.010 seconds. Transfer rate 16.40 Kbytes/sec.
Command:
dir
>>>PORT 9,67,113,57,5,130
200 Port request OK.
>>>LIST
125 List started OK
total 16
-rw-r----- 1 USER31 SYS1 162 Aug 14 13:20 FILE1
-rw-r----- 1 USER31 SYS1 162 Aug 14 13:21 FILE3
250 List completed successfully.
Command:
Results: - FTP maintains the attributes of a data set that is transmitted
between a client and a server. However, when you use the MPut subcommand,
FTP might truncate data records and you might lose data, if:
- You are creating a new file at the server and the value of LRecl,
as shown by the STAtus subcommand, is a value less than the LRecl
of the transmitted data set and SENDSite has been set to OFF, FTP
truncates the transmitted data set.
- The data set name already exists at the receiving site and the
logical record length (LRecl) of the data set at the receiving site
is less than the LRecl of the transmitted data set, FTP truncates
the transmitted data set.
- By default, if you use the MPut subcommand, the remote host creates
files with the same names as those specified in local_data_set and overwrites any existing files with those names.
To put files on the remote host with unique file names, you must
have set unique storage on before issuing the MPut command. Use the
SUnique subcommand to change the storage method.
- If you specify one or more incorrect parameters with the MPut
subcommand, an error message specifying the incorrect parameter is
displayed. All correct files are transferred, regardless of any incorrect
parameters, and do not need to be reissued.
- When UNIXFILETYPE=FIFO is configured at the FTP client, and the
local directory is a z/OS® UNIX directory, the following apply:
- Named pipes are transferred; transfers from existing z/OS UNIX regular files will fail.
- FTP is unable to read from the named pipe until another process
on the z/OS client host opens
the named pipe for writing. The z/OS FTP client waits up to the number of seconds specified
by the FIFOOPENTIME value for another process to open the named pipe.
- FTP waits up to the number of seconds specified by the FIFOIOTIME
value for each read from the named pipe to complete. If the client
cannot read any data from the named pipe for the number of seconds
specified by the FIFOIOTIME value, the file transfer fails.
- Sending the named pipe permanently removes data from the named
pipe.
- If the FTP server is a z/OS FTP server, the server UNIXFILETYPE configuration option is set
to FIFO, and the remote file directory is a z/OS UNIX file system directory, the server creates the remote files as named
pipes rather than as regular files.
The FTP server creates named
pipes using the same names as those specified in the local file and
appends to existing named pipes with those names. The FTP server
rejects transfers into z/OS UNIX regular files with the
same names as those specified in the local file.
For more
information about using z/OS UNIX named pipes, see Using z/OS UNIX System Services named pipes.
Requirement: To send a
data set to the remote host, you must have a defined working directory
on the remote host and write privileges to the files in this working
directory.
Restriction: The MPut subcommand is
not applicable to generation data groups (GDGs).
|