Previous Topic: CREATE_DIR

Next Topic: LOCAL_FILE


FILE_OPTION

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

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.

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

Default: CREATE