How to provide support with the correct DSN1PRNT reports when a Database Analyzer audit error occurs

Products

• Database Analyzer for DB2 for z/OS

Issue/Introduction

In Database Analyzer for Db2 for z/OS (PDA), the help panels for some audit error messages inform customers to provide a DSN1PRNT report to Support for the page identified
by the audit error message. However, the page number is in decimal format and if used with the PRINT option, the DSN1PRNT may be for the wrong page and therefore will be useless for analysis.

Cause

The page identified, as well as the KEYMAP ID and displacement values, in the audit error message are in decimal format. For the PRINT option of the DSN1PRNT
control statement, the page number value needs to be in a hexadecimal format.

Resolution

When an audit error message is issued either in the PTIMSG output or in Log Reporting (Option 10), the user should read its corresponding help panel.
If the help panel requests that a DSN1PRNT report be submitted to Support for the identified page, the user will need to convert the identified page into
a hexadecimal value which will then be used in the PRINT option of the DSN1PRNT control statement syntax.

For example, this audit error message is displayed in the PTIMSG output:

 => AUDIT MESSAGES FOR INDEX TSDUMP.X224G97D      
 => CONTIGUOUS RIDMAP IS NOT IN ASCENDING RID ORDER  
 => PAGE: 181 DISPLACEMENT: 01668 KEYMAP ID: 001 
 NOTE: For audit error details use PDA 'Log Reporting' menu option. 
       Enter 'H' line command next to the audit error message.

Users will need to go to Log Reporting (Option 10 off the PDA Main Menu) and enter 'H' line command next to the audit error message to display the help panel
related to this audit error. If the help panel requests that a DSN1PRNT of the identified page be submitted to Support, the user will then need to convert the
identified page into a hexadecimal value. This hexadecimal value will then be used with the PRINT option of the DSN1PRNT control statement.

With the example of above, the identified page number in the audit error message is 181 in decimal format and needs to be converted.
The hexadecimal value is B5. Therefore the DSN1PRNT should look like this:

 //PRINT EXEC PGM=DSN1PRNT,        
 // PARM='PRINT(B5),FORMAT'