Workspaces

The predefined workspaces in IBM® OMEGAMON® for Storage on z/OS® are described in this section.

Each workspace contains a table view that provides information you can use to monitor a particular resource in your system. Column headings in the table view correspond to attributes that you can use to create situations. Each of the attributes in a specific table view belongs to a single attribute group.

This document has a section for each of the nodes that you see in the Navigator. These nodes are listed in Nodes in the Navigator, which are linked to workspaces. Each node links to a workspace that has the same name. Each workspace has links to related workspaces. Each link in Nodes in the Navigator, which are linked to workspaces goes to a section that describes the corresponding workspace. The sections also describe all linked workspaces.

Nodes in the Navigator, which are linked to workspaces

Note: In the Navigator and in this document, nodes are listed in functional order, not alphabetically.

This document does not attempt to describe all details for a workspace. For details regarding the column headings (which correspond to attribute names) in a given table view, see Attributes. For additional details regarding any workspace, go to the workspace itself and inspect the tables, views, and other features.

Accessing workspaces

This topic describes the security features and tells how to access workspaces in the Tivoli Enterprise Portal.

Security features for user accounts
Security features such as the following regulate access to workspaces or access to the functionality in workspaces:
  • The typical user of the Tivoli Enterprise Portal has a standard level of privileges to view and modify the portal. For example, the sysadmin default user can see the views and modify the portal. Be aware that if you use a user account that has the Workspace administration level of privileges, the views that you see differ, as in these examples:
    • The title and status bars display *ADMIN MODE* after the user name to indicate that the user ID is in workspace administration mode.
    • Comprehensive lists of workspace links are displayed in some pop-up menus, instead of the standard menus that are nested within specific workspaces.
    The Workspace administration mode has additional privileges and purposes that are described in the IBM Tivoli Monitoring: User's Guide.
  • Authentication and authorization for running Storage Toolkit commands describes the authorization that is required for the action requests of the Storage Toolkit.
Accessing OMEGAMON for Storage on z/OS in the portal

Access OMEGAMON for Storage on z/OS in the portal through the Navigator, as in the following example.

  1. Click the plus sign (+) beside the z/OS Systems icon to see available systems.
  2. Click the plus sign (+) beside the name of the name of the z/OS system for which you want information, for example, SYSG. The available subsystems are displayed.
  3. Click the plus sign (+) beside the Storage Subsystem icon.
  4. Click the plus sign (+) beside the STORAGE managed system for which you want information, for example, VTCTH@@L:SYSG:STORAGE. A list of product nodes is displayed.
  5. Click the node of a workspace, for example, Application Summary. The portal displays the Application Summary workspace.
Nodes in the Navigator, which are linked to workspaces shows the product nodes within the hierarchy of a typical Navigator.
Accessing the workspace that corresponds to a node in the Navigator
To access a workspace that corresponds to a node in the Navigator, click the node. The workspace is displayed in the portal.
Accessing workspace links from a Navigator node
  1. Click the node. The node is activated and the corresponding workspace is displayed in the portal.
  2. Right-click the node to display the pop-up menu.
  3. Select the workspace you want in the Workspace submenu.
Note: Some workspace links that are mentioned in this document are not always visible. The Tivoli Enterprise Portal displays some workspace links only when the target workspaces are relevant in the monitoring environment. For example, if you do not monitor DS8000® storage facilities, a link is not available for a workspace that tracks attributes of DS8000 storage facilities.
Accessing workspace links from views in a workspace
  1. You can access related workspaces from table views and bar charts as follows:
    • Table views: Right-click on the link icon (Link icon) located at the left of a row in a table view.
    • Bar charts: Right-click a bar in a bar chart view and select Link To in the menu to access the list of links.
  2. Select the name of a workspace in the pop-up menu.
Accessing cross-product workspace links
You access cross-product workspace links like any other workspace link. You use this type of link to go to workspaces in other Tivoli products, as described in Integration with other products.

Standard path and method for navigating workspaces

This document presents the hierarchy of linked workspaces for each workspace node in OMEGAMON for Storage on z/OS. For example, the list in Table 1 shows the hierarchy for the Application Summary workspace node in the Navigator of the portal. The bulleted list illustrates the standard path for navigating the workspaces. The standard method of navigating workspaces is as follows:
  1. Right-click the link icon (Link icon) that is located at the left side of each row in a table view. (Most workspaces have at least one table view.)
  2. Select a new workspace to go to in the pop-up menu.
    Note: Some link names in the pop-up menu do not exactly match the name that you see in the title bar of the target workspace.
Keep the following tips in mind as you a navigate workspaces:
  • When no link icon is displayed in the table view of a workspace, you have reached the end of the standard flow of navigation for a set of workspaces.
  • Most workspace nodes in OMEGAMON for Storage on z/OS have multiple subpaths.
  • Some subpaths terminate in the navigation tree structure of a different, but related, workspace node of OMEGAMON for Storage on z/OS. For example, many nodes ultimately link to the workspaces of the SMS Storage Groups Performance node, where relevant performance data is available.
  • The Back button in the browser client or the Back arrow icon (Back arrow icon) in the Desktop client are essential navigation tools as you traverse multiple subpaths. You move backward to leave one subpath and enter another. Alternatively, you can click the workspace node in the Navigator to return to the first workspace of the node in which you are navigating.

Historical navigation

Several workspaces include historical navigation links. Some of these workspaces also include the option of using the Time Span tool to change a real-time workspace to a historical view. When a workspace has a historical navigation link, use that link to view historical data rather than using the Time Span tool that is visible in each view of the workspace.

