PI51537: THE COMPAUTH STATEMENT IS PROVIDED TO CALL COMPRESSION EXIT IN SUPERVISOR STATE.

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides new control statement COMPAUTH to call
  compression exit in supervisor state.
  This alleviates performance degradation when using an encryption
  exit provided by InfoSphere Guardium Data Encryption for DB2 and
  IMS Databases as an IMS Segment Edit/Compression exit routine.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM IMS High Performance Load   *
  *                 for z/OS Version 2 Release 1 (FMID=H1IM210). *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides new control          *
  *                      statement COMPAUTH to call compression  *
  *                      exit in supervisor state.               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides new control statement COMPAUTH to call
  compression exit in supervisor state.
  

Problem conclusion

Temporary fix

Comments

• This APAR provides new control statement COMPAUTH to call
  compression exit in supervisor state.
  If you use an encryption exit of InfoSphere Guardium Data
  Encryption for DB2 and IMS Databases as the segment compression
  exit, specifying COMPAUTH=YES reduces performance degradation.
  
  This APAR enables you to specify the COMPAUTH statement for
  HP Load, IPR Reload utility, the RELOAD block for Smart Reorg
  utility, and Load API.
  
  ========================
  = Documentation Change =
  ========================
  IMS High Performance Load for z/OS Version 2 Release 1 User's
  Guide SC18-9222-06 ( SC18922206 ) should be changed as follows:
  ================================================================
  
  Reloading IMS databases with IMS High Performance Load
    Control statements
  
    COMPAUTH control statement
  
    Specifies whether to call the segment compression exit in
    supervisor state.
  
    Tip:
    If you use an encryption exit of InfoSphere Guardium Data
    Encryption for DB2 and IMS Databases as the segment
    compression exit, specifying COMPAUTH=YES reduces performance
    degradation. Even if the input data for IMS HP Load is created
    in compressed (encrypted) format, it is recommended to specify
    COMPAUTH=YES to reduce performance degradation because IMS HP
    Load calls the encryption exit to decrypt segment data for
    internal processes in some conditions.
  
    This control statement is optional. If you do not specify this
    control statement, COMPAUTH=NO is used.
  
                   .-NO--.
                   |     |
     >>-COMPAUTH=--+YES--+---------------><
  
    NO
      Specifies to call the segment compression exit
      in problem state.
  
    YES
      Specifies to call the segment compression exit
     in supervisor state.
  
    Notes:
    - You must run this statement under program HPSRRC00, which is
      the IMS HP Load version of the region controller program.
    - Under IMS region controller (PGM=DFSRRC00), COMPAUTH=NO is
      assumed. If you specify COMPAUTH=YES, it will be ignored.
    - If you specify COMPAUTH=YES, you must APF-authorize the load
      module libraries that are specified on the STEPLIB DD.
    - If one or more libraries on the STEPLIB DD are not
      APF-authorized, IMS HP Load uses COMPAUTH=NO even if you
      specify COMPAUTH=YES.
  
  Troubleshooting
    Messages and codes
      Messages
        IMS HP Load messages
  
    HPSR0110W keyword IS IGNORED UNDER IMS REGION CONTROLLER
  
    Explanation :
      The keyword cannot be used under IMS region controller
      (PGM=DFSRRC00). The parameter was ignored.
    System action:
      Processing continues; the parameter was ignored.
    User response:
      To use the keyword, use PGM=HPSRRC00 and APF-authorize all
      the libraries that are in the STEPLIB DD concatenation.
  
    HPSR3876I COMPAUTH=YES CANNOT BE USED BECAUSE ONE OR MORE
              LIBRARIES ARE NOT AUTHORIZED
  
    Explanation :
      IMS HP Load ignored COMPAUTH=YES because one or more
      libraries are not APF authorized.
    System action:
      Processing continues; the parameter was ignored.
    User response:
      To use COMPAUTH=YES, APF-authorize all the libraries that
      are in the STEPLIB DD concatenation.
  

APAR Information

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

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

  UI33447

Modules/Macros

•    HPSRAS00 HPSRCMPA HPSRCMPB HPSRCMP2 HPSRCMP3
  HPSRCMP4 HPSRCMP7 HPSRCMP8 HPSRCMP9 HPSRFCA0 HPSRHTBL HPSRMSGT
  HPSRRRI0 HPSRRRI9 HPSRSTMT
  

Fix information

• Fixed component name

  IMS HIGH PERF L

• Fixed component ID

  5655E0700

Applicable component levels

• R210 PSY UI33447

     UP15/12/03 P F512

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.