SUnique subcommand

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.