The Batch Interface › SYSIN01 Parameters › SYSIN01 Parameters Required by FILETYPE=FILE › FILEOPT

FILEOPT

Indicates how the transferred file is managed by the receiving system.

REPLACE

Replaces the file on the receiving system. What is replaced depends on the type of VSAM file, as follows:

KSDS cluster

Records with matching and non‑matching keys are replaced.

ESDS cluster

Nothing is replaced. All records are added to the end of the data set, because a non‑reusable ESDS can only be replaced by deleting and redefining the cluster. Use CREATE to replace reusable VSAM clusters.

RRDS cluster

Nothing is replaced. This is an invalid choice.

Note: If sending a new member to a pre‑existing PDS, specify REPLACE.

ADD

Adds the records of the transferred file to the end of an existing sequential file or inserts them into an indexed file if they do not already exist there. If the records already exist there, CA XCOM Data Transport aborts the transfer.

Note: You cannot add to an existing PDS member.

CREATE

Creates the transferred file on the destination system as a sequential file. This option should also be used when VSAM clusters with the REUSE option are to be reused. If the transfer involves a PDS member, specify CREATE only if the PDS itself is being created; otherwise, an error results.

Notes:

• If CREATEDELETE=YES and the data set exists, then the data set is deleted and a new data set is allocated at the start of the transfer.
• If CREATEDELETE=NO and the data set exists, then the transfer fails with a catalog/file error.

Notes:

• This parameter is ignored for TYPE=EXECUTE transfers that specify TYPE=RECEIVE in SYSIN01 if the local file is identified through the LCLDS01 DD statement, because in this case the disposition of the file is determined by the DISP parameter on the DD statement.
• You can use symbolic variables with this parameter in batch SYSIN01. For more information, see Symbolic Parameters.

Default: REPLACE