PK56571: ADD LIU SUPPORT FOR ORF

APAR status

• Closed as new function.

Error description

• New function:   LIU support for ORF.
  Explanation:  LIU must be notified of a DBD change when ORF
  does an online change. A new keyword "IMSID" is provided to
  override the imsid found in the RESLIB.
  This APAR will fix the following:
  - ORF ends without an error message. Last message is
  MSGHRF01000I  Change receiver ended, return code is 20
  - When using the DBD parm field and the DBD(&PARM) keyword, the
  restart processor does not find the DBD in the restart
  - RELOAD.SORT keyword allowes YES or NO only, but not COND.
  - Takeover failure leaves the database in prohibit auth, but
  restart starts from the beginning.
  Addtional symptom:
  HRF01053E  VSAM PUT error DD=RESTART, RC=8, RPL
  feedback=01080008
  - ORF receives a DBRC ABENDU044
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS Online Reorganization       *
  *                 Facility Version 1.2.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: LIU support for ORF.                    *
  *                      This APAR is also fixing the following: *
  *                      1. ORF ends without an error message.   *
  *                      Last message is HRF01000I Change        *
  *                      receiver ended, return code is 20.      *
  *                      2. When using the DBD parm field and    *
  *                      the DBD(&PARM) keyword, the restart     *
  *                      processor does not find the DBD in      *
  *                      the restart dataset.                    *
  *                      3. RELOAD.SORT keyword allows YES or NO *
  *                      only, but not COND.                     *
  *                      4. Takeover failure leaves the database *
  *                      in prohibit auth, but restart starts    *
  *                      from the beginning.                     *
  *                      5. ORF has DBRC abend 44.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  LIU must be notified of a DBD change when ORF does an online
  change. A new keyword "IMSID" is provided to override the imsid
  found in the RESLIB.
  1. The change receiver tries to find all online subsystems in
  the RECON. However, the RECON initialization was incomplete.
  2.HRFOREOD did not resolve the substitution and therefore
  did not find the DBD for restart.
  3. This keyword (RELOAD.SORT) is passed to HP Load. If
  it was specified, it always created SORT=COND.
  4. The takeover phase saves and verifies all data, saves the
  data to the restart dataset, and then starts the takover
  process. Until the takeover actually starts, there is no
  restart available and also not necessary. However, the database
  remains stopped and in prohibit auth.
  5. DBRC was set to FORCE in DFSIDEF0. ORF did not reset the
  FORCE indicator when running with DBRC=N. ORF needs to switch
  to NO when it uses the shadow datasets.
  

Problem conclusion

Temporary fix

Comments

• ORF now supports LIU
  To use this enhancement through LIU, you additionally need to
  apply LIU APAR PK55232. Even if APAR PK55232 has not been
  applied to your LIU library yet, you can apply this APAR.
  1. Timing was changed for RECON initialization.
  2. HRFOREOD has been changed to resolve the substitution for
  the DBD keyword.
  3. HRFOREO5 has been changed to allow for COND and YES. NO will
  not generate the parameter for HP Load.
  4. A few new messages have been inserted telling about the
  failure prior to takeover. The database is started and prohibit
  auth is turned off.
  When takover really has started, the RESTART process will handle
  all subsequent failures.
  5. HRFODBRN has been changed to recognize DFSIDEF0.
  ×**** PE07/12/13 FIX IN ERROR. SEE APAR PK58212  FOR DESCRIPTION
  

APAR Information

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

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

  UK31897

Modules/Macros

• HRFOACBG HRFODBRN HRFOLIU0 HRFOPST0 HRFOPST4
  HRFOREOD HRFOREO0 HRFOREO5 HRFOREO7 HRFOREO8 HRFRRC10 HRFRRC81
  HRFRRC91 HRFXIMSV HRFXMDA0 HRFYCCDF HRFYDB10 HRFYDB81 HRFYDB91
  HRFYID10 HRFYID91 HRFYLIU0 HRFYOF10 HRFYOF81 HRFYOF91 H2A7120J
  

Fix information

• Fixed component name

  IMS ONLINE REOR

• Fixed component ID

  5655H9700

Applicable component levels

• R120 PSY UK31897

     UP07/12/06 P F712