# Workspaces

The predefined workspaces in IBM® Tivoli® OMEGAMON® XE 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.

- Monitoring applications
  This topic describes the workspaces that monitor the status of applications. You access these workspaces through the Application Summary node in the Tivoli Enterprise Portal.
- Monitoring cache CU performance
  This topic describes the workspaces that monitor the status of the performance of cache CU. You access these workspaces through the Cache CU Performance node in the Tivoli Enterprise Portal.
- Monitoring cache CU status
  This topic describes the workspaces that monitor the status of cache CU. You access these workspaces through the Cache CU Status node in the Tivoli Enterprise Portal.
- Monitoring channel paths
  This topic describes the workspaces that monitor the status of channel paths. You access these workspaces through the Channel Path node in the Tivoli Enterprise Portal.
- Monitoring Dataset Attributes System Summary data
  This topic describes the workspaces that monitor the status of Dataset Attributes System Summary data. You access these workspaces through the Dataset Attributes System Summary node in the Tivoli Enterprise Portal.
- Monitoring dataset groups
  This topic describes the workspaces that monitor the status of Dataset Group Summary data. You access these workspaces through the Dataset Group Summary node in the Tivoli Enterprise Portal.
- Monitoring DFSMShsm status
  This topic describes the workspaces that monitor the status of DFSMShsm™ activity. You access these workspaces through the DFSMShsm Status node in the Tivoli Enterprise Portal.
- Monitoring DFSMSrmm status
  This topic describes the workspaces that monitor the status of DFSMSrmm™ resources. You access these workspaces through the DFSMSrmm Status node in the Tivoli Enterprise Portal.
- Monitoring logical control units
  This topic describes the workspaces that monitor the status of logical control units. You access these workspaces through the Logical Control Unit node in the Tivoli Enterprise Portal.
- Monitoring SMS configuration
  This topic describes the workspaces that monitor the status of SMS configuration. You access these workspaces through the SMS Configuration node in the Tivoli Enterprise Portal.
- Monitoring SMS storage groups performance
  This topic describes the workspaces that monitor the status of SMS storage groups performance. You access these workspaces through the SMS Storage Groups Performance node in the Tivoli Enterprise Portal.
- Monitoring SMS storage groups space
  This topic describes the workspaces that monitor the status of SMS Storage Groups Space. You access these workspaces through the SMS Storage Groups Space node in the Tivoli Enterprise Portal.
- Monitoring Storage Toolkit action requests
  This topic describes the workspaces that monitor the status of Storage Toolkit action requests. You access these workspaces through the Storage Toolkit Action Requests node in the Tivoli Enterprise Portal.
- Monitoring tape groups
  This topic describes the workspaces that monitor the status of tape groups. You access these workspaces through the Tape Group node in the Tivoli Enterprise Portal.
- Monitoring the performance of user DASD groups
  This topic describes the workspaces that report the performance of user DASD groups. This topic also describes the dialog boxes that you use to add, edit, delete, and migrate user DASD volume groups.
- Monitoring the space of user DASD groups
  This topic describes the workspaces that report the status of user DASD groups space. This topic also describes the dialog boxes that you use to add, edit, delete, and migrate a user DASD volume group.
- Monitoring Virtual Tape Subsystems (VTS)
  This topic describes the workspaces that monitor the status of virtual tape subsystems. You access these workspaces through the Virtual Tape Subsystems node in the Tivoli Enterprise Portal.
- Directly monitoring situations

## 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.

- Enterprise
- z/OS Systems
- System_name
- Storage Subsystem
- SYSTEM:SUBSYSTEM:AGENT_NAME
- Application Summary
- Channel Path
- Cache CU Performance
- Cache CU Status
- Logical Control Unit
- Tape Group
- Virtual Tape Subsystems
- SMS Storage Groups Performance
- SMS Storage Groups Space
- User DASD Groups Performance
- User DASD Groups Space
- DFSMShsm Status
- DFSMSrmm Status
- Dataset Attributes System Summary
- Dataset Group Summary
- SMS Configuration
- Storage Toolkit Action Requests

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 Tivoli OMEGAMON XE for Storage on z/OS in the portal

  Access Tivoli OMEGAMON XE 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 () 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.

### 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 Group workspace > Storage Group Performance Trend
  The SMS Storage Group 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 > Group Volume Historical Performance
  The Group Volume Historical Performance 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 Group Volume Historical Performance workspace to the Dataset Performance Summary History 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, LCUs, and TotalStorage facilities.

When viewing the point-in-time historical workspace, 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 limited, unpredictable results when used 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 Group Volume Historical 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. Tivoli OMEGAMON XE 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 Tivoli OMEGAMON XE 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 Tivoli OMEGAMON XE for Storage on z/OS to the workspaces of related products. Accessing workspaces provides general information about navigating workspaces.

Table 1. Links to workspaces of related products
Product to which Tivoli OMEGAMON XE for Storage on z/OS is linked | Workspace where the link is located in Tivoli OMEGAMON XE for Storage on z/OS | Name of the link in the pop-up menu
--- | --- | ---
IBM Tivoli Advanced Audit for DFSMShsm | DFSMShsm Status | Backup Control Dataset Error Summary
Migration Control Dataset Error Summary
Offline Control Dataset Error Summary
IBM Tivoli Advanced Reporter for DFSMShsm | DFSMShsm Status | BCDS Volume Summary
BCDS Details
Daily Space Management Detail
Daily Space Management Summary
DFSMShsm Return Code Summary
Extent Reduction Summary
Log Migration Detail
Log Recall Detail
MCDS Details
MCDS Volume Summary
SMS Configuration | BCDS Details
MCDS Details
IBM Tivoli Advanced Catalog Management for z/OS | Catalog Summary | Catalog Dataset Attributes
Catalog Details Link
Last Catalog Backup
Dataset Group Details Primary | Catalog Dataset Attributes
Catalog Details
Last Catalog Backup
Dataset Group Details VSAM | Catalog Dataset Attributes
Catalog Details
Last Catalog Backup
Dataset Group VSAM Attributes | Catalog Dataset Attributes
Catalog Details
Last Catalog Backup
IBM Tivoli OMEGAMON XE on z/OS | Application Summary | Address Space CPU Usage Details
Address Space CPU Usage Enclaves
Address Space Impact Analysis
Address Space Storage for Job
Owned Enclaves
DFSMShsm Function Details | Address Space Bottleneck Details
Address Space CPU Usage Details
Address Space CPU Usage Enclaves
Address Space Impact Analysis
Address Space Storage for Job
Owned Enclaves
DFSMShsm Host Details | Address Space Bottleneck Details
Address Space CPU Usage Details
Address Space CPU Usage Enclaves
Address Space Impact Analysis
Address Space Storage for Job
Owned Enclaves
DFSMShsm Status | Address Space Bottleneck Details
Address Space CPU Usage Details
Address Space CPU Usage Enclaves
Address Space Impact Analysis
Address Space Storage for Job
Owned Enclaves
DFSMShsm Storage Usage | Address Space Storage

## 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 Tivoli OMEGAMON XE 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.