APAR status
Closed as new function.
Error description
Fast Path Advanced enhancement to support IMS Tools Knowledge Base.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of High Performance Fast Path * * Utilities Fast Path Advanced Tool Version 3 * * Release 2 (FMID: H31A320). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables Fast Path Advanced * * Tool (FPA) to store the reports to the * * Output repositoy of IMS Tools Knowledge * * Base for z/OS, Version 1 Release 1 * * (FMID: HABW110) * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** When HPFPU is registered as an IMS Tools product with the IMS Tools Knowledge Base server, the FPA reports can be stored to the Output Repository of IMS Tools Knowledge Base. When ICOUT=YES is specified, the reports produced in image copy could also be stored if the following maintenance has been applied: - UK25827 to IBM IMS High Performance Image Copy for z/OS Version 4 Release 1 (FMID=H1J0410)
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 1: Fast Path Advanced Tool Version 3 Release 2 (SC18-9869-03). ---------------------------------------------------------------- Chapter 1. Introduction 1.2 Terminology A new abbreviation should be added: ITKB Represents IMS Tools Knowledge Base 1.4 System requirements 1.4.1 Software The following lines should be added: .IMS High Performance Image Copy for z/OS, Version 4 Release 1 with PK45121 or later if ICOUT=YES and ITKBSRVR=servername are specified. .IMS Tools Knowledge Base for z/OS, Version 1 Release 1 (5655-R34), if ITKBSRVR=serverName is specified. ---------------------------------------------------------------- Chapter 2. Fast Path Advanced Tool A new section should be added as follows: 2.5 Support for IMS Tools Knowledge Base IMS Tools Knowledge Base (also referred to as ITKB) is an IMS Tools product that provides common services for storing and viewing reports that are generated by other IMS Tools products. To fully participate in the ITKB information management environment, each IMS tool must be enabled to communicate with the ITKB server. An enabled IMS tool can automatically send its generated reports to the ITKB repository. This version of FPA is enabled to participate in the ITKB environment. You must perform two configuration procedures to allow FPA to send reports to the ITKB repository: 1. Register HPFPU with ITKB. The registration process defines HPFPU reports to ITKB so that HPFPU reports can be stored in the ITKB repository. Use the ITKB product administration utility (HKTAPRA0) to register HPFPU with ITKB as described in the IMS Tools Knowledge Base User's Guide (SC18-9963). Follow the instructions in the topic "Registering IMS Tools products by using the default definition table". Submit the job below, please add a job card and change the parameters in italics to meet your site's requirements before submitting. //DEFREPDF EXEC PGM=HKTAPRA0,PARM='ITKBSRVR=servername' //STEPLIB DD DISP=SHR,DSN=HKT.SHKTLOAD //SYSPRINT DD SYSOUT=* //OUTRPT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //LOGFILE DD SYSOUT=* //SYSIN DD DATA,DLM='%%' ADDPROD PRODUCTID=DF,RELEASE=030200,RETENTION=(30,30), TABLE=HFPGPRS0,REPLACE=YES %% 2. Start the ITKB server and confirm it is properly intialized without connection failure. For the details, see IMS Tools Knowledge Base User's Guide (SC18-9963). Then you can request that FPA write reports to the ITKB repository. For the details, see the description of the control statements in Appendix A Command reference. After completing these configuration procedures, you can use the ISPF user interface to view, print, and manage reports that are generated by FPA and that are stored in the ITKB repository. ---------------------------------------------------------------- Chapter 3. Fast Path Advanced Tool command 3.1 Commands, subcommands, and keywords Table 40. HFPSYSIN commands, subcommands and keywords The following lines should be added: Command | Keywords -----------+--------------- | Global | ITKBLOAD | ITKBSRVR 3.2 Keywords Table 42. HFPSYSIN keywords The following lines should be added: Keyword | Purpose of the keyword -----------+-------------------------------------------------- | ITKBLOAD | Specifies the library name of ITKB. | ITKBSRVR | Specifies the name of the ITKB server. ---------------------------------------------------------------- Appendix A. Command reference A.32 Global The following lines should be added in the related keywords: . ITKBLOAD . ITKBSRVR The following keywords should be added: ITKBLOAD Use this keyword to specifies the name of the load module library for ITKB. ITKBLOAD is an optional keyword for the GLOBAL command. It is used only when ITKBSRVR=servername is specified. If you do not explicitly specify this keyword, ITKBLOAD=*NO will be used and FPA attempts to load an ITKB module from the STEPLIB libraries. Related keywrods: ITKBSRVR Format: ITKBLOAD=parameter Parameter Parameter can be one of the following values: dsname Specifies the name of the load module library for ITKB. *NO The ITKB modules are loaded from the private library or the system library of the job. Default ITKBLOAD=*NO ---------------------------------------------------------------- ITKBSRVR Use this keyword to specify the name of the ITKB server. ITKBSRVR is an optional keyword for the GLOBAL command. If you do not explicitly specify this keyword, ITKBSRVR=*NO will be used Related keywrods: ITKBLOAD Format: ITKBSRVR=parameter Parameter Parameter can be one of the following values: servername FPA stores reports in the ITKB Output repository of the specified server. *NO FPA does not store reports in the ITKB repository. Default ITKBLOAD=*NO ---------------------------------------------------------------- Appendix B. Sample reports The following reports could be stored to the Output repository of ITKB when ITKBSRVR=servername is specified: - Audit Report - Processing Report - Site and System Default Report - DBD Definition Report - Unloaded Report - Reloaded Report - Output File Report - Input File Report - Process Summary of Analysis Report - DEDB Area Analysis Reports - UOW Report - UOW Exception Report - Image Copy Output Report - Reorganization Processing Summary Report - UOW Space Statistics Report - DMACPRT Report ---------------------------------------------------------------- Appendix H. Messages and codes Messages The following message should be added: -------------------------------------------------------------- HFPC0018I THE ITKBLOAD PARAMETER WAS IGNORED BECAUSE NO SERVER NAME WAS SPECIFIED. Explanation: An ITKB load module library was specified for the ITKBLOAD keyword parameter, but the specification was ignored because no server name was specified for the ITKBSRVR keyword parameter. System Action: Processing continues, but HPFPU does not store any reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB output repository, specify the ITKB server name for the ITKBSRVR keyword parameter. -------------------------------------------------------------- HFPG0001W ITKB SERVER NAME WAS INCORRECT. Explanation: The connection to the ITKB server failed, because the server name specified by the ITKBSRVR keyword was incorrect. System Action: Processing continues, but HPFPU does not store any reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB Output repository, specify the correct ITKB server name. ---------------------------------------------------------------- HFPG0002W THE ACCESS TO OUTPUT REPOSITORY WAS CANCELED REASON: reason Explanation: HPFPU canceled its access to the ITKB Output repository, because the initialization process failed. The reason is one of the following: - Dynamic allocation for the library specified with the ITKBLOAD keyword failed - Failed to open the library specified with the ITKBLOAD keyword - Failed to load the HKTXXLI module System Action: Processing continues, but HPFPU does not store any reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB Output repository, specify the correct load module library of the ITKB product. ---------------------------------------------------------------- HFPG0003W HPFPU WAS NOT DEFINED IN ITKB. Explanation: HPFPU was not defined in the ITKB information management environment as a product that can store reports to the ITKB Output repository. System Action: Processing continues, but HPFPU does not store any reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB Output repository, register the HPFPU product by using the ITKB product administration utility (HKTAPRA0). ---------------------------------------------------------------- HFPG0004W REPORT WAS NOT DEFINED IN ITKB. Explanation: The report was not defined in the ITKB information management environment. System Action: Processing continues, but HPFPU does not store the report to the ITKB Output repository. Programmer Response: If you want to store the report to the ITKB Output repository, register the report by using the ITKB product administration utility (HKTAPRA0). ---------------------------------------------------------------- HFPG0005W ERROR OCCURRED IN ACCESSING OUTPUT REPOSITORY FUNC: function RC:rc RSN: rsn Explanation: An error occurred while getting access to the ITKB Output repository. System Action: Processing continues. If the return code is equal to or greater than 08, HPFPU does not store its reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB Output repository, correct the error. ---------------------------------------------------------------- HFPG0006W DBD: database name AREA: area name DD: ddname REPORT: report name Explanation: This message is displayed after message HFPG0005W, System Action: Processing continues. If the return code in the message HFPG0005W is equal to or greater than 08,HPFPU does not store the report name report for the database name, area name, and DD name. Programmer Response: See the description for message HFPG0005W. ---------------------------------------------------------------- HFPG0007W RECON ENTRY WAS NOT FOUND IN ITKB. Explanation: The RECON entry was not defined in your ITKB information management environment. System Action: Processing continues, but HPFPU does not store any reports to the ITKB Output repository. Programmer Response: If you want to store the reports to the ITKB Output repository, add a RECON environment. For more information about adding the RECON environment, see IMS Tools Knowledge Base for z/OS User's Guide (SC18-9963). ---------------------------------------------------------------- HFPM3009I LEVEL IS NOT HIGH ENOUGH TO SUPPORT OUTPUT REPOSITORY: HP Image Copy Explanation: The maintenance level of product prodname does not support the ITKB Output repository. System Action: Processing continues. The reports of FPA are stored to the ITKB Output repository, but the reports of product prodname are not stored to the ITKB Output repository. Programmer Response: If you want to store the reports of prodname to the ITKB Output repository, apply the maintenance of prodname that supports the ITKB Output repository. ---------------------------------------------------------------- ×**** PE08/07/30 FIX IN ERROR. SEE APAR PK69773 FOR DESCRIPTION
APAR Information
APAR number
PK67974
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2008-06-20
Closed date
2008-07-24
Last modified date
2008-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK38383
Modules/Macros
FABAMOD0 FABUTLMD HFPA5AI0 HFPA5DG0 HFPA5EA0 HFPA5FB0 HFPA5FD0 HFPA5FI0 HFPA5PF0 HFPA5PR0 HFPA5RP0 HFPA5SI0 HFPA5SP0 HFPA5SY0 HFPA5UW0 HFPA5000 HFPCCCT0 HFPCCDT0 HFPCDEF0 HFPCEXM0 HFPCEXO0 HFPGHKI HFPGHKI0 HFPGHKT0 HFPGHWK HFPGHWK0 HFPGMGT0 HFPGMSG0 HFPGPRS0 HFPGRPT HFPHDML0 HFPHDPA0 HFPHDPI0 HFPHDPS0 HFPLANA0 HFPLCCI0 HFPLCCT0 HFPLCC10 HFPLCC20 HFPLCC30 HFPLCC40 HFPLDBR0 HFPLDRT0 HFPLICT0 HFPLINF0 HFPLINI0 HFPLIOR0 HFPLITK0 HFPLLCT0 HFPLLPS0 HFPLLST0 HFPLLUS0 HFPLMAN0 HFPLNST0 HFPLOFT0 HFPLOPT0 HFPLRPT0 HFPLRST0 HFPLSEG0 HFPLSIT0 HFPLTST0 HFPLXST0 HFPMCCC0 HFPMESTA HFPMESTM HFPMEST8 HFPMEST9 HFPMTRM0 HFPUCHG HFPUGOP0 HFPUIN HFPUKTW0 HFPUMCT0 HFPUMVT0 HFPWMTC0 HFPWMTM0 HFPZCCT HFPZLTT HFPZMCT HFPZMVT H31A320J
| SC18986903 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R320 PSY UK38383
UP08/07/25 P F807
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.2.0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 August 2008