PI51722: PROVIDE NEW CONTROL STATEMENT COMPAUTH 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 IMS Index Builder for z/OS,     *
  *                 Version 3 Release 1 (FMID=H22O310)           *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables the new control       *
  *                      statement 'COMPAUTH YES'.               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR enables the new control statement 'COMPAUTH YES'.
  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.
  
  And the following problem is fixed:
  -If the root segment key is compressed, the index records are
  incorrect.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = Documentation Change =
  ========================
  IBM IMS Index Builder for z/OS, V3R1, User's Guide
  (SC18-9101-05) should be changed as follows:
  ================================================================
  > Using IMS Index Builder
  >> JCL and input control statements
  >>> IMS Index Builder JCL
  >>>> DD statements
  
   HSSROPT DD statement
    Specify this statement to use High Performance Unload
    for hierarchical scan. High Performance Unload commands are
    supplied by the user.
  | For more information about HSSROPT options and control
  |  statements, see the IMS High Performance Unload User's
  |  Guide.
    This statement is optional.
  
   IIUOPT DD statement
  
    This DD statement authorizes IMS Index Builder to select
    appropriate options for the IMS HP Unload feature available
    for hierarchical scans. The options are identical to
    the options for the HSSROPT DD statement, which is used in
    IMS HP Unload.
  D For more information about HSSROPT options and control
    statements, see the IMS High Performance Unload User's Guide.
  D This DD statement is optional
  | This DD is reserved for system use.
   ---------------------------------------------------------------
  > Using IMS Index Builder
  >> JCL and input control statements
  >>> IMS Index Builder input control statements
  >>>> Optional control statements
  |>>>>> COMPAUTH control statement
  |
  | The COMPAUTH control statement specifies whether the
  | segment compression routine is called 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.
  | +------------------------------------------------------+
  | |                _NO___                                |
  | | >>__COMPAUTH__|_YES__|____________________________>< |
  | +------------------------------------------------------+
  | COMPAUTH
  |   Specifies that this is an COMPAUTH statement.
  | NO
  |   The segment compression exit is called in problem state.
  | YES
  |   The segment compression exit is called in supervisor
  |   state.
  | If the COMPAUTH statement is not specified, NO is
  | the default.
  |
  | Tip: You can override the default value in the runtime
  | parameters module. See the explanation of the IIURDFLT
  | COMPAUTH entry in Defining runtime parameters.
  ----------------------------------------------------------------
  >> Defining runtime parameters
  
   Figure 1. Example of an IMS Index Builder runtime parameters
   module (Part 2 of 2)
   :
    *        DC    CL52'IIURDFLT CLASS IIU.STRIPE '
  | *        DC    CL52'IIURDFLT COMPAUTH YES'
    *        DC    CL52'IIURDFLT DBAUTH NO'
  
  |   IIURDFLT COMPAUTH entry
  
  |   Use the IIURDFLT COMPAUTH entry to specify whether
  |  the segment compression exit is called in supervisor state.
  |  For details, see COMPAUTH control statement.
  ---------------------------------------------------------------
   >Troubleshooting
   >> IMS Index Builder messages
  | IIUB115I COMPAUTH YES IS IGNORED IN LIMITED APF
  |          AUTHORIZATION JCL
  | Explanation: 'COMPAUTH YES' is ignored in the run of
  | limited APF authorization JCL.
  | System action: Processing continues
  | User response: None. This message is informational.
  ---------------------------------------------------------------
  &#215;**** PE16/02/02 FIX IN ERROR. SEE APAR PI56485  FOR DESCRIPTION
  

APAR Information

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

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

  UI34656

Modules/Macros

• IIUBIBCD IIUBINIT IIUBMSGS IIUBSTMS IIUHGSP
  IIUHMMCL IIUHMMIF IIUHPSLA IIUHPSLB IIUHPSL2 IIUHPSL3 IIUHPSL4
  IIUHPSL9 IIUH015  IIUH015A IIUH030A IIUH030B IIUH0302 IIUH0303
  IIUH0304 IIUH0309 IIUH040  IIUH060  IIUH200A IIUH200B IIUH2002
  IIUH2003 IIUH2004 IIUH2009 IIUH250A IIUH250B IIUH2502 IIUH2503
  IIUH2504 IIUH2509 IIUSCB01 IIUSCB11 IIUSCB12 IIUSIBCD IIUSIN01
  IIUSIN11 IIUSIN12 IIUSMP10
  

Fix information

• Fixed component name

  IMS INDEX BUILD

• Fixed component ID

  5655E2400

Applicable component levels

• R310 PSY UI34656

     UP16/01/23 P F601

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.