Dataset Services Interface › $DSCALL OPT=MOVEPACK

$DSCALL OPT=MOVEPACK

Moves a data set to another disk pack.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL    OPT=MOVEPACK 
                DSN=dataset_name VOL=volume_name 
                SYSPRINT={ KEEP | DELETE | DSN } 
                DISPLAY={ YES | NO }

Use this call to move a data set to a specified disk pack. This option is only useful for moving cataloged data sets.

The new data set is cataloged, with the same name, on the specified target disk pack-the data set name cannot be changed. If the target volume is the same as the source disk pack, no action is taken.

For a VSAM data set the IDCAMS utility is used to perform the move. The VSAM data set is exported and then imported on the target volume. The IEHMOVE utility is used for non-VSAM data sets. The data set is moved to the target volume and deleted from the current volume by the IEHMOVE utility. The utility catalogs the data set on the target volume.

Operands:

• OPT=MOVEPACK

  Indicates that a data set is to be moved between disk packs.

• DSN=dataset_name

  The name of the PDS or sequential data set to be moved.

• VOL=volume_name

  The name of the disk pack to which the data set will be moved.

• SYSPRINT={ KEEP | DELETE | 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.
• 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.

Example: OPT=MOVEPACK

EXEC $DSCALL OPT=MOVEPACK DSN=MYDATASET VOL=MVS009