Support for IMS Tools Knowledge Base
If your installation currently uses IMS Tools Knowledge Base, which is a component of IBM® IMS Tools Base for z/OS® (5655-V93), IMS Buffer Pool Analyzer can take advantage of the product’s ability to archive and retrieve reports. The use of IMS Tools Knowledge Base is optional.
About this task
If you choose to use IMS Tools Knowledge Base, you must prepare the IMS Tools Knowledge Base repository for IMS Buffer Pool Analyzer reports.
To retain a history of IMS Buffer Pool Analyzer reports in IMS Tools Knowledge Base, use the product administration utility to define the report retention period. After IMS Buffer Pool Analyzer is registered, you can edit the report retention period. By default, the reports are retained for 30 days. A sample job is provided in the SBPLSAMP library. The following figure shows the sample job that is provided in the BPLITKB member of the SBPLSAMP library.
Note that in addition to updating the JOB card to meet your installation’s standards, you must supply appropriate values for the three symbolic variables.
- SBPLLINK symbolic parameter
- This symbolic parameter must be set to the data set name of the IMS Buffer Pool Analyzer SBPLLINK library.
- SHKTLOAD symbolic parameter
- This symbolic parameter must be set to the data set name of the IMS Tools Knowledge Base SHKTLOAD load library.
- ITKBSRVR symbolic parameter
- This symbolic parameter must be set to the XCF group name for the IMS Tools Knowledge Base servers.
You should expect to receive the following messages from execution of the first step in the above job:
HKT2178I Attempting to add an IBM product
HKT2158I Request completed successfully
PRODUCT ID: IB RELEASE 010300 LONG NAME: IMS BUFFER POOL ANALYZER
REPORT ID LONG TITLE
DB DATABASE INFORMATION
DS DATA SET INFORMATION
GT GTF TRACE STATISTICS
MD MODEL SUBPOOL REPORTS
SP SUBPOOL REPORTS
Any other messages that occur when defining IMS Buffer Pool Analyzer to the IMS Tools Knowledge Base should be reviewed using the IMS Tools Base IMS Tools Knowledge Base User’s Guide and Reference.
In order to use IMS Tools Knowledge Base when creating reports, you must supply a PARM field in the report job step EXEC statement. The PARM field must specify the name of the IMS Tools Knowledge Base server. Further information can be found in Generating buffer pool reports. If the ITKBSRVR specification is not included in the PARM of the report JCL, IMS Buffer Pool Analyzer will not archive report output in the knowledge base repository.