Options Installation Exit Routine (ADRUIXIT)

The options installation exits routine can control certain DFSMSdss tasks or change some defaults or specified options. It is given control when DFSMSdss is invoked and also before the processing of each task. During initial entry, it can specify where the I/O and application interface buffers are to reside, change the default SERIAL mode to PARALLEL, and request that RACF class checking be bypassed. It can specify to fall back to the EXCP support for DUMP output, RESTORE input, and COPYDUMP. When entered for each task, the routine can change the options, defaults, or values.

During a DEFRAG or CONSOLIDATE, an extent of a protected data set is relocated, and the old extent is cleared (written over with zeros) for security. This adds time to the DEFRAG and CONSOLIDATE process. You can prevent the clearing of the old extent with the options installation exits. If your exit sets the UFOERASE bit to zero, it prevents clearing an old extent.

The exit routine can force the DUMP function to end if a write error occurs on any of the output copies. This is done by setting bit UFOIACPY on. The default is to continue to produce as many error-free output copies as possible.

When you are doing full volume or tracks COPY or RESTORE and the VTOC index on the target volume must be rebuilt, the exit can control whether or not ICKDSF is invoked to rebuild the VTOC index. Invoking ICKDSF from DFSMSdss can cause deadlock problems. If this happens, the exit can set UFOBLDIX to zero, and the VTOC index can be rebuilt manually by calling ICKDSF.

DFSMSdss uses the system authorization facility (SAF) interface to ensure that RACF at the 1.8.1 level or above is installed and active. If you are using a RACF-equivalent program that does not set the same level of information that DFSMSdss checks for, you can notify DFSMSdss that SAF with a RACF-equivalent program is installed by setting bit UFSAFOK on.

The exit routine supplied with DFSMSdss does not change any defaults, options, or values.

There are three categories of keywords that the installation enqueue exit routine can change:

Simple keywords with no subparameters: The exit can set or reset the option. For example, the exit can force use of the CATALOG option or force the DELETE option not to be used.
This category includes the following commands: ALLEXCP, CATALOG, CICSVRBACKUP, COMPRESS, CONCURRENT, COPYVOLID, DELETE, DUMPCONDITIONING, DYNALLOC, FCNOCOPY, FCWITHDRAW, FORCE, NULLMGMTCLAS, NULLSTORCLAS, PURGE, REPLACE, REPLACEUNCONDITIONAL, RACFLOG, RESET, SERIAL, PARALLEL, SHARE, SPHERE, UNCATALOG, VALIDATE, and WRITECHECK.

Note: Although the exit can override NULLSTORCLAS and NULLMGMTCLAS, it cannot affect the STORCLAS or MGMTCLAS keywords. That is, it cannot change NULLSTORCLAS to STORCLAS(x).
Keywords with one or more subparameters having a limited number of values: The exit can control the values of the subparameters. For example, the exit can force OPTIMIZE(4) to be used on all full volume dumps.
This category includes the following commands: DEBUG(FRMSG(MINIMAL|SUMMARIZED|DETAILED)), FASTREPLICATION(REQUIRED|PREFERRED|NONE), FORCECP(nnn), FRAGMENTATIONINDEX(n), MINSECQTY(n), MINTRACKSUNUSED(n), OPTIMIZE(n), PROCESS(SYS1), PROCESS(UNDEF), READIOPACING(n), SELECTMULTI(ALL|ANY|FIRST), TOLERATE(ENQFAILURE), TGTALLOC(x), VOLCOUNT(*|N(nn)|SRC|ANY), and WAIT(n,m).
Keywords with a subparameter having many possible values, including one specific value: The exit can either override the keyword entirely or use the one specific value. For example, the exit can force no reblocking to occur by overriding the REBLOCK keyword, or it can cause all eligible data sets to be reblocked by forcing REBLOCK(*). The exit cannot specify a data set name list with the REBLOCK keyword.
This category includes the following commands: ALLDATA(*), REBLOCK(*), and RECATALOG(*).

Note: The exit cannot set conflicting options. For example, setting CONCURRENT and DELETE is an error.

You can use this exit to stop DFSMSdss functions. Then you can force the use of your own options and controls.