A fix is available
APAR status
Closed as new function.
Error description
IPR Reload Utility supports IBM IMS Tools Knowledge Base for z/OS.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of IPR Driver of IMS Parallel * * Reorganization for z/OS Version 3 Release 2 * * (FMID=H25N320) * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables to store several * * reports of the IPR Reload to the Output * * repository of IMS Tools Knowledge Base * * for z/OS. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables to store several reports of the IPR Reload to the Output repository of IMS Tools Knowledge Base for z/OS. The following reports of the IPR Reload can be stored: - Environment - HPSIN Control Statements - DBD Summary - HALDB Partitions Processed - Segment Count Summary - Segment Statistics - HDAM Root Addressable Area Statistic - Distribution of Database Record Sizes - HISAM Statistics - Data Set Statistics - Pointer Count Summary - Pointer Statistics - HALDB Partition Definition The following reports of the reload task of the IPR Driver can be stored: - HPSIN Control Statements - Segment Statistics - Data Set Statistics - Pointer Count Summary - Pointer Statistics This APAR also provides installation default options ITKBSRVR= and ITKBLOAD= for the IPR Reload. To use this function, the following maintenance is required: - APAR PK54068 for IMS High Performance Load (FMID=H1IM210)
Problem conclusion
Temporary fix
Comments
======================== = Documentation Change = ======================== IBM IMS Parallel Reorganization for z/OS User's Guide (SC18-9228-03) should be changed as follows: ================================================================ 4.0 The IPR Reload utility 4.1 Program functions |4.1.5a Support for IMS Tools Knowledge Base | | IMS Tools Knowledge Base (IMS Tools KB) is an IMS Tools | product that provides common services for storing and viewing | reports that are generated by other participating IMS Tools | products. | To store IPR Reload utility reports in the Output repository | of IMS Tools KB by using the ITKBSRVR=serverName control | statement, you need to set up the environment with | the following steps: | 1. Apply APAR PK54068 to IMS High Performance Load. | 2. Install the IBM IMS Tools Knowledge Base product. | 3. Set up an IMS Tools KB server. | 4. Add IMS High Performance Load to the registry of the | IMS Tools KB server. | 5. If needed, register the RECON. | 6. Confirm that IMS Tools KB server is properly | initialized before you run IPR Reload utility jobs. | | For detailed procedures, see IMS Tools Knowledge Base for | z/OS User's Guide. ================================================================ 4.7 Control statements 4.7.2 Overview of IPR Reload control statements +------------------------------------------------------------+ | Table 35. IPR Reload control statements for process control| +-----------+---------------+--------+-----------------------+ |Keyword |Acceptable |Default | Description | | | Values | | | +-----------+---------------+--------+-----------------------+ : : : : : +-----------+---------------+--------+-----------------------+ | |ITKBSRVR |server_name or |*NO |Specifies the name of | | | |*NO | |the IMS Tools KB | | | | | |server. | | | | | |See "ITKBSRVR control | | | | | |statement" | | +-----------+---------------+--------+-----------------------+ | |ITKBLOAD |lib_name or |*NO |Specifies the library | | | | *NO | |name of IMS Tools KB. | | | | | |See "ITKBLOAD control | | | | | |statement" | +-----------+---------------+--------+-----------------------+ : : : : : ================================================================ |4.7.16a ITKBLOAD control statement | | ITKBLOAD specifies the name of the load module library for | IMS Tools Knowledge Base. | | This control statement is used only when ITKBSRVR=serverName | is specified. If you do not explicitly specify this control | statement, ITKBLOAD=*NO will be used and IPR Reload utility | attempts to load an IMS Tools KB module from the STEPLIB | libraries. | | +-------------------------------------------------------+ | | __ *NO ___ | | | >>__ITKBLOAD=_____|__libName__|___________________>< | | | | | +-------------------------------------------------------+ | | *NO | The IMS Tools KB modules are loaded from the private library | or the system library of the job. | | libName | specifies the name of the IMS Tools KB load module data set | that is to be used by the IPR Reload utility. | | Notes: | 1. When STEPLIB needs to be APF-authorized, this library | also needs to be APF-authorized. | | 2. You can add this option to the installation default | option table. For details, see "Setting installation | default options" in topic 6.0. ================================================================ |4.7.16b ITKBSRVR control statement | | ITKBSRVR specifies the name of the IMS Tools KB server. | | This control statement is optional. If you do not explicitly | specify this control statement, ITKBSRVR=*NO will be used. | | +-------------------------------------------------------+ | | __ *NO _______ | | | >>__ITKBSRVR=_____|__serverName__|_________________>< | | | | | +-------------------------------------------------------+ | | *NO | IPR Reload utility does not store reports in the IMS Tool | KB Output repository. | | servername | IPR Reload utility stores reports in the IMS Tools KB | Output repository of the specified server. | | If ITKBSRVR=serverName is specified, IPR Reload utility | attempts to connect to the server and then to store the | following reports in the Output repository of IMS Tools | Knowledge Base: | - Environment | - HPSIN Control Statements | - DBD Summary | - HALDB Partitions Processed | - Segment Count Summary | - Segment Statistics | - HDAM Root Addressable Area Statistics | - Distribution of Database Record Sizes | - HISAM Statistics | - Data Set Statistics | - Pointer Count Summary | - Pointer Statistics | - HALDB Partition Definition | | Notes: | 1. ITKBSRVR=serverName requires that an appropriate version | of IMS Tools Knowledge Base is installed and the server | is started. For the details, see "Software requirements" | in topic 1.2.1 and "Support for IMS Tools Knowledge Base" | in topic 4.1.6. | 2. You can add this option to the installation default option | table. For details, see "Setting installation default | options" in topic 6.0. ================================================================ 6.0 Setting installation default options 6.4 How to code HPSCOPT macro statements ---------- Product-sensitive programming interface ----------- The installation default options are specified by coding a set of HPSCOPT macro statements. These statements are assembler language macro instructions and therefore are subject to the rules contained in the High Level Assembler Programmer's Guide. The general syntax of the HPSCOPT macro statement is as follows: +------------------------------------------------------------+ | : | | | _|,A|_ _|,N|_ _|,O|_ | | | |_DRIVER_|______|_..._|______|_|______|__________| | | | _|,M|_ | | | |_DRIVRL_|______|_...____________________________| | | | _|,C|_ _|,J|_ | | | |_UNLOAD_|______|_..._|______|___________________| | | | | _|,C|_ _|,N|_ _|,O|_ _|,P|_ | | | | |_RELOAD_|______|_..._|______|_|______|_|______|_| | | | +------------------------------------------------------------+ ================================================================
APAR Information
APAR number
PK54067
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
2007-10-03
Closed date
2007-10-19
Last modified date
2007-11-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK30438
Modules/Macros
HPSCOPT HPSCOPTS HPSGCSC1 HPSGOPTR HPSGRS00
SC18922802 |
Fix information
Fixed component name
IMS PARALLEL RE
Fixed component ID
5655F7400
Applicable component levels
R320 PSY UK30438
UP07/10/24 P F710
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