Updates to IMS Buffer Pool Analyzer V1.3 User's Guide

Manual


Abstract

Updates that apply to IMS Buffer Pool Analyzer V1.3 User's Guide (SC19-2477-00)

Content

The most recent updates appear at the top of the list.


Update 5
Date of change:
May 22, 2012
Topic:
Troubleshooting: Error messages
Change description:
Updated system action for BPL104E, BPL106E, BPL107E, and BPL108E.

System action: IMS Buffer Pool Analyzer ignores the database with the error and continues processing.


Update 4
Date of change:
March 22, 2010
Topic:
Support for IMS Tools Knowledge Base
Change description:
Updated information about registering IMS Buffer Pool Analyzer with IMS Tools Knowledge Base

  • Update to the third paragraph: 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.
  • Before Figure 8, add the following note: Important: Do not use the PRODUCTID=IB option when you register IMS Buffer Pool Analyzer with IMS Tools Knowledge Base. IMS Buffer Pool Analyzer is not defined in the default definition table, so only the most recent reports will be stored in the repository if you specify PRODUCTID=IB.
  • Update the sample JCL (Figure 8):
    • Update the first STEPLIB from:
      //STEPLIB DD DISP=SHR,DSN=*!ENT!*
      // DD DISP=SHR,DSN=*!ENT!*

      To the following STEPLIB:
      //STEPLIB DD DISP=SHR,DSN=&SBPLLOAD
      // DD DISP=SHR,DSN=&SHKTLOAD

    • Update the second STEPLIB from:
      //STEPLIB DD DISP=SHR,DSN=*!ENT!*

      To the following STEPLIB:
      //STEPLIB DD DISP=SHR,DSN=&SHKTLOAD
  • Remove the following paragraph: If additional report IDs are shown in the listing, it may be caused by the activation of the original IMS Buffer Pool Analyzer definitions as distributed with the IMS Tools Knowledge Base product. The presence of additional report IDs will not cause any problems, and can be ignored.
  • In the last paragraph, change ITKNSRVR to ITKBSRVR.


Update 3
Date of change:
March 22, 2010
Topic:
Troubleshooting: Error Messages
Change description:
Revised error messages


BPL562E NUMBER OF OSAM DDNAMES EXCEEDED 65,536

EXPLANATION:
More than 65,536 DDNAMES were found in the GTF
trace data sets. IMS Buffer Pool Analyzer has a
limit of 65,536.

*****
BPL622E NUMBER OF VSAM DDNAMES EXCEEDED 65,536

EXPLANATION:
More than 65,536 VSAM component names were found
in the GTF trace data sets. IMS Buffer Pool Analyzer
has a limit of 65,536.


Update 2
Date of change:
March 22, 2010
Topic:
Troubleshooting: Error Messages
Change description:
New error messages


BPL320E BLKSIZE OF SYSLIB DD IS LESS THEN 240

EXPLANATION:
The block size of the PARMLIB data set (SYSLIB DD)
in the BPLTRACE proc is less than 240. The block
size must be at least 240.

SYSTEM ACTION:
The trace task abends.

USER RESPONSE:
Ensure that the PARMLIB data set has a RECFM of
FB and that the block size is at least 240.

*****
BPL651I ABEND Saaa RCbb DDNAME SYSLIB

EXPLANATION:
An abend occurred processing the SYSLIB DD in
the BPLTRACE process. The abend code (aaa)
and return code (bb) document the reason for
for the abend.

SYSTEM ACTION:
If the abend is a system abend 013 with return
code 18, resulting from the BPLTRACE member not
already being in the PARMLIB data set, IMS Buffer
Pool Analyzer writes a new member.
Otherwise, the BPLTRACE task abends.

USER RESPONSE:
Determine the reason for the abend and address
the cause of the problem. If a space abend
such as B37/D37/E37 abend occurs, then
increase the size of the PARMLIB data set.

*****
BPL652E COMPRESS FAILED - reason

EXPLANATION:
IMS Buffer Pool Analyzer encountered an error
attempting to compress the SYSLIB DD. The
reason for the error is shown in the
message.

SYSTEM ACTION:
The BPLTRACE task abends.

USER RESPONSE:
The reason for the error might be one of the
following:
o ATTACH RETURN CODE nn.
Determine the reason for the ATTACH macro
failed, and contact IBM Software Support
for assistance.
o IEBCOPY RETURN CODE nn.
Determine the reason for IEBCOPY to have
failed, and contact IBM Software Support
for assistance.

*****
BPL653E UNABLE TO RECOVER - reason

EXPLANATION:
IMS Buffer Pool Analyzer encountered an error
attempting to recover from an abend during
SYSLIB DD processing. The reason for the
error is shown in the message.

SYSTEM ACTION:
The BPLTRACE task abends.

USER RESPONSE:
The reason for the error may be one of the
following:
o IGNORE OPTION NOT AVAILABLE
The DCB Abend Exit cannot ignore the
error. This might be caused by the error
being encountered during close processing.
o MULTIPLE ABENDS OCCURRED
More than one abend occurred processing
the SYSLIB DD. IMS Buffer Pool Analyzer only
attempts recovery from a single abend.
o UNEXPECTED ABEND
An abend other than a system 013 return
code 18 occurred. IMS Buffer Pool Analyzer
does not recover from other abends.

Review the abend code and any other messages
associated with the error that might appear in
the MVS SYSLOG. Contact IBM Software Support
for assistance.


Update 1
Date of change:
January 6, 2009
Topic:
Troubleshooting: Error Messages
Change description:
New error messages


BPL288I NNNNNN CONFIG ENTRIES TRACED

EXPLANATION:
THE BPLTRACE TASK TRACED THE INDICATED NUMBER OF IMS
CONFIGURATION RECORDS.

SYSTEM ACTION:
NONE

PROGRAMMER RESPONSE:
NONE

*****

BPL289I NNNNNN CONFIG ENTRIES WERE RETRIED

EXPLANATION:
THE BPLTRACE TASK HAD TO RETRY TO TRACE THE INDICATED
NUMBER OF CONFIGURATION RECORDS BECAUSE GTF HAD
DISCARDED THE INITIAL TRACE ATTEMPT.

SYSTEM ACTION:
THE INIDICATED NUMBER OF RECORDS HAD TO BE TRACED MORE
ONCE.

PROGRAMMER RESPONSE:
IF RECORDS HAD TO BE RETRIED, CONSIDER INCREASING
THE BUFFER SPACE USED BY THE BPLGTF TASK.

Publication number

SC19-2477-00

Copyright date

2008

Original publication date

2008/12/12

Rate this page:

(0 users)Average rating

Document information


More support for:

IMS Tools
IMS Buffer Pool Analyzer

Software version:

1.3.0

Operating system(s):

z/OS

Software edition:

Edition Independent

Reference #:

7014905

Modified date:

2010-03-22

Translate my page

Machine Translation

Content navigation