IMS Index Builder, DFSPREC0, and Build Index function of FPA address space JCL

The IMS Index Builder address space is started when IMS Index Builder is requested to rebuild indexes.

The DFSPREC0 address space is started when DFSPREC0 is requested to rebuild HALDB primary indexes and ILDS by using either HALDB(BOTHF) or HALDB(ILEF). The Build Index function of FPA address space (FS-UAS) is started when the Build Index function of FPA is requested to rebuild secondary indexes for a Fast Path database.

All DD statements required for running in the subordinate address spaces, except STEPLIB DD and the SYSUDUMP DD, are passed from the master address space to this address space and dynamically allocated.

The required STEPLIB DD must be specified in the subordinate address space JCL and it must contain a single data set that points to the IMS Recovery Solution Pack executable load library, SFRXLOAD.

The address spaces for IMS Index Builder, DFSPREC0, IMS High Performance Image Copy, and the Build Index function of FPA are started by the master address space. The procedure that is used to create these address spaces is specified by using the DRFIAX() environmental control statement. The default procedure name is FRXJCLIP. Samples are located in the SFRXSAMP(FRXJCLIP|FRXIAX) member.
Tip: Customize the FRXRSS procedure and rename to FRXRSSxx, where xx is the maintenance level or IMS subsystem used (for example, TEST or PROD and IMS 14 or IMS 15). For example:
  • If you have different IMS subsystems, you can create FRXIAX14 for your IMS 14 system and FRXIAX15 for your IMS 15 system.
  • If you have different environments with different maintenance levels, you can create FRXRSST1 for IMS SSID IMT1 of your test environment and FRXRSSP1 for your IMS SSID IMP1 of your production environment.

The name of the address space for the Build Index function of FPA is specified by using the FSPREF() keyword. The name of the IMS Index Builder address space is specified by using the IBPREF() keyword. The name of the DFSPREC0 address space is specified by using the PRPREF() keyword. For more information, see Environmental control statements.

Multiple address spaces for IMS Index Builder, DFSPREC0, and the Build Index function of FPA can be started. One address space is started for each index that is being rebuilt.

DDNAME statement reference

STEPLIB
This required DD statement identifies the IMS Database Recovery Facility load library.

The STEPLIB DD statement must include a single load library that names the executable IMS Recovery Solution Pack load library (SFRXLOAD).

All other libraries that are required for execution are passed from the master address space and dynamically allocated for execution.

SYSUDUMP
This statement identifies the data set definition where dump output is sent after an abnormal termination.
Recommendation: For debugging and diagnostic purposes, IBM® support prefers an unformatted dump.
  • If SYSUDUMP is coded, then a formatted dump is created if an abend occurs.
  • If SYSUDUMP is not coded and an abend occurs, then a system, unformatted dump is generated.

The following DD statements can be either directly coded in the procedure JCL, or specified in the master address space JCL and dynamically allocated in the recovery sort subordinate address space (recommended).

Dynamic allocation eliminates the need to manually update subordinate address space JCL procedures when the master address space JCL is updated.

  • IMS
  • PROCLIB
  • DFSRESLB
  • IMSDALIB
  • SORTLIB
  • DFSVSAMP
  • RECON