EFFECT={C | R | A | CR | CA | CN}

This parameter defines the file creation options. The LDISP and RDISP parameters might override this parameter. Whichever parameter defined last in the batch job takes precedence.

The valid values are as follows:

• C: creates the remote file. If the remote file already exists, abort the transfer.
• R: replaces the remote file. If the remote file does not exist, abort the transfer.
• A: appends the contents of the source file to the end of the remote file.
• CR: creates the remote file or replaces it if it already exists.
• CA: creates the remote file or appends the contents of the source file to the end of the remote file if it already exists.
• CN: creates a file if it does not exist or replaces it if it already exists. If the directory where the file will be created does not exist, create it.

If the remote system is another z/OS computer and you are sending to a member of a partitioned data set, specify CR or R. Specifying C will not work because the PDS itself already exists. If you specify A or CA for a PDS-PDS transfer, the member will be sent only if it does not exist in the recurring file. Otherwise, an error message is returned and the transfer fails.