PI20420: ORF CAN STOP HALDB PARTITION WITHOUT WAITING FOR BMP TO BE PAUSED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• ORF can stop HALDB partition without waiting for BMP to be
  paused, which causes the BMP to abend with U3303 due to database
  unavailability.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS Online Reorganization Facility           *
  ****************************************************************
  * PROBLEM DESCRIPTION: ORF can stop HALDB partition without    *
  *                      waiting for BMP to be paused.           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  ORF can stop HALDB partition without waiting for BMP to be
  paused, which causes the BMP to abend with U3303 due to database
  unavailability.
  

Problem conclusion

• This APAR fixes the program to certainly detect the BMPs that
  access the HALDB being reorganized. The ORF BMP pauser is also
  changed to stop a BMP by issuing a 3303 pseudoabend regardless
  of database type.
  This APAR also forward-fits ORF V1.3 APARs PI10432 and PI15612
  to DBSP 2.1 ORF.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Solution Pack: IMS Online Reorganization
  Facility Version 2 Release 1 User's Guide (SC19-4103-00).
  ----------------------------------------------------------------
  IMS Online Reorganization Facility overview
  > IMS Online Reorganization Facility features and benefits
  >> BMP pause feature
  >>> BMPs running during the reorganization
  
  When IMS Online Reorganization Facility reorganizes a database,
  it must temporarily stop the database using the /STO or /DBR
  command. IMS does not allow a database to be stopped with a /STO
  or /DBR command while an active BMP is accessing that database.
  The IMS Online Reorganization Facility can communicate with any
  BMP that is accessing the database when the reorganization job
  must stop the database with a /STO or /DBR command. When a BMP
  detects that IMS Online Reorganization Facility must momentarily
  stop a database, the BMP temporarily stops until IMS Online
  Reorganization Facility restarts the database.
  To stop a BMP, IMS Online Reorganization Facility requests the
  BMP to stop. The BMP issues a 3303 pseudoabend after the
  successful completion of the next CHKP call. The job step TCB
  detects that it was a pseudoabend that is issued to allow IMS
  Online Reorganization Facility to stop the database with a /STO
  or /DBR command. The job step TCB then waits for IMS Online
  Reorganization Facility to restart the database. When the
  database is restarted, the job step TCB restarts the BMP from
  the last completed checkpoint.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UI19445

Modules/Macros

• HRFOREO2 HRFOXCF  HRFRRC11 HRFRRC12 HRFRRC13
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI19445

     UP14/07/10 P F407

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.