A fix is available
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 number
PI63563
Reported component name
IM DB SOLUTION
Reported component ID
5655S7700
Reported release
210
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2016-06-03
Closed date
2016-06-20
Last modified date
2016-07-04
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
SC19410301 |
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCV358","label":"IMS Database Solution Pack"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0"}]
Document Information
Modified date:
23 October 2020