DD statements for Concurrent Prefix Update

DD statements define inputs and outputs for Concurrent Prefix Update jobs. You must supply the DD statements before you run a Concurrent Prefix Update job.

The following DD statements can be specified for Concurrent Prefix Update jobs.

Table 1. DD statements for Concurrent Prefix Update
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. When you specify HPPRBH=NO: IMS.SDFSRESL must be concatenated behind the DD statement that contains the IMS HP Prefix Resolution load library. If JOBLIB or STEPLIB is not authorized by having unauthorized libraries that are concatenated to IMS.SDFSRESL, the DFSRESLB DD statement must be included.
`database`	Input Output		Optional	References the databases that were initially loaded, reorganized, or scanned. One or more DD statements must be present for each data set group of a database that has logical relationships. The ddname must match the ddname that is specified in the DBD. If you are using dynamic allocation, do not use the DD statement for the database data sets.
DFSCTL	Input	LRECL=80	Optional	Describes the data set that contains the OSAM sequential buffering (SB) control statements. By using OSAM SB, the IMS DL/I buffer handler can process OSAM data sets faster. For more information about control statement format and the OSAM sequential buffering, see IMS Database Administration and IMS System Definition. If HPPRBH=NO is specified but DFSCTL DD is not provided, a DFSCTL data set is dynamically allocated to activate OSAM SB. The allocated DFSCTL data set contains the following statement: `SBPARM ACTIV=COND` Recommendation: If you do not use the HPPR buffer handler (HPPRBH=NO), consider using OSAM SB.
DFSRESLB	Input		Optional	Points to an authorized library that contains the IMS SVC modules.
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.
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 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.
DFSVSAMP	Input	LRECL=80	Optional	Describes the data set that contains the buffer information required by the DL/I buffer handler. For more information about control statement format and the buffer pool structure, see IMS System Definition. This DD statement is required when HPPRBH=NO is specified. If HPPRBH=NO is specified but DFSVSAMP DD is not provided, a DFSVSAMP data set is dynamically allocated. The allocated DFSVSAMP data set contains the following statement: `IOBF=(32K,10)`
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.
FABYWF3O	Output		Optional	Defines the output work data set for WF3 records of HISAM databases. The Prefix Update function writes WF3 records of HISAM databases into the data set so that you can update the HISAM database by using the IMS Prefix Update utility. DCB parameters that are specified within this program are RECVM=VB and LRECL=300. Blocking is strongly recommended. If you do not specify a BLKSIZE, the system will automatically calculate the optimum block size for you. If the DFSURWF1 data set for Concurrent Prefix Update contains WF1 records for HISAM databases, this DD statement is required.
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.
IMS	Input		Required	Defines the library that contains the DBDs that describe the database that was loaded, reorganized, or both. The data set must reside on a direct-access device.
IMSDALIB	Input		Optional	Specifies the data sets that contain the dynamic allocation members for the databases and the RECON data sets. Allocation of the databases and the RECON data sets will be attempted in the following order: The DD statements coded in the JCL stream Dynamic allocation members in the IMSDALIB concatenation Dynamic allocation members in the JOBLIB or the STEPLIB concatenation
INDXWK`nn`	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.
LPLCWK`nn` TWINWK`nn`	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.
RECON`x`	Input Output		Optional	Defines the DBRC RECON data sets. If you are using dynamic allocation, do not use these DD names.
SORTLIB	Input		Optional	Defines the library that contains the load modules for your operating system sort/merge modules.
SORTWK`nn`	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, SORTWK`nn` data sets are used instead of LPLCWK`nn` data sets and TWINWK`nn` data sets. The required number and the size of the SORTWK`nn` data sets are approximately the same as those of LPLCWK`nn` data sets. Generally, the required number and the size of TWINWK`nn` data sets are smaller than those of LPLCWK`nn` data sets, so using LPLCWK`nn` number and size for SORTWK`nn` is sufficient. If SORTWK`nn` 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.