FILE_OPTION

Indicates how the transferred data is to be processed by the receiving system. For file transfers only.
xdtful11601
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.
    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).
  • 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.
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