DEFAULT (Control Defaults)

By making use of the ability of the DBIN1PR Macro to process user configuration options prior to normal SYSIN processing, the DBUTLTY DEFAULT function allows you to control a few defaults.
datacom
By making use of the ability of the DBIN1PR Macro to process user configuration options prior to normal SYSIN processing, the DBUTLTY DEFAULT function allows you to control a few defaults.
We recommend that you use the DBUTLTY DEFAULT function with caution. We recommend caution because when most users note a condition code of 0 (zero), they do not additionally view output. Therefore, other than expected results are not noticed. For that reason, it is simpler and of less potential confusion to all DBUTLTY users if the actual JCL streams are adjusted for site standards, instead of making use of the DEFAULT function.
DBIN1PR is a special process and does not follow the normal statement rules allowed by SYSIN. This includes placement of blanks and lack of the ability to have a continued statement. For more information about DBIN1PR, see Modifying DBSIDPR Parameters.
When to Use DEFAULT
Use the DEFAULT function when you want to control the allowed defaults.
How to Use DEFAULT
Use an alternate (additional) SYSIN with a DBUTLTY DEFAULT function to control certain defaults. Execute the DEFAULT function using the following command format:
►►─ DEFAULT ─┬─ INIT_IXX_BLKSIZE=
nnnn
─┬───────────────────────►◄ ├─ INIT_IXX_OPTION2=
value
┤ ├─ INIT_IXX_OLDEP=NO ─────┤ ├─ KBYTES=9999 ───────────┤ ├─ OPTIMIZE=YES ──────────┤ ├─ OPTION1=(I)────────────┤ ├─ SORT=n ────────────────┤ ├─ SORTDFLT=YES ──────────┤ ├─ SORTDD=SORTDD ─────────┤ ├─ SORTWK=9 ──────────────┤ └─ UNIT=XXXXXXXX ─────────┘
Command
  • DEFAULT
    Invokes the function to control certain defaults.
    Use no blank before DEFAULT when you specify it in columns 1-7. Follow DEFAULT with one blank (and use no continue lines).
Required Keywords
  • INIT_IXX_BLKSIZE=
    nnnn
    INIT_IXX_BLKSIZE=
    nnnn
    gives you the ability to specify a user default
    nnnn
    for the block size during an INIT function with AREA=IXX used to initialize an index area (IXX or multiple data set index).
  • INIT_IXX_OPTION2=
    value
    INIT_IXX_OPTON2=value Provides that for every INIT with AREA=IXX where OPTION2 is not specified, then the default is applied as OPTION2=
    value
    as provided with FORMAT2 or FORMAT1 as the variable.
  • INIT_IXX_OLDEP=NO
    INIT_IXX_OLDEP=NO gives you the ability to specify a user default for the Old Entry Point support for an index during an INIT function with AREA=IXX used to initialize an index area (IXX or multiple data set index). Only INIT_IXX_OLDEP=NO can be specified. The DBUTLTY default of YES is not valid for the DEFAULT function.
Optional Keywords
  • KBYTES=9999
    KBYTES=9999 is a replacement to KBYTES=4 tracks (default) during the LOAD function. The value 9999 is an exact value and is only allowed for this DEFAULT. The 9999 is not the actual number used as it is rounded down to 2 cylinders of data during the LOAD and RETIX functions.
  • OPTIMIZE=YES
    OPTIMIZE=YES is a replacement to OPTIMIZE=NO (default). Use this option carefully.
  • OPTION1=(I)
    OPTION1=(I) is a replacement to the standard of no default. It is applied during the LOAD, RECOVERY, REPLACE, RETIX, and SPLIT functions. The value is not edited for content.
  • SORT=
    n
    SORT=
    n
    is the replacement to the default of no SORT. It is applied during the LOAD and RETIX functions. The use of a sort package is always recommended. It allows the optimization of many parts of LOAD or RETIX for efficiency. A value of SORT=99999 covers the small or empty loads that might not have the SORT= value set.
  • SORTDFLT=YES
    SORTDFLT=YES is a replacement to SORTDFLT=NO (default). This value is applied during the LOAD function. Due to requirements and certain consequences, review the standard documentation for a description of SORTDFLT=YES.
  • SORTDD=SORTDD
    SORTDD=SORTDD is a replacement to no default. It is applied during the LOAD, RECOVERY, REPLACE, RETIX, and SPLIT functions. The value is not edited for content.
  • SORTWK=9
    SORTWK=9 is a replacement to SORTWK=3 (default). It is applied during the LOAD, RECOVERY, REPLACE, RETIX, and SPLIT functions. The value can be 1 through 99.
  • UNIT=XXXXXXXX
    UNIT=XXXXXXXX is the replacement to UNIT=SYSDA. It is applied during the LOAD, RECOVERY, REPLACE, RETIX, and SPLIT functions. The value can be 1 through 8 bytes.
Example
In the case of an INIT_IXX_BLKSIZE=
nnnn
, the INIT of an index area (INIT AREA=IXX) allows an optional keyword of BLKSIZE= that can be specified as numbers from 4096 through 8192. The DBUTLTY default is 4096 or less, optimized for the device type containing the data set. If you want to replace the default with your own default of, for example, 5555, you could use an additional SYSIN with the following statement:
DEFAULT INIT_IXX_BLKSIZE=5555
For every DBUTLTY execution using this additional SYSIN, if an INIT is done with an AREA=IXX that does not have BLKSIZE= specified, it is given the user default of BLKSIZE=5555.
Consider the following:
  • The DEFAULT function allows you to override this default. Therefore, if you provided a statement INIT AREA=IXX,BLKSIZE=8182, for that one INIT, the index would be initialized with a block size of 8192.
  • An individual function has no path to requesting the normal default.
  • The additional SYSIN can be overridden for any step by having a JOB/STEPLIB pointing to a different DBIN1PR module.
  • If the DBIN1PR module indicates a data set, the additional SYSIN can be overridden for any step by having a DD statement pointing to a different input.
  • All DBIN1PR input is echoed to the console without an option, for example: DB10096I - DBIN1PR PROCESSED - DEFAULT INIT_IXX_BLKSIZE=5555.
  • The use of a default does not force an error.
Sample Report
The following example is a sample report page. For an example report header, see Sample Report Headers.
INIT AREA=IXX,DBID=997 FUNCTION=INIT AREA=IXX *****- NOTE -***** BLKSIZE=05555 DB10028I - DBIN1PR DEFAULT APPLIED DBID=00997
This page of the report shows that, to make the DEFAULT more visible in the report, a note and message are displayed to indicate that a DEFAULT has been applied.