Workspaces

The predefined workspaces in IBM Z OMEGAMON AI for Storage are described in this section.

When using Tivoli® Enterprise Portal, information is displayed in workspaces. Within a given workspace, information is displayed in tabular form. Tivoli Enterprise Portal refers to this tabular format for information as a table view.

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.

Information can also be displayed in the workspace as a chart, graph, or other format you can specify.

Information can be presented to you in any of the following views:

Table view
Pie chart view
Bar chart view
Plot chart view
Needle gauge view
Thermometer gauge view
Notepad view
Situation Event console view, which shows the status of the situations associated with the system.
Take Action view, which is used to send a command to the system.
Terminal view, which enables you to start a 3270 or 5250 work session.
Browser view, which permits you to open a browser to see HTML pages and Web sites.

Use the Export function of the Tivoli Enterprise Portal to store product data as text or as comma separated values (CSV format). For example, you can right-click on a table view and select Export to export the data in the view.

A workspace is the working area of the Tivoli Enterprise Portal application window. At the left of the workspace is a Navigator that permits you to select the workspace you want to display. As part of the application window, the right side of the status bar shows the Tivoli Enterprise Portal server name to which the displayed information applies, as well as the ID of the current user. Some key points about workspaces are as follows:

As you select items in the Navigator, the workspace presents views pertinent to your selection. Each workspace has at least one view.
Every workspace has a set of properties associated with it. You can customize the workspace by working in the Properties editor to change the style and content of each view.
Another way to customize the workspace is to change the type of view or to add views to the workspace.
Always save your changes before moving to a new workspace. Otherwise, the changes you make to the workspace are lost.
Some workspaces, such as those dedicated to tracking the metrics of a DS8000® storage device, are not available in selection menus and lists when DS8000 storage devices do not exist in the monitoring environment.

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

Nodes in the Navigator that 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 section 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.
The Standard tabs in the dialog boxes of the Storage Toolkit section describes the authorization that is required for the action requests of the Storage Toolkit.

Accessing IBM Z OMEGAMON AI for Storage in the portal

Access IBM Z OMEGAMON AI for Storage in the portal through the Navigator, as in the following example.

Click the plus sign (+) beside the z/OS® Systems icon to see available systems.
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.
Click the plus sign (+) beside the Storage Subsystem icon.
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.
Click the node of a workspace, for example, Application Summary. The portal displays the Application Summary workspace.

The Nodes in the Navigator that are linked to workspace section provides information on 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

Click the node. The node is activated and the corresponding workspace is displayed in the portal.
Right-click the node to display the pop-up menu.
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

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.
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 the Integration with other products section in this topic.

Standard path and method for navigating workspaces

This document presents the hierarchy of linked workspaces for each workspace node in IBM Z OMEGAMON AI for Storage. For example, the list in Monitoring applications 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:

Right-click the link icon () that is located at the left side of each row in a table view. (Most workspaces have at least one table view.)
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 IBM Z OMEGAMON AI for Storage have multiple subpaths.
Some subpaths terminate in the navigation tree structure of a different, but related, workspace node of IBM Z OMEGAMON AI for Storage. 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 () 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 dataset 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. IBM Z OMEGAMON AI for Storage uses that feature to provide predefined links that go to storage-related workspaces in Tivoli OMEGAMON® 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 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 products that report to the same Tivoli Enterprise Monitoring Server as IBM Z OMEGAMON AI for Storage and that run in the same logical partition.

Links to workspaces of related products

This section lists the links that are available from the workspaces of IBM Z OMEGAMON AI for Storage to the workspaces of related products. The Accessing workspaces section provides general information about navigating workspaces.

Table 1. Links to workspaces of related products
IBM Z OMEGAMON AI for Storage linked product	Workspace link location in IBM Z OMEGAMON AI for Storage	Name of the link in 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
	SMS Configuration	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 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 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.

Associating workspaces with attributes

There is a direct relationship between attributes and workspaces. An attribute group typically corresponds to a table view within a named workspace and attribute items correspond to columns in the table view.

Each Tivoli Enterprise Portal workspace displays real-time information or historical data for many of the attributes. The information is available to you, independent of whether you are using IBM Z OMEGAMON AI for Storage to monitor situations.

Using IBM Z OMEGAMON AI for Storage information

You can view information about each managed system that you are monitoring. Use this information to perform the following tasks:

Monitor the performance of each managed system, helping you to identify bottlenecks and evaluate tuning decisions
Select the most effective threshold values for situations you create
Review status information when a change in the state of a given resource occurs, such as from OK to Warning or Critical

Defining workspace properties

Every workspace has a set of properties associated with it. You can customize the workspace by working in the Properties editor to change the style and content of each view. Changes you make to workspace properties, such as adding or editing a view, are only temporary. They are lost when you exit IBM Z OMEGAMON AI for Storage unless you save the workspace.

The properties of a workspace can include some or all of the following:

Query: Specify what data must be specified in the chart or table
Filters: Refine the view by filtering out unwanted data from the chart or table
Thresholds: Establish threshold values and color indicators for a table view
Configuration: Specify the script to run or the connection to make whenever you open the terminal view
Style: Change the behavior and appearance of the view

Investigating a situation event

When the conditions of a situation have been met, the situation evaluates to True, causing a situation event indicator to be displayed in the Navigator. You can investigate the situation event by opening its workspace.

The situation event workspace shows two table views, one with the values of the attributes when the situation evaluated to True, and the other with the attributes' current values.

The situation event workspace can also display a text view with any expert advice written by the author of the situation, and the Take Action view so you can send a command to the application started on that system.

Filtering information

To manually set up filtering for a given table view, place the cursor on the table view, press the right mouse button, and select Properties. (The equivalent keystroke is Ctrl+R.) From the displayed dialog box, select the Filters tab. Here you can select the columns to display as well as set up the criteria for which rows to display. To save your filtering specifications, you must save the workspace before exiting.

Sorting information

Sorting is handled by simply clicking on a column heading. Click once and the report is sorted in ascending order. Click a second time to resort the report into descending order. A third click returns you to the report's default sort order.

Adding a workspace to your favorites

When using IBM Z OMEGAMON AI for Storage in browser mode, you can start it from any workstation by entering the URL of the Tivoli Enterprise Portal server where the browser mode client is installed. Each Tivoli Enterprise Portal workspace also has a URL, so that you can save the workspace to your Favorites list or specify it as your home page.