DD statements for Stand-Alone Prefix Resolution

DD statements define inputs and outputs for Stand-Alone Prefix Resolution jobs. You must supply the DD statements before you run a Stand-Alone Prefix Resolution job.

The following DD statements can be specified for Stand-Alone Prefix Resolution jobs.

Table 1. DD statements for Stand-Alone Prefix Resolution
DDNAME Use Format Need Description
JOBLIB/STEPLIB Input   Required

Points to the IMS™.SDFSRESL, which contains the IMS nucleus and required action modules, and to the IMS HP Prefix Resolution load library, which contains the FABYMAIN main load module.

One of these DD statements is required.

DFSURCDS Input   Required

Defines the control data set. It refers to the control data set that is generated by the IMS Database Prereorganization utility.

DFSURWF1 Input LRECL=900 Required

Defines the input data set. The data sets referred to by this DD statement are the output work data sets produced during a database initial load, reload, or scan process; those work data sets must be concatenated.

DCB parameters specified within this program are RECFM=VB, and LRECL=900. Do not specify BLKSIZE.

This DD statement affects the performance of IMS HP Prefix Resolution. For more information, see Performance and tuning.

DFSURWF3 Output LRECL=300 Optional

Defines the output work data set that Stand-Alone Prefix Resolution creates. It is supplied as input to Stand-Alone Prefix Update or the IMS Database Prefix Update utility. Its size is approximately the same as that of the input data set defined by the DFSURWF1 DD statement minus the size of DFSURIDX.

DCB parameters specified within this program are RECVM=VB and LRECL=300. Blocking is strongly recommended. If you omit to specify a BLKSIZE, the system will automatically calculate optimum block size for you.

This DD statement is required if you specify TYPE=LO, TYPE=IM, or TYPE=LM for the FABYIN control statement.

DFSURIDX Output LRECL=900 Optional

Defines the output work data set that is used if secondary indexes are defined in the databases that are being reorganized or loaded. This data set is used as input to the IMS HISAM Reorganization Unload utility (DFSURUL0) for creating, replacing, merging, or extracting secondary indexes (shared or unshared).

DCB parameters specified within this program are RECFM=VB and LRECL=900. Blocking is strongly recommended. If you omit to specify a BLKSIZE, the system will automatically calculate optimum block size for you.

This DD statement is required if you specify TYPE=LM, TYPE=IO, or TYPE=IM for the FABYIN control statement.

This DD statement affects the performance of IMS HP Prefix Resolution. For more information, see Performance and tuning.

FABYIN Input LRECL=80 Required

Defines the data set for control statements that specify options for IMS HP Prefix Resolution.

FABYPRNT Output LRECL=133 Required

Defines the data set for reports.

DCB parameters that are specified within this program are RECFM=FBA and LRECL=133.

FABYMSG Output LRECL=133 Required

Defines the data set for messages.

DCB parameters that are specified within this program are RECFM=FBA and LRECL=133.

FABYWF2 Input
Output
LRECL=900 Optional

Defines the intermediate data set that is used when you specify WF2OUT=YES in the FABYIN control statement data set. Its size is approximately the same as that of the input data set defined by the DFSURWF1 DD statement minus the size of DFSURIDX.

DCB parameters are RECVM=VB and LRECL=900. Blocking is strongly recommended. If you omit the BLKSIZE parameter, the system automatically calculates the optimum block size.

This DD statement is required if you specify WF2OUT=YES in the FABYIN control statement data set.

FABYW2R3 Output LRECL=900 Optional

Defines the output data set for the SKIPLCR3 process routine. This data set is used only for the purpose of debugging to dump the first 10000 skipped records when you specify SKIPLCR3=YES in the FABYIN control statement data set. Because this DD statement might degrade performance, specify this DD statement only when you are requested by IBM® Software Support.

DCB parameters are RECVM=VB and LRECL=900. Blocking is strongly recommended. If you omit the BLKSIZE parameter, the system automatically calculates the optimum block size.

FABYW3nn Output LRECL=300 Optional

Define the output work data sets that Stand-Alone Prefix Resolution creates when you specify SPLITWF3=YES and TYPE=LO, TYPE=IM, or TYPE=LM in the FABYIN control statement data set. These output data sets are used as input to Stand-Alone Prefix Update or the IMS Database Prefix Update utility.

nn corresponds to the order of the databases processed. For example, FABYW301 is for the first database to be updated, FABYW302 is for the second database to be updated, and so on. You can specify up to 99 FABYW3nn DD statements.

If the number of FABYW3nn DD statements is less than the number of the databases to be updated, the DFSURWF3 DD statement is used for the rest of the databases.

The data set sizes are approximately the same as that of the input data set defined by the DFSURWF1 DD statement minus the size of DFSURIDX.

DCB parameters are RECVM=VB and LRECL=300. Blocking is strongly recommended. If you omit the BLKSIZE parameter, the system automatically calculates the optimum block size.

INDXWKnn Input
Output
  Optional

Define intermediate storage data sets for the operating system sort/merge program.

If these DD statements are not provided, the sort program tries to dynamically allocate the needed work space.

For more information about specifying the number and size of intermediate storage data sets, see Performance and tuning.

LPLCWKnn
TWINWKnn
Input
Output
  Optional

Define intermediate storage data sets for the operating system sort/merge program. These data sets are used when WF2OUT=YES is not specified in the FABYIN control statement data set.

If these DD statements are not provided, the sort program tries to dynamically allocate the needed work space.

For more information about specifying the number and size of intermediate storage data sets, see Performance and tuning.

INDXMSG
LPLCMSG
TWINMSG
Output   Optional

Define the message data sets from the internally attached sort/merge programs.

If these DD statements are omitted, the messages from the sort/merge programs are written into the data set that is specified by the FABYMSG DD statement.

SORTLIB Input   Optional

Defines the library that contains the load modules for your operating system sort/merge modules.

SORTWKnn Input
Output
  Optional

Define intermediate storage data sets for the operating system sort/merge program when you specify WF2OUT=YES in the FABYIN control statement data set.

When WF2OUT=YES is specified, SORTWKnn data sets are used instead of LPLCWKnn data sets and TWINWKnn data sets. The required number and the size of the SORTWKnn data sets are approximately the same as those of LPLCWKnn data sets. Generally, the required number and the size of TWINWKnn data sets are smaller than those of LPLCWKnn data sets, so using LPLCWKnn number and size for SORTWKnn is sufficient.

If SORTWKnn DD statements are not provided, the sort program tries to dynamically allocate the needed work space.

SYSUDUMP Output LRECL=133 Optional

Defines the dump data set.

This DD statement can be specified as DUMMY.