PI51721: 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 High Performance Unload for *
  *                 z/OS Version 1 Release 2 (FMID=H1IN120)      *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides the following new    *
  *                      capabilities:                           *
  *                      1. the new control statement            *
  *                        'COMPAUTH YES'                        *
  *                      2. check if the primary index data set  *
  *                        has the VSAM extended addressability  *
  *                        attribute,                            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides the following new capabilities:
  > the new control statement 'COMPAUTH YES'
  > check if the primary index data set has the VSAM extended
  addressability attribute. It's not allowed by IMS.
  
  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.
  
  The new control statement can be specified as below:
  Case 1: HP Unload utilities started by PGM=FABHX034
   //HSSROPT DD *
    COMPAUTH YES
  
   @If DECN is specified for HPSURG1 or FABHFSU unload utility,
  @'COMPAUTH YES' is ignored.
  
  Case 2: IPR Unload utility with DECOMPRESS=YES
   //HPSIN DD *
    DECOMPRESS=YES
    COMPAUTH=YES
  
  
  Case 3: Smart Reorg utility with DECOMPRESS=YES
   //HPSIN DD *
   :
   (UNLOAD)
   DECOMPRESS=YES
   COMPAUTH=YES
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IBM IMS High Performance Unload for z/OS User's Guide
  Version 1 Release 2 Suffix 8 (SC27-0936-08) should be changed
  as follows:
  
  ----------------------------------------------------------------
  > Unloading IMS databases
  >> Options for HSSR Engine
  |>>> COMPAUTH Control Statement
  |
  | The COMPAUTH control statement specifies whether to call
  | the segment compression exit in supervisor state.
  | If DECN control statement is specified, this control
  | statement is not needed.
  |
  | 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.
  |
  | 0........1.........2.........3.........4.........5..
  | 1234567890123456789012345678901234567890123456789012
  | COMPAUTH YES
  | COMPAUTH NO
  |
  | Position  Description
  | 1         Code the COMPAUTH keyword.
  | 10        Enter one of the following keywords:
  |           YES
  |             Specifies to call the segment compression exit
  |             in supervisor state.
  |           NO
  |             Specifies to call the segment compression exit
  |             in problem state. NO is the default.
  |
  | To enable 'COMPAUTH YES', the following conditions are
  | required:
  | - All of the STEPLIB libraries are APF authorized.
  | - The first load module is link-edited with authorization
  |   code AC=1 like FABHX034.
  |
  | Tip: The default of this control statement can be changed
  | by replacing the default option table (FABHOPT). Specify
  | the COMPAUTH=YES parameter on the FABHTOPT macro statement.
  | For details, see Site default options.
  
  ---------------------------------------------------------------
  > Unloading IMS databases
  >> FABHURG1 unload utility
  >>> IMS HD Reorganization Unload JCL for running FABHURG1
  :
   Restrictions
  | - The following control statements are ignored:
  |   > 'COMPAUTH YES' in the HSSROPT data set
  |   > 'HPIO YES' in the HSSROPT data set
  ---------------------------------------------------------------
  > Tuning and customizing HSSR application jobs
  >> Site default options
  >>> How the runtime parameters are determined
  
  Table 1. Options for which default values can be specified
  | Function: HSSR Engine options
  | Keyword: COMPAUTH
  | Description: COMPAUTH option
  | Related data set: HSSROPT
  ---------------------------------------------------------------
  >>> FABHTOPT macro statements
  
   (label)     FABHTOPT     COMPAT= HPU|DBT|5787LAC
  |                               :
  |                                ,COMPAUTH=YES|NO
  
  
  Table 1. Basic settings of FABHTOPT options
   +------------+-----------+------------+----------------+
   | Keyword    |COMPAT=HPU | COMPAT=DBT | COMPAT=5787LAC |
   +------------+-----------+------------+----------------+
   :            :           :            :                :
   +------------+-----------+------------+----------------+
  || COMPAUTH=  | NO        | NO         | NO             |
   +------------+-----------+------------+----------------+
  
    You can use the following keywords to override the values
    set by the basic settings:
    :
  | COMPAUTH=
  |  This optional keyword specifies the default for
  |  the COMPAUTH option in HSSROPT.
  
  ---------------------------------------------------------------
  > Troubleshooting
  >> Messages and codes
  >>> Messages
  >>>> FABH messages
  ---------------------------------------------------------------
  | FABH0660W COMPAUTH YES IS IGNORED IN UNAUTHORIZED PROGRAM
  |
  | Explanation: Although one ore more segments are compressed,
  | "COMPAUTH YES" that is specified in the HSSROPT data set
  | is ignored because of one of the following reasons:
  | - one or more STEPLIB libraries are not APF-authorized.
  | - the first load module is not assigned authorization AC=1,
  |   including the case that PGM=DFSRRC00 is specified
  |   in the JCL EXEC statement.
  | System action: HSSR Engine continues processing with
  | "COMPAUTH NO".
  | User response: If you want to activate "COMPAUTH YES",
  | APF-authorize all the STEPLIB libraries and specify program
  | name of FABHX034.
  ---------------------------------------------------------------
  | FABH0676E INCORRECT COMPAUTH CONTROL STATEMENT IS SPECIFIED
  |
  | Explanation: An incorrect operand on the COMPAUTH 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 COMPAUTH statement.
  ---------------------------------------------------------------
  | FABH2015E INCORRECT COMPAUTH= PARAMETER IS SPECIFIED
  |
  | Explanation: The value specified for the COMPAUTH= keyword
  | parameter is incorrect. It must be either YES or NO.
  | System action: The assembly of the option table ends with
  | return code 8. The option table is not replaced.
  | User response: Correct the error.
  ---------------------------------------------------------------
   FABH0581E OPEN OF DBD=dbdname DDN=ddname --- "yyyy" "text"
  
   :
   User response: The following list provides the subtext
   (yyyy and text), explanation, and the user response for each
   subtext:
  
    - "KSDS" "MODCB RPL, RECLEN...... FAILED"
    :
  
  | - "KSDS" "EXTENDED ADDRESSABILITY IS NOT SUPPORTED"
  | It was determined that the KSDS is an SMS data set with
  | the extended addressability attribute, which IMS does not
  | support.
   :
  

APAR Information

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

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

  UI33936

Modules/Macros

•    FABHDOPT FABHGSP  FABHJCB  FABHJCB0 FABHMMCL
  FABHMMIF FABHOPT  FABHPSLA FABHPSLB FABHPSL2 FABHPSL3 FABHPSL4
  FABHPSL8 FABHPSL9 FABHTCBU FABHTGBL FABHTOPT FABH000  FABH015
  FABH015A FABH030A FABH030B FABH0302 FABH0303 FABH0304 FABH0308
  FABH0309 FABH040  FABH060  FABH200A FABH200B FABH2002 FABH2003
  FABH2004 FABH2008 FABH2009 FABH250A FABH250B FABH2502 FABH2503
  FABH2504 FABH2508 FABH2509 FABH510  HPSUSTMT HPSU015  HPSU015A
  

Fix information

• Fixed component name

  IMS HIGHPERF UN

• Fixed component ID

  5655E0600

Applicable component levels

• R120 PSY UI33936

     UP15/12/23 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.