PM97558: ENABLE HP UNLOAD UTILITIES TO BYPASS IMS DBRC DATABASE AUTHORIZATION TO AVOID DBRC AUTHORIZATION FAILURE (DFS047A).

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Enable HP Unload utilities to bypass IMS DBRC database
  authorization to avoid DBRC authorization failure (DFS047A).
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Unload for *
  *                 z/OS Version 1 Release 2 (FMID=H1IN120)      *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables HP Unload utilities   *
  *                      running in the ULU region to bypass     *
  *                      IMS DBRC database authorization to      *
  *                      avoid DBRC authorization failure        *
  *                      (DFS047A).                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR enables HP Unload utilities running in the ULU region
  to bypass IMS DBRC database authorization to avoid DBRC
  authorization failure (DFS047A) for HALDB partitions.
  The new control statement 'SKIPAUTH YES' can be specified in
  the HSSROPT data set.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Unload for z/OS User's Guide
  Version 1 Release 2 Suffix 7 (SC27-0936-07) should be changed
  as follows:
  ----------------------------------------------------------------
  2.9 Options for HSSR Engine
  2.9.1 Overview of HSSROPT control statements
  
   Table 28. List of HSSROPT control statements for HSSR Engine
   +--------------+-----------+---------------------------------+
   | Use for      | Keyword   | Function                        |
   +--------------+-----------+---------------------------------+
   | Call Analyzer|           :                                 :
   | and          +-----------+---------------------------------+
  || Call Handler |SKIPAUTH   | Specifies whether to bypass IMS |
  ||              |           | DBRC database authorization for |
  ||              |           | HALDB partitions.               |
  |+--------------+-----------+---------------------------------+
  
  ----------------------------------------------------------------
  | 2.9.27a  SKIPAUTH control statement
  |
  | The SKIPAUTH control statement specifies whether to bypass
  | IMS DBRC database authorization to avoid DBRC authorization
  | failure (DFS047A) for HALDB partitions.
  |
  | 'SKIPAUTH YES' is effective only when HALDB is processed
  | in the ULU region. Otherwise, it is ignored.
  |
  | Position Description
  | 1
  |   Code the SKIPAUTH keyword to bypass IMS DBRC database
  |   authorization.
  | 10
  |   Specify one of the following keywords:
  |   Keyword Description
  |   YES
  |     Requests HSSR Engine to bypass IMS DBRC database
  |     authorization.
  |   NO
  |     Requests HSSR Engine not to bypass IMS DBRC database
  |     authorization. NO is default.
  |
  ----------------------------------------------------------------
   7.2 Messages and codes
   7.2.4.1 FABH messages
  
  (The following two messages are added: FABH0677E and FABH0696I.)
  ----------------------------------------------------------------
  | FABH0677E INVALID SKIPAUTH CONTROL STATEMENT IS SPECIFIED
  |
  | Explanation: An incorrect operand on the SKIPAUTH control
  | statement is specified in the HSSROPT data set. The operand
  | must be either YES or NO.
  | System Action: The incorrect statement is ignored.
  | User Response: Correct the SKIPAUTH statement.
  ----------------------------------------------------------------
  | FABH0696I "SKIPAUTH YES" IS APPLICABLE ONLY TO HALDB
  |
  | Explanation: 'SKIPAUTH YES' is specified in the HSSROPT
  | dataset. This control statement is applicable only to HALDB.
  | System Action: HSSR continues processing. If the database is
  | HALDB, IMS DBRC database authorization request is bypassed.
  | User Response: If you need to avoid DBRC authorization failure
  | (DFS047A) for non-HALDB, specify DBRC=N.
  ----------------------------------------------------------------
  
  (The following two messages are deleted: FABH0385E and
  FABH0392E.)
  D FABH0385E JCB POINTERS TO SDB'S NOT OK
  D FABH0392E SECONDARY LIST OF LP NOT FOUND
  ================= End of Documentation Change ==================
  

APAR Information

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

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

  UI12509

Modules/Macros

•    FABH010A FABH010B FABH0102 FABH0103 FABH0108
  FABH0109 FABH015  FABH015A FABH020A FABH020B FABH0202 FABH0203
  FABH0208 FABH0209
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UI12509

     UP13/11/16 P F311

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.