A fix is available
APAR status
Closed as new function.
Error description
New functions for IPR Driver will be provided. The description will follow after announcement.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IPR Driver of IMS Parallel * * Reorganization for z/OS Version 2 Release 1 * * (FMID=H25N210) * **************************************************************** * PROBLEM DESCRIPTION: IPR Driver now supports IMS Index * * Builder Version 2 Release 3. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** IPR Driver now supports IMS Index Builder (IIB) Version 2 Release 3 (V2R3). The control statements SORTFILSZ and SORTMAINSIZE that are introduced by this APAR can be specified not only for IIB V2R3 but also for IIB V2R1 and V2R2.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS Parallel Reorganization for z/OS Version 2 Release 1 User's Guide (Document Number: SC27-1180-01) should be changed as follows. ================================================================ PREFACE About This Guide PREFACE.3 Related Publications This book refers to information in other books using shortened versions of the book titles. The following table contains a list of books referred to by their short titles: +-------------------------+-------------------------+---------+ |Short Title Used in this | Title | Order | |Book | | Number | +-------------------------+-------------------------+---------+ : +-------------------------+-------------------------+---------+ |IMS Index Builder User's |One of the following: |SC27-0930| |Guide | | | | | - IBM IMS Index Builder | | | | for OS/390 User's | | | | Guide Version 2 | | | | Release 1 | | | | | | | | - IBM IMS Index Builder | | | | for z/OS User's Guide | | | | Version 2 Release 2 | | | | | | || | - IBM IMS Index Builder | | || | for z/OS User's Guide | | || | Version 2 Release 3 | | |_________________________|_________________________|_________| : PREFACE.4 Abbreviations of Product Names In this book,the following abbreviations are used for product names: +----------------------+------------------------------------+ |Short Name | Product Name | +----------------------+------------------------------------+ : +----------------------+------------------------------------+ || IMS Index Builder V2 | The generic name for either of the | || or just IMS Index | following program products of | || Builder | program number 5655-E24: | | | | | | - IBM IMS Index Builder for OS/390 | | | Version 2 Release 1 | | | | | | - IBM IMS Index Builder for z/OS | | | Version 2 Release 2 | | | | || | - IBM IMS Index Builder for z/OS | || | Version 2 Release 3 | | | | +----------------------+------------------------------------+ : ================================================================ Chapter 1. Introduction 1.2 Processing Environments 1.2.1 Software Requirements IPR V2 operates in either z/OS or OS/390. Its operating system requirements are the same as those for IMS supported by IPR V2. : IPR V2 requires the following products and maintenance: 2. For the INDEXBLD=YES function of IPR Driver, one of the following is required in addition to the products and maintenance listed in item 1: - IMS Index Builder for OS/390 Version 2 Release 1 (5655-E24) - The maintenance provided by APAR PQ51252 must be applied. - IMS Index Builder for z/OS Version 2 Release 2 (5655-E24) | - IMS Index Builder for z/OS Version 2 Release 3 | (5655-E24) : ================================================================ Chapter 2. IMS Parallel Reorganization Driver 2.6 JCL Requirements : 2.6.2 DD Statements : STEPLIB DD : IMS tools libraries must be concatenated before the IMS RESLIB library. * | The libraries specified on STEPLIB DD must be | APF-authorized in the following cases: | - IMSCMD=YES is specified | - INDEXBLD=YES is specified and Index Builder | Version 2 Release 3 is used | | In other cases, the libraries specified on STEPLIB DD need | not be authorized. If, however, the STEPLIB is not | authorized (for example by having unauthorized libraries | concatenated), a DFSRESLB DD statement must be included. IIUSOUT DD Defines the sort output data set for the Index Builder task. The data set contains the output from each sort | task attached or started by the Index Builder task. * If a sort error is encountered, this file should be inspected since it will contain detailed sort messages. For details, see "IIUSOUT Data Set" in topic 2.8.4. * | Note: If Index Builder Version 2 Release 3 is used and | the control statement SORTOUT=NOCOPY is specified, | the sort messages are written to SRTO data set of | the started sort task of Index Builder and the | IIUSOUT data set will be empty. * 2.7 Control Statements 2.7.5 Control Statements for Index Builder Task : +-------------------------------------------------------------+ | Table 6. Control Statements for Index Builder Task | +------------+-----------------+--------------+---------------+ |Keyword |Acceptable Values|Corresponding |Description | | | |Control State-| | | | |ment in IMS | | | | |Index Builder | | +------------+-----------------+--------------+---------------+ : +------------+-----------------+--------------+---------------+ |NDXIOBUF | data_bufferes, | NDXIOBUF |Specifies the | | | index_buffers | data_buffers,|number of VSAM | | | | indexbuffers |buffers used | | | | |for index | | | | |databases. | +------------+-----------------+--------------+---------------+ ||SORTE35 | YES or NO | SORTE35 YES | SORTE35=YES | || | | or | specifies use | || | | SORTE35 NO | the sort E35 | || | | | exit to load | || | | | sorted index | || | | | records into | || | | | the index | || | | | data set. | |+------------+-----------------+--------------+---------------+ ||SORTMAINSIZE| nnnnnnnnnn | SORTOPT | Specifies | || | | MAINSIZE=nnn | MAINSIZE | || | | nnnnnnn | parameter for | || | | | the sort's | || | | | OPTION | || | | | statement. | |+------------+-----------------+--------------+---------------+ ||SORTFILSZ | nnnnnnnnnn | SORTOPT | Specifies | || | | FILSZ=nnnnnn | FILSZ | || | | nnnnn | parameter for | || | | | the sort's | || | | | OPTION | || | | | statement. | |+------------+-----------------+--------------+---------------+ ||SORTSTAT | YES or NO | SORTSTAT=YES | SORTSTAT=YES | || | | is equivalent| specifies | || | | to SORTSTAT | producing | || | | statement for| sort count | || | | Index Builder| statistics in | || | | | the IIUPRINT | || | | | data set for | || | | | each index. | |+------------+-----------------+--------------+---------------+ ||SORTID | sort_id | SORTID | Specifies the | || | | sort_id | ID of the | || | | | IIUBSRTx | || | | | procedure | || | | | used to start | || | | | the address | || | | | space for the | || | | | sort program. | |+------------+-----------------+--------------+---------------+ ||SORTOUT | COPY or NOCOPY | SORTOUT COPY | SORTOUT=COPY | || | | or | specifies | || | | SORTOUT | that the sort | || | | NOCOPY | messages are | || | | | copied to the | || | | | IIUSOUT data | || | | | set. | ||____________|_________________|______________|_______________| * | You cannot specify any control statement other than those | listed in Table 6 and some statements are not supported or | ignored by a certain release of Index Builder. For details, | see Index Builder User's Guide. * 2.8 Reports and Statistics : 2.8.4 IIUSOUT Data Set | The output from each sort task attached or started by Index Builder task is printed in this data set. The data set should be inspected whenever sort problems are encountered. For the details of this data set, see IMS Index Builder User's Guide. * | Note: If Index Builder Version 2 Release 3 is used and the | control statement SORTOUT=NOCOPY is specified, the | sort messages are written to SRTO data set of the | started sort task of Index Builder and the IIUSOUT | data set will be empty. * 2.11 Examples 2.11.2 Reorganizing a Database and Its Secondary Indexes : | //REORG EXEC PGM=HPSGMAIN,PARM='DBD=dbdname,DBRC=Y' | | //STEPLIB DD DISP=SHR,DSN=HPS.SHPSLMD | | | // DD DISP=SHR,DSN=IIU.SIIULMOD | | // DD DISP=SHR,DSN=IMS.SDFSRESL | | //IMS DD DISP=SHR,DSN=IMS.DBDLIB | | //HPSOUT DD SYSOUT=* | | //IIUPRINT DD SYSOUT=* | | //HPSOUT2 DD SYSOUT=* | | //IIUSOUT DD SYSOUT=* | | //HPSIN DD * | | (REORG) | | IMSCMD=YES | | NAMESWAP=YES | | INDEXBLD=YES | | /* | : * 2.11.3 Reorganizing a Database While Allowing Read Access : | //REORG EXEC PGM=HPSGMAIN,PARM='DBD=dbdname,DBRC=Y' | | //STEPLIB DD DISP=SHR,DSN=HPS.SHPSLMD | | | // DD DISP=SHR,DSN=IIU.SIIULMOD | | // DD DISP=SHR,DSN=IMS.SDFSRESL | | //IMS DD DISP=SHR,DSN=IMS.DBDLIB | | //HPSOUT DD SYSOUT=* | | //IIUPRINT DD SYSOUT=* | | //HPSOUT2 DD SYSOUT=* | | //IIUSOUT DD SYSOUT=* | | //HPSIN DD * | | (REORG) | | IMSCMD=YES | | AUTHFAIL=WTOR | | DBSHARE=YES | | NAMESWAP=YES | | INDEXBLD=YES | | /* | : ================================================================ E.0 Appendix E. Messages and Codes E.3 Messages E.3.4 HPSG Messages <<< The following message is added. >>> HPSG0241E xxxxxxxxxxxx IS NOT A VALID KEYWORD Explanation: The string xxxxxxxxxxxx is not valid as a control statement keyword. System Action: IPR Driver ends with a return code of 8. Programmer Action: Check the release level and maintenance level of the products used under IPR Driver to see whether the keyword is supported.
APAR Information
APAR number
PQ65233
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2002-08-13
Closed date
2002-09-11
Last modified date
2002-10-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UQ69760
Modules/Macros
HPSGCM00 HPSGGRGB HPSGGRG0 HPSGGSTB HPSGMAIN HPSGMSGT HPSGRS00 HPSGSTMI HPSGTM00
SC27118001 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R210 PSY UQ69760
UP02/09/13 P F209
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":"SSVL5Q","label":"IMS Database Reorganization Expert for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023