Purpose
The SUnique subcommand changes
the method of storing files on the foreign host.
Format
>>-SUnique--+-------------------------------+------------------><
'-+---------+--+--------------+-'
'-On--Off-' '-NAME--NONAME-'
Parameters
- On
- Turns on store unique.
- Off
- Turns off store unique.
- NAME
- When specified with ON or OFF, instructs the client to include
a name when sending a store-unique command to the server.
- NONAME
- When specified with ON or OFF, instructs the client to omit a
name when sending the store-unique command to the server.
Usage
- By default, the SUnique setting is OFF NAME and FTP uses a store
command (STOR) with the PUt and MPut subcommands. If the foreign host
already has a data set or file with the name specified by the foreign_file value, the foreign host overwrites
the existing data set or file.
- If SUnique is set to ON, FTP uses a store-unique command (STOU)
with the PUt and MPut subcommands and prevents you from overwriting
or erasing the existing data set or file on the foreign host. If
the default setting of NAME is in effect, a name string is sent to
the server with the store-unique command. The created foreign data
set or file is stored with a unique name. FTP sends the unique name
of the created foreign data set or file to the local host, where the
data set or file name is displayed on your terminal.
- SUnique with no parameters toggles the ON/OFF setting. If ON
or OFF is specified, SUnique is set to that value, regardless of its
current setting. The NAME/NONAME setting can be changed as SUnique
is turned ON or OFF. It is in effect when SUnique is ON and does
not change for the session until another NAME or NONAME setting is
specified.