A fix is available
APAR status
Closed as new function.
Error description
Integrity Checker support of RDE creation and verification for HALDB by LICON utility This APAR enables Integrity Checker to create RDE of HALDB and verify HALDB using LICON utility, INIT.DB command and VERIFY.DB command.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: IMS Library Integrity Utilities for z/OS, * * Version 2 Release 1 (FMID=H27P210) users who * * use the Integrity Checker utility. * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables the Integrity Checker * * utility to create and verify an RDE for * * a HALDB partition by the LICON utility. * * This APAR addresses RFE Id: 32314. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables the Integrity Checker utility to create and verify an RDE for a HALDB partition by the LICON utility using the following control statements: - INIT.DB - VERIFY.DB - The LICON utility displayed incorrect value as the "PRIME DD NAME" in the listing of RDE report for a HALDB RDE. This APAR addresses RFE Id: 32314.
Problem conclusion
Temporary fix
Comments
The following modules and macros have been modified. FABLARCA FABLASCD FABLBA0A FABLBA0B FABLBA0C FABLBA0D FABLBA00 FABLBA09 FABLBD0A FABLBD0B FABLBD0C FABLBD0D FABLBD00 FABLBD09 FABLIDBA FABLIDBB FABLIDBC FABLIDBD FABLIDB0 FABLIDB9 FABLIL10 FABLIU00 FABLRCKA FABLRCKB FABLRCKC FABLRCKD FABLRCK0 FABLRCK9 FABUARCA ======================== = DOCUMENTATION CHANGE = ======================== IMS Library Integrity Utilities for z/OS Version 2 Release 1 User's Guide (Document Number: SC19-2479-01) should be changed as follows. ================================================================ -------------------------------------------------------------- 3.0 Integrity Checker utility 3.2 Integrity Checker key concepts 3.2.1 What is an RDE? -------------------------------------------------------------- The following description is modified: |You can create an RDE for a DEDB area, a non-HALDB |full-function database or a HALDB partition by using either the |LICON utility batch job or by the first access to the DEDB |area, the non-HALDB full-function database or HALDB partition by IMS after Integrity Checker is installed. IBM recommends using the LICON utility batch job to avoid a decline in the performance that can occur when an RDE is created during IMS online processing. The following description is deleted: |For HALDBs, you can create an RDE for a HALDB partition by the |first access to the HALDB partition by IMS. In many cases, an |RDE for a HALDB partition will be created when you run the |HALDB Partition Data Set Initialization utility or the Database |Prereorganization utility. -------------------------------------------------------------- 3.3 Restrictions and requirements for Integrity Checker -------------------------------------------------------------- The following description is deleted: |LICON utility restrictions for HALDBs | |For HALDBs, Integrity Checker does not support the following |commands of the LICON utility: | |- INIT.DB |- VERIFY.DB -------------------------------------------------------------- 3.8 LICON utility reference 3.8.3 INIT.DB command -------------------------------------------------------------- The following description is modified: Parameters DBD(pattern) Specifies the database for which you want to create an RDE. You can specify either of the following patterns: | - A specific database name or a specific HALDB Partition name - A partially specified database name pattern--for example, DH41*, where * means ALL The following description is deleted: | If a HALDB partition name is specified, this command fails | with message FABL0451E. -------------------------------------------------------------- 3.8.11 VERIFY.DB command -------------------------------------------------------------- The following description is modified: Parameters DBD(pattern) Specifies the database for which you want to verify the DBD/ACBs. You can specify either of the following patterns: | - A specific database name or a specific HALDB Partition name - A partially specified database name pattern--for example, DH41*, where * means ALL The following description is deleted: | If a HALDB partition name is specified, this command fails | with message FABL0451E. -------------------------------------------------------------- 13.0 Troubleshooting 13.4 IMS Library Integrity Utilities messages 13.4.1 FABL messages 13.4.1.103 FABL0442E -------------------------------------------------------------- The following description is modified: Explanation: The INIT.DB command was requested but failed. The current RDE |for non-HALDB full-function database dddddddd, HALDB partition |dddddddd or area aaaaaaaa of database dddddddd was not replaced, because no REPLACE option was specified in the INIT.DB command control statement. If you already have the current RDE for this database or area, and are going to create one with the INIT.DB command, you need to specify the REPLACE option. -------------------------------------------------------------- 13.4.1.105 FABL0444E -------------------------------------------------------------- The following description is modified: Explanation: The VERIFY.DB command detects data mismatch between the RDE and the specified DBD (or ACB). The detail of the mismatch is |explained by the messages that precede message FABL0204E for |non-HALDB full-function database dddddddd, HALDB partition |dddddddd or area aaaaaaaa of database dddddddd. -------------------------------------------------------------- 13.4.1.106 FABL0447E -------------------------------------------------------------- The following description is modified: Explanation: The INIT.DB command failed to create the RDE for non-HALDB |full-function database dddddddd, HALDB partition dddddddd or area aaaaaaaa of database dddddddd. -------------------------------------------------------------- 13.4.1.109 FABL0450E -------------------------------------------------------------- The following description is modified: Explanation: No ACB or DBD member matched the specified database name |pattern. Thus no ACB or DBD member is processed for database |pattern or HALDB partition pattern. -------------------------------------------------------------- 13.4.1.110 FABL0451E -------------------------------------------------------------- The following description is modified: Explanation: |The ACB or DBD member is not found for the specified |database dddddddd or HALDB partition dddddddd. -------------------------------------------------------------- 13.4.1.112 FABL0453I -------------------------------------------------------------- The following description is deleted: |HALDB DBD | HALDB DBD is not supported. The following description is added: |HALDB WITHOUT RECON | HALDB DBD requires RECONx DD statement or DFSMDA dynamic | allocation members but not specified.
APAR Information
APAR number
PM88667
Reported component name
IMS LIBR INTEG
Reported component ID
5655I4200
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-05-08
Closed date
2013-05-14
Last modified date
2013-06-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK94301
Modules/Macros
FABLARCA FABLBA0A FABLBA0B FABLBA0C FABLBA0D FABLBA09 FABLBD0A FABLBD0B FABLBD0C FABLBD0D FABLBD09 FABLIDBA FABLIDBB FABLIDBC FABLIDBD FABLIDB9 FABLIL10 FABLIU00 FABLRCKA FABLRCKB FABLRCKC FABLRCKD FABLRCK9
| SC19247901 |
Fix information
Fixed component name
IMS LIBR INTEG
Fixed component ID
5655I4200
Applicable component levels
R210 PSY UK94301
UP13/05/17 P F305
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89N","label":"IMS Library Integrity Utilities"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0"}]
Document Information
Modified date:
14 December 2020