PM12287: BYPASS THE DBRC AUTHORIZATION IN IPR UNLOAD UTILITY

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR enables the IPR Unload utility to bypass the DBRC
  authorization because the users do not want to take the database
  offline. (FITS MR1217092141)
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  *                 z/OS, Version 1 Release 2 (FMID=H1IN120),    *
  *                 who use the IPR Unload utility of IMS        *
  *                 Parallel Reorganization for z/OS Version 3   *
  *                 Release 2 (FMID=H25N320) or IMS Database     *
  *                 Reorganization Expert for z/OS Version 4     *
  *                 Release 1 (FMID=H25N410).                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables the IPR Unload        *
  *                      utility to bypass the IMS DBRC database *
  *                      authorization.                          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables the IPR Unload utility to bypass the IMS DBRC
  database authorization. The new control statement 'SKIPAUTH=YES'
  is provided.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  The IBM IMS Database Reorganization Expert for z/OS User's Guide
  Version 4 Release 1 (SC19-1137-00) should be changed as follows:
  
  ================================================================
   4.0 Unloading a database
   4.3 IPR Unload JCL statements
   4.3.2 Control statements for IPR Unload
  
   4.3.2.3 Control statements for unload function
  
   (The SKIPAUTH control statement is added.)
  
   This topic summarizes the HPSIN control statements that are use
   for controlling the unload function. The following control
   statements can be coded to control the unload function.
  
   The following table shows control statements for unload
   functions.
  
   Table 23. Control statements for unload function
   +-----------+------------+--------+--------------------------+
   |Keyword    |Acceptable  |Default |Description               |
   |           |values      |        |                          |
   +-----------+------------+--------+----------------------- --+
   :           :            :        :                          :
   +-----------+------------+--------+--------------------------+
  ||SKIPAUTH   |YES or NO   |NO      |Specifies whether to      |
  ||           |            |        |bypass IMS DBRC database  |
  ||           |            |        |authorization.            |
   +-----------+------------+--------+--------------------------+
  
  ----------------------------------------------------------------
  |4.3.2.3.x SKIPAUTH control statement
  |
  | Specifies whether to bypass IMS DBRC database authorization
  | to avoid DBRC authorization failure (DFS047A).
  | This control statement is used only when DBRC is active.
  |
  | This control statement is optional. If you do not explicitly
  | specify this control statement, SKIPAUTH=NO is used.
  |  _______________________________________________________
  | |                    __NO  ________                     |
  | | >>__SKIPAUTH=_____|__YES_________|_________________>< |
  | |_______________________________________________________|
  |
  | YES
  |   A database authorization request is not sent to IMS DBRC.
  |
  | NO
  |   A database authorization request is sent to IMS DBRC
  |   before opening each database or partition.
  |
  | Note:
  |   When SKIPAUTH=YES is specified, you can run the IPR
  |   Unload utility without issuing an IMS /DBDUMP command
  |   to the database and no read integrity is provided.
  ===================  END OF DOC-CHANGE  =======================
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK57099

Modules/Macros

•    FABHRTI0 FABHTCB  FABHTCBU FABH001  FABH010A
  FABH010B FABH0108 FABH0109 HPSUFCB0 HPSUGTI0 HPSUHFCB HPSUSTMT
  HPSUURGA HPSUURGB HPSUURG8 HPSUURG9 HPSU015  HPSU015A
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UK57099

     UP10/05/21 P F005

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.