The Menu Interface (TSO/ISPF Panels) › Receive File From Another System Screen › Parameter Fields › Create/Replace/Add

Create/Replace/Add

Informs CA XCOM Data Transport how to handle the file in which the transferred data are going to be received. This is the file whose name appears in the Local File Name field.

C(reate)

CA XCOM Data Transport attempts to create (allocate) a new file on the receiving system. For information concerning the provision of additional allocation parameters for this new file, see the File Allocation Information screen in this chapter.

A(dd)

CA XCOM Data Transport adds the records being transferred to the end of an existing file (named in the Local File Name field).

For an indexed file, the keys must not match those in the file on the local system or CA XCOM Data Transport terminates the transfer with an error.

R(eplace)

CA XCOM Data Transport replaces the contents of a file on the local (initiating) system with the data being transferred.

If the file is indexed, the records with matching keys are replaced and those with non‑matching keys are added.

Notes:

• When transferring a partitioned data set, specify C only if the PDS itself is being created. If a new member is being sent to an existing PDS, specify R for Replace.
• If you specify Create, the CA XCOM default options table value REPCR is used to determine if the file will be replaced or if the transfer will terminate with an error. For more information, see REPCR in the chapter "The Batch Interface."

Default: C(reate)