The Command Line Interface › Using the Retrieve File Command › FILE_OPTION_RF

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 a value is not specified, then the value of FILE_OPTION is used. If no default is specified in FILE_OPTION or FILE_OPTION_RF, then the value defaults to CREATE.

For most file transfers, the parameter values are 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 wildcard transfers, the parameter values are as follows:

CREATE

Create the PDS/Directory and add the transferred members. If the PDS/Directory already exists, the transfer fails with an error.

APPEND

Add transferred members/files. If the PDS/Directory does not exist or the member/file already exists, the transfer fails with an error.

REPLACE

Add or replace transferred members/files. If the PDS/Directory does not exist, the transfer fails with error XCOMN0403E Cannot open output file-No such file or directory.

Default: CREATE