General Options

Panel A.I.4.2 – Set FDR Global General Options

These options are used by many FDR programs. They can be displayed or changed on the following panel.

Set FDR Global General Options – Panel A.I.4.2

ICFCORE

In order to match ICF VSAM component names to cluster names, the FDR data set dump programs must build a table of such names. See the ICFCORE= operand in various sections for details. There is rarely a reason to override the default, but if you do get errors relating to ICFCORE, you can increase it on individual backups with the ICFCORE= operand, or increase it globally here.

FDRCC

If an error occurs during execution of FDR, FDRDSF, FDRCOPY, or FDRTCOPY that is not severe enough to cause immediate termination, these programs complete their processing and then issue an abend or set a return code to call attention to the error. The default “ABEND” causes an abend U0888. If you wish a return code instead of the abend, set any desired value from 8 to 255.

Default: ABEND

FDRSTMT

If “NO” and program FDR is executed with no control statements in SYSIN and no PARM= on the EXEC statement, it defaults to a DUMP (backup). Changing this option to “YES” causes FDR to fail if no statement or PARM was specified, requiring that the operation to be performed be positively specified.

Default: NO

LINECNT

Specifies the maximum number of lines to be printed on any report page. The number may be from 10 to 99 inclusive.

Default: 58

SELTERR

FDR programs produce a diagnostic message if a SELECT or EXCLUDE or related control statement, specifying a data set name or filter, does not actually match any of the data sets processed in the step. If set to “YES”, FDR considers this a possible user error and causes a return code or U0888 abend at step end to draw attention to it. If you do not want to consider this an error condition, change SELTERR to “NO” (the diagnostic message is still printed but it is not considered an error). This option can be overridden at execution time.

Default: YES

ALCRSTIN

If “YES”, enables support for the FDR interface to several allocation control software products. The interface invokes your DASD allocation software product to get target volume serials when FDR is allocating a non-VSAM data set. The interface is supported by several DASD allocation products:

• AMI Storage Allocation function DASDPOOL
• ACC from DTS Software.
• BrightStor CA Allocate from Broadcom, formerly called SAMS-ALLOCATE.

This support requires an interface module, PLDRSTIN, which is provided by each of the vendors of DASD allocation products listed above. This module must be located in some link list (LNKLST) library so that it is available to FDR whenever data sets are restored. If this option is set to “YES” and PLDRSTIN is available, FDR calls PLDRSTIN to obtain target volumes for non-VSAM data sets.

Default: NO

If you have any questions or problems installing the PLDRSTIN module from your allocation product vendor, please check first with that vendor for instructions and additional information. If you cannot resolve the problem, call BMC Support for assistance.

RESTLRDT

RESTCRDT

RESTEXDT

For RESTLRDT, RESTCRDT, and RESTEXDT, during a data set restore, copy, or move, the three date fields in the Format 1 DSCB of the data set (last reference date, creation date, and expiration date) are normally set based on rules described in What is Updated in the DSCB in Data Set Restore Rules. Sometimes the date fields are copied from the backup or input data set; sometimes they are changed to today’s date or zero. For each of those three dates, a “NO” value in the associated option caused those rules to be used.

If you change any or all of these options to “YES”, the associated date field is always copied from the value on the backup tape or the value from the input data set.

For RESTEXDT specify 'R' to cause the expiration date to never be restored from the backup, regardless of the current value of the expiration date.

Default: NO (for all the above three operands)

HFSQUIESCE

If “YES”, during all types of backups FDR attempts to quiesce access to all Hierarchical File System (HFS) data sets, used by UNIX System Services (USS)). This is required to get a consistent backup of the HFS data if updates may be occurring during the backup. However, this option is honored only if DSNENQ=USE or HAVE is specified on the DUMP statement at run time.

Default: NO

WTOWAITVOL

Specifies whether to issue the FDRW28 WTOR message “RESTORE WAITING ON TAPE VOLUME”.

Default: NO

ZEDC

Specifies whether to use zEDC hardware compression for backups.

Default: NO

RTC

Specifies whether to use Read Track CCWs to read DASD blocks.

Default: YES.

ROUTECODE

Specifies the route codes to be used when issuing the following Write-To-Operator or Write-To-Operator-with-Reply messages: FDRW01, FDRW02, FDRW03, FDRW04, FDRW05, FDRW06, FDRW27, FDRW80, FDRW81, and FDRW90. The ROUTECODE value can be from 1 through 16 inclusive. Multiple route codes can be entered as ROUTECODE=(nn,…,nn).

Default: (2,11)

DESCRIPTCODE

Specifies the descriptor codes to be used when issuing the following Write-To-Operator or Write-To-Operator-with-Reply messages: FDRW01, FDRW02, FDRW03, FDRW04, FDRW05, FDRW06, FDRW27, FDRW80, FDRW81, and FDRW90. The DESCRIPTCODE value can be from 1 through 16 inclusive. Multiple descriptor codes can be entered if specified as DESCRIPTCODE=(nn,…,nn).

Default: X’4000’ (2)

The routing and descriptor codes are documented in the IBM manual Routing and Descriptor Codes and are used by z/OS to control on which consoles the messages appear, and how they are displayed.