MO71 has an Application Activity Trace viewer (which we wrote about before here) and we have recently made some changes to it as a result of some customer feedback. We thought we would take this opportunity to remind you that the viewer was there, and to tell you about the recent additions.
You can find the “Activity Trace…” feature in the “Action” menu. The viewer will be opened using your currently selected queue manager.
- Change any of the options for filtering on the “Settings” tab.
- Always remember to press the “Apply Settings” button at the bottom.
- Switch to the “Output” tab to see the information about what your traced application has been doing.
22:35:01 21372( 1) [ 231us] d:\nttools\q.exe MQCONNX 22:35:01 21372( 1) [ 43us] d:\nttools\q.exe MQOPEN Q1 22:35:01 21372( 1) [ 23us] d:\nttools\q.exe MQOPEN Q2 22:35:01 21372( 1) [ 28us] d:\nttools\q.exe MQGET Q1 RC(2080) Truncated message failed Sat Jun 12 22:35:01 2021 Context MQGET( Connection Id:414D51434D5147312020202020202020B3E9C26001206725 Hobj :2 QUEUE(MQG1/Q1) MQMD MQGMO Buffer Length:2048 Data Length :3428 CompCode :1 Reason :2080 Truncated message failed ) 22:35:01 21372( 1) [ 2161us] d:\nttools\q.exe MQGET Q1 22:35:01 21372( 1) [16230us] d:\nttools\q.exe MQPUT Q2 22:35:01 21372( 1) [ 6us] d:\nttools\q.exe MQGET Q1 RC(2033) No message available 22:35:01 21372( 1) [ 6us] d:\nttools\q.exe MQBACK 22:35:01 21372( 1) [ 6us] d:\nttools\q.exe MQDISC
Some example output from the MO71 Application Activity Trace viewer
You can filter the view so it only shows what you are interested in. For example, you might want to only see unsuccessful API calls, so you uncheck OK CompCodes on the “Settings” tab. However, some failing Reason Codes are not so interesting. One such failing Reason Code that is less interesting to view is MQRC_NO_MSG_AVAILABLE (2033). One of the new features added is the ability to list reason codes to be excluded from the output.
Previously this Reason Code entry field was only for one reason code. Now it can be a list, and either a list to include, or a list to exclude.
If you are using the Activity Trace Viewer to understand the behaviour of an application, you may wish to create a report from what you have learned. Once you have filtered the viewer to show just what you want to see, and perhaps opened up some of the sections to drill down on certain API calls to look at more details, you might want to copy some or all of what you can see to add to a report.It has always been possible to select text in the “Output” tab of the Activity Trace Viewer, and use Ctrl + C to copy what you have selected. However, there are now a few additional ways to get hold of the output. A context menu (right-mouse click) has been added to the viewer, and it allows you to copy the selected text (just the same as using Ctrl + C); it also allows you to copy all the text that is shown in the viewer to the clipboard, saving you having to select it first if you want all of it.
Also, there is a new option to export the text directly to a file which might be more appropriate if you have a larger report, rather than selecting only a small section of text. When exporting the text to a file, it will output what is shown, that is the levels you have opened will have their contents shown in the file output and the contents of the levels you have left closed will not be in the file.
You can however, select the “All Levels” checkbox on the export dialog. This essentially saves you manually opening up every single level to show the detail on all the API calls, but will of course increase the amount of data exported considerably.
Activity Trace is a very useful feature in IBM MQ, and the Viewer in MO71 makes it very easy to learn exactly what the data produced by MQ is telling you about your application. Why not try it out and see what you can discover about some of the applications making use of your queue manager?
The new version can be downloaded from the MO71 Download Page. Any current licensed users of MO71 can run the new version on their existing licence. If you don’t have a licence and would like to try out MO71 then send an email to firstname.lastname@example.org and a 1-month trial licence will be sent to you.