A fix is available
APAR status
Closed as program error.
Error description
In some cases, the performance of IMS High Performance Prefix Resolution for OSAM databases can be slow.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Prefix Resolution * * for z/OS Version 3 Release 1 users * * (FMID=H1IP310). * **************************************************************** * PROBLEM DESCRIPTION: In some cases, the performance of IMS * * High Performance Prefix Resolution for * * OSAM databases can be slow. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** When running IMS High Performance Prefix Resolution for OSAM databases in which most database records have logical segments, performance of IMS High Performance Prefix Resolution can be slow in some cases. ======================== = ACTION and UCLIN = ======================== Before applying this APAR, read what follows to determine any action that may need to be taken: Case 1. Neither an SMPCSI data set nor any of the distribution and target libraries of High Performance Prefix Resolution V3 is shared with another product. In this case, allocate new target and distribution libraries for the new macro and the new sample JCL. Then, add DDDEF entries for these libraries. You can use the sample JCL and the sample UCLIN included in this APAR to allocate these libraries and to add DDDEF entries. Case 2. A target zone and a distribution zone of High Performance Prefix Resolution V3 are shared with other products. In this case, check the following DDDEF entries in the target and distribution zone for High Performance Prefix Resolution V3 by using the LIST DDDEF command or the SMP/E Dialog: Entries in Target Zone: - SHPSMAC0 - SHPSSAMP - AHPSMAC0 - AHPSSAMP Entries in Distribution Zone: - AHPSMAC0 - AHPSSAMP If all of these DDDEF entries exist, no action is necessary. If any one of these DDDEF entries does not exist, add all DDDEF entries that are missing. The libraries specified in the added DDDEF entries must be allocated. You can use the sample JCL and the sample UCLIN included in this APAR to allocate these libraries and to add DDDEF entries. Case 3. All target libraries and distribution libraries for High Performance Prefix Resolution V3 are shared with other SMPCSIs. If libraries for macros and samples are already defined by other products and High Performance Prefix Resolution V3 will share them, add DDDEF entries (SHPSMAC0, SHPSSAMP, AHPSMAC0, AHPSSAMP) to a SMPCSI of High Performance Prefix Resolution V3. You can use the sample UCLIN included in this APAR to add DDDEF entries to SMPCSI for High Performance Prefix Resolution V3. If the target and distribution libraries for macros and samples have not been allocated, you can use the sample JCL included in this APAR to allocate these libraries. <<< A sample JCL to allocate libraries >>> //SHPSMAC0 DD DISP=(NEW,CATLG,DELETE), // DSNAME=$hpprhlq.SHPSMAC0, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volsert //SHPSSAMP DD DISP=(NEW,CATLG,DELETE), // DSNAME=$hpprhlq.SHPSSAMP, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volsert //AHPSMAC0 DD DISP=(NEW,CATLG,DELETE), // DSNAME=$hpprhlq.AHPSMAC0, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volserd //AHPSSAMP DD DISP=(NEW,CATLG,DELETE), // DSNAME=$hpprhlq.AHPSSAMP, // DCB=(RECFM=FB,LRECL=80,BLKSIZE=0), // SPACE=(TRK,(70,25,60)), // UNIT=SYSALLDA, // VOL=SER=$volserd <<< A sample UCLIN of target and distribution zone >>> SET BDY($tzone). UCLIN . ADD DDDEF(SHPSMAC0) UNIT(SYSALLDA) DATASET($hpprhlq.SHPSMAC0) WAITFORDSN SHR. ADD DDDEF(SHPSSAMP) UNIT(SYSALLDA) DATASET($hpprhlq.SHPSSAMP) WAITFORDSN SHR. ADD DDDEF(AHPSMAC0) UNIT(SYSALLDA) DATASET($hpprhlq.AHPSMAC0) WAITFORDSN SHR. ADD DDDEF(AHPSSAMP) UNIT(SYSALLDA) DATASET($hpprhlq.AHPSSAMP) WAITFORDSN SHR. ENDUCL . SET BDY($dzone). UCLIN . ADD DDDEF(AHPSMAC0) UNIT(SYSALLDA) DATASET($hpprhlq.AHPSMAC0) WAITFORDSN SHR. ADD DDDEF(AHPSSAMP) UNIT(SYSALLDA) DATASET($hpprhlq.AHPSSAMP) WAITFORDSN SHR. ENDUCL .
Problem conclusion
IMS High Performance Prefix Resolution has been modified to support IMS DL/I buffer handler to update OSAM data sets. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Prefix Resolution for z/OS Version 3 Release 1 User's Guide (Document Number: SC18-9230-00) should be changed as follows. ================================================================ 2.0 Chapter 2. Running High Performance Prefix Resolution 2.2 Concurrent Prefix Update 2.2.3.2 DD Statements The DD statements that are listed in Table 3 are valid for Concurrent Prefix Update. : +----------------+--------+-------------------+-------------+ |DDNAME |Use |Format |Need | +----------------+--------+-------------------+-------------+ ||JOBLIB/STEPLIB |Input | |Required(4) | +----------------+--------+-------------------+-------------+ ||DFSRESLB |Input | |Optional | +----------------+--------+-------------------+-------------+ | : | +----------------+--------+-------------------+-------------+ ||DFSVSAMP |Input |LRECL=80 |Optional(5) | +----------------+--------+-------------------+-------------+ |Notes: | | : | ||(4) If a library concatenated to JOBLIB or STEPLIB is not | || APF-authorized, the DFSRESLB DD statement is required | || when running Concurrent Prefix Update and Stand-Alone | || Prefix Update with HPPRBH=NO. | || | ||(5) The DFSVSAMP DD statement is required when running | || Concurrent Prefix Update and Stand-Alone Prefix Update | || with HPPRBH=NO. | +-----------------------------------------------------------+ 2.3 Stand-Alone Prefix Update 2.3.3.2 DD Statements The DD statements listed in Table 5 are valid for Stand-Alone Prefix Update. : +----------------+--------+-------------------+-------------+ |DDNAME |Use |Format |Need | +----------------+--------+-------------------+-------------+ ||JOBLIB/STEPLIB |Input | |Required(3) | +----------------+--------+-------------------+-------------+ ||DFSRESLB |Input | |Optional | +----------------+--------+-------------------+-------------+ | : | +----------------+--------+-------------------+-------------+ ||DFSVSAMP |Input |LRECL=80 |Optional(4) | +----------------+--------+-------------------+-------------+ |Notes: | | : | ||(3) If a library concatenated to JOBLIB or STEPLIB is not | || APF-authorized, the DFSRESLB DD statement is required | || when running Concurrent Prefix Update and Stand-Alone | || Prefix Update with HPPRBH=NO. | || | ||(4) The DFSVSAMP DD statement is required when running | || Concurrent Prefix Update and Stand-Alone Prefix Update | || with HPPRBH=NO. | +-----------------------------------------------------------+ 2.4 Description of DD Statements The following DD statements are used. : JOBLIB DD or STEPLIB DD Points to the IMS.SDFSRESL, which contains the IMS nucleus and required action modules and to the High Performance Prefix Resolution load library, which contains the FABYMAIN main load module. | When you run Concurrent Prefix Update and Stand-Alone Prefix | Update with HPPRBH=NO: | -the IMS.SDFSRESL must be concatenated behind the DD | statement containing the High Performance Prefix Resolution | load library. | -and if JOBLIB or STEPLIB is not authorized by having | unauthorized libraries concatenated to IMS.SDFSRESL, the | DFSRESLB DD statement must be included. One of these DD statements is required. |DFSRESLB DD | Points to an authorized library that contains the IMS SVC | modules. | | This DD statement is optional. : |DFSVSAMP DD | Describes the data set that contains the buffer information | required by the DL/I buffer handler. For additional | information on control statement format and the buffer pool | structure, see IMS Installation Volume 2: System Definition | and Tailoring. | | This DD statement is required when running Concurrent Prefix | Update and Stand-Alone Prefix Update with HPPRBH=NO. <<The following new chapter is added.>> |4.0 Site Default Option |You can change the default value for a option by creating a |site default table (FABYGBT0) for your site. | |4.1 Setting a Site Default Table |You can create a site default table (FABYGBT0) to change the |default value of a option. If High Performance Prefix |Resolution finds FABYGBT0 in the execution libraries, the value |specified in the site default table is applied to the job. | |To set the table, do as follows: | | 1. To generate a site default table, modify the FABYTGEN | macro statements in the FABYGDFT sample JCL. | 2. Submit the job to assemble and link-edit FABYGBT0. | 3. Concatenate the load module library in which FABYGBT0 | exists to STEPLIB. | |4.2 Generating a Site Default Table |To generate a site default table (FABYGBT0), you can use the |FABYGDFT sample JCL. FABYGDFT is provided as a member of the |HPS.SHPSSAMP library. It assembles the user-specified FABYTGEN |macro statements and link-edits the output of the assembly |into the HPS.SHPSLMD0 load module library to build FABYGBT0. | |The default value for the following option can be changed |by creating FABYGBT0: | | oHPPRBH | Specifies whether High Performance Prefix Resolution | uses HPPR buffer handler to update OSAM data sets. | The system default value for this parameter is YES. | | _YES_ | >>__HPPRBH=__|_NO _|_____________________________________>< | | YES or Y | High Performance Prefix Resolution uses HPPR buffer | handler to update OSAM data sets. | | NO or N | High Performance Prefix Resolution uses IMS DL/I buffer | handler to update OSAM data sets. | ================================================================ Appendix C. Messages and Codes C.2 Messages <<The following messages are added.>> | FABY120A NAME/TOKEN SERVICE XXXXXXXX FAILURE. RC=rr | | Explanation: An attempt to use the name/token service | XXXXXXXX failed. The return code from the service was rr. | | System Action: Processing ends with a return code of 8. | | Programmer Response: Call the IBM Software Support. | FABY121A BUFFER HANDLER RETURNED AN ERROR CODE OF cc | | Explanation: The program received a nonzero return code from | the buffer handler. The meaning of this return code can be | found in the PST DSECT in the field labeled PSTRTCDE. | See the buffer handler return codes in IMS Messages and | Codes, Volume 1. | | System Action: Processing ends with a return code of 8. | | Programmer Response: Correct any errors noted by the return | code, and rerun the job. | FABY122A INTERNAL ERROR IN BLOCK BUILDER: FUNC=xxxxxxxx | RSN=rr | | Explanation: There was an internal error while the control | blocks were being built. | | System Action: Processing ends with a return code of 8. | | Programmer Response: Call the IBM Software Support.
Temporary fix
Comments
APAR Information
APAR number
PQ99976
Reported component name
IMSPREFIXRESOLU
Reported component ID
5655I1500
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-01-25
Closed date
2005-02-03
Last modified date
2005-03-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
FABYALLC FABYBRL0 FABYBRL7 FABYBRL8 FABYBRL9 FABYDDEF FABYDSCT FABYGDFT FABYGOPT FABYINI0 FABYIPR0 FABYISI0 FABYLINK FABYMAIN FABYPI00 FABYRGP0 FABYRGP7 FABYRGP8 FABYRGP9 FABYTGEN FABYTRM0 FABYUBD0 FABYUBH0 FABYUDY0 FABYUOS0 FABYUP00 FABYURGP FABYURG0 FABYURI0 FABYURP0 FABYUTC0 FABYUVS0 FABYWMT FABYWM0 FABYWM1 FABY0040 HPSGTYD H1IP310J
Fix information
Fixed component name
IMSPREFIXRESOLU
Fixed component ID
5655I1500
Applicable component levels
R310 PSY UK00233
UP05/02/25 P F502
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":"SSCX89H","label":"IMS HP Prefix Resolution"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310"}]
Document Information
Modified date:
21 October 2020