Troubleshooting with the Playback Error Summary (MQ)


Performance Test for WebSphere MQ’s unattended playback function automatically generates an Error Summary Report, in text format, for all playback jobs. Use this report to troubleshoot playback errors. View it with a spool display facility such as IBM SDSF.

The summary contains all of the error messages and significant warning messages that occurred during the playback. Use the time stamps from the messages in the summary as search criteria for locating the area of the playback log where the event occurred. This feature requires an ERRORLOG DD statement, positioned ahead of the Playback Log SYSOUT DD, in the unattended playback JCL. MQPLAY1, the procedure called by the log file, supplies this DD for you.

Important

Unattended playback requires the ERRORLOG DD statement for successful playback. If it is not included in the job, playback halts and the job returns an error code of 100.

Generate an interactive HTML version of the report by including an HTMLLOG DD statement that specifies an HFS path in the playback JCL. That is, in the log file used to run the unattended playback job, between ANALYZE EXEC PROC=MQPLAY1 and LOGCOPY.INDD DD *, insert PROCESS.HTMLLOG DD with the appropriate PATHOPTS, PATH, and PATHMODE definitions. See Sample Log File.

View the report with a supported web browser.

Playback Error Summary Report (HTML Version)

image2021-2-18_19-4-52.png

In this version of the report, the error summary appears at the top of the browser window and the message log at the bottom. The time stamps on the messages in the summary are hyperlinked to the corresponding messages in the playback log. Click an error or warning message’s time stamp to position the log accordingly. The target error/warning message is highlighted for easy recognition. Scroll up or down to see messages generated before and after the error.

Important

Please note HFS paths are case sensitive. Be aware of the position of the Caps Lock key when you edit the log file used to run the unattended playback job. Additionally, optimum screen resolution for viewing this report is 800 x 600 pixels or better.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*