The WebSphere MQ Monitoring agent provides dozens of workspaces for you to view monitoring data. Some workspaces can be retrieved directly from the TEP navigation nodes, for example, the Queue Manager Status workspace. Some workspaces can only be linked to from another workspace, which might not be that obvious especially when you are not familiar with the agent. If you want to locate some specific attribute and don’t know which workspace contains this attribute, here is something you can try with the documentation.
Note: Only the workspaces on TEP are discussed here. For enhanced 3270 user interfaces, go check this booklet to get the information about a high-level drill down diagram, workspace descriptions and workspace navigation path strings for the e3270 UI.
The documentation about workspace and attribute group is arranged in this way:
- In the Workspaces section, each workspace description provides general introduction about this workspace, including predefined views, predefined links, and related attribute group in the table view. The information about how to access this workspace is provided for some particular workspaces.
- In the Attributes section, each attribute group lists all the contained attributes including the by default hidden ones.
- In the Monitoring with workspaces section, workspaces are grouped into several categories based on the main navigation nodes in the TEP physical view. High-level introduction and guidelines are provided for each group as well as the information about how to access the group of workspaces.
For example, if you want to know which workspace contains the Application tag attribute that is associated with a handle, try the following method.
In Knowledge Center (online)
- Go to the product Knowledge Center. For example, go to https://www.ibm.com/support/knowledgecenter/en/SSRLD6_7.3.0 for the latest V7.3.0 fix pack 2.
- Search for "application tag" within the documentation of this version. One attribute might be defined in multiple attribute groups. In the search result, focus on the topic whose title ends with "attributes". This type of topic indicates an attribute group description.
- In this example, we have three attribute groups that contains this attribute in the search result, i.e. Application Connections attributes, Application Topology attributes, and Queue Handle Status attributes. After reading the general description of each attribute group, it is decided that Queue Handle Status attribute group is what we are looking for. The next step is to find which workspace contains this attribute group.
- Search for "Queue Handle Status attributes" within the documentation. In the search result, focus on the topic whose title ends with the word "workspace" and there are two of them, i.e., Open Queue Handles workspace and Queue Status workspace.
- Read the workspace description and decide which workspace you want to check. The next step is to find out how to access the desired workspace.
- For the Open Queue Handles workspace, the access information can be found in the workspace description. For the Queue Status workspace, you might need to search for "Queue Status workspace" within the whole documentation. Many related topics appear in the search result. Focus on the topic whose title ends with the plural "workspaces". This type of topic provides the information about how to access a group of similar workspaces. For the Queue Status workspace, there are multiple ways to access it. One way is explained in the Queue Statistics workspaces topic.
In PDF (offline)
If you know the exact attribute name (not any other variations) to look for, PDF might be more effective. Otherwise, go search for it in online documentation (Knowledge Center) for a fuzzy match.
Tip: The PDF product manuals in English are downloadable from ftp://public.dhe.ibm.com/software/tivoli/OMEGAMON/OMXEMES/.
- Open the WebSphere MQ Monitoring Agent User’s Guide in PDF format and search for "application tag" in the Attributes section of Reference chapter.
- One attribute might appear multiple times in different attribute groups. Read the attribute group introduction or the attribute description to decide whether the spotted attribute is what you want. In the example, the Queue Handle Status attribute group contains the Application Tag attribute that we want.
- In the Workspaces section of the Reference chapter, search for "Queue Handle Status attributes". You can see which workspace contains this attribute group in its table view. In this example, both the Open Queue Handles workspace and the Queue Status workspace contain the Application Tag attribute.
- For the Open Queue Handles workspace, the workspace description already tells us how to access this workspace. But the Queue Status workspace description does not. For the Queue Status workspace, first go to the Monitoring with the workspaces chapter and search for "Queue Status". The search result tells you several ways to access this workspace.