PK67974: ADD SUPPORT OF ITKB TO FPA

A fix is available

Subscribe

You can track all active APARs for this component.

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

  • 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
    

Publications Referenced
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

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.



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS Tools
IMS HP Fast Path Utilities

Software version:

3.2.0

Reference #:

PK67974

Modified date:

2008-08-02

Translate my page

Machine Translation

Content navigation