Setting up the report repository

IMS HP Image Copy supports the function of the IMS Tools Base IMS Tools KB Output repository, which can store and centrally manage IMS HP Image Copy reports.

To use this function, you must install and configure IMS Tools Knowledge Base (IMS Tools KB), which is provided by IBM® IMS Tools Base for z/OS®.

Subtopics:

Reports that can be stored in the IMS Tools KB repository

IMS HP Image Copy can store the following IMS HP Image Copy reports in the Output repository of IMS Tools KB:

  • ICEIN Statements report
  • Global Options report
  • Environment report
  • Image Copy Processing messages
  • Image Copy Dump Process report
  • Image Copy Process Summary report
  • Image Copy Stacking Process report
  • Data Set Statistics report
  • Recovery Process report
  • Create Image Copy report
  • DBRC NOTIFY.IC Processing report
  • Selected Area report

IMS HP Image Copy can store reports in the IMS Tools KB Output repository only when the IMS HP Image Copy function is invoked by FABJMAIN JCL. Reports cannot be stored in the repository if the function is invoked by IMS compatible JCL.

Configuration steps to use the IMS Tools KB repository

To store IMS HP Image Copy reports in the IMS Tools KB Output repository, you must set up the environment by completing the following steps:

Table 1. Checklist for configuring IMS Tools KB for IMS HP Image Copy
Status Task
  1. Set up an IMS Tools KB server by following the instructions in the IMS Tools Base Configuration Guide.
  2. Register IMS HP Image Copy to the registry of the IMS Tools KB server.

See Registering products and reports to IMS Tools KB and Verifying product information registered to IMS Tools KB.
  3. If needed, add the RECON.
  4. Ensure that the IMS Tools KB server is properly initialized before you run IMS HP Image Copy jobs.

See Verifying communication with the IMS Tools KB server.
  5. Request IMS HP Image Copy to store reports in the IMS Tools KB repository by adding keywords to IMS HP Image Copy JCL.

See Requesting IMS HP Image Copy write reports to the IMS Tools KB repository.

For detailed procedures, see the IMS Tools Base Configuration Guide.

Storing IMS HP Image Copy reports generated in jobs of other IMS Tools

IMS Online Reorganization Facility
To store IMS HP Image Copy reports and IMS HP Pointer Checker reports in the IMS Tools KB repository in IMS Online Reorganization Facility jobs, specify the IMS Tools KB server name by using one of the following keywords:
  • When you process HALDBs, specify the server XCF group name on the ITKBSERVER keyword in HRFSYSIN DD. The ITKBSRVR keyword in ICEIN DD or in the IMS HP Image Copy site default table is not effective for HALDBs. If you do not specify the ITKBSERVER keyword, and if the ITKBSRVR keyword is specified in ICEIN DD or in the IMS HP Image Copy site default table, a warning message (FABJ0221W) is issued.
  • When you process non-HALDBs, specify the server XCF group name either on the ITKBSRVR keyword in ICEIN DD or on the ITKBSERVER keyword in HRFSYSIN DD. The ITKBSRVR keyword in the IMS HP Image Copy site default table is also effective.
IMS Database Reorganization Expert
For information about storing the reports of IMS HP Image Copy and IMS HP Pointer Checker in the IMS Tools KB repository in IMS Database Reorganization Expert jobs, see the IMS Database Reorganization Expert User's Guide.
IMS HP Fast Path Utilities
For information about storing IMS HP Image Copy reports in the IMS Tools KB repository in IMS HP Fast Path Utilities jobs, see the IMS Fast Path Solution Pack IMS High Performance Fast Path Utilities User's Guide.