Dataset Services Interface › $DSCALL OPT=COPYPDS

$DSCALL OPT=COPYPDS

Copies a PDS member from a source data set to a target data set.

EXEC $DSCALL OPT=COPYPDS 
             FROMDSN=source_dsn TODSN=target_dsn 
             MEMBER=member_name 
             REPLACE={ YES | NO }
             STAT={ SHR | MOD | OLD }
             SYSPRINT={ KEEP | DELETE | DSN }
             DISPLAY={ YES | NO }

This call is used to copy a PDS member from a source data set to a target data set.

Operands:

• OPT=COPYPDS

  Indicates that a copy of a PDS member is requested.

• FROMDSN=source_dsn

  Specifies the data set which contains the member to be copied.

• TODSN=target_dsn

  Specifies the data set to be copied to.

• MEMBER=member_name

  Specifies the names of the members to be copied. If MEMBER=* is specified, all members in the PDS are copied.

• REPLACE={ YES | NO }

  Specifies whether to replace an existing data set of the same name and is only applicable where the values of the FROMDSN and TODSN operands are both PDS data sets.

  If REPLACE=YES is specified, the member name specified in the FROMDSN operand is copied and given the member name specified in the TODSN operand even if that member name already exists.

  If REPLACE=NO is specified, the member specified in the FROMDSN operand is not copied if the member name specified in the TODSN operand already exists.

• STAT={ SHR | MOD | OLD }

  Specifies whether the data set specified in the TODSN operand is allocated exclusively for the copy operation (STAT=OLD), or is shared with other users (STAT=SHR). It is recommended that STAT=OLD be used as data set integrity cannot be guaranteed if another user attempts to access the data set while the copy operation is in progress.

  The data set specified in the FROMDSN operand is always allocated with STAT=SHR.

  You can use STAT=MOD to modify a sequential data set by adding new records after the last record in the data set.

• SYSPRINT={ DELETE | KEEP | DSN }

  Specifies the type of data set to be allocated to the SYSPRINT DD for the copy operation.

  • If SYSPRINT=KEEP is specified, your product region allocates a SYSOUT file with CLASS=A, and after the copy has completed the SYSOUT data set is deallocated with DISP=KEEP to cause it to be kept. The output from the copy operation is browsed through, for example, SDSF.
  • If SYSPRINT=DELETE is specified, your product region allocates a SYSOUT file with CLASS=A, and after the copy has completed, the SYSOUT file is deallocated with DISP=DELETE to cause it to be deleted. The output from the copy operation cannot be browsed.
  • If SYSPRINT=DSN is specified, your product region allocates a temporary data set, which is deleted when your product region terminates. The output from the copy operation is browsed through ISPF or by the use of the DISPLAY=YES operand on this call. The data set is not deallocated from your product region on completion of the copy operation. The data set name, ddname and volume for the data set are returned in variables to the caller. Removing the data set is the responsibility of the caller-the caller should deallocate the data set to delete it.
• DISPLAY= YES | NO

  Specifies whether to display the output on completion of the function. This operand is only valid if SYSPRINT=DSN is specified. If DISPLAY=YES is specified, a full-screen display of the SYSPRINT data set is presented after the copy operation has completed.

Return Codes:

Note: For more information about &SYSMSG, &$DSRC, and &$DSFDBK, see Return Codes and Feedback Codes.

Examples: OPT=COPYPDS

EXEC $DSCALL OPT=COPYPDS FROMDSN=dsn1_name
   TODSN= dsn2_name MEMBER=member_name STAT=SHR
   SYSPRINT=DSN DISPLAY=YES

This example copies member_name from dsn1_name to dsn2_name and displays the sysprint output to the screen.

EXEC $DSCALL OPT=COPYPDS FROMDSN=dsn1_name
  TODSN=dsn2_name MEMBER=member_name STAT=SHR
  SYSPRINT=DELETE

This example copies member_name from dsn1_name to dsn2_name and deletes the sysprint output.