A fix is available
APAR status
Closed as new function.
Error description
Provide support for IMS V10 ( 10.0 ) KEYWORDS: IMSV10TGT/K
Local fix
Apply fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IMS Parallel Reorganization * * for z/OS, Version 3 Release 2 * * (FMID=H25N320) * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables IPR to run under * * IMS Version 10. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables IPR to run under IMS Version 10 and support the following new functions introduced by IMS Version 10; 1. Parallel RECON Access If IMS RECON is defined as ACCESS=PARALLEL, IMS DBRC SCI Registration requires IMSplex name and DBRC group ID. Users can specify them in the DBRC SCI Registration exit (DSPSCIX0) or in the PARM parameter of the EXEC statement for PGM=HPSGMAIN and PGM=HPSCMAIN. For example, //stepname EXEC PGM=HPSGMAIN, // PARM='DBD=ITHIDM02,DBRC=Y,IMSID=IMA1, // IMSPLEX=PLEXA,DBRCGRP=010' 2. z/OS 1.7 DFSMSdfp Large Sequential Data Sets >64k Tracks In z/OS V1R7 or later, IPR Unload utility supports the large format data set for unload data sets (the SYSUT2, the SYSUT3, and the SYSUT4 DD statements). Currently, the large format data set is not supported for the other data sets. 3. DBRC Timestamp Precision If IMS RECON is defined as MINVERS('10.1'), IPR Driver issues the DBRC NOTIFY command using the time stamp with microsecond precision. To use IPR Driver with IMS Version 10, the following APARs are also required for the related products: - PK33118 IMS High Performance Unload (FMID: H1IN110) - PK33129 IMS High Performance Load (FMID: H1IM210) - PK29311 IMS Index Builder (FMID: H22O230) - PK33115 IMS High Performance Image Copy (FMID: H1J0410) - PK33116 IMS High Performance Prefix Resolution (FMID: H1IP310) - PK33114 IMS High Performance Pointer Checker (FMID: HPC2220) - PK33141 IMS Library Integrity Utilities (FMID: H27P110) - PK34809 IMS Tools Online System Interface (FMID: H2B7110)
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IBM IMS Parallel Reorganization for z/OS User's Guide (SC18-9228-02) should be changed as follows: ================================================================ PREFACE.3 Terminology used in this book : The following terms are used as indicated: IMS Version 8 Represents IMS Version 8 Release 1. IMS Version 9 Represents IMS Version 9 Release 1. | IMS Version 10 Represents IMS Version 10 Release 1. : In this book, the following abbreviations are used for product names: +-----------+------------------------------------------------+ | IMS |The generic name for one of the following | | |program products: | | | - IMS Version 8 Release 1 ..... | | | - IMS Version 9 Release 1 ..... | || | - IMS Version 10 Release 1 Database Manager | || | (Program number: 5635-A01) | +-----------+------------------------------------------------+ : ================================================================ 1.0 Introduction 1.2 Processing environments 1.2.1 Software requirements : IPR Version 3 Release 2 requires one of the following IMS releases: -IMS Version 8 Release 1 Database Manager with APAR PQ58303 -IMS Version 9 Release 1 Database Manager | -IMS Version 10 Release 1 Database Manager : ================================================================ 2.0 IMS Parallel Reorganization Driver 2.5 Setting up processing environments 2.5.1 Setup for DBRC 2.5.1.2 Setup for DBRC SCI registration exit routine | If you want to activate the automatic RECON Loss Notification | of DBRC, you must specify the IMSplex name that is saved | in the RECON data set. | In IMS Version 10 or later, the DBRC group identifier is added | to identify which sharing group the notification belongs to, | and this is needed to access the parallel RECON data set. | You can specify these identifiers in the DBRC SCI Registration | exit routine (DSPSCIX0), or by the IMSPLEX and the DBRCGRP | EXEC parameters. For more information about the automatic RECON Loss Notification, see the IMS DBRC Guide and Reference. For more information about the DBRC SCI Registration exit, see the IMS Customization Guide. ================================================================ 2.6 JCL requirements 2.6.1 EXEC statement The EXEC statement for the IPR Driver must be in the following format: //stepname EXEC PGM=HPSGMAIN,PARM='DBD=dbdname' Specify HPSGMAIN as the program name. The PARM parameter must include the following keyword: DBD=dbdname ... |Optionally, you can specify the following keywords to specify the job step environment: DBRC=x ... IMSID=ssna ... IRLM=x ... IRLMNM=irlm ... | IMSPLEX=name | Specifies the IMSplex name to be used by IMS DBRC SCI | Registration. This parameter is 1 to 5 characters. | DBRCGRP=ccc | Specifies the DBRC group identifier to be used by IMS | DBRC SCI Registration. This parameter is 3 characters. SWAP=x ... GSGNAME=gsgname ... D Note: The IMSPLEX= parameter cannot be specified for D the IPR Driver. | If you want to specify the IMSplex name, you can also use the DBRC SCI Registration exit. For details, see "Setup for DBRC" in topic 2.5.1. ================================================================ 3.0 The IPR Unload utility 3.7 JCL requirements 3.7.1 EXEC statement The EXEC statement for the IPR Unload utility must be in the following format: //name EXEC PGM=HPSCMAIN, // PARM='FUNC=UL,DBD=dbdname' Specify HPSCMAIN as the program name. The PARM= parameter keywords include the following: FUNC=UL ... DBD=dbdname ... |Optionally, you can specify the following keywords to specify the job step environment: DBRC=x ... IRLM=x ... IRLMNM=name ... | IMSPLEX=name | Specifies the IMSplex name to be used by IMS DBRC SCI | Registration. This parameter is 1 to 5 characters. | DBRCGRP=ccc | Specifies the DBRC group identifier to be used by IMS | DBRC SCI Registration. This parameter is 3 characters. SWAP= ... GSGNAME=name ... ================================================================ 3.7.2 DD statements : SYSUT2 DD SYSUT3 DD SYSUT3 DD Defines the output data set on which the database is unloaded. The data set must reside on either a tape or a direct access device. It can also be defined as DUMMY. If a block size is not specified on the SYSUTn DD statement, the IPR Unload utility uses the half track size for each device type. If the database contains segments larger than the block size, the maximum block size 32K is used. Do not specify the LRECL value on the DD statement. The IPR Unload utility uses the default record size (that is, block size minus 4). | The large format data set can be specified | when z/OS Version 1 Release 7 or later and IMS Version 10 | or later are used. The IPR Unload utility uses BUFNO=24 as the default buffer number. When the default buffer number is used, the buffer is allocated above the 16MB line. If you want to change the buffer number, specify DCB=BUFNO=nn on the DD statement. : ================================================================ 3.9 Reports and Statistics 3.9.1 Environment Report (The IMSPLEX name is removed from the Environment report.) D IMSPLEX NAME D The IMSPLEX name to be used for a RECON specified as the D IMSPLEX= parameter in the EXEC statement. D If the IMSPLEX= parameter is not specified, this item is D not displayed, no lines altogether. ================================================================ 4.0 The IPR Reload utility 4.6 JCL requirements EXEC Must be in this form: //name EXEC PGM=HPSCMAIN, // PARM='FUNC=RL,DBD=dbdname' Specify HPSCMAIN as the program name. The PARM= parameter keywords include the following: FUNC=RL ... DBD=dbdname ... |Optionally, you can specify the following keywords to specify the job step environment: DBRC= ... IRLM= ... IRLMNM=irlm ... | IMSPLEX=name | Specifies the IMSplex name to be used by IMS DBRC SCI | Registration. This parameter is 1 to 5 characters. | DBRCGRP=ccc | Specifies the DBRC group identifier to be used by IMS | DBRC SCI Registration. This parameter is 3 characters. SWAP= ... GSGNAME=gsgname ... : ================================================================ 4.8 Reports and Statistics 4.8.1 HPSOUT data set 4.8.1.1 Environment Report (The IMSPLEX name is removed from the Environment report.) D IMSPLEX NAME D The IMSPLEX name to be used for a RECON specified as the D IMSPLEX= parameter in the EXEC statement. D If the IMSPLEX= parameter is not specified, this item is D not displayed, no lines altogether. ================================================================ 5.0 The IPR DB Scan utility 5.5 JCL requirements 5.5.1 EXEC statement The EXEC statement for the IPR DB Scan must be in the following format: //stepname EXEC PGM=HPSCMAIN,PARM='FUNC=SN' Specify HPSCMAIN as the program name. The PARM= parameter must include the following: FUNC=SN ... |Optionally, you can specify the following keywords to specify the job step environment: DBRC=x ... IRLM=x ... IRLMNM=name ... | IMSPLEX=name | Specifies the IMSplex name to be used by IMS DBRC SCI | Registration. This parameter is 1 to 5 characters. | DBRCGRP=ccc | Specifies the DBRC group identifier to be used by IMS | DBRC SCI Registration. This parameter is 3 characters. SWAP=x ... GSGNAME=name ... ================================================================ 10.0 Messages and codes 10.3 Messages 10.3.2 HPSG messages (The new messages HPSG0116E and HPSG0407E are added.) ---------------------------------------------------------------- HPSG0116E IMS LEVEL XXXX IS UNSUPPORTED: PROD=prodname Explanation: The prerequisite product prodname is not support the IMS release level XXXX. For example, XXXX is '1010', it means IMS version 10. prodname is one of the followings: - IMS HIGH PERFORMANCE UNLOAD - IMS HIGH PERFORMANCE LOAD - IMS INDEX BUILDER - IMS HP IMAGE COPY - IMS HP PREFIX RESOLUTION System Action: The IPR Driver ends with a return code of 8. Programmer Response: Apply the maintenance to the product to run it under the IMS release level. ---------------------------------------------------------------- HPSG0407E RECON MINIMUM VERSION IS NOT FOUND Explanation: The IPR Driver failed to obtain the RECON MINIMUM version that is defined in RECON. System Action: Reorganization Manager issues a U0407 abend, and the IPR Driver ends with a return code of 16. Programmer Response: This is likely an internal system error. Contact IBM Software Support. ---------------------------------------------------------------- ================= End of Documentation Change ==================
APAR Information
APAR number
PK33131
Reported component name
IMS PARALLEL RE
Reported component ID
5655F7400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2006-10-18
Closed date
2006-12-26
Last modified date
2010-08-26
APAR is sysrouted FROM one or more of the following:
PK33111
APAR is sysrouted TO one or more of the following:
UK20902
Modules/Macros
HPSGBBLA HPSGBBL0 HPSGBBL8 HPSGBBL9 HPSGCM10 HPSGDATE HPSGGIOB HPSGGIO0 HPSGGRGB HPSGGRG0 HPSGGSTB HPSGGVM0 HPSGGVT0 HPSGIRMD HPSGLINK HPSGMPA0 HPSGMSGS HPSGMSGT HPSGRM10 HPSGRS30 HPSGRX00 HPSGTJD HPSGTJ00 HPSGTM20 HPSGTR00 HPSGTU10 HPSGTU2A HPSGTU20 HPSGTU28 HPSGTU29 HPSGTU3A HPSGTU30 HPSGTU38 HPSGTU39 HPSGUBBL H25N320J
| SC18922802 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R320 PSY UK20902
UP06/12/28 P F612
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":"320","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
06 January 2023