PM28298: ENHANCEMENT OF DBRC COMMAND PROCESSING

Obtain the fix for this APAR.

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.
  &#215;**** PE11/01/28 PTF IN ERROR. SEE APAR PM31497  FOR DESCRIPTION
  

APAR Information

• 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
  

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.