A fix is available
APAR status
Closed as new function.
Error description
Reorg Expert currently issues all DBRC commands using IMS Batch DBRC utility (DSPURX00), but IMS DBRC API provides better performance than DSPURX00. This APAR moves most of the DBRC commands from DSPURX00 to DBRC API for IMS V10 and above, and also reduces the use of DSPURX00 by issuing the rest of DBRC commands all at once.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Database Reorganization * * Expert for z/OS Version 4 Release 1 * * (FMID=H25N410) * **************************************************************** * PROBLEM DESCRIPTION: Enhancement of DBRC command processing * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** Reorg Expert currently issues all DBRC commands by using IMS Batch DBRC utility (DSPURX00), but the IMS DBRC API provides better performance than DSPURX00. This APAR moves most of DBRC commands from DSPURX00 to the DBRC API for IMS V10 and above, and also reduces the use of DSPURX00 by issuing the rest of DBRC commands all at once.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 Suffix 1 (SC19-1137-01) (Revision bar shows the part of change) 3.5 Smart Reorg JCL statements 3.5.2 Control statements for Smart Reorg 3.5.2.2 Control statements for the Smart Reorg Driver *New entry for DBRCAPI control statement should be added into table 11. The content should be as follows: Table 11. Control statements for the Smart Reorg Driver -------------------------------------------------------------- Keyword Acceptable values Default Description -------------------------------------------------------------- | DBRCAPI YES or NO If DBRC is active: Specifies whether | -YES for IMS V10 to use the DBRC | or later. API to issue DBRC | -NO for IMS V9. commands. See | No default if DBRC "DBRCAPI control | is not active. statements" in | topic 3.5.2.2.4. -------------------------------------------------------------- *New subsection for DBRCAPI control statement should be added, as follows: | 3.5.2.2.4 DBRCAPI control statement | | Specifies whether to use the DBRC API to issue DBRC commands. | | This control statement is optional. If you do not explicitly | specify this control statement, DBRCAPI=YES is used. | | _____________________________________________________________ || | || _YES_ | || >>__DBRCAPI=__|_NO _|____________________________________>< | || | ||_____________________________________________________________| | | When DBRCAPI=NO is specified, the Smart Reorg utility does not | use the DBRC API, but uses the IMS Batch DBRC utility | (DSPURX00) to issue DBRC commands. | | When DBRCAPI=YES is specified, all the DBRC commands before | the reorganization are issued by using DBRC API, and all the | DBRC commands after the reorganization are issued by using | DSPURX00. | | The Smart Reorg utility only supports the DBRC API of IMS | Version 10 or later. If the IMS RESLIB library on the STEPLIB | concatenation is of IMS Version 9, this statement is ignored | and DSPURX00 is used to issue all the DBRC commands. | | If DBRC is not active, this control statement is ignored and | has no effect. | | For the DBRC commands that are issued in Smart Reorg utility | jobs, see "Automated DBRC authorization and unauthorization | processing" in topic 3.3.1.2. For more information about DBRC | API, see the IMS System Programming API Reference. 8.2 Messages and Codes 8.2.3 Messages r an error message for DBRC API should be 8.2.3.3 HPSG Messages *New subsection for an error message for DBRC API should be added, as follows: | 8.2.3.3.257 HPSG2330E | | HPSG2330E DBRC API FUNC=function, TYPE=type, RC=rc,RSN=rsn | | Explanation: | | The Smart Reorg utility received an error return code from the | DBRC API. function is the function name of the DBRC API, type | is the type of the DBRC query request, rc is the return code | in decimal, and rsn is the reason code in hexadecimal format. | | System Action: | | The Smart Reorg utility ends with a return code of 8. | | User Response: | | See the IMS System Programming API Reference and check the | meaning of the return code and reason code. ×**** PE11/01/28 PTF IN ERROR. SEE APAR PM31497 FOR DESCRIPTION
APAR Information
APAR number
PM28298
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2010-12-06
Closed date
2011-01-18
Last modified date
2011-02-09
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK64051
Modules/Macros
HPSGCM20 HPSGCR10 HPSGCSC1 HPSGDI00 HPSGGIOB HPSGGIO0 HPSGGRGB HPSGGRG0 HPSGGRMB HPSGGRM0 HPSGLINK HPSGMPA0 HPSGMSGT HPSGODA0 HPSGRE00 HPSGRM00 HPSGRM10 HPSGRP10 HPSGRP20 HPSGRP30 HPSGRS00 HPSGRS30 HPSGRX00 HPSGSTMT HPSGTM00 H25N410J
SC19113701 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UK64051
UP11/01/20 P F101
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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023