DSF DUMP Statement

DUMP statement syntax

DUMP statement

The DUMP statement requests a dump (backup) operation. It must be the first statement input.

These operands control the backup of each specified DASD volume (DISKx DD statement) to its backup data set (TAPEx DD statement). If a TAPExx DD statement is also present, a second duplicate copy of the backup is written there. The backup data sets may be on tape or DASD. The backups proceed for each valid DISKx and TAPEx DD statement pair in the JCL. If the ATTACH or MAXTASKS= option is specified, a SYSPRINx DD statement is also required, to separate messages for each concurrent dump subtask.

One or more SELECT statements and optionally one or more EXCLUDE statements to specify the data sets or tracks to be dumped must follow it.

DUMP statement operands

TYPE=DSF

Specifies that a data set backup is to be performed. It is required.

ATTACH

Backups proceed concurrently for all DASD volumes for which a triplet of DISKx, TAPEx, and SYSPRINx DD statements appear.

Default: Each DISKx and TAPEx statement pair is processed one at a time, in the order that the DISKx DD statements appear in the JCL, unless MAXTASKS= is specified.

BCV=

Used only when you are licensed for FDRINSTANT and only if you have previously used program EMCTF to create an instant point-in-time image of a volume by SPLITing a BCV in an EMC Symmetrix DASD subsystem with the TimeFinder/Mirror feature. It causes FDRto backup the point-in-time image instead of the online DASD volume. See FDRINSTANT-for-EMC-TimeFinder for details of the use of BCV= with FDR.

BUFNO=

Specifies how many buffers are used for dumping each DASD volume. Each buffer holds one DASD track.

Buffers sufficient to read 1 cylinder of the input DASD volume are acquired (usually 16).

nn

The specified number of buffers is acquired.

Default: BUFNO=MAX, unless RTC=YES is specified on the DUMP statement or as a global option.

cloudname

The name of the cloud where the backup is directed.

Default: The backup is created on tape or disk, as indicated by the TAPEx DD statement.

COMPRESS=

Controls the use of FDRsoftware compression. Values for COMPRESS= are:

The backup file for both copies (TAPEx and TAPExx) is compressed.

Only the backup on TAPEx DD statements is compressed.

Only the backup on TAPExx DD statements is compressed.

See FDR-Fast-Dump-Restore for the additional storage required by COMPRESS=.

Default: Backups are not compressed.

cloudcontainer

The name of the container in the cloud where the backup is stored. The name must start with FDR.. If the specified or defaulted container name does not exist, it is created automatically, provided that the FDRTCTSR started task is running (FDR-Installation). The name may be up to 128 characters long. If the name does not fit on one line, then break it any point and code CONTAINER= on subsequent lines with the next part of the name. Example:

Default: FDR.DSF.BACKUP.

DATA=

All allocated tracks of all selected data sets are backed up. You may need to specify DATA=ALL if the data sets to be backed up include JES2 spool/CHKPT data sets or CICS sequential journal data sets.

Only the used portion of Physical Sequential (PS) and PO (partitioned, PDS) data sets are backed up. On almost all volumes, this makes the dump run faster.

Default: DATA=USED.

DSNENQ=

Specifies whether a SYSDSN enqueue should be issued for each selected data set on a volume during the backup of the volume. For more information see Data Set Enqueue Option section.

The options for DSNENQ= are:

Enqueue the data sets. If an enqueue fails, ask the operator what to do.

No data set enqueue is issued.

Do not enqueue the data sets, but test to see if they are enqueued to another task.

Enqueue the data sets. This is the most frequently used option.

Default: DSNENQ=NONE.

EMSG=

Used when the FDRe-mail notification facility has been invoked by including an FDREMAIL DD statement in the FDRexecution JCL.

E-mail notifications are sent from successful FDRoperations as well as failures.

Default: E-mail notifications are sent only for FDRfailures.

ENQ=

Specifies whether a SYSVTOC enqueue should be issued on the VTOC of each DASD volume while data sets from it are being backed up. For more information, see VTOC Enqueue Option section.

The VTOC is not enqueued or RESERVEd during the backup.

The VTOC of each DASD volume is enqueued during its backup. This enqueue may be effective only on the system where the backup is executing; other systems may still be able to update the VTOC.

In addition to the enqueue, a hardware RESERVE is issued on each DASD volume during its backup.

Default: ENQ=OFF.

ENQERR=

Specifies processing if the DSNENQ= option finds that a data set is in use (enqueued):

Do not backup an active data set. 

Backup a data set even if it is active (a warning message will still be produced).

Default: ENQERR=PROCESS.

ENQERR=NO

If the DSNENQ= operand is used to request data set enqueues, an enqueue failure (in-use data set) is not considered an error (see Step Termination). Use ENQERR=NO if you want messages about active data sets but want the step to terminate normally.

Default: A DSNENQ failure is considered an error and causes a condition code or abend at step termination. This is to call attention to the error.

If RTC=YES is in effect, then page-fix the disk and tape I/O buffers in real storage for the duration of the DUMP operation, and pass real channel programs to the system instead of virtual channel programs. This saves considerable CPU time that the system would otherwise consume for fixing and unfixing pages at the beginning and end of each I/O operation, and for translating the channel programs from virtual to real. EXCPVR=YES may reduce elapsed time by 5 to 20 percent and may reduce CPU time and CPU service units by 40 to 60 percent.

