A fix is available
APAR status
Closed as program error.
Error description
After applying a Db2 HPU APAR, any attempt to run INZUTILB fails after the following system message is issued: CSV031I LIBRARY ACCESS FAILED FOR MODULE INZUTILB, RETURN CODE 20, REASON CODE 26130003 It occurs when all the following conditions are fulfilled: - the IEWBODEF module that specifies the default binder options specifies COMPAT(LKED) or COMPAT(MIN) - the binder used is affected by OA66955 - SMP/E does not support COMPAT=PM5 - the JCLIN SMP/E item for Db2 HPU specifies COMPAT=PM5 The latter condition applies: - with Db2 HPU 5.1, if the fix for PH44349 is applied - with Db2 HPU 5.2, regardless of the maintenance level Other non-identified symptoms might result from the use of COMPAT=PM5 in the JCLIN described above.
Local fix
If you face the precise symptom indicated above, apply either of the solutions S0, S1 or S2 described below. If you face a similar issue affecting any of the INZUTILB, INZUTIB1, INZUTIB2, INZUTILC, INZSTI01 or INZTOOLS modules, consider applying either of the solutions S0 or S2. Otherwise (issue related to a different Db2 HPU load module), contact your IBM support to get a link-edit job to solve the issue. S0) Apply the fix for OA66955 S1) Modify the INZALIAS customization job consider applying the solution S2. to add COMPAT=PM5 to the PARM list of the ALIAS step as follows: //ALIAS EXEC PGM=IEWL,REGION=20M, // PARM='AC=1,REUS=REFR,STORENX=NEVER,EXTATTR=APF,RMODE=SPLIT, COMPAT= // PM5' Then, submit the modified job. S2) Customize the following JCL by replacing the db2_hpu_hlq by the high level qualifier of your Db2 HPU libraries: //HINZ510 JOB CLASS=A,NOTIFY=&SYSUID,MSGCLASS=H, // TIME=(3,59),MSGLEVEL=(1,1) //CALLLIBS=YES // //RELINK1 EXEC PGM=LINKEDIT, // PARM='LIST,LET,XREF,COMPAT=PM4,REUS=REFR,AC=1, // AMODE=31,RMODE=SPLIT' //SYSLIB DD DISP=SHR,DSN=CBC.SCCNOBJ //AINZLINK DD DISP=SHR,DSN=db2_hpu_hlq.AINZLINK //SYSLMOD DD DISP=SHR,DSN=db2_hpu_hlq.SINZLINK //SYSPRINT DD SYSOUT=* //SYSLIN DD * INCLUDE AINZLINK(INZUTIB1) ENTRY INZUTILB NAME INZUTIB1(R) INCLUDE AINZLINK(INZUTIB2) ENTRY INZUTILB NAME INZUTIB2(R) INCLUDE AINZLINK(INZUTILC) ENTRY INZUTILB NAME INZUTILC(R) INCLUDE AINZLINK(INZSTI01) ENTRY INZSTI01 NAME INZSTI01(R) INCLUDE AINZLINK(INZTOOLS) ENTRY INZUTILB NAME INZTOOLS(R) /* Then submit the customized JCL. Then submit the INZALIAS Db2 HPU customization job.
Problem summary
**************************************************************** * USERS AFFECTED: Users of Db2 High Performance Unload for * * z/OS * **************************************************************** * PROBLEM DESCRIPTION: After applying a Db2 HPU APAR, any * * attempt to run INZUTILB fails after * * the following system message is issued: * * CSV031I LIBRARY ACCESS FAILED FOR * * MODULE INZUTILB, RETURN CODE 20, * * REASON CODE 26130003 * * * * It occurs when all the following * * conditions are fulfilled: * * - the IEWBODEF module that specifies * * the default binder options specifies * * COMPAT(LKED) or COMPAT(MIN) * * - the binder used is affected by * * OA66955 * * - SMP/E does not support COMPAT=PM5 * * - the JCLIN SMP/E item for Db2 HPU * * specifies COMPAT=PM5 * * * * The latter condition applies: * * - with Db2 HPU 5.1, if the fix for * * PH44349 is applied * * - with Db2 HPU 5.2, regardless of the * * maintenance level * * * * Other non-identified symptoms might * * result from the use of COMPAT=PM5 in * * the JCLIN described above. * * * * Local fix: If you face the precise * * symptom indicated above, apply either * * of the solutions S0, S1 or S2 * * described below. If you face a similar * * issue affecting any of the INZUTILB, * * INZUTIB1, INZUTIB2, INZUTILC, * * INZSTI01 or INZTOOLS modules, consider * * applying either of the solutions S0 or * * S2. Otherwise (issue related to a * * different Db2 HPU load module), * * contact your IBM support to get a * * link-edit job to solve the issue. * * * * S0) Apply the fix for OA66955 * * S1) Modify the INZALIAS customization * * job consider applying the solution * * S2. to add COMPAT=PM5 to the PARM * * list of the ALIAS step as follows: * * //ALIAS EXEC PGM=IEWL,REGION=20M, * * // PARM='AC=1,REUS=REFR,STORENX= * * NEVER,EXTATTR=APF,RMODE=SPLIT, * * COMPAT= * * // PM5' * * Then, submit the modified job. * * * * S2) Customize the following JCL by * * replacing the db2_hpu_hlq by the * * high level qualifier of your Db2 * * HPU libraries: * * //HINZ510 JOB CLASS=A,NOTIFY=&SYSUID, * * MSGCLASS=H, * * // TIME=(3,59),MSGLEVEL=(1,1) * * //CALLLIBS=YES * * // * * //RELINK1 EXEC PGM=LINKEDIT, * * // PARM='LIST,LET,XREF, * * COMPAT=PM4,REUS=REFR, * * AC=1, * * // AMODE=31,RMODE=SPLIT' * * //SYSLIB DD DISP=SHR,DSN=CBC.SCCNOBJ * * //AINZLINK DD DISP=SHR, * * DSN=db2_hpu_hlq.AINZLINK * * //SYSLMOD DD DISP=SHR, * * DSN=db2_hpu_hlq.SINZLINK * * //SYSPRINT DD SYSOUT=* * * //SYSLIN DD * * * INCLUDE AINZLINK(INZUTIB1) * * ENTRY INZUTILB * * NAME INZUTIB1(R) * * INCLUDE AINZLINK(INZUTIB2) * * ENTRY INZUTILB * * NAME INZUTIB2(R) * * INCLUDE AINZLINK(INZUTILC) * * ENTRY INZUTILB * * NAME INZUTILC(R) * * INCLUDE AINZLINK(INZSTI01) * * ENTRY INZSTI01 * * NAME INZSTI01(R) * * INCLUDE AINZLINK(INZTOOLS) * * ENTRY INZUTILB * * NAME INZTOOLS(R) * * /* * * * * Then submit the customized JCL. * * Then submit the INZALIAS Db2 HPU * * customization job. * **************************************************************** * RECOMMENDATION: Apply the PTF * **************************************************************** CSV031I LIBRARY ACCESS FAILED FOR MODULE INZUTILB, RETURN CODE 20, REASON CODE 26130003 after maintenance application
Problem conclusion
Code has been changed to fix this problem
Temporary fix
Comments
APAR Information
APAR number
PH63057
Reported component name
DB2 HI PERF UNL
Reported component ID
5697F4400
Reported release
510
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2024-09-03
Closed date
2024-10-07
Last modified date
2024-11-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
INZHPUCL INZTVAR INZUTILK
Fix information
Fixed component name
DB2 HI PERF UNL
Fixed component ID
5697F4400
Applicable component levels
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":"SSZJXP","label":"DB2 Tools for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.1.0","Line of Business":{"code":"LOB10","label":"Data and AI"}}]
Document Information
Modified date:
03 November 2024