Dataset Services Interface › $DSCALL OPT=COMPRESS

$DSCALL OPT=COMPRESS

Compresses a PDS.

&CONTROL SHRVARS=($DS)
EXEC $DSCALL OPT=COMPRESS
             DSN=dataset_name
           [ DISPLAY= {YES | NO } ]
           [ STAT= { OLD | SHR } ]
           [ SYSPRINT= { DELETE | KEEP | DSN } ]

This call is used to compress a PDS using IEBCOPY. The compress function is used to reclaim unused space in the data set. This reduces fragmentation within the PDS and can result in more efficient use of the space allocated to the PDS.

Operands:

• OPT=COMPRESS

  Specifies that the data set be compressed.

• DSN=dataset_name

  Specifies the name of the data set to be compressed. No member name is specified.

• 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 compress operation has completed.

• STAT={ OLD | SHR }

  Specifies if the data set to be compressed is allocated exclusively for IEBCOPY (STAT=OLD) or is allowed to be shared with other users (STAT=SHR). It is recommended that STAT=OLD be specified to avoid the possibility of the PDS being corrupted if another user updates the PDS during the compress operation.

• SYSPRINT={ DELETE | KEEP | DSN }

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

  • If SYSPRINT=KEEP is specified, your product region allocates a SYSOUT file with CLASS=A. After the compress operation has completed, the SYSOUT data set is deallocated with DISP=KEEP to cause it to be kept. The output from the compress operation is browsed through, for example, SDSF.
  • If SYSPRINT=DELETE is specified, your product region allocates a SYSOUT file with CLASS=A. After the compress operation has completed, the SYSOUT file is deallocated with DISP=DELETE to cause it to be deleted. The output from the compress 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 compress operation is browsed through ISPF or by specifying DISPLAY=YES for this call. The data set is not deallocated from your product region on completion of the compress operation. The data set name, ddname, and volume for the data set are returned to the caller in variables. Use $DSCALL with OPT=FREE specifying the SYSPRINT ddname to remove the data set created by SYSPRINT.

Return Codes:

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

Return Variables:

• &$DSPRINTDSN

  SYSPRINT data set name if SYSPRINT=DSN is specified, or SYSOUT=A if SYSPRINT=DELETE or SYSPRINT=KEEP

• &$DSPRINTDD

  SYSPRINT ddname

• &$DSPRINTVOL

  SYSPRINT data set volume

Example: OPT=CLOSE

EXEC $DSCALL OPT=CLOSE  DSN=SYS.WORK.DEV01 STAT=SHR +
   SYSPRINT=DSN DISPLAY=NO

Note: IEBCOPY is invoked internally.