FABPATH0 and FABPATHZ procedures

IMS HP Pointer Checker provides two procedures (FABPATH0 and FABPATHZ) for building environmental setting for the HASH pointer checking.

When IMS Database Recovery Facility calls the HASH Check function, HD Pointer Checker starts the procedure, which initiates a subordinate address apace as a started task to build environmental setting for the HASH pointer checking.

If you specify a procedure name in IMS Database Recovery Facility master address space JCL by using the PCPROCNM() parameter, HD Pointer Checker starts that procedure. If you do not specify a procedure name in IMS Database Recovery Facility master address space JCL, HD Pointer Checker starts the following procedure:
  • If the job name that is assigned to a procedure that HD Pointer Checker starts is specified in IMS Database Recovery Facility master address space JCL by using either the PCPREF() or the PCJOBNM() parameter, HD Pointer Checker starts the FABPATHZ procedure. A sample is located in the SFRXSAMP(FRXPATHZ) member.
  • If the job name that is assigned to a procedure that HD Pointer Checker starts is not specified in IMS Database Recovery Facility master address space JCL, HD Pointer Checker starts the FABPATH0 procedure. A sample is located in the SFRXSAMP(FRXPATH0) member.

The following figures show examples for the FABPATH0 procedure and the FABPATHZ procedure.

//FABPATH0 PROC  HPPCLIB1=,HPPCLIB2= 
//ATH0PROC EXEC  PGM=FABPAUTH      
//STEPLIB  DD DISP=SHR,DSN=&HPPCLIB1  
//         DD DISP=SHR,DSN=HALDB partition selection exit
//         DD DISP=SHR,DSN=&HPPCLIB2 
//SYSUDUMP DD SYSOUT=*  
//FABPATHZ PROC L1=,L2=                                                
//ATHZPROC EXEC  PGM=FABPAUTH                                          
//STEPLIB  DD DISP=SHR,DSN=&L1                                         
//         DD DISP=SHR,DSN=HALDB partition selection exit
//         DD DISP=SHR,DSN=&L2                                         
//SYSUDUMP DD SYSOUT=*

The FABPATHZ procedure differs from the FABPATH0 procedure in the following respects:

  • Parameter L1= is used instead of HPPCLIB1
  • Parameter L2= is used instead of HPPCLIB2

The following EXEC and DD statements are used:

EXEC statement
A required statement. Specify the EXEC statement as follows: 
EXEC PGM=FABPAUTH
STEPLIB DD
A required statement. In the FABPATH0 procedure, specify two DD statements as follows:
//STEPLIB  DD DISP=SHR,DSN=&HPPCLIB1  
//         DD DISP=SHR,DSN=&HPPCLIB2
In the FABPATHZ procedure, specify two DD statements as follows:
//STEPLIB  DD DISP=SHR,DSN=&L1
//         DD DISP=SHR,DSN=&L2

&HPPCLIB1 in FABPATH0 or &L1 in FABPATHZ is used for the IMS HP Pointer Checker load module library. &HPPCLIB2 in FABPATH0 or &L2 in FABPATHZ is used for the IMS RESLIB.

Do not remove or override these DSN parameters (&HPPCLIB1, &HPPCLIB2, &L1, and &L2). HD Pointer Checker obtains the data set names from the IMS Database Recovery Facility master address space JCL and passes the data set names to these parameters. The data sets must be cataloged.

If you process a HALDB, and the HALDB uses a partition selection exit routine, FABPATH0 or FABPATHZ refers to the partition selection exit module. It is required that you do either of the following tasks:

  • Store the partition selection exit module in the IMS RESLIB.
  • Add a DD statement to the STEPLIB concatenation, and specify a data set name that contains the partition selection exit module. APF-authorize the data set.
SYSUDUMP
This optional output data set defines the output from a system ABEND dump routine. It is used only when a dump is required. Though optional, it is recommended that you include this data set.

In addition, FABPATH0 and FABPATHZ refer to the IMS and RECONx DD statements. IMS DD statement is not referred when IMS management of ACBs is enabled. These DD statements are basically not required in the procedure JCL. HD Pointer Checker obtains the data set names from the IMS Database Recovery Facility master address space JCL. The data sets must be cataloged.

The contents of the IMS and RECON DD statements are as follows:

IMS DD
The data set that contains the DBD load modules. When IMS management of ACBs is enabled, this DD statement is ignored.
RECON1, RECON2, and RECON3 DDs
RECON data sets

If IMS and RECONx DD statements are specified in the FABPATH0 or FABPATHZ JCL, the data set names in the FABPATH0 or FABPATHZ JCL are used.