Parameters › List of Parameters › FILE_OPTION

FILE_OPTION

Indicates how the transferred data is to be processed by the receiving system. For file transfers only.

For general transfers, the range of values is as follows:

CREATE

Create a new file on the receiving system.

APPEND

Append the transferred data to an existing file on the receiving system.

REPLACE

Replace an existing file on the receiving system.

For library-type transfers, the range of values is as follows:

CREATE

For systems supporting PDS:

Creates the PDS on the receiving system and adds the transferred members. If the PDS already exists, the transfer fails.

Note: The transfer will not fail if the PDS already exists if CREATEDELETE=YES is specified and the remote z/OS system has been set up to allow the PDS to be recreated through the default table (XCOMDFLT) or destination member (XCOMCNTL).

For systems supporting directories:

If the directory does not exist, the reaction depends on the value of CREATE_DIRECTORIES in the global file, as follows:

• If CREATE_DIRECTORIES=YES, the transfer creates the directory and adds the transferred members.
• If CREATE_DIRECTORIES=NO, the transfer fails.

ADD/APPEND

For systems supporting PDS:

Adds or replaces transferred members on the receiving system. If the PDS does not exist, the transfer fails.

For systems supporting directories:

The value of CREATE_DIRECTORIES determines the outcome of the transfer on the remote system, as follows:

• If CREATE_DIRECTORIES=YES and the directory does not exist, then the directory is created and the transfer members are added to this directory. If the directory does exist, the transfer members are added to this existing directory.
• If CREATE_DIRECTORIES=NO and the directory does not exist, then the transfer fails. If the directory does exist, then the transfer adds the transfer members to the directory.

REPLACE

Adds or replaces transferred members. If the directory does not exist, the reaction depends on the value of CREATE_DIRECTORIES in the global file, as follows:

• If CREATE_DIRECTORIES=YES, the transfer creates the directory and adds the transferred members.
• If CREATE_DIRECTORIES=NO, the transfer fails.

Note: SUSPEND and RESUME are not supported for those transfers that are transferring multiple files with the use of the * wildcard character.

Default: CREATE

Note: When creating a file on an IBM mainframe system, some additional information may be necessary. For more information, see the RECORD_FORMAT, BLKSIZE, VOLUME, and UNIT parameters.

FILE_OPTION_RF

Indicates how the transferred data is to be processed by the receiving system (that is, the local system). Used when the transfer type is Retrieve File. If no value is specified, then the value defaults to CREATE.

For general transfers, the range of values is as follows:

CREATE

Create a new file on the receiving system.

APPEND

Append the transferred data to an existing file on the receiving system.

REPLACE

Replace an existing file on the receiving system.

For library-type transfers, the range of values is as follows:

CREATE

For systems supporting PDS:

Creates the PDS on the receiving system and adds the transferred members. If the PDS already exists, the transfer fails.

Note: The transfer will not fail if the PDS already exists if CREATEDELETE=YES is specified and the remote z/OS system has been set up to allow the PDS to be recreated through the default table (XCOMDFLT) or destination member (XCOMCNTL).

For systems supporting directories:

If the directory does not exist the reaction depends on the value of CREATE_DIRECTORIES in the global file, as follows:

• If CREATE_DIRECTORIES=YES, the transfer creates the directory and adds the transferred members.
• If CREATE_DIRECTORIES=NO, the transfer fails.

ADD|APPEND

For systems supporting PDS:

Adds or replaces transferred members on the receiving system. If the PDS does not exist, the transfer fails.

For systems supporting directories:

The value of CREATE_DIRECTORIES determines the outcome of the transfer on the remote system, as follows:

• If CREATE_DIRECTORIES=YES and the directory does not exist, then the directory is created and the transfer members are added to this directory. If the directory does exist, the transfer members are added to this existing directory.
• If CREATE_DIRECTORIES=NO and the directory does not exist, then the transfer fails. If the directory does exist, then the transfer adds the transfer members to the directory.

REPLACE

Adds or replaces transferred members. If the directory does not exist, the reaction depends on the value of CREATE_DIRECTORIES in the global file, as follows:

• If CREATE_DIRECTORIES=YES, the transfer creates the directory and adds the transferred members.
• If CREATE_DIRECTORIES=NO, the transfer fails.

Note: If Windows is the local system, PDS files would usually apply only to metatransfers to a remote system such as z/OS. For information about metatransfers, see the following sections:

• How to Send a Metatransfer
• Command Examples for Metatransfers and Inquire on Status

Note: SUSPEND and RESUME are not supported for those transfers that are transferring multiple files with the use of the * wildcard character.

Default: CREATE