A fix is available
APAR status
Closed as new function.
Error description
HP Load supports IBM IMS Tools Knowledge Base for z/OS.
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 to store several * * reports of HP Load to the output * * repository of ITKB. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR enables to store several reports of HP Load (PGM=DFSRRC00/HPSRRC00) to the output repository of IMS Tools Knowledge Base for z/OS. The following reports of HP Load can be stored: - FRRIN Control Statements - Segment Count Summary - Segment Statistics - Data Set Statistics - Pointer Count Summary - Pointer Statistics - HALDB Process Summary
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: ================================================================ 1.1.6.1 Software requirements : To use the user exit routine written in the languages listed, you must use it in Language Environment (LE). | IMS Tools Knowledge Base for z/OS, Version 1 Release 1 or | later, if ITKBSRVR=serverName. | 1.1.x Support for IMS Tools Knowledge Base | IBM IMS Tools Knowledge Base for z/OS (also referred to as | IMS Tools Knowledge Base or 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 fully participate in the IMS Tools Knowledge Base | information management environment, each IMS tool must be | enabled to communicate with the IMS Tools Knowledge Base | server. An enabled IMS tool can automatically send its | generated reports to the IMS Tools Knowledge Base repository. | This version of IMS HP Load is enabled to participate in the | IMS Tools Knowledge Base environment. | You must perform the following procedures to allow IMS HP Load | to send reports to the IMS Tools Knowledge Base repository: | 1. Register IMS HP Load with IMS Tools Knowledge Base. | The registration process defines IMS HP Load reports to IMS | Tools Knowledge Base so that IMS HP Load reports can be | stored in the IMS Tools Knowledge Base repository. | Use the IMS Tools Knowledge Base product administration | utility (HKTAPRA0) to register IMS HP Load with IMS Tools | Knowledge Base as described in the IMS Tools Knowledge Base | User's Guide. Follow the instructions in the topic | "Registering IMS Tools products by using the default | definition table". | Specify the following command: | ADDPROD PRODUCTID=DL RELEASE=020100 | 2. Verify communication with the IMS Tools Knowledge Base | server. | Verify that the systems that you will run IMS HP Load | on will have XCF communications with the IMS Tools | Knowledge Base server and that the FPQ subsystem is | started on each of these systems. In the IMS Tools | Knowledge Base User's Guide, refer to the topic "Defining | IMS Tools KB to the operating system". | 3. Request that IMS HP Load write reports to the IMS Tools | Knowledge Base repository. | Specify the name of the IMS Tools Knowledge Base server in | the ITKBLOAD and ITKBSRVR control statements of the IMS HP | Load FRRIN data set. These control statements direct IMS HP | Load to communicate to the IMS Tools Knowledge Base server | so that IMS HP Load reports can be stored in the IMS Tools | Knowledge Base repository. For the details of the control | statements to specify in the FRRIN data set, see "Control | statements" in topic 2.2.3. | After completing these configuration procedures, you can use | the ISPF user interface to view, print, and manage reports | that are generated by IMS HP Load and that are stored in the | IMS Tools Knowledge Base repository. | For the reports that can be stored in the IMS Tools KB Output | repository, see "Storing reports in the IMS Tool KB Output | repository" in topic 2.1.1.4. 2.0 IMS HP Load 2.1.1 Program functions |2.1.1.4 Storing reports in the IMS Tools KB Output repository | | 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 IMS HP Load 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 PM00732 to IMS HP Load. | 2. Install the IBM IMS Tools Knowledge Base product. | 3. Set up an IMS Tools KB server. | 4. Add IMS HP 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 IMS HP Load jobs. | | For detailed procedures, see IMS Tools Knowledge Base for | z/OS User's Guide. 2.2.3 Control statements 2.2.3.2 Overview of IMS HP Load 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" | +-----------+---------------+--------+-----------------------+ : : : : : |2.2.3.xx 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 IMS HP Load | 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 IMS HP Load. | | 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.1. |2.3.xx 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 | IMS HP Load does not store reports in the IMS Tool | KB Output repository. | | serverName | IMS HP Load stores reports in the IMS Tools KB | Output repository of the specified server. | | If ITKBSRVR=serverName is specified, IMS HP Load | attempts to connect to the server and then to store the | following reports in the Output repository of IMS Tools | Knowledge Base: | - FRRIN Control Statements | - Segment Count Summary | - Segment Statistics | - Data Set Statistics | - Pointer Count Summary | - Pointer Statistics | - HALDB Process Summary | | 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.1.6.1 and "Storing reports in the IMS Tools | KB Output repository" in topic 2.1.1.4. | 2. You can add this option to the installation default option | table. For details, see "Setting installation default | options" in topic 6.1. 4.1 Introduction to Load API 4.1.3 Restrictions The following are the restrictions of the Load API function: : | The Load API does not support to store reports to the output | repository of IMS Tools Knowledge Base for z/OS. 6.1 Setting installation default options 6.1.4 How to code HPSROPT macro statements : RELOAD: : | |_ __________________________ _______________| | | | _C__________ | | | | |_ILDSBLD=__|_YES________|_| | | | |_(YES,DSPR)_| | | | |_NO_________| | | | |_ ___________________________ ______________| | | | | __ *NO ____ | | | | | |_ITKBLOAD=__|__libName__|__|______________| | | |_ _____________________________ ____________| | | | | __ *NO _______ | | | | | |_ITKBSRVR=__|__serverName__|_|____________| | |_ __________________ _______________________| | | | _NO__ | | | | |_OADSPR=__|_YES_|_| | :
APAR Information
APAR number
PM00732
Reported component name
IMS HIGH PERF L
Reported component ID
5655E0700
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2009-11-06
Closed date
2009-12-17
Last modified date
2010-01-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK53010
Modules/Macros
FABFLINK FABSHPSR FABUHPSR HPSCCHG HPSCRPTH HPSRAPF0 HPSRGITB HPSRGITH HPSRHALA HPSRHALB HPSRHALM HPSRHAL7 HPSRHAL8 HPSRHAL9 HPSRHDLA HPSRHDLB HPSRHDLD HPSRHDL7 HPSRHDL8 HPSRHDL9 HPSRHTBL HPSRIT10 HPSRIT20 HPSRMSGS HPSRMSGT HPSROPT HPSROPTA HPSRPC00 HPSRRPTH HPSRRRIN HPSRRRI0 HPSRRRI9 H1IM210J
| SC18922204 |
Fix information
Fixed component name
IMS HIGH PERF L
Fixed component ID
5655E0700
Applicable component levels
R210 PSY UK53010
UP09/12/22 P F912
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:
05 January 2010