APAR status
Closed as new function.
Error description
FPO is being enhanced to support IMS Tools Knowledge Base.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of High Performance Fast Path * * Utilities Fast Path Online Tools Version 3 * * Release 2 (FMID: H31A320). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enables Fast Path Online * * Tools (FPO) 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 FPO reports can be stored to the Output Repository of IMS Tools Knowledge Base. To store the FPO reports in the ITKB repository, the ITKB related keywords should be specified in FPXIN DD.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 1: Fast Path Online Tools Version 3 Release 2 (SC18-9871-03). ---------------------------------------------------------------- Chapter 1. Introduction 1.1 Overview of FPO 1.1.2 Terminology A new abbreviation should be added: ITKB Represents IMS Tools Knowledge Base A new section should be added as follows: 1.1.x Support for IMS Tools Knowledge Base IMS Tools Knowledge Base 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 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 FPO is enabled to participate in the IMS Tools Knowledge Base environment. You must perform three configuration procedures to allow FPO to send reports to the IMS Tools Knowledge Base repository: 1. Register IMS HPFPU with IMS Tools Knowledge Base The registration process defines IMS HPFPU reports to IMS Tools Knowledge Base so that IMS HPFPU reports can be stored in the IMS Tools Knowledge Base repository. Use the IMS Tools Knowledge Base product administration utility (HKTAPRA0) to register IMS HPFPU with IMS Tools Knowledge Base 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". To register IMS HPFPU with IMS Tools Knowledge Base, you need to submit the following job. Before submitting the job, add a job card and change the parameter in italics to meet your site's requirements. //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 * ADDPROD PRODUCTID=DF,RELEASE=030200,RETENTION=(30,30), TABLE=HFPGPRS0,REPLACE=YES // 2. Verify communication with the IMS Tools Knowledge Base server Verify that the systems that you will run FPO 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 FPO write reports to the IMS Tools Knowledge Base repository Specify the name of the IMS Tools Knowledge Base server in the ITKBSRVR parameter of the FPO control statement (FPXIN). This parameter directs FPO to communicate to the IMS Tools Knowledge Base server so that FPO reports can be stored in the IMS Tools Knowledge Base repository. Syntax and configuration instructions for the FPXIN control statement are located in ITKBLOAD on page xx and ITKBSRVR on page xx. After completing these configuration procedures, you can use the ISPF user interface to view, print, and manage reports that are generated by FPO and that are stored in the IMS Tools Knowledge Base repository. ---------------------------------------------------------------- 2.1.7 Software requirements 4.1.7 Software requirements 5.1.5 Software requirements 6.1.2 Software requirements The following lines should be added: .IMS Tools Knowledge Base for z/OS, Version 1 Release 1 (5655-R34), if ITKBSRVR=servername is specified. ---------------------------------------------------------------- The following lines should be added in the following sections: 2.3.3 Utility control statements before ANALYZE control statement 4.3.6 Utility control statements - original expansion before EXTEND control statement 5.3.2 Utility control statements before REORG control statement 6.3.3 Utility control statements before DMACPRT control statement . GLOBAL control statement The GLOBAL control statement defines the job step keyword values. If specified, GLOBAL must be the first command in the input stream. ---------------------------------------------------------------- A new section should be added before the following sections: 2.3.3.2 ANALYZE statement 4.3.6.1 EXTEND statement 5.3.2.1 REORG statement 6.3.3.1 DMACPRT statement x.x.x.x GLOBAL statement The GLOBAL control statement specifies the job step keyword values. This control statement is optional. The keywords that are associated with the GLOBAL command are: .DBRC .ITKBLOAD .ITKBSRVR x.x.x.x.1 DBRC keyword The DBRC keyword is used to specify whether the report that is stored to the ITKB repository is associated with a RECON. This keyword is optional. The variable fields are defined as follows: NO Store the report in the ITKB repository that is not associated with a RECON. You can specify just N rather than NO. YES Store the report in the ITKB repository that is associated with a RECON. You can specify just Y rather than YES. Default: NO, if the DBRC keyword is not specified. x.x.x.x.2 ITKBLOAD keyword The ITKBLOAD keyword is used to specify the name of the load module library for ITKB. This keyword is optional. It is used only when ITKBSRVR=servername is specified. If you do not explicitly specify this keyword, ITKBLOAD=*NO will be used and FPO attempts to load an ITKB module from the STEPLIB libraries. The variable fields are defined as follows: *NO The ITKB modules are loaded from the private library or the system library of the job. dsname Specifies the name of the load module library for ITKB. Default: *NO, if the ITKBLOAD keyword is not specified. x.x.x.x.3 ITKBSRVR keyword The ITKBSRVR keyword is used to specify the name of the ITKB server. This keyword is optional. The variable fields are defined as follows: *NO FPO does not store reports in the ITKB repository. servername FPO stores reports in the ITKB Output repository of the specified server. Default: *NO, if the ITKBSRVR keyword is not specified. ---------------------------------------------------------------- Appendix D. Site default options support The following description should be changed: FPO supports the site default options. Appendix1.4.2 Defining site default options The following description should be changed: where xxx can be GBL, OPC, ODE, OER, or ODM. Appendix1.4.3 Supported control statement keywords The following description should be changed: All the control statement keywords are available for the site default options, except for: . AREA keyword . Keywords that are associated with the SELECT and OUTPUT control statements of ODE . Keywords that are associated with the THRESHOLD control statements of OPC and OER . Keywords that are associated with the EXTEND control statement of OAE Appendix1.4.4 How keyword values are determined The following description should be changed: An exception is that, for GLOBAL control statement, for ODE running with the run-level control and for ODM, the AREA member is not used. Appendix1.4.5.1 Example 1: Sample configuration member of FPXCFG00 The following line should be added in Figure 64: . GBLSUF=01 . OPCSUF=01 ... The following line should be added: The global site default options of GLOBAL control statement are specified in member FPXGBL01 ---------------------------------------------------------------- Appendix E. FPXIN syntax rules The following line should be added: . GLOBAL . ANALYZE ... ---------------------------------------------------------------- Appendix H. Messages and codes Messages The following message should be added: -------------------------------------------------------------- FPX0272E GLOBAL command must be specified as a first command. Explanation: FPO found that the GLOBAL command was not specified on the first line of FPXIN. System action: Processing ends with a return code of 8. User Response: Specify the GLOBAL command on the first line of FPXIN, and rerun the job. -------------------------------------------------------------- FPX0273I The ITKBLOAD parameter was ignored because no server name was specified. Explanation: An IMS Tools KB 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 IMS Tools KB Output repository. User Response: If you want to store the reports to the IMS Tools KB output repository, specify the IMS Tools KB server name for the ITKBSRVR keyword parameter. ---------------------------------------------------------------- A new section should be added as follows: Appendix x. Viewing FPO reports stored in ITKB The following messages and reports could be stored to the Output repository of ITKB when ITKBSRVR=servername is specified: - OPC processing messages - OAE processing messages - OER processing messages - ODM processing messages - Reorganization Processing Summary Report - UOW Space Statistics Report - DMACPRT Report - Online Pointer Checker Statistics - Process Summary of Analysis Report - DEDB Area Analysis Reports - UOW Report - UOW Exception Report
APAR Information
APAR number
PK73035
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-09-30
Closed date
2008-10-30
Last modified date
2008-11-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK41187
Modules/Macros
FPXALIF0 FPXAQPR0 FPXATA00 FPXATQ00 FPXAUCN0 FPXA0000 FPXBDRVA FPXBDRV0 FPXBDRV8 FPXBDRV9 FPXBMBLK FPXBMBL0 FPXBPAR1 FPXB0000 FPXCONS0 FPXMCPR0 FPXMDMLA FPXMDML0 FPXMDML8 FPXMDML9 FPXMDPIA FPXMDPI0 FPXMDPI8 FPXMDPI9 FPXMDPSA FPXMDPS0 FPXMDPS8 FPXMDPS9 FPXMOC00 FPXMOMCB FPXMPUT0 FPXMSG00 FPXM0000 FPXUCIOB FPXUCIO0 FPXUGBA0 FPXUGBB FPXUGBB0 FPXUGBD0 FPXUGBK0 FPXUGRP0 FPXUGRS0 FPXUGSI0 FPXUITB FPXUITB0 FPXUITH0 FPXUITI0 FPXUITO0 FPXUITW0 FPXULOD0 FPXUMOD FPXUMOD0 FPXUPPE0 FPXUSIT0 FPXUTCFG FPXXCPR0 FPXXLPS0 FPXXLUS0 FPXXLWRK FPXXRC00 FPXXRG00 HFPA5000 HFPGHKI HFPGHKI0 HFPGHKT0 HFPGPRS0 HFPGRPT HFPQMAI0 HFPQUBLK H31A320J
| SC18987103 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R320 PSY UK41187
UP08/10/31 P F810
[{"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:
04 November 2008