Application Programming Interface › Using API Member Names › copies

copies

The number of copies to be sent. If this parameter is not specified, the remote system queues one copy of the report to the system's default printer. For report transfers only.

Range: 1 to 999

Default: 1

createdelete

Specifies whether an existing data set can be deleted and a new data set allocated at the start of a FILEOPT=CREATE transfer. This functionality is for CA XCOM Data Transport z/OS partners with support for CREATEDELETE. The CREATEDELETE parameter in the z/OS default table (XCOMDFLT) or destination member (XCOMCNTL) specified by the z/OS CA XCOM Data Transport Administrator affects the functionality of this parameter.

When z/OS has CREATEDELETE=ALLOW:

YES

If FILEOPT=CREATE and the data set exists, then the data set is deleted and a new data set is allocated at the start of the transfer.

NO

If FILEOPT=CREATE and the data set exists, then the transfer fails with a catalog/file error.

When z/OS has CREATEDELETE=YES:

YES or NO

If FILEOPT=CREATE and the data set exists, then the data set is deleted and a new data set is allocated at the start of the transfer.

When z/OS has CREATEDELETE=NO:

YES or NO

If FILEOPT=CREATE and the data set exists, then the transfer fails with a catalog/file error.

Default: NO

Notes:

• The attributes of the existing dataset are deleted and the new data set is allocated with the attributes specified in the transfer when CREATEDELETE=YES.
• CREATEDELETE applies only if the target data set is a sequential data set or an entire PDS/PDSE. CREATEDELETE is ignored for other types of data sets (such as PDS members, PDSE members, VSAM, and USS files).
• CREATEDELETE applies to relative GDGs when the dataset is specified using the fully qualified GxxxxVxx name.