A fix is available
APAR status
Closed as new function.
Error description
ORF functional enhancement.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: Users of IBM IMS Database Solution Pack V2.1 * * IMS Online Reorganization Facility * **************************************************************** * PROBLEM DESCRIPTION: Multiple functional enhancements for * * IMS Online Reorganization Facility * **************************************************************** * RECOMMENDATION: * **************************************************************** This APAR makes the following changes to IMS Online Reorganization Facility: - Add support of the SHADOW(R) keyword - Add support of the XCFMAX base configuration parameter - Terminate the reorganization job when the internal message buffers are exhausted - Add support of the CHGDATAC and CHGSTORC base configuration parameters - Improve misleading messages during the Copy phase
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IBM IMS Database Solution Pack for z/OS Version 2 Release 1 IMS Online Reorganization Facility User's Guide (SC19-4103-00) ---------------------------------------------------------------- Using IMS Online Reorganization Facility > HRFSYSIN DD statement > > HRFSYSIN DD statement keywords > > > SHADOW keyword SHADOW keyword This keyword is used to indicate whether all shadow data sets exist as your predefined shadows or if the shadows are to be deleted or defined by Online Reorganization Facility. This keyword is optional. The options are: - SHADOW(A) to indicate that IMS Online Reorganization Facility deletes or defines them using the attributes of the original data sets. - SHADOW(E) to indicate that the shadows exist and have been predefined. This option can be useful when the cluster definition needs to be changed and is different than the original data set attributes, such as amount of space, and other attributes. NEW: |- SHADOW(R) to indicate that IMS Online Reorganization Facility | deletes or defines them using the attributes of the original | data sets. When SHADOW(R), the allocated size of the original | data sets is used for the primary allocation size. This option | can be useful when you want to have all the database records | stored in the primary extent of the database data sets after | the reorganization. NEW: Format (A | E | R) where A Allocate E Exist R Allocate and resize (NEW) ---------------------------------------------------------------- Changing the IMS Online Reorganization Facility environment > Customizing your base environment > > Base configuration parameters NEW: | CHGDATAC=sss | A 1- to 8-character SMS data class name that is used to define | temporary data sets to store the change records that are sent | from the IMS online regions. | This parameter is an optional parameter for SMS environments. | Specify this parameter only when you want to have those data | sets allocated by using a specific SMS data class. | Default: None. | | CHGSTORC=sss | A 1- to 8-character SMS storage class name that is used to | define temporary data sets to store the change records that | are sent from the IMS online regions. | This parameter is an optional parameter for SMS environments. | Specify this parameter only when you want to have those data | sets allocated by using a specific SMS storage class. | Default: None. NEW: NEW: | XCFMAX=nnn | A 256-2047 numeric value that specifies the size (in MB) of | the internal message buffers that are used by the IMS Online | Reorganization Facility job to receive XCF messages. These | buffers are provided to protect against cases where IMS Online | Reorganization Facility cannot keep up with the changes that | are being captured from the online IMS subsystems. When the | internal message buffers are exhausted, the IMS Online | Reorganization Facility job abends. | Default: 256 NEW: ---------------------------------------------------------------- Troubleshooting > Messages and codes > > Messages NEW: | HRF01575E Internal message buffer allocation failed | Explanation: IMS Online Reorganization Facility could not | allocate the internal message buffers that are used for | receiving XCF messages. | System action: The process terminates. | User response: Adjust the size of the internal message buffers | by specifying the XCFMAX parameter in the base configuration | module. For more information, see "Base configuration | parameters". | | HRF01576E Internal message buffers are exhausted | Explanation: The internal message buffers that are used to | receive XCF messages are exhausted. | System action: The process terminates. | User response: Increase the size of the internal message | buffers by specifying the XCFMAX parameter in the base | configuration module. For more information, see "Base | configuration parameters". NEW:
APAR Information
APAR number
PI24397
Reported component name
IM DB SOLUTION
Reported component ID
5655S7700
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2014-08-21
Closed date
2014-09-11
Last modified date
2014-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI21303
Modules/Macros
HRFODSN0 HRFOLEV0 HRFOREO1 HRFOREO3 HRFOUOW1 HRFOXCF HRFSET HRFXALLO HRFXIDCA HRFXLGDS HRFYCCDF HRFYMSGT
SC19410300 |
Fix information
Fixed component name
IM DB SOLUTION
Fixed component ID
5655S7700
Applicable component levels
R210 PSY UI21303
UP14/09/16 P F409
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