DEDB Reload SYSIN DD data set control statements

This topic describes the control statements used with DEDB Reload.

Subsection:

Syntax of the control statement

The FABCUR3 keywords and their associated parameter values may be coded in free format (columns 1 - 72) provided certain syntactical rules are followed:

  1. All keyword parameter sets can be contained in one or more control statements.
  2. All keywords must be separated from their associated parameter values by an equal sign. The equal sign must not be preceded by blanks, but may be followed by one or more blanks.
  3. Parameter values must be separated from the next keyword by one or more blanks, a comma, or a comma followed by one or more blanks.
  4. Parentheses are always required for keyword parameters that use them.

Control statement keywords

The FABCUR3 control statement contains the following keywords:

[DBDNAME=dbdname]
[IOVFBUF=nn]
[STARTAREA=zzz]
[TBLENTRY=mmmm]
[EXITRTN=(exit-routine,function)] 
[IMGCPY=NO|YES|DUAL]
[ICHASH=(NO|YES,SSP)]
[ICCOMPRESS=(NO|YES,routine)]
[KEYSEQERROR={NOCHECK|ABEND|BYPASS}]
[KEYCHGCHECK={YES|NO}]
[SDEPRELOCATE={YES|NO}]
[IMSCATHLQ={*NO|bsdshlq}]
[IMSCATACB_INPUT={CURRENT|PENDING}]
[RAPERROR=NOCHECK|ABEND]

DBDNAME control statement

This optional statement specifies the DBD name of the DEDB for the unloaded segment records file. This statement is required if ACBLIB DD or IMSCATHLQ=bsdshlq is specified instead of DURDBDFN DD to obtain the DEDB definition.

If DURDBDFN DD is specified, this statement is not necessary.

When DBDNAME= is specified:
  • If both DURDBDFN DD and ACBLIB DD statements are specified, or both DURDBDFN DD statement and the IMSCATHLQ=bsdshlq keyword are specified, ACBLIB DD or the IMSCATHLQ=bsdshlq keyword takes precedence over DURDBDFN DD.
  • If the ACB library or the IMS directory is used, the ACB library or the IMS directory is validated to make sure that the correct ACB library or IMS directory is provided.
dbdname
Specifies the name of the DBD that is to be used.

IOVFBUF control statement

Optional statement to specify the number of IOVF buffers to allocate for direct processing of the IOVF work data set. This should be equal to the maximum number of IOVF CIs used by any UOW being reloaded. The maximum value specified should not exceed approximately 99. Too small a value has the potential to cause excessive flushing and rereading of IOVF CIs.

The default value is calculated as follows:

28K x 5 / size of the largest CI of areas to be processed

If the calculated value is greater than 99, then 99 is used.

For example, the number 5 is used for a 28 K CI; the number 99 is used for a 512-byte CI.

STARTAREA control statement

Optional statement to specify which area to start processing (that is, data for areas less than this value are bypassed). This statement should be used only in restart situations.

Example: The input file contains segment data for areas 3 and 6. Area 3 was successfully loaded, but during the loading of area 6 a physical I/O error occurred. The reload job can be restarted after a new area 6 is defined on a different pack by specifying STARTAREA=6 (that is, data for area 3 is bypassed).

The area number is 1 - 2048.

TBLENTRY control statement

Optional statement to increase the number of:entries in the internal segment parentage table. This table is only used when the insert limit count (ILC) feature of FABCUR1 is used.

The default value is 200 entries per RAP CI. The maximum value is 9999 and the minimum value is 1.

The ILC value is specified on the FABCUR1 LOADCTL control statement. If a single RAP has more than 200 dependent-segment twin chains that exceed the ILC value, you must use this keyword. Just make mmm larger than the maximum number of long twin chains that can occur on one RAP.

EXITRTN control statement

This optional statement specifies the name of the user exit routine to be invoked, and the function to be performed by it.

For more information on the exit routine, see the topic "Exit routine option and its interface" in the IMS Fast Path Solution Pack: IMS High Performance Fast Path Utilities User's Guide.

The EXITLIB DD statement must be provided when this control statement is specified.
exit-routine
Specifies the name of the user exit routine to be invoked.
function
Specifies the function to be performed by the exit routine.
EXP
Expansion
CMP
Compression
EXC
Expansion and then compression; invoke the exit routine twice

IMGCPY control statement

Optional statement to specify whether image copies of the areas being reloaded are to be created.

To create an image copy, IMS High Performance Image Copy (included in IMS Fast Path Solution Pack) must be installed, and its load module library data set must be concatenated to the JOBLIB DD or the STEPLIB DD statement.

NO
No image copies are created. This is the default.
YES
A single image copy of each area being reloaded is created.
DUAL
Dual image copies of each area being reloaded are created.

