PI63563: ORF ERROR HANDLING IMPROVEMENT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• ORF error handling improvement.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS Database Solution Pack  *
  *                 V2.1 IMS Online Reorganization Facility      *
  ****************************************************************
  * PROBLEM DESCRIPTION: ORF Error handling improvement          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• This APAR improves the error handling of ORF so that the users
  would get comprehensible messages in the following conditions:
  - An online IMS subsystem is started during the reorganization.
  - Database was started on online IMS subsystems, but the databas
    allocation was delayed due to a dynamic allocation failure.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS Database Solution Pack for z/OS Version 2 Release 1
  IMS Online Reorganization Facility User's Guide (SC19-4103-01)
  ----------------------------------------------------------------
  Topic: IMS Online Reorganization Facility overview > IMS Online
    Reorganization Facility restrictions
  The following description has been added at the end of the
  topic:
  In a multi-step job, any job step that follows the IMS Online
  Reorganization Facility job step should not statically allocate
  the database data sets that the IMS Online Reorganization
  Facility job step reorganized. If static allocation of the
  database data sets is requested in a subsequent job step, the
  database data sets will be used exclusively by the job until the
  job completes (even if DISP=SHR is specified) and online IMS
  subsystems will not be able to allocate the database data sets.
  ----------------------------------------------------------------
  Topic: Troubleshooting > Messages and codes > Messages
  The description for the following message has been modified:
  HRF01515W message_type from member membername reason
  Explanation: An unexpected XCF message was received from the
    corresponding member. message_type shows one of the following
    values:
      NEWMBR: The member that newly joined the XCF group. This
        type of message is typically received when an IMS
        subsystem is started during the reorganization.
      LOSTCONN: The connection to the member was lost. This type
        of message is typically received when an IMS subsystem
        terminates during the reorganization or the reorganization
        job abnormally terminates.
  System action: If the IMS Online Reorganization Facility job
    receives the message, the job terminates. If the message is
    received in the IMS control region, capturing changes for the
    remote IMS Online Reorganization Facility utility ends.
  User response: None.
  ----------------------------------------------------------------
  Topic: Troubleshooting > Messages and codes > Messages
  The following new messages have been added:
  HRF01580W Database database was not allocated on STA request
  Explanation: Database was started on online IMS subsystems, but
    the database was not allocated due to a dynamic allocation
    failure. The database will be allocated when it is scheduled.
    This message might be issued when a job step that follows the
    IMS Online Reorganization Facility job step attempts to
    statically allocate the database data sets. After the database
    data sets are reorganized, the job will have exclusive use of
    the database data sets until the job completes. Therefore,
    even if DISP=SHR is specified in the allocation job step, the
    online IMS subsystem fails to allocate the database data sets.
  System action: Processing continues.
  User response: If static allocation of database data set is
    requested in a subsequent job step, split that job step into
    another job.
  HRF01581E Number of online IMS subsystems has changed
  Explanation: The IMS Online Reorganization job detected a change
    in the number of online IMS subsystems during reorganization.
    See the preceding HRF01515W message to determine whether IMS
    subsystem was started or terminated.
  System action: Processing terminates.
  User response: If you do not plan to start or shutdown any
    online IMS subsystems, resubmit the IMS Online Reorganization
    Facility job. If you received this message as a result of an
    error or a sudden termination of the IMS control region,
    correct the problem with in the IMS control region and
    resubmit the IMS Online Reorganization Facility job.
  ----------------------------------------------------------------
  

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:

  UI38779

Modules/Macros

• HRFOAPLY HRFOLEV0 HRFOREO1 HRFOREO2 HRFOREO3
  HRFYMSGT
  

Fix information

• Fixed component name

  IM DB SOLUTION

• Fixed component ID

  5655S7700

Applicable component levels

• R210 PSY UI38779

     UP16/06/22 P F606

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.