A fix is available
APAR status
Closed as new function.
Error description
Provide an option to create a WF1 when reloading a HALDB.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM IMS High Performance Load * * for z/OS Version 2 Release 1 (FMID=H1IM210). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables HP Load to create * * work files for rebuilding PSINDEX * * without scanning HALDB. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables HP Load to create work files for rebuilding PSINDEX database. The work files are named WFP data sets, and they are used as input of IMS Index Builder (FMID=H22O310) to rebuild PSINDEX without scanning database. WFP data set will be created for each partition of HALDB when WFHPLQ= is specified in the FRRIN DD statement. APAR PM64823 is required for IMS Index Builder to use WFP data sets as input.
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IMS High Performance Load for z/OS Version 2 Release 1 User's Guide SC18-9222-04 ( SC18922204 ) should be changed as follows: ================================================================ | 2.3.3 Example 3: Create work data sets for PSINDEX | | HP Load can create work data sets that is used in rebuilding | PSINDEX without scanning database. The work data sets are | named WFP data sets, and they are used as input of IMS Index | Builder. | WFP data set will be created for each partition of HALDB when | WFPHLQ= is specified in the FRRIN DD statement. | For example, if you specify WFPHLQ=IMSTOOLS.WORK.HMPORDP1, | and the partition names are PART001 and PART002, the | following WFP data sets will be created: | IMSTOOLS.WORK.HMPORDP1.PART001.WFP | IMSTOOLS.WORK.HMPORDP1.PART002.WFP | | //RELOAD EXEC PGM=DFSRRC00, | // PARM='ULU,DFSURGL0,HMPORDP1,,,,,,,,,,,Y,N' | //STEPLIB DD DISP=SHR,DSN=HPS.SHPSLMD0 | // DD DISP=SHR,DSN=IMSESA.RESLIB | //IMS DD DISP=SHR,DSN=IMSESA.DBDLIB | //IMSDALIB DD DISP=SHR,DSN=IMSESA.MDALIB | //DFSUINPT DD DISP=(OLD,PASS),DSN=DBSAMP01.UNLOAD | //SYSPRINT DD SYSOUT=A | //SYSUDUMP DD SYSOUT=A | //DFSVSAMP DD * | 4096,10 | //FRRIN DD * | WFPHLQ=IMSTOOLS.WORK.HMPORDP1 | WFPVOLCNT=5 | PARTINIT=YES,UNLOAD | | Figure xx. Sample JCL to create WFP data sets | |Notes: | 1. If HALDB may have empty partitions, the unloaded data set | must be created by IMS HP Unload with the CHECKREC=YES | option to create WFP data set for empty partitions. | 2. The DD statements for the WFP data sets are not needed. | 3. The 'WFPVOLCNT=5' statement is optional. Specify an | appropriate value for your volume capacity. | 4. Specify the same HLQ value for WFPHLQ statement in the | IIUIN DD of IMS Index Builder. 2.2 Operating instructions 2.2.2 JCL requirements Table 1.DD statements and record format for IMS High Performance Load +--------+------+-------------------+-----------------------+ |DDNAME |Use |Format |Need | +--------+------+-------------------+-----------------------+ | : | : | : | : | |+--------+------+-------------------+-----------------------+ ||HPSRPnnn|Output|RECFM=FB,LRECL=7250|Optional*5 | |+--------+------+-------------------+-----------------------+ | : | : | : | : | +--------+------+-------------------+-----------------------+ | Notes: | | : | || (*5): This Data set is required only if the WFPHLQ= | || control statement is specified. | +-----------------------------------------------------------+ : | HPSRPnnn DD | Describes the work data set named as WFP data set to be | created during reload per partition for HALDB, nnn shows | sequence number. nnn is a 3-digit decimal number from 001 | to 999, T00, and T01.T00 means 1000, T01 means 1001. | The data set must reside on a direct-access device. | The data set is used as input to the following utilities to | rebuild partition secondary index(PSINDEX). | - IMS Index builder | The data set is necessary if all of the following conditions | are met: | - The database has a partition secondary index(PSINDEX). | - You want to avoid scanning database during index rebuilding | by index builder. | If HALDB may have empty partitions, the unloaded data set | must be created by IMS HP Unload with the CHECKREC=YES option | to create WFP data set for empty partitions. | Naming convention for WFP data set names | You must specify the prefix of the names of WFP data sets by | using WFPHLQ= control statement. Each partitoin name and WFP | must follow the HLQ as follows: | WFPHLQ : IMSTOOLS.WORK.HMPORDP1 | Partition name : PART001,PART002 | WFP data set names : IMSTOOLS.WORK.HMPORDP1.PART001,WFP | IMSTOOLS.WORK.HMPORDP1.PART002.WFP | If you specify HPSRPnnn DD statements for each WFP data set, | the data set name must follow the naming convention. | If the WFP data set already exists when HP Load allocates | it dynamically, HP Load deletes the old data set and creates | a new one with the same data set name. : Table 2. IMS HP Load defaults for the data set access metho buffer +--------+----+------+-----------------+---------------------+ |DDNAME |Use |Access|Default parameter|Storage used | +--------+----+------+-----------------+---------------------+ | : | : | : | : | : | |+--------+----+------+-----------------+---------------------+ ||HPSRPnnn|Out |QSAM |DCB=(BUFNO=105) |private high | |+--------+----+------+-----------------+---------------------+ | : | : | : | : | : | +--------+----+------+-----------------+---------------------+ : 2.2.3 Control statements 2.2.3.2 Overview of IMS HP Load control statements : | 2.2.3.xx WFPHLQ control statement | Specifies the high level qualifiers of WFP data set. This | control statement is only required if you need to create WFP | data set, and does not have a default. _____________________________________________________________ | | | | |>>__WFPHLQ=_ _hlq ______ ________________________________>< | | |____________________________________________________________| | hlq | Specify the data set name for WFP data set. The name is a | 1-32 alphanumeric or national characters ($,#,@). | 2.2.3.xx WFPSPACE control statement | Specifies the space parameter for WFP data set that is | dynamically allocated. This specification is valid only when | WFPHLQ is specified. | If you do not explicitly specify this control statement, HP | Load estimates the size on the basis of the allocation size | of partition data set. | | This control statement is optional and does not have a | default. | _____________________________________________________________ | | | | | >>__WFPSPACE=_ _CYL_ _,primary_alloc,secondary_alloc____>< | | | |_TRK_| | | |____________________________________________________________| | CYL | Specifies that space is to be allocated in cylinders. | TRK | Specifies that space is to be allocated in tracks. | primary_alloc | Specifies a primary space quantity. | It must be a left-justified decimal number from 1 to 9999. | secondary_alloc | Specifies a secondary space quantity. | It must be a left-justified decimal number from 1 to 9999. | | 2.2.3.xx WFPUNIT control statement | Specifies a device for WFP data sets that is dynamically | allocated. This specification is valid only when WFPHLQ | controlstatement is specified. | This control statement is optional. If you do not explicitly | specify this control statement, WFPUNIT=SYSALLDA is used. | _____________________________________________________________ | | | | | >>__WFPUNIT=__|_unitname__|_____________________________>< | | |____________________________________________________________| | unitname | Specifies a device type or a device group name for WFP | data set. | 2.2.3.xx WFPVOL control statement | Specifies one or more volume names for WFP data sets that is | dynamically allocated. This specification is valid only when | WFPHLQ control statement is specified. | This control statement is optional and does not have a | default. | ____________________________________________________________ | | | | | <_,_____________ | | | >>__WFPVOL=_ _(___ _volume_name_ _|__)_ ________________>< | | | | |_*___________| | | | | |_ _volume_name_ __________| | | | |_*___________| | | |____________________________________________________________| | volume_name | Specifies volume names. You can indicate nonspecific volumes | by designating an asterisk (*). | Two or more volume names must be separated by commas and | enclosed in parentheses. For example, WFPVOL=(VOLSR1,VOLSR2) | You can specify up to 5 volume names. | 2.2.3.xx WFPVOLCNT control statement | Specifies volume count for WFP data sets that is dynamically | allocated. This specification is valid only when WFPHLQ | control statement is specified. | This control statement is optional and does not have a | default. ____________________________________________________________ | | | | | >>__WFPVOLCNT=___nnn____________________________________>< | | |____________________________________________________________| | nnn | Specifies the maximum number of volumes that WFP data sets | requires. The volume count is a decimal number from 1 | through 59 for a DASD data set 7.2.3 Messages 7.2.3.1 IMS HP Load messages | HPSR0045I WFPHLQ IS IGNORED BECAUSE PSINDEX IS NOT DEFINED | Explanation: The keyword WFPHLQ statement is ignored because | PSINDEX is not defined in the database to be reloaded. | System Action: Processing continues; the parameter was | ignored. | Programmer Response: None | HPSR3650E QSAM PUT ERROR OCCURRED FOR WFP DATASET: dataset | Explanation: QSAM put error occurred for WFP dataset : | dataset | System Action: HP Load issues a user 3650 abend and a dump. | Programmer Response: Correct the error and rerun the job. | Problem Determination: Register 3 points to the address of | the status indicators. Check the status indicators exception | for the error as described in the DFSMSdfp Diagnosis. | HPSR3779E WFP DATA SET (DDNAME=ddname) FOR partname IS NOT | EMPTY | Explanation: The data set assigned to the DD name ddname is | not empty. The ddname is one of the DD names that are used | to specify the WFP data set or data sets for the partition | indicated by the partname. | System Action: IMS High Performance Load issues a user 3779 | abend and a dump. | Programmer Response: Check if the correct data set is | specified for the DD name. | HPSR3780E DUMMY SPECIFIED FOR ddname DD | Explanation: The DUMMY parameter is specified in the DD name | ddname. The DUMMY parameter is not allowed for the DD. | System Action: IMS High Performance Load issues a user 3780 | abend and a dump. | Programmer Response: Correct the error and rerun the job. | Problem Determination: Make sure that a DD statement is | present for the ddname indicated, and that it properly | identifies the correct data set. | HPSR3781E WFP DATA SET NAME (DDNAME=ddname) FOR partname IS | INCORRECT | Explanation: The data set name assigned to the DD name | ddname is incorrect. WFP data set name need to follow the | naming convention. | System Action: IMS High Performance Load issues a user 3781 | abend and a dump. | Programmer Response: Check if the correct data set name is | specified for the DD statement | HPSR3782E LOCATE FAILED(R15=register15,R0=register0), | DSN=dsname | Explanation: An error occurred during the process of the | LOCATE macro for a data set name dsname. register15 and | register0 show the returned information from the LOCATE | macro. | System Action: IMS High Performance Load issues a user 3782 | abend and a dump. | User Response: Correct the error and rerun the job. If the | error persists, contact IBM Software Support. | Programmer Response: To interpret the returned information | from the LOCATE macro, refer to z/OS DFSMS Managing Catalogs. | HPSR3778E SEGMENT LENGTH IN PSINDEX DB (DBDNAME=dbdname) | IS TOO LONG. | Explanation: IMS High Performance Load can not create | WFP data set, because the defined length in PSINDEX DB is | too long. | System Action: IMS High Performance Load issues a user 3778 | abend and a dump. | Programmer Response: Remove the WFPHLQ control statement or | reduce the sum of the segment length and the root key | length of the PSINDEX to 7189 or less.
APAR Information
APAR number
PM62216
Reported component name
IMS HIGH PERF L
Reported component ID
5655E0700
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function
Submitted date
2012-04-10
Closed date
2012-06-26
Last modified date
2012-07-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK79846
Modules/Macros
FABFLINK HPSRFCA0 HPSRHALA HPSRHALB HPSRHAL2 HPSRHAL7 HPSRHAL8 HPSRHAL9 HPSRHDBA HPSRHDBB HPSRHDB2 HPSRHDB7 HPSRHDB8 HPSRHDB9 HPSRHRPA HPSRHRPB HPSRHRP2 HPSRHRP7 HPSRHRP8 HPSRHRP9 HPSRHTBL HPSRIDA0 HPSRMSGT HPSRRLDA HPSRRLDB HPSRRLD2 HPSRRLD7 HPSRRLD8 HPSRRLD9 HPSRRRI0 HPSRRRI9 HPSRSTMT HPSRWFP0 H1IM210J
| SC18922204 |
Fix information
Fixed component name
IMS HIGH PERF L
Fixed component ID
5655E0700
Applicable component levels
R210 PSY UK79846
UP12/07/02 P F206
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":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89F","label":"IMS HP Load"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"2.1.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 July 2012