PI79711: ORF DOES NOT WAIT FOR A RESPONSE TO THE WTOR END ACTION OF TAKEOVER.WINDOW

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When TAKEOVER.WINDOW keyword is specified with the end action of
  WTOR (default), ORF issues a WTOR message to ask for an action
  after the takeover window is expired. However, ORF does not wait
  for the response to the WTOR message but proceeds with takeover
  processing.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 *
  *                 IMS Online Reorganization Facility.          *
  ****************************************************************
  * PROBLEM DESCRIPTION: ORF does not wait for a response to the *
  *                      WTOR end action of TAKEOVER.WINDOW.     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When TAKEOVER.WINDOW keyword is specified with the end action of
  WTOR (default), ORF issues a WTOR message to ask for an action
  after the takeover window is expired. However, ORF does not wait
  for the response to the WTOR message but proceeds with takeover
  processing.
  
  This APAR also fixes the following problems:
   - The WTOR message that ORF issues as the end action does not
    have a message ID.
   - When the response to the WTOR end action is 'A'(Abend), the
    ORF job can get ABENDS0C4 during the job termination process
   - After the Receiver task ends due to an XCF messaging error,
    the Apply task still tries to communicate with the Receiver
    task and gets ABENDS0C4, which causes an unclean termination
    of the ORF job.
  

Problem conclusion

• This APAR modifies the program as follows:
   - When ORF becomes ready for takeover after ORF issues a WTOR
    message as the end action, ORF reissues a WTOR message to ask
    for the action and waits for the response.
   - When WTOR end action is specified, ORF issues a WTOR message
    with message ID HRF01544A.
   - The job termination process is improved so that the Apply
    task does not try to communicate with the Receiver task after
    the Receiver task terminates.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS Online Reorganization Facility User's Guide (SC19-4103-02)
  ----------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  The following new message has been added:
  HRF01544A (jobname): Reply 'N', 'T',  'C',  or 'A'
  Explanation: This WTOR message is issued after message
  HRF01544I. This message indicates that the IMS Online
  Reorganization Facility job is waiting for an operator response.
  System action: Processing waits for an operator response. During
  the wait, the IMS Online Reorganization Facility job continues
  reorganization in the background. If the job is ready for the
  Takeover phase, it goes into idle mode and waits for a response
  to the WTOR message.
  User response: Take one of the actions listed in the preceding
  HRF01544I message.
  ----------------------------------------------------------------
  

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:

  UI46862

Modules/Macros

• HRFOLEV0 HRFOREOE HRFOREO1 HRFYMSGL
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI46862

     UP17/05/02 P F705

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.