ICHASH control statement

Optional statement to specify whether the HASH Check option of DEDB Pointer Checker is invoked while the image copy is being created.

NO
HASH check is not performed. This is the default.
YES
HASH check is performed. This subparameter is effective only when IMGCPY=YES or when IMGCPY=DUAL is specified.

Additional DD statements described in Function-unique DD statements for the HASH Check option are required for this option.

SSP
Subset pointer check is performed during the HASH check. This subparameter is effective only when ICHASH=(YES,) is specified.

ICCOMPRESS control statement

Optional statement to specify whether the ICE Image Copy function compresses the output image copy data.

NO
The compression routine is not invoked. This is the default.
YES
The compression routine has been invoked. This subparameter is effective only when IMGCPY=YES or when IMGCPY=DUAL is specified.
routine
The compression routine. The ICE provides two compression exit routines: FABJCMP1 and FABJCMP2. Specify one of these compression routines to be called by the ICE Image Copy function. If no compression routine is specified, FABJCMP1 is used as the default. This subparameter is effective only when ICCOMPRESS=(YES,) is specified.
Recommendation: To check that the area reloaded has no error, specify the creation of image copies and run of HASH check when loading an area. If you do this, you do not need to run additional jobs: Image Copy Utility and the DEDB Pointer Checker.

KEYSEQERROR control statement

This optional statement specifies whether FABCUR3 checks the key sequence, and what to do when a sequence error in a key sequence field is detected.

NOCHECK
Specifies that FABCUR3 ignores the key sequence check function. This is the default.
ABEND
Specifies that FABCUR3 ends abnormally, and an error message is issued.
BYPASS
Specifies that any segments that have a sequence error in a key sequence field, as well as any children, are ignored in the reloading process.

KEYCHGCHECK control statement

This optional statement determines whether FABCUR3 should check alternation of key sequence field after returning from a user exit routine.

YES
Specifies that FABCUR3 checks altered key sequence field. This is the default.
NO
Specifies that FABCUR3 does not check altered key sequence field.

SDEPRELOCATE control statement

This optional statement determines whether FABCUR3 should relocate areas of the SDEP segments. If SDEP segments are unloaded with SDEP=PHYSICAL accompanied by a DBD change, this optional statement is not necessary because the reload process (FABCUR3) automatically sets SDEPRELOCATE=YES. SDEPRELOCATE=YES can be specified only when the SDEP segments are unloaded with the SDEP=PHYSICAL and AIR=YES options.

For how to process SDEP segments, see the topic "Determining how to process SDEP segments" in the IMS Fast Path Solution Pack: IMS High Performance Fast Path Utilities User's Guide.

YES
Specifies that FABCUR3 relocates SDEP pointers.
NO
Specifies that FABCUR3 does not relocate SDEP pointers. This is the default.

IMSCATHLQ control statement

This optional statement specifies to retrieve ACBs from the IMS directory (an extension of the IMS catalog) instead of from the ACB library.

bsdshlq
Specifies to read ACBs from the IMS directory by using the IMS Tools Catalog Interface. bsdshlq specifies the high-level qualifier of the bootstrap data set of the IMS directory. IMSCATHLQ=bsdshlq is effective when the IMS catalog and the IMS management of ACBs are enabled.

If a TYPE=CATDSHLQ statement was used to create a DFSMDA member in your MDA library, you must specify the SYSDSHLQ parameter used in that DFSMDA member for the IMSCATHLQ keyword parameter.

*NO
Specifies to read ACBs from the ACB library. This is the default.

IMSCATACB_INPUT control statement

This optional statement specifies whether to retrieve currently active ACB definitions or pending ACB definitions from the IMS directory. IMSCATACB_INPUT keyword is effective only when the IMSCATHLQ=bsdshlq option is specified.

CURRENT
Specifies that currently active ACB members are retrieved from the IMS directory data sets. This is the default.
PENDING
Specifies that pending ACB members are retrieved from the staging data set.

RAPERROR control statement

This optional statement specifies whether FABCUR3 checks the validity of RAP data in the prefix part of the unloaded segment record by using the result of the randomizer call.
NOCHECK
Specifies that FABCUR3 does not check the validity of the RAP data in the prefix part of the unloaded segment record by using a randomizer. This is the default.
ABEND
Specifies that FABCUR3 checks the validity of the RAP data in the prefix part of the unloaded segment record by using a randomizer. FABCUR3 ends abnormally with an error message if it finds an error.

The DBDNAME control statement must be specified to enable RAPERROR=ABEND. Also, either the ACBLIB DD statement or the IMSCATHLQ=bsdshlq control statement must be specified.