FABPMAIN EXEC statement

To run the HD Pointer Checker processor (FABPMAIN), supply an EXEC statement with PARM parameters.

Subsections:

EXEC statement format
Additional requirements for processing IMS catalog databases
Additional requirements for running HD Pointer Checker when the IMS management of ACBs is enabled

EXEC statement format

You can run the HD Pointer Checker processor (FABPMAIN) with two methods.

The first method is to run the FABPMAIN program in the IMS region controller program (DFSRRC00). To use this method, specify PGM=DFSRRC00 in the EXEC statement and specify parameters for the IMS region controller program as follows:

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

The other method is to run the FABPMAIN program in the FABPPC00 program. In this method, the FABPMAIN program runs under the IMS region controller program (DFSRRC00) internally. To use this method, specify PGM=FABPPC00 in the EXEC statement and specify parameters for the IMS region controller program as follows:

//        EXEC PGM=FABPPC00,
//            PARM=(region,FABPMAIN,psbname,,,,,,,,,,,dbrc,N,   
//            ,,,,,,,,,imsplex,,'DBRCGRP=dbrcgrp')

Requirement: To use the Integrated DB Sensor function or to monitor the latest VSAM statistics of IMS online full-function databases with the Space Monitor process that is called within an HD Pointer Checker job, you must run the FABPMAIN program in the FABPPC00 program.

With both methods, the number of commas after psbname is 11. The PARM parameter has the same format as that used in the DLIBATCH or the DBBBATCH procedure. For information about the format, see IMS System Definition.

The following subparameters can be specified for PARM:

region

Required parameter that specifies an IMS region type. The possible values are ULU, DLI, or DBB.

ULU: Runs HD Pointer Checker as a utility batch program region (ULU region) by using the DBD library.
DLI: Runs an offline DL/I batch processing program region (DLI region) by using the PSB and DBD libraries.
DBB: Runs an offline DL/I batch processing program region (DBB region) by using the ACB library.

Requirement: To use the Integrated DB Sensor function when the IMS management of ACBs is not enabled, specify ULU or DLI.

psbname

Specifies the PSB name 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. The PSB, in which less than 2,500 of database data sets are referred to, can be used in the HD Pointer Checker run.

It is required if DLI or DBB is specified for the region parameter. It is not required if ULU is specified for the region parameter.

dbrc

Specifies whether the Database Recovery Control facility is to be used. The possible values are Y or N.

Y: Uses the Database Recovery Control facility
N: Does not use the Database Recovery Control facility

When HD Pointer Checker runs in the following condition, you must specify Y:

HISTORY=Y is specified in the PROCCTL data set.
The database to process is a HALDB.
If you specify an image copy data set as input and you omit the image copy data set DD statement. HD Pointer Checker refers to the RECON data set for the image copy data set name and allocates the data set dynamically.

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 requirements for processing IMS catalog databases

When you process an IMS catalog database, the following additional requirements must be met:

If the IMS catalog database to be processed is registered in the RECON data sets, and an alias is not defined for that database, you can run HD Pointer Checker for that IMS catalog database in the same manner as it is run for HALDBs.
When you run HD Pointer Checker against an IMS catalog database in the DLI or DBB region, you must specify one of the IMS catalog PSBs (DFSCP000, DFSCP001, or DFSCP002), which are provided by IMS, for the psbname parameter.
When you run HD Pointer Checker for an IMS catalog database that is not registered in the RECON data set or that has an alias defined, specify the DFSDF parameter for the PARM parameter. The DFSDF parameter must be enclosed in single quotes. The value must be the 3-character suffix (xxx) of the DFSDFxxx member (in IMS.PROCLIB data set) that contains the names of unregistered IMS catalog databases. For example:
```
//         EXEC PGM=DFSRRC00,
//              PARM=(DLI,FABPMAIN,psbname,,,,,,,,,,,dbrc,N,
//            ,,,,,,,,,,,'DFSDF=xxx')
```
When you run HD Pointer Checker in a ULU region with DBRC=N for an IMS catalog database that is not registered in the RECON data set, specify DFSCD000 for the DBD name for the IMS catalog database. For example:
```
//         EXEC PGM=DFSRRC00,
//               PARM=(ULU,FABPMAIN,DFSCD000,,,,,,,,,,,N,N,
//             ,,,,,,,,,,,'DFSDF=xxx')
```
If you define an alias name for the IMS catalog database, specify the alias name instead of DFSCD000.

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.

Additional requirements for running HD Pointer Checker when the IMS management of ACBs is enabled

To run HD Pointer Checker when the IMS management of ACBs is enabled, specify the EXEC statement in any of the following formats:

ULU region

//        EXEC PGM=DFSRRC00,
//             PARM=(ULU,FABPMAIN,dbdname,,,,,,,,,,,dbrc,N,
//             ,,,,,,,,,,,'DFSDF=xxx')

//        EXEC PGM=FABPPC00,
//             PARM=(ULU,FABPMAIN,dbdname,,,,,,,,,,,dbrc,N,
//             ,,,,,,,,,,,'DFSDF=xxx')

DLI or DBB region

//        EXEC PGM=DFSRRC00,
//             PARM=(region,FABPMAIN,psbname,,,,,,,,,,,dbrc,N,
//             ,,,,,,,,,,,'DFSDF=xxx')

//        EXEC PGM=FABPPC00,
//             PARM=(region,FABPMAIN,psbname,,,,,,,,,,,dbrc,N,
//             ,,,,,,,,,,,'DFSDF=xxx')

Requirements:

To run HD Pointer Checker in the ULU region, you must specify a DBD name on the PARM parameter of the EXEC statement. The DBD name can be of any DBD name that is specified on DATABASE statements of the PROCCTL DD statement.
If you use an alias name for the IMS catalog, you must specify EXEC PGM=DFSRRC00 and run HD Pointer Checker in the DBB region.

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