FDR DUMP Statement

DUMP statement syntax

DUMP statement

The DUMP statement requests a full-volume dump (backup) operation. It is optional (See EXEC Statement on specifying operands via the PARM= operand), but if present must be the first and only 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/TAPEx 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.

DUMP statement operands

TYPE=FDR

A full volume dump 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 SPLITting a BCV in an EMC Symmetrix DASD subsystem with the TimeFinder/Mirror feature. It causes FDR to backup the point-in-time image instead of the online DASD. For more information, see Working-with-FDRINSTANT-for-Dell-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: 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 FDR software compression. Values for COMPRESS= are:

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

Only the backups on TAPEx DD statements are compressed.

Only the backups on TAPExx DD statements are compressed.

See Memory Requirements for the additional storage required by COMPRESS=.

Default: Backups are not compressed. For FDR encryption, COMPRESS= is the default.

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 . For more information, see 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.FDR.BACKUP

DATA=

All allocated tracks of all 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. This makes the dump run faster on almost all volumes.

Default: ALL

DSNENQ=

Specifies whether a SYSDSN enqueue should be issued for each of the data sets on a volume during the backup of the volume. 

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: NONE

EMSG=

Used when the FDR e-mail notification facility has been invoked by including an FDREMAIL DD statement in the FDR execution JCL.

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

Default: E-mail notifications are sent only for FDR failures.

ENQ=

Specifies whether a SYSVTOC enqueue should be issued on the VTOC of each DASD volume while it is being backed up. 

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: OFF, except that in FDRINSTANT it defaults to RESERVE for a SNAP statement in program FDRSNAP ( see Working-with-FDRINSTANT-for-SnapShot) or a FCOPY statement in program FDRFLASH ( see Working-with-FDRINSTANT-for-FlashCopy).

ENQERR=

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

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

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 FDRINSTANT programs to create an instant point-in-time image of a volume in a DASD subsystem with the FlashCopy feature. FCOPY causes FDR to backup the point-in-time image instead of the online DASD volume. See Working-with-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 impacts 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) data sets are backed up. HFS=QUIESCE implies DSNENQ=USE so it attempts to get a SYSDSN enqueue on the HFS 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. For more information, see Hierarchical File System (HFS).

If you are executing FDRINSTANT (where the main control statement is SNAP, FCOPY, PSPLIT, or SPLIT instead of DUMP), ZFS=QUIESCE performs the same type of quiesce on zFS files if it cannot get the SYSDSN enqueue on them.

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

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 are 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: 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.

FDR buffers 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 FDR backups when the backup data set is itself on DASD is significantly improved.

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

Use other techniques to read DASD data tracks.

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

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 an EMC Symmetrix with the TimeFinder/Clone or TimeFinder/Snap features. It causes FDR to backup the point-in-time image instead of the online DASD. See Working-with-FDRINSTANT-for-Dell-EMC-TimeFinder for Dell 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.