APAR status
Closed as new function.
Error description
For FPA to support LIU V2.1 integrity checker services.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of High Performance Fast Path * * Utilities Fast Path Advanced Tool Version 3 * * Release 2 (FMID: H31A320). * **************************************************************** * PROBLEM DESCRIPTION: FPA supports the Integrity Checker * * services of LIU V2. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides a new function to support Integrity Checker utility of IMS Library Integrity Utilities for z/OS, Version 2 (FMID: H27P210). APAR PK78962 is required for IMS Library Integrity Utilities .
Problem conclusion
Temporary fix
Comments
FPA calls the Integrity Checker API services to notify the completion of reorganization. The following functions of IMS HPFPU support the creation of an RDE in which the DMB information is registered: * FPA Reload * FPA Change * FPA Reorg This function is activated when the Global Option Module and LICON data set for Integrity Checker are found. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Version 3 Release 2 (SC18-9869-04). About DOCUMENTATION CHANGE in detail, See http://www-01.ibm.com/software/data/db2imstools/imstools-library .html#imshpfputils-lib 1.1.5 IMS HPFPU terminology A new abbreviation should be added: IMS Library Integrity Checker Utilities, IMS LIU Represents IBM IMS Library Integrity Checker Utilities for z/OS. A new section should be added after "1.1.7 Support for IMS Tools Knowledge Base" 1.1.x Support for IMS Library Integrity Utilities IMS Library Integrity Utilities is an IMS Tools product that aids you in managing data for the libraries, such as the DBD, PSB, and ACB libraries, that you use when referring to the IMS database. Some typical data management functions are: * To prevent the database corruption that the use of an incorrect member of a library can cause. * To check the consistency among each library. * To check, compare, change, generate, and maintain the members of a library. Integrity Checker prevents database corruption caused when IMS applications use incorrect IMS control blocks to get access to a database. It verifies that the DMB that IMS is using for access to the database is the same as the one that IMS used to load it. To do this, Integrity Checker compares the contents of the DMB that IMS is using against the registered DMB information (registered DMB entries are referred to as RDE), which is stored in the IMS LIU Integrity Control data set (hereafter called the LICON data set) before the verification. For DMB verification in both IMS batch and online environments, see IMS Library Integrity Utilities User's Guide. The following functions of IMS HPFPU support the creation of an RDE in which the DMB information is registered: * FPA Reload * FPA Change * FPA Reorg IMS LIU Integrity Checker requires IMS Version 9 or later. About additional 600K bytes extended storage is needed for IMS LIU Integrity Checker. Restrictions for using Integrity Checker Only the Reload, Change, and Reorg functions of FPA enable you to create an RDE for the reorganized area. Thus, for the following operations, you must manually create an RDE by using the LICON utility of IMS LIU: * When you reorganize a DEDB area to change DBD definition by using the functions of FPB, you need to create an RDE for the reorganized area before using the area. * When you extend the size of a DEDB area by using the OAE utility, you need to create an RDE for the extended area before using the area. 2.4.3 Running Reload 2.5.3 Running Change 2.6.4 Running Reorg Optional step is added to use the LIU Integrity Checker function of IMS Library Integrity Utilities. 3. Optional. If you want to create an RDE during the FPA process, follow these steps: 1. Activating Integrity Checker To create a new RDE by using LIU Integrity Checker, follow these steps. For details, see IMS Library Integrity Utilities User's Guide. 1. Install Integrity Checker. 2. Create global option modules. 3. Define the LICON data set. 4. Initialize the LICON data set. 5. Register DMB information. 6. Add DD statements to the DBRC and DLIBATCH procedures. 2. Request that FPA creates an RDE by using IMS LIU Integrity Checker. 1. If you are to use a specific LIU global option module, specify the name of the LIU global option module in the LIUGOPT parameter of the FPA control statement (HFPSYSIN). You also need to specify DBRC=YES in the FPA JCL because IMS LIU Integrity Checker requires that DBRC be active. 2. In the JOBLIB/STEPLIB DD statement, concatenate the following load module libraries. * The IMS LIU load module library * The LIU global option modules(LIU@INST and/or LIU@imsi) 4. Run the JCL. Related information: LIUGOPT Considerations for using Integrity Checker * When you change a DBD and reorganize DEDB areas by using FPA, Integrity Checker creates new RDEs for the reorganized areas. If reorganization completes successfully, but Integrity Checker fails to create new RDEs, you must take one of the following actions: * Rerun the reorganization job to create new RDEs for the reorganized areas. * If you decide not to rerun the reorganization job and to use the original areas, you must delete the RDEs that were created during the reorganization by using the DELETE.DB command of the LICON utility before using the areas. * If you decide not to rerun the reorganization job and to use the reorganized areas, you must create the RDEs whose creation failed during the reorganization by using the INIT.DB command of the LICON utility before using the areas. * When any of the following error conditions were detected in FPA or IMS LIU Integrity Checker processing, the RDEs are not created: * Either the return code is qual to or greater than 8 or the processing ends abnormally for one or more areas in the Reload, Change, or Reorg processing. * The return code is equal to or greater than 8 for the Analyze function even when Reload, Change, or Reorg function completes successfully. * LIU Integrity Checker fails to create an RDE. * The checksum value for the randomizer routine, and the checksum value for the Edit/Compression routine when the routine is defined in the DBD library, are stored in the RDE. You must make sure that the libraries that contain the correct routines are specified in one of the following DD statements: * Reload and Change functions * IMSRESLB * When IMSRESLB is not specified, JOBLIB/STEPLIB * Reorg function * JOBLIB/STEPLIB If the library that contains the Edit/Compression routine is not concatenated to JOBLIB/STEPLIB, FABL0212W message is issued by LIU Integrity Checker. 2.1.5 Software and hardware requirements of FPA Add the following statement Software IMS Fast Path Advanced Tool requires the following products for the optional functions: IBM IMS Library Integrity Checker Utilities for z/OS, Version 2 Release 1 (5655-U08) with PK78962 or later, if LIUGOPT=modulename is specified. 2.4.5 Utility control statements for Reload process, GLOBAL command keywords, Table 9. GLOBAL command keywords 2.5.5 Utility control statements for Change process, GLOBAL command keywords, Table 17. GLOBAL command keywords 2.6.6 Utility control statements for Reorg process, GLOBAL command keywords, Table 26. GLOBAL command keywords The following line should be added: Keyword | Purpose of the keyword -----------+-------------------------------------------------- LIUGOPT | Specifies an LIU global option module that is to be used by IMS LIU. 2.10.4 Commands, subcommands, and keywords 2.10.4.14 DBRC The following line should be updated. Related keywords: LIUGOPT 2.10.4.33 GLOBAL The following line should be added in the Related keywords and Syntax: . LIUGOPT +-------------------------------------------------------------+ | | |>>----GLOBAL----+---LIUGOPT=IMS_subsystem_level---+----->< | | | +-------------------------------------------------------------+ The following keyword should be added: 2.10.4.xx LIUGOPT Use the LIUGOPT keyword to specify an LIU global option module that is to be used by IMS LIU. LIU Integrity Checker requires that DBRC be active. This keyword is effective only when all of the following conditions are met: * IMS Version 9 or later. * IMS LIU load module library is concatenated to the JOBLIB/STEPLIB library. * DBRC=YES is specified in HFPSYSIN. LIUGOPT is an optional keyword for the GLOBAL command. Related keywords: DBRC Format: LIUGOPT=IMS_susubsystem_level IMS_susubsystem_level Specify the IMS subsystem ID with 4 characters. The LIU global option module named LIU@IMS_subsystem_level will be used by IMS LIU. Default: IMS subsystem ID (subsystem ID from DFSVC000) Site default support: Yes -------------------------------------------------------------- 7.1 Messages and codes of IMS HPFPU, 7.1.3.22 HFPU messages The following message should be added: -------------------------------------------------------------- HFPU0040I LIU INTEGRITY CHECKER INITIALIZED. Explanation: LIU Integrity Checker has been initialized to create the RDE of the DBD. System action: Processing continues. Programmer response: None. -------------------------------------------------------------- HFPU0041E LIU INTEGRITY CHECKER FUNC=INIT ERROR. RC=rc, RSN=yyyy, DBD=dbdname Explanation: FPA received an error issued by LIU Integrity Checker. rc is the return code and yyyy is the reason code returned from LIU Integrity Checker. For the detail of the error reason, see the FABLxxxxE message that was issued by LIU Integrity Checker. System action: The job ends with an return code of 8. Programmer response: See the explanation for the FABLxxxxE message in the IMS Library Integrity Utilities User's Guide. -------------------------------------------------------------- HFPU0042W LIU INTEGRITY CHECKER FUNC=CREATE ERROR. RC=rc, RSN=yyyy, DBD=dbdname Explanation: FPA received an error issued by LIU Integrity Checker. rc is the return code and yyyy is the reason code returned from LIU Integrity Checker. For the detail of the error reason, see the FABLxxxxE message that was issued by LIU Integrity Checker. This message indicates that FPA process completed successfully but the RDE of the DBD was not created. System action: The return code is set to 4 and processing continues. Programmer Response: See the explanation for the FABLxxxxE message in the IMS Library Integrity Utilities User's Guide. -------------------------------------------------------------- HFPU0043E ERROR OCCURRED WHILE PROCESSING LIU INTEGRITY CHECKER FUNC=INIT - GETMAIN FAIL. Explanation: GETMAIN macro to obtain space for internal blocks for FUNC=INIT of LIU Integrity Checker failed. System action: The job ends with a return code of 8. Programmer response: If the region size specified is too small, increase the REGION size in the JOB statement in the JCL, and rerun the utility. -------------------------------------------------------------- HFPU0044W ERROR OCCURRED WHILE PROCESSING LIU INTEGRITY CHECKER FUNC=CREATE - GETMAIN FAIL. Explanation: GETMAIN macro to obtain space for internal blocks for FUNC=CREATE of LIU Integrity Checker failed. This message indicates that FPA process completed successfully but the RDE of the DBD was not created. System action: The return code is set to 4 and processing continues. Programmer response: See the restrictions and considerations about using LIU Integrity Checker in the IMS Library Integrity Utilities User's Guide.
APAR Information
APAR number
PK79836
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2009-02-02
Closed date
2009-03-06
Last modified date
2009-04-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK44615
Modules/Macros
FABLAPID FABLAPIP FABLTAPI FABLURCK HFPCCCT0 HFPCCDT0 HFPCDEF0 HFPISTM0 HFPLINI0 HFPLMAN0 HFPMCCC0 HFPMESTA HFPMESTB HFPMESTM HFPMEST8 HFPMEST9 HFPMSYS0 HFPMTRM0 HFPUEST0 HFPULIU0 HFPUMVT0 HFPWMTU0 HFPZCCT HFPZMCT HFPZMVT H31A320J
SC18986904 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R320 PSY UK44615
UP09/03/07 P F903
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 April 2009