By using the historical navigation feature, the workspace view is changed from a real-time view to a trend view of a single object in the real-time view. From the trend-view, you can navigate to a historical point-in-time view of the items within the object. For instance, rather than using the Time Span tool, use the following navigation path:
SMS Storage Groups Performance workspace > Storage Group Performance Trend
The SMS Storage Groups Performance workspace provides real-time data for all of the defined SMS performance groups. The Storage Group Performance Trend workspace provides trending information for a single storage group.
Storage Group Performance Trend > SMS Storage Group Historical Volume Performance
The SMS Storage Group Historical Volume Performancee workspace shows the performance data for all of the volumes in the storage group at the point in time that is selected from the row of data in the Storage Group Performance Trend workspace.

Similarly, navigation is available from the SMS Storage Group Historical Volume Performance workspace to the Dataset Historical Performance Summary workspace, where a point-in-time view of the data set activity for the selected volume is displayed. Similar navigation capability is provided for user DASD groups, channels, cache CUs, logical control units (LCUs), and TotalStorage facilities.

When viewing the point-in-time historical workspaces, the Time Span tool is visible on each view of the workspace. The Time Span tool does not function correctly on these workspaces. These workspaces have been constructed to display a point-in-time historical view that cannot be altered by using the Time Span tool.

For best results, view the Tivoli Data Warehouse summarization data from an object trend workspace. By using the preceding example, the summarization display is most useful when invoked from the Storage Group Performance Trend workspace. If you want a volume performance summarization, access the Volume Performance Trend workspace. The following trend workspaces are provided by the product and supported by Tivoli Data Warehouse summarization. The Time Span tool functions correctly in these workspaces:
  • Cache CU DFW Retry Trend
  • Cache CU Destaging Trend
  • Cache CU Performance Trend
  • Cache CU Read Hit Percent Trend
  • Cache CU Staging Trend
  • Cache CU Status Trend
  • Cache CU Write Hit Percent Trend
  • Channel Path Trend
  • Logical Control Unit Trend
  • SMS Storage Group Performance Trend
  • SMS Storage Group Space Trend
  • Storage Group Percent Free Trend
  • User DASD Group Performance Trend
  • User DASD Group Space Trend
  • Volume Cache Trend
  • Volume Destaging Trend
  • Volume Performance Trend
  • Volume Space Trend
  • Volume Staging Trend
The following point-in-time historical workspaces are included with the product. The Time Span tool has unsupported results. Do not use the Time Span tool on the following workspaces:
  • Cache CU Volume DFW Retry History
  • Cache CU Volume Read Hit Percent History
  • Cache CU Volume Write Hit Percent History
  • User DASD Group Volume Historical Cache
  • User DASD SMS Storage Group Historical Volume Performance
  • User DASD Group Volume Historical Space
  • Volume Cache History
  • Volume Destaging History
  • Volume Group Space History
  • Volume Staging History

Integration with other products

IBM Tivoli Monitoring provides the dynamic workspace linking feature to enable you to quickly access workspaces in multiple products. OMEGAMON for Storage on z/OS uses that feature to provide predefined links that go to storage-related workspaces in Tivoli OMEGAMON XE on z/OS and in HSM Advanced Reporter. For example, the Application Summary workspace provides a predefined link to the Address Space Bottleneck Detail workspace in Tivoli OMEGAMON XE on z/OS.

Note: You can also modify the links that are provided by the product by default. See Tivoli Enterprise Portal Help for information on the Link Wizard that helps you modify the default linkages provided in the popup menus of rows in a workspace.
Note: Dynamic linking is available only for instances of OMEGAMON XE products that report to the same Tivoli Enterprise Monitoring Server as IBM OMEGAMON for Storage on z/OS and that run in the same logical partition.

Links to workspaces of related products

Table 1 lists the links that are available from the workspaces of OMEGAMON for Storage on z/OS to the workspaces of related products. Accessing workspaces provides general information about navigating workspaces.

About dynamic linking to cross-product workspaces

Dynamic workspace linking (sometimes referred to as DWL) permits you to easily navigate between workspaces that are provided by multiple products. This feature aids problem determination and improves integration across the monitoring products, permitting you to quickly determine the root cause of a problem. Predefined cross-product links provided by the OMEGAMON XE products permits you to obtain additional information about systems, subsystems, resources, or network components that are being monitored by other monitoring agents.

When you right-click on a link, the list of links is displayed. This list might contain links to workspaces provided by one or more monitoring products. The product you are linking to must be installed and configured.

Note: Your Tivoli Enterprise Portal user ID must be authorized to access the target product. Otherwise links to workspaces in the targeted product are not included in the list.

Choose a workspace from the list to navigate to that workspace. By linking to the target workspace in context, you receive additional information that is related to the system, subsdsystem, or resource you are currently viewing.

If you choose a workspace from the list and the target workspace is not available, you receive message KFWITM081E. Refer to the Problem Determination Guide for more information. Also, the "Target Not Found" topic in the online help in the Tivoli Enterprise Portal describes options for responding to failed links. The following scenario describes how this problem can arise:
  • You are upgrading from OMEGAMON XE version 4.1.0 products to OMEGAMON XE version 4.2.0 products, and you have a combination of version 4.1.0 and version 4.2.0 monitoring agents installed in your environment. For example, you might have a OMEGAMON for Storage on z/OS version 4.2.0 monitoring agent and an OMEGAMON XE on z/OS version 4.1.0 monitoring agent running on the same z/OS system during the migration period.
  • After this upgrade, the use of dynamic workspace linking to link from an OMEGAMON XE version 4.2.0 workspace to workspaces in an OMEGAMON XE version 4.1.0 product works correctly, as long as the target workspace exists in the version 4.1.0 product. If the target workspace does not exist, you receive the KFWITM081E message.
  • However, if a target workspace for version 4.2.0 has been modified (for example to accept link parameters to limit the data displayed) you might notice different behavior during the upgrade.