If RTC=YES is in effect, then pass virtual channel programs to the system, and allow the system to fix and unfix the pages of the I/O buffers at the beginning and end of each I/O operation.

If RTC=YES is not in effect, then EXCPVR= is ignored.

Default: YES.

FCOPY=

Used only when you are licensed for FDRINSTANT and only if you have previously used program FDRFLASH or FDRABR (with the FCOPY statement) to create an instant point-in-time image of a volume in a DASD subsystem with the FlashCopy feature. It causes FDRto copy files from the point-in-time image instead of the online DASD volume. See FDRINSTANT-for-FlashCopy for details of the use of FCOPY= with FDR.

FORMAT=

Specifies the format of the sequential backup file.

The backup is created using a maximum block size of 56K. A block contains the image of one or more tracks from the input DASD volume.

The backup is created using a maximum block size of 32K. Blocks that would be more than 32K are written as 2 blocks of 32K or less. However, FORMAT=SPLIT causes use of a DASD I/O technique that is less efficient than that used by FORMAT=NEW, which affects backup performance.

Default: FORMAT=NEW if all (TAPE1/TAPE11) backups on tape; FORMAT=SPLIT if any (TAPE1/TAPE11) backups on DASD.

HFS=QUIESCE

ZFS=QUIESCE

Invokes special processing when Hierarchical File System (HFS) and zSeries File System (zFS) data sets are backed up. HFS=QUIESCE and ZFS=QUIESCE imply DSNENQ=USE so it first attempts to get a SYSDSN enqueue on the file. If the enqueue fails, it probably means that the file system is mounted to UNIX System Services (USS), so a “quiesce” call is issued to prevent updates to the data set during the backup. If the quiesce fails and ENQERR=BYPASS was specified, the data set is not backed up. See Hierarchical File System (HFS) and zSeries File System (zFS) sections in FDR-Processing-by-Type-of-Data-Set.

Default: HFS and zFS data sets are not quiesced unless HFSQUIESCE is set to YES in the FDRGlobal Options (see HFSQUIESCE section in General-Options). If you use the default, you should unmount the file system before the backup to be sure of getting a usable backup.

ICFCORE=

nnnnnnn

Specifies the size, in bytes, of the table used to the store the VSAM cluster and component names while matching them with VTOC DSCBs. Specifying ICFCORE= increases the backup region requirement by the value specified. The default is large enough for almost all volumes.

MAXCARDS=

nnnnn

Accept additional SELECT/EXCLUDE statements (over 250).

Default: MAXCARDS=250.

MAXERR=

nnnn

Specifies the number of tape or DASD errors (1 to 9999) that, if reached, cause the operation to abend. Each error is indicated by a message and possible mini-dump.

Default: 20, except when the output is a tape where MAXERR=1 is forced.

MAXTASKS=

n

Specifies the maximum number of volumes that are dumped concurrently in this step. It has the same effect as the ATTACH operand except that the maximum number of concurrent backups is limited to “n”. The value may be from 1 to 9 but the actual number of concurrent backups is no greater than the number of TAPEx DD statements in this step's JCL. If MAXTASKS=2 or more, messages for each backup are directed to the SYSPRINx DD statement corresponding to the TAPEx DD statement associated with the backup (see “TAPEx DD Statement” in Section 10.3).

Default: MAXTASKS=1 unless the ATTACH operand is specified.

RTC=

Use READ TRACK CCWs to read DASD data tracks. RTC=YES also causes:

Up to 1 cylinder of DASD data is read at a time.

FDRbuffers are moved above the 16MB line (about 2MB per concurrent backup), allowing more concurrent backups to be run in one step.

The elapsed time of FDRbackups when the backup data set is itself on DASD is significantly improved.

The elapsed time of FDRbackups on fast tapes and DASD, especially on FICON channels, may be improved

Use other techniques to read DASD data tracks.

Default: RTC=NO, unless RTC=YES is specified as a global option.

SELTERR=

Specifies what happens at step termination if DSF finds that a SELECT or EXCLUDE statement was never referenced (no data set on any input DASD volume was selected by the statement):

A condition code or abend is not to be issued at step termination. You might use SELTERR=NO when you expect some unmatched SELECT or EXCLUDE statements, perhaps because some data sets may not exist.

A condition code or abend is issued at step termination to call attention to a possible control statement error.

Default: SELTERR=YES unless overridden in the Set-FDR-Global-Options.

SNAP=

Used only when you are licensed for FDRINSTANT and only if you have previously used program FDRSNAP to create an instant point-in-time image of a volume in an EMC Symmetrix with the TimeFinder/Clone or TimeFinder/Snap features. It causes FDRto backup the point-in-time image instead of the online DASD volume. See FDRINSTANT-for-EMC-TimeFinder for EMC TimeFinder.

ZEDC=

Invoke zEDC (zEnterprise Data Compression) for both compression and decompression if the CPU and the operating system support it.

Use the zEDC hardware compression/decompression feature:

Do not use the zEDC hardware compression/decompression feature.

Default: NO.