A fix is available
APAR status
Closed as new function.
Error description
Add site default options of COMPAUTH to call compression in supervisor state.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: IBM IMS Database Reorganization Expert for * * z/OS V4.1(FMID=H25N410) users. * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables a new control * * statement COMPAUTH=YES that specifies * * to call the segment compression exit * * in supervisor state. * * * * And the following problem is fixed: * * - Smart Reorg utility for a HALDB * * receives ABENDS0C2 when STEPLIB is * * not APF-authorized. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables a new control statement COMPAUTH=YES that specifies to call the segment compression exit in supervisor state under the following utilities: - Smart Reorg utility - IPR Unload utility - IPR Reload utility - IPR DB Scan utility The following APARs are also required for the related products: - PI51721 IMS High Performance Unload V1R2 (FMID: H1IN120) - PI53313 IMS High Performance Load V2R1 (FMID: H1IM210)
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IBM IMS Database Reorganization Expert for z/OS User's Guide Version 4 Release 1 Suffix 4 (SC19-1137-04) should be changed as follows: --------------------------------------------------------------- > Reorganizing a database in one job step >> Smart Reorg JCL statements >>> Control statements for the Smart Reorg utility >>>>> Control statements for the Smart Reorg Driver >>>>>> DYNALLOC control statement Notes: : - If all of the following conditions are met, XTIOT (extended task input/output table) is used to allocate each HALDB data set dynamically: |> All of the STEPLIB libraries are APF-authorized. > z/OS is V1.12 or later. > (If one or more OSAM data sets are included) @The NON_VSAM_XTIOT option is coded in the DEVSUPxx member @of PARMLIB. @> The DBALLABOVE statement is specified in the DFSVSAMP @data set. If the DFSVSAMP data set is dynamically allocated @and if other conditions are met, the DBALLABOVE statement @is automatically coded in the DFSVSAMP data set. --------------------------------------------------------------- >>>> Control statements for the Unload task Table 2. Control statements used for controlling HSSR Engine | Keyword: COMPAUTH | Acceptable values: YES or NO | Default: NO | Description: Specifies whether to call the segment | compression exit in supervisor state. --------------------------------------------------------------- >>>> Control statements for the Reload task Table 1. Control statements for the Reload task | Keyword: COMPAUTH | Acceptable values: YES or NO | Default: NO | Description: Specifies whether to call the segment | compression exit in supervisor state. --------------------------------------------------------------- > Unloading a database >> IPR Unload JCL statements >>> Control statements for IPR Unload >>>> Control statements for the unload function >>>>>> DECOMPRESS control statement Notes: : | - If DECOMPRESS=YES degrades the performance, see | 'COMPAUTH Control Statement'. --------------------------------------------------------------- >>>> Control statements for HSSR Engine Table 1. Control statements for Call Analyzer and Call Handler | Keyword: COMPAUTH | Acceptable values: YES or NO | Default: NO | Description: Specifies whether to call the segment | compression exit in supervisor state. --------------------------------------------------------------- |>>>>> COMPAUTH Control statement | Specifies whether to call the segment compression exit | in supervisor state. If DECOMPRESS=YES is specified, | this control statement is available. | | If you use an encryption exit of InfoSphere Guardium Data | Encryption for DB2 and IMS Databases as the segment | compression exit, 'COMPAUTH YES' reduces performance | degradation. | +-------------------------------------------------+ | | +-NO---+ | | | >>-+-COMPAUTH=--+-YES--+------------------->< | | +-------------------------------------------------+ | YES | The segment compression exit is called in supervisor | state. 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 HPSCMAIN or HPSGMAIN. | NO | The segment compression exit is called in problem state. | NO is the default. | | Tip: You can change the default value of this control | statement by creating an Installation Default Option Table | (HPSCOPTI). For more information, see Setting installation | default options. --------------------------------------------------------------- > Reloading a database >> IPR Reload JCL statements >>> Control statements >>>> Overview of the IPR Reload control statements Table 1. IPR Reload utility control statements for process control | Keyword: COMPAUTH | Acceptable values: YES or NO | Default: NO | Description: Specifies whether to call the segment | compression exit in supervisor state. --------------------------------------------------------------- |>>>> COMPAUTH Control statement | | Specifies whether to call the segment 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. Even if the input data for the IPR Reload utility | is created in compressed (encrypted) format, it is recommended | to specify COMPAUTH=YES to reduce performance degradation | because the IPR Reload utility 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 | The segment compression exit is called in problem state. | YES | The segment compression exit is called in supervisor | state. | | Notes: | - 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, the IPR Reload utility uses COMPAUTH=NO | even if you specify COMPAUTH=YES. | | Tip: You can change the default value of this control | statement by creating an Installation Default Option Table | (HPSCOPTI). For more information, see Setting installation | default options. --------------------------------------------------------------- |>Scanning a database to resolve logical relationships |>> IPR DB Scan JCL statements |>>> Control statements for IPR DB Scan |>>>> Overview of the IPR DB Scan control statements | The following control statements can be used to control | HSSR Engine: | - COMPAUTH --------------------------------------------------------------- > Reference >> Setting installation default options >>> How to code HPSCOPT macro statements DRIVUL +-,----------------------------+ v | |--DRIVUL----+-------------------------+--+---------| : : | | +---NO----+ | | +--COMPAUTH=+---YES---+---+ DRIVRL +-,----------------------------+ v | |--DRIVRL----+-------------------------+--+---------| : : | | +---NO----+ | | +--COMPAUTH=+---YES---+---+ UNLOAD +-,----------------------------+ v | |--UNLOAD--+-------------------------+--+----------| : : | | +---NO----+ | | +--COMPAUTH=+---YES---+---+ RELOAD +-,----------------------------+ v | |--RELOAD--+-------------------------+--+----------| : : | | +---NO----+ | | +--COMPAUTH=+---YES---+---+ --------------------------------------------------------------- >Troubleshooting>Messages and codes>Messages>HPSU messages HPSU3171W RAPCHECK DETECTS INCORRECT RAPS: TOTAL ROOTS=nn,nnn,nnn,nnn Explanation: The RAPCHECK exit (HPSURPCX) detected one or more incorrect RAP chains. System action: The IPR Unload utility continues processing and the unload data set is produced. User response: Check the HDAM RAPCHECK Incorrect RAP Chain report. It is recommended that the unload records are sorted before reloading. |If the HPSU3203I message is shown and the root key field |is compressed, add the control statement DECOMPRESS=YES |and rerun the job. ---------------------------------------------------------------
APAR Information
APAR number
PI52760
Reported component name
IMS DB REORG EX
Reported component ID
5655F7400
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2015-11-18
Closed date
2016-01-26
Last modified date
2016-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI34741
Modules/Macros
HPSCOPT HPSCOPTS HPSGOPTR HPSGOPTU HPSGTM00
| SC19113704 |
Fix information
Fixed component name
IMS DB REORG EX
Fixed component ID
5655F7400
Applicable component levels
R410 PSY UI34741
UP16/01/28 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.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023