FABTROOT JCL

The following table (Table 1) summarizes the DD statements that are appropriate for all FABTROOT runs. The subsequent table (Table 2) summarizes the extra DD statements that you need if you run FABTROOT under IMS.

EXEC

If you are running this program as a standard MVS™ batch program, code as follows:

//     EXEC PGM=FABTROOT,PARM=NOIMS

If you are running this program as an IMS batch program, this statement must be in the following form:

//        EXEC PGM=DFSRRC00,
//            PARM=(DLI,FABTROOT,psbname,,,,,,,,,,,dbrc,N,   
//            ,,,,,,,,,imsplex,,'DBRCGRP=dbrcgrp')

To process a HALDB, you must run the program as an IMS batch program.

The PARM parameter has the same format as that used in the DLIBATCH procedure. For information about the DLIBATCH procedure, see IMS System Definition.

The following subparameters can be specified for PARM:

psbname

Specifies the name of the PSB that contains the PCB of the processing databases. The PSB name must be defined as a PSB with LANG=ASSEM, LANG=COBOL, or LANG=PL/I. It must refer directly or indirectly to all input databases.

dbrc

Specifies whether the Database Recovery Control facility is used.

Y

Use the Database Recovery Control facility

N

Do not use the Database Recovery Control facility

Requirement: To process a HALDB database, dbrc must be Y.

Tip: If DBRC=Y is specified and another job that has DBRC authorization exists, the DBRC authorization might be denied, and a DFS047A message might be issued in the HD Tuning Aid job. To avoid this problem, specify the name of the PSB that contains the PROCOPT=G PCB of the database. If the DBRC authorization problem occurs with PROCOPT=G PCB, rerun HD Tuning Aid after the job that has the DBRC authorization ends.

imsplex

Specifies the IMSplex name that is used in the IMS DBRC SCI registration. If the IMSplex name is set in the RECON data sets, you must supply the IMSplex name by either of the following methods:

• Specify the IMSplex name on the EXEC statement.
• Specify the library that contains the DBRC SCI Registration exit routine in the STEPLIB DD statement.

DBRCGRP=dbrcgrp

Specifies the DBRC group ID that is used in the IMS DBRC SCI registration. If the DBRC group ID is set in the RECON data sets, you must supply the DBRC group ID by either of the following methods:

• Specify the DBRC group ID on the EXEC statement.
• Specify the library that contains the DBRC SCI Registration exit routine in the STEPLIB DD statement.

Additional requirement when the IMS management of ACBs is enabled

When the IMS management of ACBs is enabled, run HD Tuning Aid under the IMS batch region controller and specify the DFSDF= parameter for the PARM= parameter. The value must be the 3-character suffix (xxx) of the DFSDFxxx member (in IMS.PROCLIB data set) that enables IMS-managed ACBs.

For example:

//        EXEC PGM=DFSRRC00,
//             PARM='DLI,FABTROOT,psbname,,,,,,,,,,,dbrc,N,  
//             ,,,,,,,,,,,,DFSDF=xxx'  

If you specify the library that contains the Catalog Definition exit routine (DFS3CDX0) in the STEPLIB DD statement, you do not need to specify the DFSDF=xxx parameter.

STEPLIB DD

When the utility runs as a standard MVS batch program, this statement defines the IMS HP Pointer Checker production library (required).

When the utility runs as an IMS batch program, this statement defines the following input data sets:

• IMS HP Pointer Checker production library (required)
• IMS RESLIB (required)
• The library that contains the DFSMDA members for dynamic allocation (optional)
• The library that contains the partition selection exit routine if a partition selection exit is defined to your input PHDAM or PHIDAM database in the RECON data sets
• IMS Tools Base library (SGLXLOAD) of IMS Tools Base 1.6 or later if the IMS management of ACBs is enabled
• The library that contains the Catalog Definition exit routine (optional)

IMS DD

This required input data set is a library (partitioned data set) that contains your PSB and DBD load modules. It must contain all DBDs that are referenced (either directly or indirectly) by your PSB. If your PSB and DBDs are not in the same library, all appropriate libraries must be concatenated.

If the IMS management of ACBs is enabled, you do not need to specify this DD statement. If the HD Tuning Aid utility finds this DD statement, the utility ignores the statement.

IMS2 DD

This required input data set is a library (partitioned data set) containing the randomizing modules. If a partition selection exit name is specified in CTL DD statements, IMS2 data set must contain the partition selection exit module defined in CTL.

KEYSIN DD

This required input data set contains root segment keys that are written by the SCAN process of HD Pointer Checker.

CTL DD

This optional input data set contains the values of DBD parameters and or partition selections that you want to override. This optional input data set contains your overrides of certain DBD parameters. Use this data set whenever you want to perform iterative analysis of randomizer performance. It describes the databases that are processed. It also contains optional user’s requests for printing the reports.

PR8 DD

This required output data set contains the reports produced by module FABTROOT. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

RAPSIN DD

This required output data set contains HDAM block/RAP assignments for all keys that are in the KEYSIN data set. BLKSIZE, if coded, must be a multiple of 42.

SYSUDUMP DD

This statement defines output from a system abend dump routine. It is used only when a dump is required. Although optional, it is highly recommended that you include this data set.

DFSRESLB DD

This statement defines the data set that contains the IMS load modules. This statement is applicable only if you are running this program as an IMS batch program, in which case it is required.

DFSVSAMP DD

This input data set contains the buffer information required by the DL/I buffer handler. This statement is applicable only if you are running this program as an IMS batch program, in which case it is required.

RECONx DD

These optional data sets are the RECON data set. They are required when the input DBDs are HALDB and when RECON data sets are not allocated dynamically.

PROCLIB DD

This statement defines the library that contains all IMS generated cataloged procedures and jobs. This statement is applicable only if you are running this program as an IMS batch program, in which case it is optional. If it is omitted, a warning message might be issued by IMS. You can ignore this warning message.

If you specify the DFSDF=xxx subparameter on the EXEC PARM parameter, you must specify the IMS PROCLIB data set that contains the DFSDFxxx member.

DFSHDBSC DD

This optional input DD statement points to the IMS catalog partition definition data set. When the IMS management of ACBs is enabled and an IMS catalog database is not registered in the RECON data set, you must specify the IMS catalog partition definition data set in which the IMS catalog database is defined. If you omit this DD statement, the DFSHDBSC data set is allocated dynamically by the DFSMDA member.

SYSPRINT DD

This output data set contains messages produced by IMS. Because the HD Tuning Aid’s IMS activity consists only of a GSCD call, no data is usually written to the SYSPRINT data set. This statement is applicable only if you are running this program as an IMS batch program, in which case it is required.

PR10 DD

This data set is optional and applicable only for HALDB. This optional output data set contains reports produced by FABTROOT. If BLKSIZE is coded on the DD statement, it must be a multiple of 133.

IEFRDER DD

This statement defines the primary system log data set. This statement is applicable only if you are running this program as an IMS batch program, in which case it is required and should be coded as DUMMY.