IBM Tivoli Advanced Reporting for DFSMShsm …publib.boulder.ibm.com/tividd/td/TARfDFSM/SC27-2352-01/en_US/PDF… · ® IBMTivoliAdvanced Reporting for DFSMShsm Monitoring Agent

Tivoli® IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgentVersion 02.30.00

User's Guide

SC27-2352-01

��

Tivoli® IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgentVersion 02.30.00

User's Guide

SC27-2352-01

��

NoteBefore using this information and the product it supports, read the information in Appendix D, “Notices,” on page 313.

This edition applies to version 02.30.00 of IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent(product number 5698-B14) and to all subsequent releases and modifications until otherwise indicated in neweditions.

© Copyright IBM Corporation 2008.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

Contents

Tables . . . . . . . . . . . . . . . v

Chapter 1. Overview of the IBM TivoliAdvanced Reporting for DFSMShsmMonitoring Agent . . . . . . . . . . . 1IBM Tivoli Monitoring overview. . . . . . . . 1Features of the monitoring agent . . . . . . . 1Functions of the monitoring agent . . . . . . . 1New in this release . . . . . . . . . . . . 2Components of the IBM Tivoli Monitoringenvironment . . . . . . . . . . . . . . 2User interface options . . . . . . . . . . . 2

Chapter 2. Requirements for themonitoring agent . . . . . . . . . . . 5Requirements for the monitoring agent . . . . . 5Installing language packs . . . . . . . . . . 6

Windows systems. . . . . . . . . . . . 6UNIX or Linux systems. . . . . . . . . . 6

Chapter 3. Workspaces reference . . . . 9About workspaces . . . . . . . . . . . . 9More information about workspaces . . . . . . 9Predefined workspaces . . . . . . . . . . . 9Agent Navigator items. . . . . . . . . . . 11

IBM Tivoli Advanced Reporting for DFSMShsmNavigator item . . . . . . . . . . . . 11Advanced Reporting Event Data Navigator item 11BCDS Details Navigator item . . . . . . . 12BCDS Volume Summary Navigator item. . . . 12CDS SMS Class Summary Navigator item . . . 12Daily Space Management Detail Navigator item 12Daily Space Management Summary Navigatoritem . . . . . . . . . . . . . . . . 13DFSMShsm Collection Data Navigator item . . 13Extent Reduction Summary Navigator item. . . 13Filter Attribute Group Navigator item . . . . 14Health Reports Navigator item . . . . . . . 14HSM Host Information Navigator item . . . . 15Log Migration Detail Navigator item . . . . . 16Log Recall Detail Navigator item . . . . . . 16MCDS Details Navigator item . . . . . . . 16MCDS Volume Summary Navigator item . . . 16Reports From The CDSS Navigator item. . . . 17Return Code Summary Navigator item . . . . 19

Chapter 4. Attributes reference . . . . 21About attributes . . . . . . . . . . . . . 21More information about attributes . . . . . . . 21Attribute groups and attributes for the IBM TivoliAdvanced Reporting for DFSMShsm MonitoringAgent . . . . . . . . . . . . . . . . 21Activity Logs attribute group . . . . . . . . 26Advanced Reporting Event Data attribute group . . 27

Advanced Reporting Messages attribute group . . 28Backup Data Sets attribute group . . . . . . . 30Backup Versions attribute group . . . . . . . 34Backup Volumes attribute group . . . . . . . 37BCDS Details attribute group . . . . . . . . 42BCDS Volume Summary attribute group. . . . . 44CDS SMS Class Summary attribute group . . . . 44Control Data Sets attribute group . . . . . . . 45Daily Function Stats attribute group . . . . . . 47Daily Space Management Detail attribute group . . 51Daily Space Management Summary attribute group 54Daily Statistics attribute group . . . . . . . . 56Daily Volume Stats attribute group . . . . . . 65DFSMS Class Summary attribute group . . . . . 69DFSMShsm Functions attribute group . . . . . 71Dump Classes attribute group . . . . . . . . 72Dump Data Sets attribute group . . . . . . . 75Dump Versions attribute group . . . . . . . . 77Dump Volumes attribute group. . . . . . . . 81Exit Information attribute group . . . . . . . 85Extent Reduction Summary attribute group. . . . 88Extent Reductions attribute group . . . . . . . 89Filter Attribute Group attribute group . . . . . 95Function Records attribute group . . . . . . . 96Function Summary attribute group . . . . . . 102HSM Backup Reports attribute group . . . . . 103HSM CDS Backups attribute group . . . . . . 104HSM CDS Space attribute group . . . . . . . 105HSM CDS Users attribute group . . . . . . . 118HSM Health Detail Reports attribute group . . . 121HSM Host Info attribute group . . . . . . . 129HSM Migration Reports attribute group . . . . 137HSM Volume Dump Reports attribute group . . . 138Issue HSM Commands attribute group . . . . . 139Log Data Sets attribute group . . . . . . . . 141Log Migration Detail attribute group . . . . . 142Log Recall Detail attribute group . . . . . . . 144MCDS Details attribute group . . . . . . . . 147MCDS Volume Summary attribute group . . . . 150Migrated Data Sets attribute group . . . . . . 151Migration Volumes attribute group . . . . . . 160Mounted Volumes attribute group . . . . . . 168MWE Queue Contents attribute group . . . . . 175Patches attribute group . . . . . . . . . . 179Performance Object Status attribute group. . . . 181Return Code Summary attribute group . . . . . 184SETSYS Values attribute group . . . . . . . 185SMS HSM Mounted Volume Reports attributegroup . . . . . . . . . . . . . . . . 186Tape Copy Needed attribute group . . . . . . 187Tape Volumes attribute group . . . . . . . . 189Thrashing Report attribute group. . . . . . . 191Volume Statistics Records attribute group . . . . 193Disk capacity planning for historical data . . . . 200

© Copyright IBM Corp. 2008 iii

Chapter 5. Situations reference. . . . 203About situations . . . . . . . . . . . . 203More information about situations . . . . . . 203Predefined situations . . . . . . . . . . . 204IBM Tivoli Advanced Reporting for DFSMShsmNavigator item . . . . . . . . . . . . . 206Advanced Reporting Event Information Navigatoritem . . . . . . . . . . . . . . . . 206BCDS Details Navigator item . . . . . . . . 206BCDS Volume Summary Navigator item . . . . 206CDS SMS Class Summary Navigator item . . . . 206Daily Space Management Detail Navigator item 206Daily Space Management Summary Navigator item 206DFSMShsm Collection Data Navigator item . . . 206Extent Reduction Summary Navigator item . . . 206Filter Attribute Group Navigator item . . . . . 206Health Reports Navigator item . . . . . . . 206HSM Host Information Navigator item . . . . . 207Log Migration Detail Navigator item . . . . . 207Log Recall Detail Navigator item . . . . . . . 207

KRH_Error_Editing_CDS situation . . . . . 207KRH_Mig_Vol_Not_Avail situation . . . . . 207KRH_No_Pri_Vol_Avail situation . . . . . . 208KRH_Request_Vol_Not_Avail situation . . . . 208KRH_Insuff_Sp_On_Trg_Vol situation . . . . 209KRH_No_Unit_Avail situation . . . . . . . 210KRH_Cant_Recover_w_NewName situation . . 210KRH_Recover_Failed situation. . . . . . . 211KRH_Recall_Delete_Held situation . . . . . 211KRH_Restore_Failed situation . . . . . . . 212KRH_Recall_Recover_Error situation . . . . 212KRH_No_Pri_Vol_Avail situation . . . . . . 213KRH_No_Uni_Avail situation . . . . . . . 214KRH_Recover_Failed situation. . . . . . . 214KRH_Existing_DS_Delete_Err situation . . . . 215KRH_Recall_Delete_Held situation . . . . . 215KRH_Recall_Recovery_Err situation . . . . . 216

MCDS Details Navigator item . . . . . . . . 216MCDS Volume Summary Navigator item . . . . 216Reports From The CDSS Navigator item . . . . 216Return Code Summary Navigator item . . . . . 217

KRH_No_Mig_Vol_Available situation . . . . 217KRH_Duplicate_DSN_In_MCDS situation . . . 217KRH_Mig_Copy_Already_Exist situation . . . 218KRH_Data_Set_In_Use situation . . . . . . 218KRH_No_Space_In_Mig_Vol situation . . . . 219KRH_L0_Vol_Not_Available situation . . . . 219KRH_Migration_Held situation . . . . . . 220KRH_Unsupported_Data_Set situation . . . . 221KRH_Cant_Mv_Bkup_Miss_Vol situation . . . 221KRH_No_Vol_For_Bkup situation . . . . . 222KRH_Data_Set_In_Use situation . . . . . . 222KRH_DS_Not_Elig_For_Bkup situation . . . . 223KRH_Ext_Record_Missing situation . . . . . 223KRH_No_Space_On_Bkup_Vol situation . . . 224KRH_Bkup_Funct_Disabled situation . . . . 225KRH_Bkup_Failed_For_DSN situation . . . . 225KRH_Backup_Held situation . . . . . . . 226KRH_BCDS_Record_Not_Found situation . . . 226KRH_Fail_In_Bkvol_Dump situation . . . . 227KRH_Unsupported_Data_Set situation . . . . 227

Chapter 6. Take Action commandsreference . . . . . . . . . . . . . 229About Take Action commands. . . . . . . . 229More information about Take Action commands 229Predefined Take Action commands . . . . . . 229HBACKDS action . . . . . . . . . . . . 230HBDELETE action . . . . . . . . . . . . 231HCANCEL action . . . . . . . . . . . . 233HDELETE action . . . . . . . . . . . . 235HMIGRATE action . . . . . . . . . . . 236HRECALL action . . . . . . . . . . . . 237HRECOVER action . . . . . . . . . . . 239

Chapter 7. Policies reference. . . . . 243About policies . . . . . . . . . . . . . 243More information about policies . . . . . . . 243Predefined policies . . . . . . . . . . . 243

Chapter 8. Troubleshooting . . . . . 245Built-in troubleshooting features . . . . . . . 245Problem classification. . . . . . . . . . . 245Trace logging . . . . . . . . . . . . . 245

Overview of log file management . . . . . 246Principal trace log files . . . . . . . . . 246Setting RAS trace parameters . . . . . . . 249

Problems and workarounds . . . . . . . . 251Installation and configuration troubleshooting 251Remote deployment troubleshooting . . . . 253Agent troubleshooting . . . . . . . . . 254Workspace troubleshooting . . . . . . . . 255Situation troubleshooting . . . . . . . . 257Take Action commands troubleshooting . . . 260Tivoli Common Reporting troubleshooting . . 260

Support information . . . . . . . . . . . 260Informational, warning, and error messages . . . 261

Message format . . . . . . . . . . . 261IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent messages . . . . . . . 262IBM Tivoli Common Data Collection Agent(TEDA) messages . . . . . . . . . . . 262

Appendix A. IBM Tivoli EnterpriseConsole event mapping . . . . . . . 279

Appendix B. Documentation library 309IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent library . . . . . . . . . 309Prerequisite publications. . . . . . . . . . 309Related publications . . . . . . . . . . . 310Other sources of documentation . . . . . . . 310

Appendix C. Accessibility . . . . . . 311Navigating the interface using the keyboard . . . 311Magnifying what is displayed on the screen . . . 311

Appendix D. Notices . . . . . . . . 313Trademarks . . . . . . . . . . . . . . 314

Index . . . . . . . . . . . . . . . 317

iv IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide

Tables

1. Capacity planning for historical data loggedby component Advanced Reporting forDFSMShsm . . . . . . . . . . . . 200

2. Trace log files for troubleshooting agents 2463. Problems and solutions for installation and

configuration . . . . . . . . . . . 2514. General problems and solutions for

uninstallation . . . . . . . . . . . 2535. Remote deployment problems and solutions 2536. Agent problems and solutions . . . . . . 2547. Workspace problems and solutions . . . . 256

8. General situation problems and solutions 2579. Problems with configuring situations that you

solve in the Situation Editor . . . . . . 25810. Problems with configuration of situations that

you solve in the Workspace area . . . . . 25911. Take Action commands problems and

solutions . . . . . . . . . . . . . 26012. Tivoli Common Reporting for IBM Tivoli

Advanced Reporting for DFSMShsmMonitoring Agent problems and solutions . . 260

© Copyright IBM Corp. 2008 v

vi IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide

Chapter 1. Overview of the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent

The IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent providesyou with the capability to monitor IBM Tivoli Advanced Reporting for DFSMShsm,and to perform basic actions with IBM Tivoli Advanced Reporting for DFSMShsm.This chapter provides a description of the features, components, and interfaceoptions for the IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent.

IBM Tivoli Monitoring overviewIBM Tivoli Monitoring is the base software for the IBM Tivoli Advanced Reportingfor DFSMShsm Monitoring Agent. IBM Tivoli Monitoring provides a way tomonitor the availability and performance of all the systems in your enterprise fromone or several designated workstations. It also provides useful historical data thatyou can use to track trends and to troubleshoot system problems.

You can use IBM Tivoli Monitoring to perform the following tasks:v Monitor for alerts on the systems that you are managing by using predefined

situations or custom situations.v Establish your own performance thresholds.v Trace the causes leading to an alert.v Gather comprehensive data about system conditions.v Use policies to perform actions, schedule work, and automate manual tasks.

The Tivoli Enterprise Portal is the interface for IBM Tivoli Monitoring products. Byproviding a consolidated view of your environment, the Tivoli Enterprise Portalpermits you to monitor and resolve performance issues throughout the enterprise.

See the IBM Tivoli Monitoring publications listed in “Prerequisite publications” onpage 309 for complete information about IBM Tivoli Monitoring and the TivoliEnterprise Portal.

Features of the monitoring agentThe IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent softwarecan identify, notify you of, and correct common problems with the application thatit monitors. The software includes the following features:v Monitoringv Data gatheringv Event managementv Operations management

Functions of the monitoring agentThe IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent monitorsand collects data from the managed system and passes the data to monitoringservers, receives instructions from the monitoring servers, and issues commandstot he managed systems.

© Copyright IBM Corp. 2008 1

New in this releaseFor version 02.30.00 of the IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent, the following enhancements have been made since version 2.2,including the fix packs:v New attribute groups

– HSM Host Information– Reports from the CDSS– Health Reports– DFSMShsm Collection Data

v New or changed attributes in the following attribute groups– HSM Host Information– Reports from the CDSS– Health Reports– DFSMShsm Collection Data

v Updated krh.baroc file to support TEC event mapping

Components of the IBM Tivoli Monitoring environmentAfter you install and set up the IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent, you have an environment that contains the client, server, andmonitoring agent implementation for IBM Tivoli Monitoring that contains thefollowing components:v Tivoli Enterprise Portal client with a Java™-based user interface for viewing and

monitoring your enterprise.v Tivoli Enterprise Portal Server that is placed between the client and the Tivoli

Enterprise Monitoring Server and enables retrieval, manipulation, and analysisof data from the monitoring agents. The Tivoli Enterprise Portal Server is thecentral repository for all user data.

v Tivoli Enterprise Monitoring Server that acts as a collection and control point foralerts received from the monitoring agents, and collects their performance andavailability data. The Tivoli Enterprise Monitoring Server is also a repository forhistorical data.

v Tivoli Enterprise Monitoring Agent, IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent. This monitoring agent collects and distributesdata to a Tivoli Enterprise Portal Server.

IBM Tivoli Enterprise Console is an optional component, which acts as a centralcollection point for events from a variety of sources, including those from otherTivoli® software applications, Tivoli partner applications, custom applications,network management platforms, and relational database systems. You can viewthese events through the Tivoli Enterprise Portal (using the event viewer), and youcan forward events from IBM Tivoli Monitoring situations to the IBM TivoliEnterprise Console component.

User interface optionsInstallation of the base software and other integrated applications provides thefollowing interfaces that you can use to work with your resources and data:

Tivoli Enterprise Portal browser client interfaceThe browser client interface is automatically installed with the Tivoli

2 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide

Enterprise Portal Server. To start the Tivoli Enterprise Portal browser clientin your Internet browser, enter the URL for a specific Tivoli EnterprisePortal browser client installed on your Web server.

Tivoli Enterprise Portal desktop client interfaceThe desktop client interface is a Java-based graphical user interface (GUI)on a Windows® or Linux® workstation.

IBM Tivoli Enterprise ConsoleAn event management application that integrates system, network,database, and application management to help ensure the optimalavailability of an IT services for an organization.

Manage Tivoli Enterprise Monitoring Services windowThe window for the Manage Tivoli Enterprise Monitoring Services utility isused for configuring the agent and starting Tivoli services not alreadydesignated to start automatically.

Chapter 1. Overview of the IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent 3


Chapter 2. Requirements for the monitoring agent

This chapter contains information about the requirements for the IBM TivoliAdvanced Reporting for DFSMShsm Monitoring Agent.

To install and configure the IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent, use the procedures for installing monitoring agents in the IBMTivoli Monitoring Installation and Setup Guide.

If you are performing a silent installation using a response file, see the informationabout performing a silent installation in the IBM Tivoli Monitoring Installation andSetup Guide.

Requirements for the monitoring agentIn addition to the requirements described in the IBM Tivoli Monitoring Installationand Setup Guide, the IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent has the following requirements:v The monitoring agent runs on any of these operating systems:

– Windows 2003 Server SE (32 bit) with Service Pack 1 or higher– z/OSIf running this monitoring agent on a Windows operating system, the User IDmust have Administrator privileges.

Note: For the most current information about the operating systems that aresupported, see http://www-306.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html.

v This agent monitors the following versions:– IBM Tivoli Advanced Reporting for DFSMShsm 2.3

v A single computer that hosts the hub monitoring server, portal server, and amonitoring agent requires approximately 300 MB of space. A computer thathosts only the monitoring agent requires approximately 30 MB of space,including the specific enablement code for the monitoring agent. More space isrequired for each additional monitoring agent that you deploy on themonitoring computer.

v The monitoring agent must be connected to the following software:– IBM Tivoli Monitoring V6.2.1After you install the prerequisite software, install the following software, whichis required for the IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent to operate:– IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent– IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent for Tivoli

Enterprise Monitoring Server support– IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent for Tivoli

Enterprise Portal Server support– IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent for Tivoli

Enterprise Portal Desktop Client support– IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent for Tivoli

Enterprise Portal Browser Client support


http://www-306.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html

http://www-306.ibm.com/software/sysmgmt/products/support/Tivoli_Supported_Platforms.html

Installing language packsTo install a language pack, first make sure that you have already installed theproduct in English, then perform the following steps depending on whichoperating system you are using.

Windows systems1. Double-click lpinstaller.bat in the language pack CD to launch the installation

program.2. Select the language of the installer and click OK.3. Click Next on the Introduction panel.4. Click Add/Update and click Next.5. Select the folder in which the National Language Support package

(NLSPackage) files are located.

Note: Usually the NLSPackage files are located in the nlspackage folderwhere the installer executable is located.

6. Select the language support for the agent of your choice and click Next.

Note: Hold down the Ctrl key for multiple selections.7. Select the languages that you want to install and click Next.8. Examine the installation summary page and click Next to begin installation.9. Click Finish after installation completes to exit the installer.

10. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,and Eclipse Help Server if any of these components are installed.

UNIX or Linux systems1. Run the following command to create a temporary directory on the computer.

Make sure that the full path of the directory does not contain any spaces:mkdir dir_name

2. Mount the language pack CD to the temporary directory you just created.3. Run the following command to launch the installation program:

cd dir_namelpinstaller.sh -c ITM Home Directory

Where ITM Home Directory is where you installed IBM Tivoli Monitoring.Usually it is /opt/IBM/ITM for AIX and Linux.

4. Select the language of the installer and click OK.5. Click Next on the Introduction panel.6. Click Add/Update and click Next.7. Select the folder in which the National Language Support package

(NLSPackage) files are located.

Note: Usually, the NLSPackage files are located in the nlspackage folderwhere the installer executable is located.

8. Select the language support for the agent of your choice and click Next.

Note: Hold down the Ctrl key for multiple selections.9. Select the languages that you want to install and click Next.

10. Examine the installation summary page and click Next to begin installation.


11. Click Finish after installation completes to exit the installer.12. Restart Tivoli Enterprise Portal Desktop Client, Tivoli Enterprise Portal Server,

and Eclipse Help Server if any of these components are installed.

Chapter 2. Requirements for the monitoring agent 7


Chapter 3. Workspaces reference

This chapter contains an overview of workspaces, references for detailedinformation about workspaces, and descriptions of the predefined workspacesincluded in this monitoring agent.

About workspacesA workspace is the working area of the Tivoli Enterprise Portal applicationwindow. At the left of the workspace is a Navigator that you use to select theworkspace you want to see. As part of the application window, the right side ofthe status bar shows the Tivoli Enterprise Portal server name and port number towhich the displayed information applies, and the ID of the current user.

When you select an item in the Navigator tree, a default workspace is displayed.When you right-click a Navigator item, a menu that includes a Workspace item isdisplayed. The Workspace item contains a list of workspaces for that Navigatoritem. Each workspace has at least one view. Some views have links to otherworkspaces.

This monitoring agent provides predefined workspaces. You cannot modify ordelete the predefined workspaces, but you can create new workspaces by editingthem and saving the changes with a different name.

A table view within a workspace corresponds to a group of attributes; the columnsin the table view show some or all of the attributes available in the attribute group.

More information about workspacesFor more information about creating, customizing, and working with workspaces,see the Tivoli Enterprise Portal User's Guide.

For a list of the predefined workspaces for this monitoring agent and a descriptionof each workspace, refer to the Predefined workspaces section in this chapter andthe information in that section for each individual workspace.

Some attribute groups for this monitoring agent might not be represented in thepredefined workspaces or views for this agent. For a full list of the attributegroups, see the Attributes reference section.

Predefined workspaces

The IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent providesthe following predefined workspaces, which are organized by Navigator item.v IBM Tivoli Advanced Reporting for DFSMShsm Navigator item

– IBM Tivoli Advanced Reporting for DFSMShsm workspacev Advanced Reporting Event Data Navigator item

– Advanced Reporting Event Data workspace– Advanced Reporting Event Messages workspace

v BCDS Details Navigator item


– BCDS Detail workspacev BCDS Volume Summary Navigator item

– BCDS Volume Summary workspacev CDS SMS Class Summary Navigator item

– CDS SMS Class Summary workspacev Daily Space Management Detail Navigator item

– Daily Space Management Detail workspace– Daily Space Management Summary workspace

v Daily Space Management Summary Navigator item– Daily Space Management Summary workspace

v DFSMShsm Collection Data Navigator item– DFSMShsm Collection Data workspace– Thrashing Report– Function Summary– Function Records– Extent Reduction

v Extent Reduction Summary Navigator item– Extent Reduction Summary workspace

v Filter Attribute Group Navigator item– Filter Attribute Group workspace

v Health Reports Navigator item– Health Reports workspace– SMS HSM Mounted Volume Reports– HSM Migration Reports– HSM Backup Reports– HSM Volume Dump Reports– HSM Health Detail Reports– Health Reports

v HSM Host Information Navigator item– HSM Host Information workspace– Control Data Sets– Log Data Sets– Mounted Volumes– MWE Queue Contents– SETSYS Values– Exit Information– Patches– Activity Logs– DFSMShsm Functions

v Log Migration Detail Navigator item– Log Migration Detail workspace

v Log Recall Detail Navigator item– Log Recall Detail workspace

v MCDS Details Navigator item– MCDS Details workspace


v MCDS Volume Summary Navigator item– MCDS Volume Summary workspace

v Reports From The CDSs Navigator item– Reports From The CDSs workspace– HSM CDS Users workspace– HSM CDS Backups workspace– HSM CDS Space– Migrated Data Sets– Backup Data Sets– Backup Versions– Dump Data Sets– Migration Volumes– Backup Volumes– Dump Volumes– Dump Versions– Tape Volumes– Tape Copy Needed– Dump Classes– Daily Statistics– Daily Function Statistics– Volume Statistics Records– Daily Volume Statistics– DFSMS Class Summary

v Return Code Summary Navigator item– Return Code Summary workspace

Agent Navigator itemsThis section contains descriptions of predefined workspaces. The workspaces areorganized by the Navigator item to which the workspaces are relevant.

IBM Tivoli Advanced Reporting for DFSMShsm Navigator itemIBM Tivoli Advanced Reporting for DFSMShsm workspace

This workspace appears when you select the Advanced Reporting forDFSMShsm navigator item. It provides a display area for AdvancedReporting for DFSMShsm reports, which in turn provide access to the TakeAction commands.

Advanced Reporting Event Data Navigator itemAdvanced Reporting Event Data workspace

Advanced Reporting Event Data workspace provides information on eventdetails

This workspace contains the following view:

Advanced Reporting Event DataAdvanced Reporting Event Data.

Chapter 3. Workspaces reference 11

Advanced Reporting Event Messages workspaceAdvanced Reporting Event Messages workspace provides detailedinformation about event messages.


Advanced Reporting Event MessagesAdvanced Reporting Event Message details.

BCDS Details Navigator itemBCDS Details workspace

BCDS Detail workspace showing the details


BCDS DetailDetails for BCDS.

BCDS Volume Summary Navigator itemBCDS Volume Summary workspace

The BCDS Volume Summary workspace provides volume summaryinformation for the BCDS.


BCDS Volume SummaryBCDS volume summary.

CDS SMS Class Summary Navigator itemCDS SMS Class Summary workspace

CDS Summary by SMS Class workspace showing the summary


CDS Summary by SMS ClassCDS SMS class summary.

Daily Space Management Detail Navigator itemDaily Space Management Detail workspace

Daily Space Management Summary workspace showing the summary forthe daily space management


Daily Space Management SummaryDaily Space Management Summary.

Daily Space Management Summary workspaceThe Daily Space Management Summary workspace provides detailinformation for the daily space management.


Daily Space Management SummaryDaily Space Management Summary.


Daily Space Management Summary Navigator itemDaily Space Management Summary workspace

The Daily Space Management Summary workspace provides detailinformation for the daily space management.


Daily Space Management SummaryDaily space management summary.

DFSMShsm Collection Data Navigator itemDFSMShsm Collection Data workspace

DFSMShsm Collection Data workspace showing reports on DFSMShsmActivity


DFSMShsm CollectionDFSMShsm Collection.

Thrashing Report workspaceThrashing Report workspace shows information about migration/recallthrashing activity.


Migration/Recall ThrashingShows information about migration/recall thrashing activity.

Function Summary workspaceFunction Summary workspace shows a summarization of DFSMShsmfunction activity.


Function SummaryShows a summarization of DFSMShsm function activity.

Function Records workspaceThrashing Report workspace shows detailed information about functionactivity.


Function Activity DetailsShows detailed information about function activity.

Extent Reduction workspaceExtent Reduction workspace shows information about extent reductionactivity.


Extent Reduction ActivityShows information about extent reduction activity.

Extent Reduction Summary Navigator itemExtent Reduction Summary workspace

The Extent Reduction Summary workspace provides detail information forthe extent reduction.



Extent Reduction SummaryExtent reduction summary.

Filter Attribute Group Navigator itemFilter Attribute Group workspace

Filter Attribute Group workspace showing the available filters


Filter Attribute GroupFilter Attribute Group.

Health Reports Navigator itemHealth Reports workspace

Health Reports workspace showing reports on DFSMShsm health


Health ReportsHealth Reports.

SMS HSM Mounted Volume Reports workspaceSMS HSM Mounted Volume Reports workspace showing summaryinformation for the mounted volumes.


SMS HSM Mounted Volume ReportsShows summary information for mounted volumes.

HSM Migration Reports workspaceHSM Migration Reports workspace showing a summary of migrationstatus


HSM Migration ReportsShows a summary of migration status.

HSM Backup Reports workspaceHSM Backup Reports workspace showing a summary of backup activity.


HSM Backup ReportsShows a summary of backup activity.

HSM Volume Dump Reports workspaceHSM Volume Dump Reports workspace showing a summary of volumedump activity.


HSM Volume Dump ReportsShows a summary of volume dump activity.

HSM Health Detail Reports workspaceHSM Health Detail Reports workspace showing detailed healthinformation for specific volumes.


HSM Health Detail ReportsShows detailed health information for specific volumes.


Health Reports workspaceHealth Reports workspace showing summary information for the mountedvolumes.


Health ReportsShows summary information for the mounted volumes.

HSM Host Information Navigator itemHSM Host Information workspace

HSM Host Information workspace showing information on activeDFSMShsm Hosts


HSM Host InformationLists active HSM hosts.

Control Data Sets workspaceControl Data Sets workspace shows a list of the HSM control data sets.


Control Data SetsLists the HSM control data sets.

Log Data Sets workspaceLog Data Sets workspace showing a list of HSM ARCLOG data sets.


Log Data SetsShows a list of HSM ARCLOG data sets.

Mounted Volumes workspaceMounted Volumes workspace showing a list of volumes used in HSMprocessing.


Mounted VolumesShows a list of volumes used in HSM processing.

MWE Queue Contents workspaceMWE Queue Contents workspace showing current HSM work elements.


MWE Queue ContentsShows current HSM work elements.

SETSYS Values workspaceSETSYS Values workspace showing current SETSYS processing values.


SETSYS ValuesShows current SETSYS processing values.

Exit Information workspaceExit Information workspace showing a list of HSM exits in use.



Exit InformationShows a list of HSM exits in use.

Patches workspacePatches workspace showing a list of patches available to DFSMShsm.


PatchesShows a list of patches available to DFSMShsm.

Activity Logs workspaceActivity Logs workspace showing a list of DFSMShsm activity logs.


Activity LogsShows a list of DFSMShsm activity logs.

DFSMShsm Functions workspaceDFSMShsm Functions workspace showing status information for a list ofDFSMShsm functions.


DFSMShsm FunctionsShows status information for a list of DFSMShsm functions.

Log Migration Detail Navigator itemLog Migration Detail workspace

The Log Migration Detail workspace provides detail information for themigration log


Log migration detailLog migration detail.

Log Recall Detail Navigator itemLog Recall Detail workspace

Log Recall Detail workspace showing the details


Log Recall DetailDetail of recall log.

MCDS Details Navigator itemMCDS Details workspace

The MCDS Details workspace provides detail information for the MCDS.


MCDS DetailMCDS details.

MCDS Volume Summary Navigator itemMCDS Volume Summary workspace

The MCDS Volume Summary workspace provides volume summaryinformation for the MCDS.



MCDS Volume SummaryMCDS volume summary.

Reports From The CDSS Navigator itemReports From The CDSS workspace

Reports From The CDSS workspace showing information from DFSMShssControl Data Sets


Reports From The CDSSReports From The CDSS.

HSM CDS Users workspaceHSM CDS Users workspace shows information from DFSMShsm ControlData Sets.


HSM CDS UsersInformation from the DFSMShsm Control Data Sets about the HSMCDS users.

HSM CDS Backups workspaceHSM CDS Backups workspace shows backup version information fromDFSMShsm Control Data Sets.


HSM CDS BackupsHSM CDS Backups workspace shows backup version informationfrom DFSMShsm Control Data Sets.

HSM CDS Space workspaceHSM CDS Space workspace shows space information from DFSMShsmControl Data Sets.


HSM CDS SpaceHSM CDS Space workspace shows space information fromDFSMShsm Control Data Sets.

Migrated Data Sets workspaceMigrated Data Sets workspace shows data set-level migration informationfrom the control data sets.


Migrated Data SetsShows data set-level migration information.

Backup Data Sets workspaceBackup Data Sets workspace shows data set-level backupinformation from DFSMShsm Control Data Sets.


Backup Data SetsShows data set-level backup information from DFSMShsmControl Data Sets.


Dump Data Sets workspaceDump Data Sets workspace shows information about the data setson dump volumes.


Dump Data SetsShows information about the data sets on dump volumes.

Migration Volumes workspaceMigration Volumes workspace shows information about thevolumes used in MIGRATE commands.


Migration VolumesShows information about the volumes used in MIGRATEcommands.

Backup Volumes workspaceBackup Volumes workspace shows information about volumescontaining backup data.


Backup VolumesShows information about the volumes containing backupdata.

Dump Volumes workspaceDump Volumes workspace contains volume dump copies.


Dump VolumesContains volume dump copies.

Dump Versions workspaceDump Versions workspace lists versions of dump copies.


Dump VersionsLists versions of dump copies.

Tape Volumes workspaceTape Volumes workspace shows tape volume information.


Tape VolumesShows tape volume information.

Tape Copy Needed workspaceTape Copy Needed workspace shows information about tapevolumes that need updating.


Tape Copy NeededShows information about tape volumes that need updating.

Dump Classes workspaceDump Classes workspace shows information about dump classesand their attributes.



Dump ClassesShows information about dump classes and their attributes.

Daily Statistics workspaceDaily Statistics workspace shows the daily statistics kept by HSM.


Daily StatisticsShows daily statistics kept by HSM.

Daily Function Statistics workspaceDaily Function Statistics workspace shows the daily statistics forfunctions.


Daily Function StatisticsShows the daily statistics for functions.

Volume Statistics Records workspaceVolume Statistics Records workspace shows statistics records forvolumes.


Volume Statistics RecordsShows statistics records for volumes.

Daily Volume Statistics workspaceDaily Volume Statistics workspace shows volume statistics byfunction.


Daily Volume StatisticsShows volume statistics by function.

DFSMS Class Summary workspaceDFSMS Class Summary workspace shows a summary of DFSMSclasses.


DFSMS Class SummaryShows a summary of DFSMS classes.

Return Code Summary Navigator itemReturn Code Summary workspace

The Return Code Summary workspace provides summary information forthe return codes.


Return Code SummaryReturn code summary.



Chapter 4. Attributes reference

This chapter contains an overview of attributes, references for detailed informationabout attributes, and descriptions of the attributes for each attribute groupincluded in this monitoring agent.

About attributesAttributes are the application properties being measured and reported by the IBMTivoli Advanced Reporting for DFSMShsm Monitoring Agent.

Attributes are organized into groups according to their purpose. The attributes in agroup can be used in the following two ways:v Chart or table views

Attributes are displayed in chart and table views. The chart and table views usequeries to specify which attribute values to request from a monitoring agent.You use the Query editor to create a new query, modify an existing query, orapply filters and set styles to define the content and appearance of a view basedon an existing query.

v SituationsYou use attributes to create situations that monitor the state of your operatingsystem, database, or application. A situation describes a condition you want totest. When you start a situation, the Tivoli Enterprise Portal compares the valuesyou have assigned to the situation attributes with the values collected by theIBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent and registersan event if the condition is met. You are alerted to events by indicator icons thatare displayed in the Navigator.

More information about attributesFor more information about using attributes and attribute groups, see the TivoliEnterprise Portal User's Guide.

For a list of the attributes groups, a list of the attributes in each attribute group,and descriptions of the attributes for this monitoring agent, see the Attributegroups and attributes section in this chapter.

Attribute groups and attributes for the IBM Tivoli Advanced Reportingfor DFSMShsm Monitoring Agent

This monitoring agent contains the following attribute groups. The table namedepends on the maximum table name limits of the target database being used forTivoli Data Warehouse. If the maximum name is 30 characters, then any warehousetable name longer than 30 characters is shortened to the table name.v Attribute group name: Activity Logs

– Table name: KRHACTLOGS– Warehouse table name: KRH_ACTIVITY_LOGS or KRHACTLOGS

v Attribute group name: Advanced Reporting Event Data– Table name: KRHAREVENT


– Warehouse table name: KRH_ADVANCED_REPORTING_EVENT_DATA orKRHAREVENT

v Attribute group name: Advanced Reporting Messages– Table name: KRHARMSGS– Warehouse table name: KRH_ADVANCED_REPORTING_MESSAGES or

KRHARMSGSv Attribute group name: Backup Data Sets

– Table name: KRHBKUPDSN– Warehouse table name: KRH_BACKUP_DATA_SETS or KRHBKUPDSN

v Attribute group name: Backup Versions– Table name: KRHBKUPVER– Warehouse table name: KRH_BACKUP_VERSIONS or KRHBKUPVER

v Attribute group name: Backup Volumes– Table name: KRHBKUPVOL– Warehouse table name: KRH_BACKUP_VOLUMES or KRHBKUPVOL

v Attribute group name: BCDS Details– Table name: KRHBCDSDET– Warehouse table name: KRH_BCDS_DETAILS or KRHBCDSDET

v Attribute group name: BCDS Volume Summary– Table name: KRHBCDSSUM– Warehouse table name: KRH_BCDS_VOLUME_SUMMARY or

KRHBCDSSUMv Attribute group name: CDS SMS Class Summary

– Table name: KRHCDSSUM– Warehouse table name: KRH_CDS_SMS_CLASS_SUMMARY or KRHCDSSUM

v Attribute group name: Control Data Sets– Table name: KRHHSMCDSS– Warehouse table name: KRH_CONTROL_DATA_SETS or KRHHSMCDSS

v Attribute group name: Daily Function Stats– Table name: KRHDSRFUNC– Warehouse table name: KRH_DAILY_FUNCTION_STATS or KRHDSRFUNC

v Attribute group name: Daily Space Management Detail– Table name: KRHDSMDET– Warehouse table name: KRH_DAILY_SPACE_MANAGEMENT_DETAIL or

KRHDSMDETv Attribute group name: Daily Space Management Summary

– Table name: KRHDSMSUM– Warehouse table name: KRH_DAILY_SPACE_MANAGEMENT_SUMMARY or

KRHDSMSUMv Attribute group name: Daily Statistics

– Table name: KRHDAILYST– Warehouse table name: KRH_DAILY_STATISTICS or KRHDAILYST

v Attribute group name: Daily Volume Stats– Table name: KRHVSRFUNC– Warehouse table name: KRH_DAILY_VOLUME_STATS or KRHVSRFUNC

v Attribute group name: DFSMS Class Summary


– Table name: KRHSMSSMRY– Warehouse table name: KRH_DFSMS_CLASS_SUMMARY or KRHSMSSMRY

v Attribute group name: DFSMShsm Functions– Table name: KRHHSMFUNC– Warehouse table name: KRH_DFSMSHSM_FUNCTIONS or KRHHSMFUNC

v Attribute group name: Dump Classes– Table name: KRHDUMPCLS– Warehouse table name: KRH_DUMP_CLASSES or KRHDUMPCLS

v Attribute group name: Dump Data Sets– Table name: KRHDUMPDSN– Warehouse table name: KRH_DUMP_DATA_SETS or KRHDUMPDSN

v Attribute group name: Dump Versions– Table name: KRHDUMPVER– Warehouse table name: KRH_DUMP_VERSIONS or KRHDUMPVER

v Attribute group name: Dump Volumes– Table name: KRHDUMPVOL– Warehouse table name: KRH_DUMP_VOLUMES or KRHDUMPVOL

v Attribute group name: Exit Information– Table name: KRHHSMEXIT– Warehouse table name: KRH_EXIT_INFORMATION or KRHHSMEXIT

v Attribute group name: Extent Reduction Summary– Table name: KRHXTRSUM– Warehouse table name: KRH_EXTENT_REDUCTION_SUMMARY or

KRHXTRSUMv Attribute group name: Extent Reductions

– Table name: KRHCOLEXTR– Warehouse table name: KRH_EXTENT_REDUCTIONS or KRHCOLEXTR

v Attribute group name: Filter Attribute Group– Table name: KRHFILTER– Warehouse table name: KRH_FILTER_ATTRIBUTE_GROUP or KRHFILTER

v Attribute group name: Function Records– Table name: KRHCOLFNCS– Warehouse table name: KRH_FUNCTION_RECORDS or KRHCOLFNCS

v Attribute group name: Function Summary– Table name: KRHCOLSUMM– Warehouse table name: KRH_FUNCTION_SUMMARY or KRHCOLSUMM

v Attribute group name: HSM Backup Reports– Table name: KRHHLTBKUP– Warehouse table name: KRH_HSM_BACKUP_REPORTS or KRHHLTBKUP

v Attribute group name: HSM CDS Backups– Table name: KRHCDSBCKP– Warehouse table name: KRH_HSM_CDS_BACKUPS or KRHCDSBCKP

v Attribute group name: HSM CDS Space– Table name: KRHCDSSPCE– Warehouse table name: KRH_HSM_CDS_SPACE or KRHCDSSPCE

Chapter 4. Attributes reference 23

v Attribute group name: HSM CDS Users– Table name: KRHCDSENQS– Warehouse table name: KRH_HSM_CDS_USERS or KRHCDSENQS

v Attribute group name: HSM Health Detail Reports– Table name: KRHHLTDET– Warehouse table name: KRH_HSM_HEALTH_DETAIL_REPORTS or

KRHHLTDETv Attribute group name: HSM Host Info

– Table name: KRHHSMHOST– Warehouse table name: KRH_HSM_HOST_INFO or KRHHSMHOST

v Attribute group name: HSM Migration Reports– Table name: KRHHLTMIG– Warehouse table name: KRH_HSM_MIGRATION_REPORTS or KRHHLTMIG

v Attribute group name: HSM Volume Dump Reports– Table name: KRHHLTDUMP– Warehouse table name: KRH_HSM_VOLUME_DUMP_REPORTS or

KRHHLTDUMPv Attribute group name: Issue HSM Commands

– Table name: KRHHSMCMDS– Warehouse table name: KRH_ISSUE_HSM_COMMANDS or KRHHSMCMDS

v Attribute group name: Log Data Sets– Table name: KRHHSMLOGS– Warehouse table name: KRH_LOG_DATA_SETS or KRHHSMLOGS

v Attribute group name: Log Migration Detail– Table name: KRHLMIGDET– Warehouse table name: KRH_LOG_MIGRATION_DETAIL or KRHLMIGDET

v Attribute group name: Log Recall Detail– Table name: KRHLRECDET– Warehouse table name: KRH_LOG_RECALL_DETAIL or KRHLRECDET

v Attribute group name: MCDS Details– Table name: KRHMCDDET– Warehouse table name: KRH_MCDS_DETAILS or KRHMCDDET

v Attribute group name: MCDS Volume Summary– Table name: KRHMMVSUM– Warehouse table name: KRH_MCDS_VOLUME_SUMMARY or

KRHMMVSUMv Attribute group name: Migrated Data Sets

– Table name: KRHMGRTDSN– Warehouse table name: KRH_MIGRATED_DATA_SETS or KRHMGRTDSN

v Attribute group name: Migration Volumes– Table name: KRHMGRTVOL– Warehouse table name: KRH_MIGRATION_VOLUMES or KRHMGRTVOL

v Attribute group name: Mounted Volumes– Table name: KRHHSMVOLS– Warehouse table name: KRH_MOUNTED_VOLUMES or KRHHSMVOLS


v Attribute group name: MWE Queue Contents– Table name: KRHHSMMWES– Warehouse table name: KRH_MWE_QUEUE_CONTENTS or KRHHSMMWES

v Attribute group name: Patches– Table name: KRHHSMPTCH– Warehouse table name: KRH_PATCHES or KRHHSMPTCH

v Attribute group name: Performance Object Status– Table name: KRHPOBJST– Warehouse table name: KRH_PERFORMANCE_OBJECT_STATUS or

KRHPOBJSTv Attribute group name: Return Code Summary

– Table name: KRHRCSUM– Warehouse table name: KRH_RETURN_CODE_SUMMARY or KRHRCSUM

v Attribute group name: SETSYS Values– Table name: KRHHSMSSYS– Warehouse table name: KRH_SETSYS_VALUES or KRHHSMSSYS

v Attribute group name: SMS HSM Mounted Volume Reports– Table name: KRHHLTHVST– Warehouse table name: KRH_SMS_HSM_MOUNTED_VOLUME_REPORTS or

KRHHLTHVSTv Attribute group name: Tape Copy Needed

– Table name: KRHTAPECPY– Warehouse table name: KRH_TAPE_COPY_NEEDED or KRHTAPECPY

v Attribute group name: Tape Volumes– Table name: KRHTAPEVOL– Warehouse table name: KRH_TAPE_VOLUMES or KRHTAPEVOL

v Attribute group name: Thrashing Report– Table name: KRHCOLTHRS– Warehouse table name: KRH_THRASHING_REPORT or KRHCOLTHRS

v Attribute group name: Volume Statistics Records– Table name: KRHVOLEST– Warehouse table name: KRH_VOLUME_STATISTICS_RECORDS or

KRHVOLEST

The remaining sections of this chapter contain descriptions of these attributegroups, which are listed alphabetically. The following information is provided foreach attribute group:

Historical groupWhether the attribute group is a historical type that you can roll off to adata warehouse

Attribute descriptionsDescription, type, and Warehouse name for each attribute in the attributegroup

Some attributes are designated as key attributes. A key attribute is anattribute that is used in warehouse aggregation to identify rows of datathat represent the same object.


Activity Logs attribute group

Lists DFSMShsm Activity Logs If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.

Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.

Attribute descriptionsThe following list contains information about each attribute in the Activity Logsattribute group:

Node attribute - This attribute is a key attribute.

DescriptionThe managed system name of the agent.

Type String

Timestamp attribute

DescriptionThe local time at the agent when the data was collected.

Type String

System Name attribute

DescriptionSystem\Name

Type String

Plex Name attribute

DescriptionPlex\Name

Type String

Data Set Name attribute

DescriptionData set name

Type String

Creation Date attribute

DescriptionDate of backup

Type String

Days Since Created attribute

DescriptionDays since created

Type Integer (Counter) with enumerated values. The strings aredisplayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)


v Value_Exceeds_Minimum (-2147483648)

Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.

Volser attribute

DescriptionVolume serial number

Type String

Advanced Reporting Event Data attribute group

The attribute group provides Advanced Reporting Event Data. If the warehousedefault setting is enabled, data for this attribute group is stored in Tivoli DataWarehouse.


Attribute descriptionsThe following list contains information about each attribute in the AdvancedReporting Event Data attribute group:



Type String

Timestamp attribute


Type String

Command attribute - This attribute is a key attribute.

DescriptionCommand issued.

Type String

Timestamp attribute

DescriptionTime when command was issued

Type Timestamp

User ID attribute

DescriptionUser ID used to issue the command.

Type String

Return Code attribute

DescriptionReturn Code from the command.


Type Integer (Counter) with enumerated values. The strings aredisplayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)


Reason Code attribute

DescriptionReason Code from the command.




DescriptionData Set Name which the command was issued for.

Type String

Product Release attribute

DescriptionProduct release from which the command was issued against.

Type String

Message attribute

DescriptionMessage associated with the action

Type String

Advanced Reporting Messages attribute group

The attribute group provides Advanced Reporting Message details. If thewarehouse default setting is enabled, data for this attribute group is stored inTivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the AdvancedReporting Messages attribute group:




Type String

Timestamp attribute


Type String

Command attribute - This attribute is a key attribute.

DescriptionCommand issued.

Type String


DescriptionReturn Code from the command.




DescriptionReason Code from the command.



Return Code Message attribute

DescriptionMessage for the associated Return Code.

Type String

Reason Code Message attribute

DescriptionMessage for the associated Reason Code.

Type String


Backup Data Sets attribute group

Data Set Level Backup Info If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Backup DataSets attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String


DescriptionDataset name

Type String

Backup Volser attribute

DescriptionVolser

Type String

Max Copies attribute

DescriptionMax backup copies





Date Backed Up attribute

DescriptionDate backup was made

Type Timestamp

Data Set Organization attribute

DescriptionDataset organization

Type String

Maximum Blocksize attribute

DescriptionMaximum blocksize



Key Length attribute

DescriptionKey length



Record Format attribute

DescriptionRecord format

Type String

Percent Compressed attribute

DescriptionPercent saved if compressed

Type Integer (Counter) with enumerated values. The strings aredisplayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:


v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)


Size In Tracks attribute

DescriptionTracks on user volume



Size In Kilobytes attribute

DescriptionKbytes on user volume



Version Size(2K Blks) attribute

DescriptionSize of curr version in 2k blks



SMS Managed attribute

DescriptionSMS managed

Type String

Version Number attribute

DescriptionCurrent version

Type Integer (Counter) with enumerated values. The strings are


displayed in the Tivoli Enterprise Portal. The warehouse andqueries return the values shown in parentheses. The followingvalues are defined:v Value_Exceeds_Maximum (2147483647)v Value_Exceeds_Minimum (-2147483648)


Number Backup Versions attribute

DescriptionNumber of backup versions



Total Backup Versions attribute

DescriptionTotal number of backup versions



Backup Frequency attribute

DescriptionBackup frequency in days



Date Last Referenced attribute

DescriptionDate last referenced

Type String

Date Uncataloged attribute


DescriptionDate uncataloged

Type String

Days Since Backed Up attribute

DescriptionDays since backed up



Days Since Last Referenced attribute

DescriptionDays since last referenced



Days Since Uncataloged attribute

DescriptionDays since uncataloged



Backup Versions attribute group

Lists Versions of a Backup DS If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Backup Versionsattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String



Type String

Backup Volser attribute

DescriptionBackup volser

Type String

Generation Number attribute

DescriptionGeneration number



Backup Version Data Set Name attribute

DescriptionBackup dsname

Type String


User Volser attribute

DescriptionUser volser

Type String

Date Backed Up attribute

DescriptionDate backup version was made

Type String


DescriptionVersion number



On ML1 Volume attribute

DescriptionResides on ML1 volume

Type String

Cataloged attribute

DescriptionWas cataloged on FRVOL

Type String

VSAM Data Set attribute

DescriptionVSAM dataset

Type String

On Tape attribute

DescriptionResides on tape

Type String

Retired Dataset attribute

DescriptionRetired dataset

Type String

Backup Profile attribute

DescriptionBackup profile exists


Type String


DescriptionVersion is SMS managed

Type String

Expired Data Set attribute

DescriptionExpired dataset

Type String

Days Since Backed Up attribute

DescriptionDays since backed up



Backup Volumes attribute group

Volumes Containing Backup Data If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Backup Volumesattribute group:



Type String

Timestamp attribute


Type String




Type String

Plex Name attribute


Type String

Volser attribute


Type String

Unit Name attribute

DescriptionUnit name

Type String

Volume Type attribute

DescriptionVolume type

Type String

Volume Full attribute

DescriptionVolume full

Type String

Volume Capacity attribute

DescriptionVolume capacity

Type String

HSM Write attribute

DescriptionHSM Write

Type String

Percent Full attribute

DescriptionPercent full



Timestamp Of First Backup attribute


DescriptionTimestamp of first backup

Type Timestamp

Days Since First Backup attribute

DescriptionDays since first backup



Timestamp Of Last Backup attribute

DescriptionTimestamp of last backup

Type Timestamp

Days Since Last Backup attribute

DescriptionDays since last backup



Alternate Volume attribute

DescriptionAlternate volume

Type String

Total Tracks attribute

DescriptionTotal tracks




Free Tracks attribute

DescriptionFree tracks



Track Length attribute

DescriptionTrack length



LWM attribute

DescriptionLwm



Fragmentation Index attribute

DescriptionFragmentation index



Density attribute


DescriptionDensity



Device Type attribute

DescriptionDevice Type

Type String, 8 characters in length.

Timestamp Of Last Spilled attribute

DescriptionTimestamp of last spill

Type Timestamp

Days Since Last Spill attribute

DescriptionDays since last spill



Timestamp Of Last Cleaned attribute

DescriptionTimestamp of last cleaned

Type Timestamp

Days Since Last Clean attribute

DescriptionDays since last clean




BCDS Details attribute group

Listing of migration volumes used by DFSMShsm. If the warehouse default settingis enabled, data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the BCDS Detailsattribute group:



Type String

Timestamp attribute


Type String

Data Set Name attribute - This attribute is a key attribute.

DescriptionData set name.

Type String

Tracks Backed Up attribute

DescriptionNumber of tracks backed up.




DescriptionThe version number of this backup copy.




Backup Volume attribute

DescriptionThe backup volume data set resides on.

Type String

Source Volume attribute

DescriptionThe volume the data set was backed up from.

Type String

Backup Timestamp attribute

DescriptionThe time this version of the data set was backed up.

Type Timestamp

Alias attribute

DescriptionHSM internal backup copy name.

Type String

VSAM Indicator attribute

DescriptionVSAM indicator. 0 = Non-VSAM, 1 = VSAM.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Non-VSAM (0)v VSAM (1)


Data Class attribute

DescriptionThe SMS data class name.

Type String

Management Class attribute

DescriptionThe SMS management class name.

Type String

Storage Class attribute

DescriptionThe SMS storage class name.

Type String


BCDS Volume Summary attribute group

Listing of backup volumes used by DFSMShsm. If the warehouse default setting isenabled, data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the BCDS VolumeSummary attribute group:



Type String

Timestamp attribute


Type String

Volume Serial attribute - This attribute is a key attribute.

DescriptionBackup volume serial number.

Type String

Unit attribute

DescriptionGeneric unit assigned at ADDVOL time.

Type String

Esoteric Name attribute

DescriptionEsoteric name assigned at ADDVOL time.

Type String

CDS SMS Class Summary attribute group

Summary of migrated/backup data sets controlled by DFSMShsm summarized bySMS class. If the warehouse default setting is enabled, data for this attribute groupis stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the CDS SMS ClassSummary attribute group:



Type String

Timestamp attribute


Type String

SMS Class attribute - This attribute is a key attribute.

DescriptionSMS Class type.

Type String

Class Name attribute

DescriptionThe name of SMS class.

Type String

Occurrences attribute

DescriptionThe number of data sets found in this class.



Source attribute

DescriptionSource of data.

Type String

Control Data Sets attribute group

HSM Control Data Set List If the warehouse default setting is enabled, data for thisattribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Control DataSets attribute group:



Type String

Timestamp attribute


Type String

System ID attribute

DescriptionSystem id

Type String

Plex ID attribute

DescriptionPlex id

Type String

Job Name attribute

DescriptionTask using DSN

Type String

Job Number attribute

DescriptionTask job number

Type String

Host ID attribute

DescriptionHost Id

Type String


DescriptionDataset name to use

Type String

RLS Flag attribute

DescriptionRLS flag

Type String

File Type attribute


DescriptionType Dsn

Type String

Volser attribute

DescriptionVolser DSN is on

Type String

Daily Function Stats attribute group

Daily Statistics For Functions If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Daily FunctionStats attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Date attribute

DescriptionConverted Date

Type String

Function attribute

DescriptionFull function name


Type String

Number Of Data Sets Processed attribute

DescriptionNum non-VSAM DSs processed



Number Of Tracks Read attribute

DescriptionNum tracks read



Number Of Tracks Written attribute

DescriptionNum tracks written



Number Of Bytes Read attribute

DescriptionNum bytes read below 1 gigabyte




Number Of Bytes Written attribute

DescriptionNum bytes written below 1 gigabyte



Age Of Data Sets Processed attribute

DescriptionAge of the DSs processed



Time Requests In Queue attribute

DescriptionTime in queue before processing



Time Requests Waited for Volume attribute

DescriptionTime in queue waiting for vol mounts



Time Requests Processed attribute


DescriptionNum elpsd time to process requests



Total Time For Requests attribute

DescriptionTotal time for requests



Number Of Gigabytes Read attribute

DescriptionNum of gigabytes read



Number Of Gigabytes Written attribute

DescriptionNum of gigabytes written



Number Of Failing Requests attribute

DescriptionNum failing requests




Number Of Voluntary Requests attribute

DescriptionNum voluntary requests initd by user



Number Of Requests Initiated By System attribute

DescriptionNum requests initiated by the system



Daily Space Management Detail attribute group

Detail information about DFSMShsm daily space management processing. If thewarehouse default setting is enabled, data for this attribute group is stored inTivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Daily SpaceManagement Detail attribute group:




Type String

Timestamp attribute


Type String

Volume Serial Number attribute - This attribute is a key attribute.

DescriptionVolume serial number of primary volume

Type String

Start Date and Time attribute

DescriptionStart date and time

Type Timestamp

End Date and Time attribute

DescriptionEnd date and time

Type Timestamp

Elapsed Time attribute

DescriptionElapsed time to process volume

Type String

Data Set Count attribute

DescriptionCount of data sets processed.



Tracks attribute

DescriptionNumber of tracks freed by HSM.




Minimum Age attribute

DescriptionMinimum age of data sets.



Percent Free attribute

DescriptionPercent free space on volume.



Tracks Free attribute

DescriptionNumber of free tracks on volume.



Cylinders Free attribute

DescriptionNumber of free cylinders on volume.





DescriptionFragmentation index.



Daily Space Management Summary attribute group

Summary of DFSMShsm daily space management processing. If the warehousedefault setting is enabled, data for this attribute group is stored in Tivoli DataWarehouse.


Attribute descriptionsThe following list contains information about each attribute in the Daily SpaceManagement Summary attribute group:



Type String

Timestamp attribute


Type String

Volume Serial Number attribute - This attribute is a key attribute.

DescriptionThe volume serial number of the primary volume.

Type String

Proc Count attribute

DescriptionNumber of times daily space management provided a service forthis reporting interval.




Highest % of Free Space attribute

DescriptionHighest percentage of free space found on this volume.



Lowest % of Free Space attribute

DescriptionLowest percentage of free space found on this volume.



Highest # of Free Cylinders attribute

DescriptionHighest number of free cylinders found on this volume.



Lowest # of Free Cylinders attribute

DescriptionLowest number of free cylinders found on this volume.




Highest Fragmentation Index attribute

DescriptionHighest fragmentation index for this volume.



Lowest Fragmentation Index attribute

DescriptionLowest fragmentation index for this volume.



Daily Statistics attribute group

Daily Statistics Kept by HSM If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Daily Statisticsattribute group:



Type String

Timestamp attribute


Type String




Type String

Plex Name attribute


Type String

Date attribute

DescriptionDate for record

Type String

Number Of Starts attribute

DescriptionNum HSM Startups this day



Number Of Abends attribute

DescriptionNum DFSMShsm subtask abends



Number Of Shutdowns attribute

DescriptionNum DFSMShsm shutdowns this day



Number Of MWEs attribute


DescriptionNum management work elements (SVC)



Number Of Successful Recalls attribute

DescriptionNum times Recall was satisfied



Number Of Successful Recovers attribute

DescriptionNum times Recover was satisfied



Total Jobstep Time attribute

DescriptionTotal elapsed Jobstep time - in mss



Number Of Events attribute

DescriptionEvent count for writing DSR to SMF




Time Of Last DSR Log attribute

DescriptionTime of day the DSR was last written to the log

Type String

Number Of Migrations attribute

DescriptionNum volume migrations done this day



Number Of Space N/A Migrations attribute

DescriptionNum vol migrations forced because space was N/A



Number Of Backups attribute

DescriptionNum volumes backed up




Number Of Backup Recycled attribute

DescriptionNum tape backup volumes recycled this day



Number Of Migration Recycled attribute

DescriptionNum tape migration level 2 volumes recycled today



Number Of System-Requested Dumps attribute

DescriptionNum system-requested volume dumps



Number Of User-Requested Dumps attribute

DescriptionNum user-requested volume dumps



Number Of Failed Dumps attribute


DescriptionNum volume dumps that failed



Number Of System-Requested Dump Copies attribute

DescriptionNum system-requested dump copies



Number Of User-Requested Dump Copies attribute

DescriptionNum user-requested dump copies



Number Of Dump Copies Failed attribute

DescriptionNum dump copies that failed



Times Dump Requests Queued attribute

DescriptionNum of dump requests waited in queue




Times Dump In Volume Allocation Wait attribute

DescriptionNum of dump requests waited for volume allocation



Times Dump In Process attribute

DescriptionTime dump request took to process



Total Time Dump attribute

DescriptionTot. elpsd time for all dump requests 2be process



Number Of Restores attribute

DescriptionNum volume restores requested





Number Of Restores Failed attribute

DescriptionNum volume restores that failed



Number Of Data Set Restores attribute

DescriptionNum data set restores requested



Number Of Data Set Restores Failed attribute

DescriptionNum data set restores that failed



Number Of Extent Reductions attribute

DescriptionNum extent reductions





Number Of ABACKUPs attribute

DescriptionNum ABACKUPs requested



Number Of ABACKUPs Failed attribute

DescriptionNum ABACKUPs that failed



Number Of ABACKUPs ML2 Extra attribute

DescriptionNum extra ML2 vols mounts by ABACKUP (rcl takeaway)



Number Of Data Sets Reconnected attribute

DescriptionNum data sets reconnected





Number Of Tracks Reconnected attribute

DescriptionNum tracks reconnected to tape



Daily Volume Stats attribute group

Volume Statistics By Function If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Daily VolumeStats attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

Volser attribute


Type String

Date attribute

DescriptionConverted Date

Type String

Function attribute

DescriptionFull function name

Type String

All Numbers Zeroes attribute

DescriptionAll numbers zeroes flag

Type String

Number Of Data Sets Processed attribute

DescriptionNum non-VSAM DSs processed



Number Of Tracks Read attribute

DescriptionNum tracks read



Number Of Tracks Written attribute


DescriptionNum tracks written



Number Of Bytes Read attribute

DescriptionNum bytes read below 1 gigabyte



Number Of Bytes Written attribute

DescriptionNum bytes written below 1 gigabyte



Number Of Failing Requests attribute

DescriptionNum failing requests



Number Of User Reqeusts attribute

DescriptionNum vol requests initd by user




Number Of System Requests attribute

DescriptionNum requests initiated by the sys



Age Of Data Sets Processed attribute

DescriptionAge of the DSs processed



Time Requests In Queue attribute

DescriptionTime in queue before processing



Time Requests Waiting For Volume Mount attribute

DescriptionTime queue waiting for vol mnt





Elpased Time To Process Requests attribute

DescriptionNum elpsd time to process requests



DFSMS Class Summary attribute group

Summary of DFSMS Classes If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the DFSMS ClassSummary attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

Class Name attribute

DescriptionClass name

Type String

Class Type attribute

DescriptionClass type

Type String

Interval Date attribute

DescriptionDate for interval

Type Timestamp

Backup Data Sets attribute

DescriptionBackup data sets



Migration Data Sets attribute

DescriptionMigration data sets



Backup Data Set Size attribute

DescriptionBackup data set size

Type String

Migration Data Set Size attribute


DescriptionMigration data set size

Type String

Date Interval For Class attribute

DescriptionDate interval for particular class



DFSMShsm Functions attribute group

Lists DFSMShsm Function Status If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the DFSMShsmFunctions attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Job Name attribute



Type String



Type String

ASCB Address attribute

DescriptionDFHSM task ASCB address

Type String

Host ID attribute

DescriptionHost Id

Type String

Function attribute

DescriptionHSM function being reported

Type String

Status attribute

DescriptionConnction status

Type String

Dump Classes attribute group

Dump Classes and Attributes If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Dump Classesattribute group:



Type String

Timestamp attribute



Type String



Type String

Plex Name attribute


Type String

Dump Class attribute

DescriptionDump class name

Type String

Auto Reuse attribute

DescriptionAUTOREUSE

Type String

Data Set Restore attribute

DescriptionDATASETRESTORE

Type String

Reset attribute

DescriptionRESET

Type String

No Compression attribute

DescriptionNo compression

Type String

Frequency attribute

DescriptionFrequency



Retpd attribute


DescriptionRETPD



Day attribute

DescriptionDAY



Unit Name attribute

DescriptionUNIT

Type String

Disposition attribute

DescriptionDISPOSITION

Type String

Disposition Length attribute

DescriptionDISPOSITION length



Expire Date attribute

DescriptionExpiration date

Type String


VTOC Copies attribute

DescriptionVTOCCOPIES



Dump Data Sets attribute group

Data Sets on Dump Volumes If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Dump Data Setsattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String


Dump Date attribute

DescriptionDump date

Type Timestamp

Days Since Dump attribute

DescriptionDays since dump created



Device Type-Hex attribute

DescriptionDevice type from UCB

Type String


DescriptionDevice type of volume in hex

Type String


DescriptionTrack length (for HRMAU030 call)



ML1 Volume attribute

DescriptionML1 volume where VTOC copy is

Type String


DescriptionDS name from VTOC copy

Type String



DescriptionDS creation date

Type String

Expiration Date attribute

DescriptionDS expiration date

Type String

Last Referenced Date attribute

DescriptionDS last referenced date

Type String

Number Extents attribute

DescriptionNumber of data extents on volume




DescriptionDS data set organization flags

Type String

Dump Versions attribute group

Lists Versions of Dump Copies If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Dump Versionsattribute group:



Type String

Timestamp attribute



Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String

Dump Timestamp attribute

DescriptionDump time

Type Timestamp





VTOC Copy attribute

DescriptionDump generation has VTOC copy ds

Type String

Reset Option attribute

DescriptionReset option set

Type String

Command Initiation attribute

DescriptionCreated by command initiation

Type String



DescriptionDump generation is SMS managed

Type String

Compressed attribute

DescriptionVolume is compressed

Type String

Num 2k Blocks attribute

DescriptionNum 2k blocks Vtoc copy occupies



Number Of Records attribute

DescriptionNum records in VTOC copy



Backup Prefix attribute

DescriptionBackup prefix

Type String

Backup Prefix Length attribute

DescriptionBackup prefix length





DescriptionML1 volume where VTOC copy is

Type String

Device type from UCB attribute

DescriptionDevice type from UCB

Type String

Device type of volume attribute

DescriptionDevice type of volume

Type String





Cycle Date attribute

DescriptionCycle date when dump began

Type String

Days Since Cycle attribute

DescriptionNum days since cycle date




DescriptionDump class


Type String

Unit Name attribute


Type String


DescriptionVolume expiration date

Type String

Days Till Expire attribute

DescriptionDays till expiration



Tape Expire Date attribute

DescriptionTape expiration date

Type String

Number Of Dump Volumes attribute

DescriptionNum dump volumes containing dump



Volume List attribute

DescriptionList of volumes

Type String

Dump Volumes attribute group

These Contain Volume Dump Copies If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Dump Volumesattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String

Unit Name attribute


Type String

Volume Unavailable attribute

DescriptionTape volume unavailable

Type String

Compacted Data attribute

DescriptionContains compacted data

Type String

HSM Write attribute

DescriptionHSM has written to tape


Type String

In Use attribute

DescriptionVol currently in use

Type String

Password Protected attribute

DescriptionPassword protected

Type String

RACF Protected attribute

DescriptionRACF protected volume

Type String

Tape Exit attribute

DescriptionTape exit needs called

Type String

Valid Dump attribute

DescriptionContains at least one valid copy

Type String

Device Type from UCB attribute

DescriptionDevice type from UCB in hex

Type String


DescriptionDevice type of volume

Type String

Density attribute

DescriptionDensity of tape






Type String


DescriptionVolume expiration date

Type String

Days Till Expire attribute

DescriptionDays till expiration



DGN Key attribute

DescriptionDGN Key

Type String

Source Volser attribute

DescriptionSource volume serial

Type String

Source Device Type-Hex attribute

DescriptionSource volume device type in hex

Type String

Source Device Type attribute

DescriptionSource volume device type

Type String

Dump Timestamp attribute

DescriptionDump time

Type Timestamp











Exit Information attribute group

HSM Exits in Use If the warehouse default setting is enabled, data for this attributegroup is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Exit Informationattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

Job Name attribute


Type String



Type String

Host ID attribute

DescriptionHost Id

Type String

Exit Name attribute

DescriptionName of exit

Type String

Description attribute

DescriptionDescription for exit

Type String

Module Header attribute

DescriptionFirst part of exit data

Type String

Exit Status attribute

DescriptionExit status

Type String

Module Address attribute

DescriptionModule address

Type String

Addr Mode attribute

DescriptionModules Amode

Type String

Res Mode attribute


DescriptionModules Rmode

Type String

Rent Attr attribute

DescriptionModule is reentrant

Type String

Load Location attribute

DescriptionLocation loaded from

Type String

Reus Attr attribute

DescriptionModule is reusable

Type String

Lib Auth attribute

DescriptionLoaded from authorized library

Type String

Mod Auth attribute

DescriptionModule is authorized

Type String

Use Count attribute

DescriptionUse count



Module Length attribute

DescriptionModule length





DescriptionDsn module resides in

Type String

Extent Reduction Summary attribute group

Detail of each DFSMShsm action that resulted in a reduction in the number ofextents used by a data set. If the warehouse default setting is enabled, data for thisattribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the ExtentReduction Summary attribute group:



Type String

Timestamp attribute


Type String

Primary Volume attribute

DescriptionPrimary volume the data set resides on.

Type String

Number of 2KB Blocks attribute

DescriptionThe count of 2 kilobyte blocks processed.



Number of Tracks Migrated attribute


DescriptionNumber of tracks migrated.



Number of Tracks Recalled attribute

DescriptionNumber of tracks recalled.



Return Code of HSM Action attribute

DescriptionReturn code of HSM action. If blank, HSM kept the data setmigrated.




DescriptionThe name of the data set with extent reduction.

Type String

Source of Data attribute - This attribute is a key attribute.

DescriptionThe source of the data. This is hidden from the user

Type String

Extent Reductions attribute group

View Extent Reduction Activity If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the ExtentReductions attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

HSM Action attribute

DescriptionHSM\Action

Type String


DescriptionReturn code



User ID attribute

DescriptionUser ID requesting function

Type String



DescriptionData set name being processed

Type String

To Volume attribute

DescriptionTarget volume

Type String

Device Type-hex attribute

DescriptionTo volume device type in hex

Type String

Device Type(char) attribute

DescriptionTo volume device type in character

Type String

From Volume attribute

DescriptionFrom volume

Type String


DescriptionReason code



Abend Code attribute

DescriptionAbend code

Type String

RACF Group attribute

DescriptionRACF group

Type String

Request Number attribute

DescriptionRequest number





Request Date attribute

DescriptionDate user made request



Request Time attribute

DescriptionTime user made request



Start Time attribute

DescriptionTime HSM started processing



Complete Time attribute

DescriptionTime request was completed





Kbytes Read attribute

DescriptionKilobytes read



Kbytes Written attribute

DescriptionKilobytes written



Tracks Read attribute

DescriptionTracks read/freed



Tracks Written attribute

DescriptionTracks written






DescriptionData set organization

Type String

TSO Request attribute

DescriptionTSO request

Type String

User Requested attribute

DescriptionUser requested

Type String

Wait attribute

DescriptionUser waited for request to completion

Type String

Cpu Time .01 attribute

DescriptionCpu time used .01



Age attribute

DescriptionAge






Type String


DescriptionStorage class name

Type String


DescriptionMgmt class name

Type String



Type String

Host ID attribute

DescriptionHost id

Type String

System ID attribute


Type String

Levels attribute

DescriptionLevel movement

Type String


DescriptionRequest date

Type String

Filter Attribute Group attribute group

The attribute group for filtering data. If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Filter AttributeGroup attribute group:



Type String

Timestamp attribute


Type String

Target attribute - This attribute is a key attribute.

DescriptionName of target attribute group of the filter.

Type String

Filter attribute

DescriptionFilter argument(s).

Type String

IBM Provided attribute

DescriptionYes/No flag to indicate if this is provided by IBM.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v No (0)v Yes (1)


Filter ID attribute

DescriptionInternal number for identifying the filter.

Type String


DescriptionShort description of filter data.

Type String

Function Records attribute group

View Function Activity Details If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the FunctionRecords attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String


DescriptionHSM\Action

Type String





User ID attribute

DescriptionUser ID requesting function

Type String




Type String

To Volume attribute

DescriptionTarget volume

Type String


DescriptionTo volume device type in hex

Type String

Device Type(Char) attribute

DescriptionTo volume device type in characters

Type String


DescriptionFrom volume

Type String


DescriptionReason code



Abend Code attribute

DescriptionAbend code

Type String


DescriptionRACF group

Type String








DescriptionDate user made request

Type Timestamp

Start Time attribute

DescriptionTime HSM started processing

Type String

Complete Time attribute

DescriptionTime request was completed

Type String

Kbytes Read attribute

DescriptionKilobytes read



Kbytes Written attribute

DescriptionKilobytes written



Tracks Read attribute

DescriptionTracks read/freed




Tracks Written attribute

DescriptionTracks written





Type String


DescriptionTSO request

Type String

User Requested attribute

DescriptionUser requested

Type String

Wait attribute

DescriptionUser waited for request to complete

Type String

Cpu Time .01 attribute

DescriptionCpu time used .01




Age attribute

DescriptionAge





Type String



Type String


DescriptionMgmt class name

Type String



Type String

Host ID attribute

DescriptionHost id

Type String

System ID attribute


Type String

Levels attribute

DescriptionLevel movement

Type String


Function Summary attribute group

Summary of DFSMShsm Function Activity If the warehouse default setting isenabled, data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the FunctionSummary attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String


DescriptionHSM Action

Type String





Count attribute


DescriptionNumber of matching records




DescriptionDescription

Type String

HSM Backup Reports attribute group

Summary of Backup Activity If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the HSM BackupReports attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Status attribute


DescriptionVolume management status

Type String

Count attribute

DescriptionNumber of volumes for given stat




DescriptionStatus description

Type String

HSM CDS Backups attribute group

Shows CDS Backup Versions If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the HSM CDSBackups attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

HSM Type attribute

DescriptionData set type

Type String

Backup Data Set Name attribute

DescriptionBackup data set name

Type String

Backup Timestamp attribute

DescriptionDate of backup

Type Timestamp

Days Since Backup attribute





DescriptionControl data set name

Type String

Catalog Name attribute

DescriptionCatalog name

Type String

Volser attribute


Type String

HSM CDS Space attribute group

Shows CDS Space Information If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the HSM CDS Spaceattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Control Data Set Name attribute

DescriptionComponent name

Type String

Entry Type attribute

DescriptionEntry type

Type String

Entry Type Description attribute

DescriptionText entry type description

Type String

Catalog Flag attribute

DescriptionCatalog flag

Type String

Catalog Name attribute

DescriptionCatalog name


Type String

Volser attribute


Type String

UCB Address attribute

DescriptionUCB address

Type String

UCBLOOK Return Code attribute

DescriptionUCBLOOK return code

Type String

UCBLOOK Reason Code attribute

DescriptionUCBLOOK reason code

Type String

Speed attribute

DescriptionSpeed is set

Type String

Unique Keys attribute

DescriptionUnique keys

Type String

Reuse attribute

DescriptionReuse set

Type String

Erase attribute

DescriptionErase set

Type String

Regional Share Options attribute

DescriptionRegional share options

Type String

System Share Options attribute

DescriptionSystem share options

Type String


Open attribute

DescriptionData set is open

Type String

Buffer Size attribute

DescriptionMinimum buffer size



Primary Allocation attribute

DescriptionPrimary allocation



Secondary Allocation attribute

DescriptionSecondary allocation



Allocation Type attribute

DescriptionAllocation type

Type String

High Used RBA attribute

DescriptionHigh used RBA




High Allocated RBA attribute

DescriptionHigh allocated RBA



Used Percent attribute

DescriptionUsed percentage

Type String

Average Lrecl attribute

DescriptionAverage lrecl





Type String


DescriptionData class name

Type String



DescriptionManagement class name

Type String

Cluster Type attribute

DescriptionCluster type

Type String



Type String

Write Check attribute

DescriptionWritecheck set

Type String

Imbed attribute

DescriptionImbed set

Type String

Replicate attribute

DescriptionReplicate set

Type String

Span attribute

DescriptionSpanned records allowed

Type String

Use Volumes In Order attribute

DescriptionUse volumes in order

Type String

Key Position attribute

DescriptionPosition of key








CA Percent Free Space attribute

DescriptionFreespace CA percent



CI Percent Free Space attribute

DescriptionFreespace CI percent



CI Per CA attribute

DescriptionCI per CA



CI Size attribute


DescriptionCI size



Maximum Lrecl attribute

DescriptionMaximum lrecl



Index Levels attribute

DescriptionFor index - number of levels



Records attribute

DescriptionNumber of records



Extents attribute

DescriptionNumber of extents




Deletes attribute

DescriptionNumber of deletes



Inserts attribute

DescriptionNumber of inserts



Updates attribute

DescriptionNumber of updates



Retrieved attribute

DescriptionNumber retrieved





CI Splits attribute

DescriptionNumber CI splits



CA Splits attribute

DescriptionNumber CA splits



EXCP Count attribute

DescriptionEXCP count



Number Extents attribute

DescriptionNumber of extents





High Level RBA attribute

DescriptionHigh key RBA



High Used RBA attribute

DescriptionHigh used RBA



High Allocated RBA attribute

DescriptionHigh allocated RBA



Block Size attribute

DescriptionBlocksize





Blocks Per Track attribute

DescriptionBlocks per track



Tracks Per Cylinder attribute

DescriptionTracks per cylinder



Bytes Per Track attribute

DescriptionBytes per track



Free Bytes attribute

DescriptionFree bytes





System Timestamp attribute

DescriptionSystem time stamp

Type Timestamp

Tracks Per CA attribute

DescriptionTracks per CA



Extent Type attribute

DescriptionType extent



Entries Per Section attribute

DescriptionEntries per section



Sequence Set RBA attribute


DescriptionSequence set RBA





Type String


DescriptionDevice type in hex

Type String


DescriptionCharacter device type

Type String

High Level RBA attribute

DescriptionIndex high level RBA



AIX Upgrade attribute

DescriptionAIX Upgrade flag

Type String

HSM CDS Users attribute group

Shows Users of the CDSS If the warehouse default setting is enabled, data for thisattribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the HSM CDS Usersattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Request QNAME attribute

DescriptionQNAME for request

Type String

Control Data Set Name attribute

DescriptionRNAME for request

Type String

Request Type attribute

DescriptionRequest type

Type String

Num Wait attribute

DescriptionNum requestors waiting





Wait Exclusive attribute

DescriptionNum of exclusive requests



Wait Shared attribute

DescriptionNum of shared requests



Status attribute

DescriptionStatus of request

Type String

Level attribute

DescriptionRequest level (Reserve or Enq)

Type String

Request Jobname attribute

DescriptionJobname of requestor

Type String

Request System Name attribute

DescriptionSystem\Name of requestor

Type String

TCB Address attribute


DescriptionTCB address of requestor

Type String

ASID attribute

DescriptionASID of requestor

Type String

Scope attribute

DescriptionScope of Enq

Type String

Num Owners attribute

DescriptionOwners of resource



ECB Address attribute

DescriptionECB address

Type String

SVRB Address attribute

DescriptionSVRB Address

Type String

Must Complete attribute

DescriptionMust complete flag

Type String

Device Number attribute

DescriptionDevice number

Type String

HSM Health Detail Reports attribute group

Detail health information for specific volumes If the warehouse default setting isenabled, data for this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the HSM HealthDetail Reports attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Status attribute


Type String

Volser attribute

DescriptionVolume serial

Type String

System ID attribute

DescriptionSMS system id job ran on

Type String

Storage Group attribute

DescriptionStorage group name

Type String


DescriptionDevice type


Type String


DescriptionSMS managed (Y/N)

Type String

HSM Managed attribute

DescriptionN=not managed B=backup 0.1.2=ML

Type String

In Mounted Volume Table attribute

DescriptionVolume in mountd vol table (Y/N)

Type String

If ML1/SDSP attribute

DescriptionIf ML1 - SDSP exists

Type String

SDSP attribute

DescriptionSDSP exists (Y/N)

Type String

Last Space Management Timestamp attribute

DescriptionLast space management date

Type Timestamp

Auto Management attribute

DescriptionAuto management required (Y/N)

Type String

Last Automatic Backup Timestamp attribute

DescriptionLast automatic backup date

Type Timestamp

Auto Backup attribute

DescriptionAuto backup required (Y/N)

Type String

Last Automatic Dump Timestamp attribute

DescriptionLast automatic dump date

Type Timestamp


Auto Dump attribute

DescriptionAuto dump required (Y/N)

Type String

Last Interval Migration Timestamp attribute

DescriptionLast interval migration date

Type Timestamp

Interval Migration attribute

DescriptionInterval migratn required (Y/N)

Type String

High Threshold attribute

DescriptionHigh threshold if threshold

Type String

Low Threshold attribute

DescriptionLow threshold if threshold

Type String

Current Occupancy attribute

DescriptionCurrent occupancy



Capacity In Tracks attribute

DescriptionVolume capacity in tracks



Tracks Free attribute


DescriptionNumber of free tracks



Number Of Migrations attribute

DescriptionCount of successful migrns



Number Of Tracks Migrated attribute

DescriptionCount of tracks migrated



Number Of Data Sets Migrated attribute

DescriptionCount of DSs migrated



Size Migrated attribute

DescriptionSize of DSs migrated




Migration Attempts attribute

DescriptionMigration attempts from VSR



Migration Failures attribute

DescriptionMigration failures from VSR



Recall Attempts attribute

DescriptionRecall attempts from VSR



Recall Failures attribute

DescriptionRecall failures from VSR





Delete Attempts attribute

DescriptionDelete attempts from VSR



Delete Failures attribute

DescriptionDelete failures from VSR



Backup Attempts attribute

DescriptionBackup attempts from VSR



Backup Failures attribute

DescriptionBackup failures from VSR





Dump Attempts attribute

DescriptionDump attempts from VSR



Dump Failures attribute

DescriptionDump failures from VSR



Cached attribute

DescriptionVolume is cached Y/N

Type String

Track Caching attribute

DescriptionTrack caching Y/N

Type String

Dual Copy attribute

DescriptionDual copy Y/N

Type String

DASD Fast Write attribute

DescriptionDASD fast write Y/N


Type String

VTOC Indexed attribute

DescriptionVTOC is indexed Y/N

Type String

Index Enabled attribute

DescriptionIndex is enabled Y/N

Type String

VSR Date attribute

DescriptionVSR date

Type String

Health Days attribute

DescriptionHealth days



Health Limit attribute

DescriptionHealth limit



HSM Host Info attribute group

Lists Active HSM Hosts If the warehouse default setting is enabled, data for thisattribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the HSM Host Infoattribute group:



Type String

Timestamp attribute


Type String

System ID attribute


Type String

Plex ID attribute

DescriptionPlex id

Type String

Job Name attribute


Type String



Type String

Host ID attribute

DescriptionHost Id

Type String

Release attribute

DescriptionRelease of DFHSM

Type String

HSM Type attribute

DescriptionTask type

Type String

Status attribute


DescriptionLogging status

Type String

MCVT Address attribute

DescriptionMCVT address

Type String

QCT Address attribute

DescriptionQCT address

Type String

QCT Element Address attribute

DescriptionQCTE address

Type String

Host ASID attribute

DescriptionASID

Type String


DescriptionASCB address

Type String

Cmd Suffix attribute

DescriptionARCCMD suffix

Type String

SMF Number attribute

DescriptionSMF number



Backup Prefix attribute

DescriptionBackup prefix

Type String


Migrate Prefix attribute

DescriptionMigration prefix

Type String

Max Backup Tasks attribute

DescriptionMax backup tasks



Max Dump Tasks attribute

DescriptionMax dump tasks



Max Recall Tasks attribute

DescriptionMax recall tasks



Max Tape Recall Tasks attribute

DescriptionMax tape recall tasks





Max Migration Tasks attribute

DescriptionMax migration tasks



Max Interval Migration Tasks attribute

DescriptionMax interval migration tasks



Max Recover Tasks attribute

DescriptionMax recover tasks



Max Recycle Tasks attribute

DescriptionMax recycle tasks




Max CSA Usage attribute

DescriptionMax CSA byte count



Active Limit attribute

DescriptionActive CSA limit



Inactive Limit attribute

DescriptionInactive CSA limit



Used CSA attribute

DescriptionCSA in use




Used Percent attribute

DescriptionUsed percentage



Max MWEs attribute

DescriptionMWEs per address space



Audit Status attribute

DescriptionAudit status

Type String

Auto Backup Status attribute

DescriptionAuto backup status

Type String

Auto Dump Status attribute

DescriptionAuto dump status

Type String

Auto Migration Status attribute

DescriptionAuto migration status

Type String

Backup Status attribute

DescriptionBackup status

Type String

Dump Status attribute


DescriptionDump status

Type String

List Status attribute

DescriptionList status

Type String

Migrate Status attribute

DescriptionMigration status

Type String

Recall Status attribute

DescriptionRecall status

Type String

Recover Status attribute

DescriptionRecover status

Type String

Recycle Status attribute

DescriptionRecycle status

Type String

Report Status attribute

DescriptionReport status

Type String

TapeCopy Status attribute

DescriptionTapecopy status

Type String

TapeDSN Recall Status attribute

DescriptionTapeDSN Recall Status

Type String

TapeDSN Recover Status attribute

DescriptionTapeDSN Recover Status

Type String

Tape Replace Status attribute


DescriptionTape replace status

Type String

TSO TapeDsn Status attribute

DescriptionTSO TapeDsn status

Type String

BCDS Backup Status attribute

DescriptionBCDS backup status

Type String

MCDS Backup Status attribute

DescriptionMCDS backup status

Type String

OCDS Backup Status attribute

DescriptionOCDS backup status

Type String

Journal Backup Status attribute

DescriptionJournal backup status

Type String

HSM Migration Reports attribute group

Summary of Migration Status If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the HSM MigrationReports attribute group:



Type String

Timestamp attribute



Type String



Type String

Plex Name attribute


Type String

Status attribute


Type String

Count attribute






Type String

HSM Volume Dump Reports attribute group

Summary of Volume Dump Activity If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the HSM VolumeDump Reports attribute group:




Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Status attribute


Type String

Count attribute






Type String

Issue HSM Commands attribute group

Issue Command to DFSMShsm Host If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Issue HSMCommands attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Job Name attribute


Type String

Host Identifier attribute

DescriptionHost identifier

Type String

Message Text attribute

DescriptionMessage text

Type String

Message Text (Cont) attribute

Description

Type String

Command Length attribute

DescriptionLength of command

Type String

Command To Issue attribute

DescriptionCommand to issue


Type String

Log Data Sets attribute group

HSM ARCLOG Data Set List If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Log Data Setsattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Job Name attribute


Type String



Type String


DescriptionDataset name to use

Type String

Type File attribute


DescriptionType Dsn

Type String

Source Product attribute

DescriptionWhere dataset name came from

Type String

Log Migration Detail attribute group

Detail of DFSMShsm actions for MIGRATE related actions. If the warehousedefault setting is enabled, data for this attribute group is stored in Tivoli DataWarehouse.


Attribute descriptionsThe following list contains information about each attribute in the Log MigrationDetail attribute group:



Type String

Timestamp attribute


Type String


DescriptionThe name of the data set.

Type String

Action attribute

DescriptionAction performed on the data set.

Type String


DescriptionReturn code for the action perfomed.






DescriptionReason code for the action performed.



Tracks attribute

DescriptionThe data set size in tracks.



Age attribute

DescriptionAge of the data set when the action was performed.



Timestamp attribute

DescriptionThe date/time when the action was performed.

Type Timestamp

From Volume Serial attribute

DescriptionVolume serial number of primary volume.

Type String


To Volume Serial attribute

DescriptionVolume serial number of migration volume.

Type String

CPU Seconds attribute

DescriptionThe amount of CPU seconds required to process the data set.



Log Recall Detail attribute group

Detail of DFSMShsm actions for RECALL related actions. If the warehouse defaultsetting is enabled, data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Log RecallDetail attribute group:



Type String

Timestamp attribute


Type String


DescriptionThe data set name.

Type String

Action attribute

DescriptionThe action performed on the data set.

Type String



DescriptionThe return code for the action performed.




DescriptionThe reason code for the action performed.



Tracks attribute

DescriptionThe size of the data set in tracks.



Age attribute

DescriptionThe age of the data set when the action was performed.



Timestamp attribute


DescriptionThe date/time when the action was performed.

Type Timestamp

Run Time attribute

DescriptionThe elapsed time to process the request.

Type String

Number of 2KB Blocks attribute

DescriptionThe count of 2 kilobyte blocks processed.



Level attribute

DescriptionThe level from which the data set was recalled.



TSO User attribute

DescriptionThe TSO user making the request.

Type String

BTSO attribute

DescriptionThe address space from which the request was made.

Type String


DescriptionThe volume from which the recalled was performed.

Type String

To Volume attribute


DescriptionThe volume the recalled data set was put on.

Type String

CPU Seconds attribute

DescriptionThe number of CPU seconds required to process the data set.



MCDS Details attribute group

Detail listing of migrated data sets controlled by DFSMShsm. If the warehousedefault setting is enabled, data for this attribute group is stored in Tivoli DataWarehouse.


Attribute descriptionsThe following list contains information about each attribute in the MCDS Detailsattribute group:



Type String

Timestamp attribute


Type String


DescriptionData Set name.

Type String

Migrated attribute

DescriptionIndicates if the dataset is currently migrated.

Type Integer with enumerated values. The strings are displayed in the


Tivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v No (0)v Yes (1)



DescriptionDate of creation.

Type String

Last Referenced Date attribute

DescriptionDate of last reference.

Type String

Date Migrated attribute

DescriptionDate when data set was migrated.

Type String


DescriptionDate when data set expires.

Type String

Last Backup attribute

DescriptionDate of last backup.

Type String

Migration Volume attribute

DescriptionMigration volume data set resides on.

Type String


DescriptionPrimary volume data set was migrated from or recalled to.

Type String

Migration Time attribute

DescriptionNumber of times data set has migrated since this record wascreated.





Thrashing Index attribute

DescriptionThrashing index based off the number of times migrated.



Migration Level attribute

DescriptionCurrent migration level of data set.



VSAM Indicator attribute

DescriptionVSAM Indicator. 0 = Non-VSAM, 1 = VSAM.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v Non-VSAM (0)v VSAM (1)


Tracks Occupied attribute

DescriptionThe number of tracks the data set occupies the primary volume.




Migrated KB2 Bytes attribute

DescriptionThe number of 2K blocks this data set occupies on the migrationvolume.




DescriptionSMS Data class name.

Type String

Management Class Name attribute

DescriptionSMS management class name.

Type String

Storage Class Name attribute

DescriptionSMS Storage class name.

Type String

SDSP attribute

DescriptionIndicates if the dataset used SDSP.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v No (0)v Yes (1)


MCDS Volume Summary attribute group

Listing of migration volumes used by DFSMShsm. If the warehouse default settingis enabled, data for this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the MCDS VolumeSummary attribute group:



Type String

Timestamp attribute


Type String

Volume Serial attribute - This attribute is a key attribute.

DescriptionMigration Volume.

Type String

Unit Type attribute

DescriptionThe type migration unit of the volume.

Type String

Migrated Data Sets attribute group

Data Set Level Migration Info If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Migrated DataSets attribute group:



Type String

Timestamp attribute


Type String




Type String

Plex Name attribute


Type String



Type String

Migration Volser attribute

DescriptionMigration volser

Type String

Valid Data Set attribute

DescriptionValid data set

Type String

Deleted attribute

DescriptionData set was deleted

Type String

SDSP Data Set attribute

DescriptionVSAM SDSP data set

Type String


DescriptionMigration level

Type String

Percent Compressed attribute

DescriptionSpace saved if compressed



Date Created attribute


DescriptionDate created

Type String

Last Used Timestamp attribute

DescriptionTimestamp of when this was last used

Type Timestamp

Last Updated (VSAM) attribute

DescriptionTimestamp of when this was last updated (VSAM)

Type Timestamp

Time Migrated attribute

DescriptionTime migrated

Type Timestamp

Time Last Backup attribute

DescriptionTime last backup

Type Timestamp

Days Since Last Backup attribute

DescriptionDays since last backup





Type String

Max Blocksize attribute

DescriptionMaximum blocksize










Type String

Size In Tracks attribute

DescriptionTracks on user volume



Size In Kilobytes attribute

DescriptionKbytes on user volume



Version Size(2K Blks) attribute

DescriptionSize of curr version in 2k blks





Times Migrated attribute

DescriptionNumber of times migrated



Days Til Migrated attribute

DescriptionDays until eligible for migration



User Volser attribute

DescriptionUser volser

Type String

User Volser Device Type-Hex attribute

DescriptionModel type of primary volume

Type String

User Volser Device Type attribute

DescriptionDevice type of primary volume

Type String

Time Recalled attribute

DescriptionTime recalled


Type Timestamp

Migration Volser Device Type-Hex attribute

DescriptionMigration vol device model

Type String

Migration Volser Device Type attribute

DescriptionMigration vol device type

Type String

Volumes Available For Recall attribute

DescriptionNum volumes available for recall




DescriptionExpiration date

Type String

Multi Volume attribute

DescriptionMulti-volume data set

Type String


DescriptionSMS managed data set

Type String

Secondary Allocation Type attribute

DescriptionSecondary allocation type

Type String

Secondary Allocation Amount attribute

DescriptionSecondary allocation amount





Migration Copy Data Set Name attribute

DescriptionMigration dsname

Type String

Additional Volumes attribute

DescriptionAdditional migration volumes



Number Of 16 Blks For Backup Version attribute

DescriptionTotal number of 16 blocks for backup version



Stripe/Data Set attribute

DescriptionDataset is striped

Type String

Data Class Name attribute

DescriptionData class name

Type String

Storage Class Name attribute


Type String

Management Class Name attribute


DescriptionManagement class name

Type String

MCO Exists attribute

DescriptionMCO Exists

Type String

Days Since Created attribute




Days Since Last Used attribute

DescriptionDays since last used



Days Since VSAM Last Used attribute

DescriptionDays since VSAM last used



Days Since Migrated attribute

DescriptionDays since migrated





Days Since Recalled attribute

DescriptionDays since recalled



Days Till Expired attribute

DescriptionDays until expiration




DescriptionLength of track on this device



MCL Exists attribute

DescriptionMCL Exists

Type String


Migration Volumes attribute group

Volumes Used in Migrate Commands If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the MigrationVolumes attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String

Unit Name attribute

DescriptionUnit Name

Type String


DescriptionVolume Type

Type String


DescriptionMigration Level


Type String

SDSP attribute

DescriptionSDSP?

Type String

No Auto Recall attribute

DescriptionNo auto recall?

Type String

Volume Full attribute

DescriptionVolume full

Type String

No Command Migration attribute

DescriptionNo command migration

Type String

Tape Write attribute

DescriptionTape write

Type String

Tape Empty attribute

DescriptionTape empty

Type String

Tape Used attribute

DescriptionTape used

Type String

Tape Unavailable attribute

DescriptionTape unavailable

Type String

Tape No Update attribute

DescriptionTape no update

Type String

Primary Threshold attribute

DescriptionPrimary Threshold

Type String


HWM attribute

DescriptionHWM



LWM attribute

DescriptionLWM



Timestamp Of Last Migration attribute

DescriptionTimestamp of last migration

Type Timestamp

Days Since Migrate attribute

DescriptionDays since migration



Total Tracks attribute

DescriptionTotal Tracks






DescriptionFree Tracks




DescriptionDevice Type

Type String, 8 characters in length.


DescriptionBlock Size



Number Of Cylinders attribute

DescriptionNumber of cylinders




DescriptionTracks per cylinder









Number Of 2K Blocks attribute

DescriptionNumber of 2k blocks



Tape Percent Full attribute

DescriptionTape percent full




DescriptionMinimum Age





Number Of Data Sets attribute

DescriptionNumber of data sets



Number Of Tracks attribute

DescriptionNumber of tracks







DBA Days attribute

DescriptionDBADays





Tape Density attribute

DescriptionTape density



Lspace Timestamp attribute

DescriptionLspace timestamp

Type Timestamp

Lspace Days attribute

DescriptionLspace days




DescriptionSMS managed

Type String



Type String

Auto Prim Timestamp attribute

DescriptionLast auto prim timestamp


Type Timestamp

Auto Prim Days attribute

DescriptionDays since last auto prim



Auto Backup Timestamp attribute

DescriptionLast auto backup timestamp

Type Timestamp

Auto Backup Days attribute

DescriptionDays since last auto backup



Auto Dump Date attribute

DescriptionLast auto dump date

Type Timestamp

Auto Dump Days attribute

DescriptionDays since last auto dump



Int Migration Timestamp attribute


DescriptionInt migration timestamp

Type Timestamp

Mounted Volumes attribute group

Volumes Used in HSM Processing If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the MountedVolumes attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Job Name attribute


Type String



Type String

Host ID attribute

DescriptionHost Id


Type String

HSM Volume Type attribute

DescriptionHSM Type MVT entry

Type String

Volser attribute

DescriptionVolser

Type String

UCB Address attribute

DescriptionUCB address

Type String



Type String





Volume Sequence Number attribute

DescriptionVolume sequence number



Migration Required attribute

DescriptionMigration required flag

Type String


No Auto Migration attribute

DescriptionNo auto migration flag

Type String

SDSP attribute

DescriptionSDSP volume

Type String

Full VTOC attribute

DescriptionVTOC almost full

Type String

No Auto Recall attribute

DescriptionNo auto recalls

Type String

Auto Backup attribute

DescriptionAuto backup

Type String

No Command Migration attribute

DescriptionNo command migration

Type String

Unit Name attribute


Type String

Total Space (Trks) attribute

DescriptionTotal space (in tracks)



Free Space (Trks) attribute

DescriptionFree space (in tracks)




Low Thresh attribute

DescriptionLow threshold



High Thresh attribute

DescriptionHigh threshold




DescriptionDevice type

Type String


DescriptionDevice type in hex

Type String


DescriptionMax blocksize





Number Of Cylinders attribute

DescriptionNumber of cylinders




DescriptionNumber of tracks per cylinder







#2k Blk Per Trk attribute

DescriptionNum 2k blocks per track




Opt Blksz for 2k Blks attribute

DescriptionOptional blocksize for 2k blocks



Guaranteed Backup Frequency attribute

DescriptionGuaranteed backup freq in days




DescriptionMinimum age to migrate from vol








Reserve Count attribute

DescriptionReserve count on volume



ML1 Overflow attribute

DescriptionML1 Overflow volume

Type String

In Use By DS Migration attribute

DescriptionIn use by DS migration

Type String

Processing Unit attribute

DescriptionId of processing unit

Type String

Delete Days attribute

DescriptionNum inactive days for deletion



Migrate Convert Volser attribute

DescriptionVolser for migrate convert cmd

Type String

Backup Day attribute

DescriptionDay of backup cycle

Type String

Tape Density attribute


DescriptionDensity of tape



Last File Sequence # attribute

DescriptionFile seq of last file written



MWE Queue Contents attribute group

Current HSM Work Elements If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the MWE QueueContents attribute group:



Type String

Timestamp attribute


Type String



Type String


Plex Name attribute


Type String

Job Name attribute


Type String



Type String

Host ID attribute

DescriptionHost Id

Type String

MWE Entry Type attribute

DescriptionType MWE entry

Type String

Request Timestamp attribute

DescriptionDate and time request was queued

Type Timestamp

Function code attribute

DescriptionFunction code

Type String

VSAM DSN attribute

DescriptionVSAM dataset

Type String

No Wait attribute

DescriptionWAIT=NO requested

Type String

In CSA attribute

DescriptionMWE copied to CSA

Type String



DescriptionRequest made from TSO

Type String

Migrate ML2 attribute

DescriptionMigrate is directly to ML2

Type String

Wait For Volume attribute

DescriptionWaiting for volume

Type String

User Authorized attribute

DescriptionUser has auth

Type String

MWE Status attribute

DescriptionMWE status

Type String






DescriptionASCB address of the requestor

Type String


DescriptionMWE completion code

Type String

Reason ode attribute

DescriptionMWE reason code

Type String


Abend code attribute

DescriptionMWE system abend code

Type String


DescriptionRACF group name

Type String

Requestor Job Name attribute

DescriptionRequestor jobname

Type String

Request Priority attribute

DescriptionRequest priority




DescriptionDSN being processed

Type String

Storage Group Name attribute

DescriptionStorage group name

Type String

Alternate Unit attribute

DescriptionAlternate unit

Type String

Volser attribute

DescriptionVolser number

Type String

User ID attribute

DescriptionUserid making request


Type String

MWE Address attribute

DescriptionAddress of MWE

Type String

Queue Position attribute

DescriptionPosition in queue - character



RCB Address attribute

DescriptionRCB address

Type String

TCB Address attribute

DescriptionTCB address

Type String

Task ID attribute

DescriptionTask id

Type String

Descriptive Type attribute

DescriptionDescriptive type

Type String

Patches attribute group

Patches Available to DFSMShsm If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the Patches attributegroup:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Patch Command attribute

DescriptionPatch command

Type String

Verify Command attribute

DescriptionVerify command

Type String


DescriptionDescription of patch command

Type String

Patch Active attribute

DescriptionPatch is active in host

Type String

Job Name attribute


Type String




Type String

Host ID attribute

DescriptionHost Id

Type String

Performance Object Status attribute group

The Performance Object Status attribute group contains information that reflectsthe status of other attribute groups so you can see the status of all of theperformance objects that make up this application all at once. Each of these otherperformance attribute groups is represented by a row in this table (or other type ofview). The status for an attribute group reflects the result of the last attempt tocollect data for that attribute group, which allows you to see whether the agent isperforming correctly. Unlike other attribute groups, the Performance Object Statusattribute group does not reflect the state of the monitored application. Thisattribute group is most often used to determine why data is not available for oneof the performance attribute groups. If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the PerformanceObject Status attribute group:



Type String

Timestamp attribute


Type String

Query Name attribute - This attribute is a key attribute.

DescriptionThe name of the attribute group.

Type String

Object Name attribute

DescriptionThe name of the performance object.

Type String

Object Type attribute


DescriptionThe type of the performance object.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v WMI (0)v PERFMON (1)v WMI_ASSOCIATION_GROUP (2)v JMX (3)v SNMP (4)v SHELL_COMMAND (5)v JOINED_GROUPS (6)v CIMOM (7)v CUSTOM (8)v ROLLUP_DATA (9)v WMI_REMOTE_DATA (10)v LOG_FILE (11)v JDBC (12)v CONFIG_DISCOVERY (13)v NT_EVENT_LOG (14)v FILTER (15)


Object Status attribute

DescriptionThe status of the performance object.

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v ACTIVE (0)v INACTIVE (1)


Error Code attribute

DescriptionThe error code associated with the query

Type Integer with enumerated values. The strings are displayed in theTivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v NO_ERROR (0)v GENERAL_ERROR (1)v OBJECT_NOT_FOUND (2)v COUNTER_NOT_FOUND (3)v NAMESPACE_ERROR (4)v OBJECT_CURRENTLY_UNAVAILABLE (5)


v COM_LIBRARY_INIT_FAILURE (6)v SECURITY_INIT_FAILURE (7)v PROXY_SECURITY_FAILURE (9)v NO_INSTANCES_RETURNED (10)v ASSOCIATOR_QUERY_FAILED (11)v REFERENCE_QUERY_FAILED (12)v NO_RESPONSE_RECEIVED (13)v CANNOT_FIND_JOINED_QUERY (14)v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_1_RESULTS

(15)v CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_2_RESULTS

(16)v QUERY_1_NOT_A_SINGLETON (17)v QUERY_2_NOT_A_SINGLETON (18)v NO_INSTANCES_RETURNED_IN_QUERY_1 (19)v NO_INSTANCES_RETURNED_IN_QUERY_2 (20)v CANNOT_FIND_ROLLUP_QUERY (21)v CANNOT_FIND_ROLLUP_ATTRIBUTE (22)v FILE_OFFLINE (23)v NO_HOSTNAME (24)v MISSING_LIBRARY (25)v ATTRIBUTE_COUNT_MISMATCH (26)v ATTRIBUTE_NAME_MISMATCH (27)v COMMON_DATA_PROVIDER_NOT_STARTED (28)v CALLBACK_REGISTRATION_ERROR (29)v MDL_LOAD_ERROR (30)v AUTHENTICATION_FAILED (31)v CANNOT_RESOLVE_HOST_NAME (32)v SUBNODE_UNAVAILABLE (33)v SUBNODE_NOT_FOUND_IN_CONFIG (34)v ATTRIBUTE_ERROR (35)v CLASSPATH_ERROR (36)v CONNECTION_FAILURE (37)v FILTER_SYNTAX_ERROR (38)v FILE_NAME_MISSING (39)v SQL_QUERY_ERROR (40)v SQL_FILTER_QUERY_ERROR (41)v SQL_DB_QUERY_ERROR (42)v SQL_DB_FILTER_QUERY_ERROR (43)v PORT_OPEN_FAILED (44)v ACCESS_DENIED (45)v TIMEOUT (46)v NOT_IMPLEMENTED (47)v REQUESTED_A_BAD_VALUE (48)v RESPONSE_TOO_BIG (49)


v GENERAL_RESPONSE_ERROR (50)v SCRIPT_NONZERO_RETURN (51)v SCRIPT_NOT_FOUND (52)v SCRIPT_LAUNCH_ERROR (53)


Return Code Summary attribute group

Summary of all DFSMShsm actions in the interval, summarized by action andreturn code. If the warehouse default setting is enabled, data for this attributegroup is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Return CodeSummary attribute group:



Type String

Timestamp attribute


Type String

Return Code attribute - This attribute is a key attribute.

DescriptionThe return code of the function performed.



Count attribute

DescriptionThe count of datasets.





Message attribute

DescriptionDescription of the return code.

Type String

Action attribute

DescriptionFunction performed.

Type String

Type attribute

DescriptionSource of data, hidden from user.

Type String

SETSYS Values attribute group

Current SETSYS Processing Values If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the SETSYS Valuesattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

Job Name attribute


Type String



Type String

Host ID attribute

DescriptionHost Id

Type String

Keyword attribute

DescriptionKeyword from JCL/ARCCMD member

Type String

Parm Value attribute

DescriptionValue associated with keyword

Type String


DescriptionShort parm description

Type String

SMS HSM Mounted Volume Reports attribute group

Summary of the Mounted Volumes If the warehouse default setting is enabled,data for this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the SMS HSMMounted Volume Reports attribute group:



Type String

Timestamp attribute



Type String



Type String

Plex Name attribute


Type String

Status attribute


Type String

Count attribute






Type String

Tape Copy Needed attribute group

Tape Volumes Needing Updating If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Tape CopyNeeded attribute group:




Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String


DescriptionType volume

Type String

TapeCopy Timestamp attribute

DescriptionDate of last auto Tapecopy

Type Timestamp

Days Since Tapecopy attribute

DescriptionDays since last auto Tapecopy



Alternate Unit Name attribute

DescriptionAlternate volume unit name

Type String


New Tape Architecture attribute

DescriptionTape uses new tape architecture

Type String

Tape Volumes attribute group

Tape Volume Information If the warehouse default setting is enabled, data for thisattribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Tape Volumesattribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

Volser attribute


Type String


DescriptionType volume

Type String

Full attribute


DescriptionIf volume is full

Type String

Capacity attribute

DescriptionVolume capacity type

Type String

Unit Name attribute


Type String

Data Set Number attribute

DescriptionNumber of data sets



Total Blocks attribute

DescriptionTotal number of blocks



Number Of Valid Blocks attribute

DescriptionValid number of blocks




Previous Volume attribute

DescriptionPrevious volume

Type String

Next Volume attribute

DescriptionNext volume

Type String



Type String

Alternate Unit attribute

DescriptionUnit name for alternate volume

Type String

Number Of VSAM Files attribute

DescriptionNum of VSAM files



Number Of Valid Data Sets attribute

DescriptionNumber of valid data sets



Thrashing Report attribute group

View Migration/Recall Thrashing If the warehouse default setting is enabled, datafor this attribute group is stored in Tivoli Data Warehouse.



Attribute descriptionsThe following list contains information about each attribute in the ThrashingReport attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute


Type String

User ID attribute

DescriptionUser id requesting function

Type String



Type String

Host ID attribute

DescriptionHost id

Type String

System ID attribute


Type String

Number Of recalls attribute

DescriptionNumber of recalls




Number Of Migrates attribute

DescriptionNumber of migrates



Volume Statistics Records attribute group

Statistics Records for Volumes If the warehouse default setting is enabled, data forthis attribute group is stored in Tivoli Data Warehouse.


Attribute descriptionsThe following list contains information about each attribute in the Volume StatisticsRecords attribute group:



Type String

Timestamp attribute


Type String



Type String

Plex Name attribute



Type String

Volser attribute


Type String

Date attribute

DescriptionDate

Type String



Type String

Number Of User Migrates attribute

DescriptionNumber of user migrates



Number Of System Migrates attribute

DescriptionNumber of system migrates



Number Of Non-VSAM Data Set attribute

DescriptionNumber of non-VSAM data set






DescriptionMinimum age



Allocated Tracks attribute

DescriptionAllocated tracks







Lwm attribute

DescriptionLwm




Hwm attribute

DescriptionHwm



Obm attribute

DescriptionObm



Oam attribute

DescriptionOam



Percent Eligible attribute

DescriptionPercent eligible




Number Of Int Migration attribute

DescriptionNumber of int migration



Number Of Int Met attribute

DescriptionNumber of int met







Migration Time attribute

DescriptionMigration time



Unit Name attribute



Type String

Dump Attempted attribute

DescriptionDump attempted

Type String

Dump Failed attribute

DescriptionDump failed

Type String

Restore Attempted attribute

DescriptionRestore attempted

Type String

Restore Failed attribute

DescriptionRestore failed

Type String

Dump Copies attribute

DescriptionDump copies



Dump Copies Failed attribute

DescriptionDump copies failed



Number Of Restores attribute


DescriptionNumber of restores



Number Of Restores Failed attribute

DescriptionNumber of restores failed



Total Capacity attribute

DescriptionTotal capacity



Number Of Data Set Reconnnected attribute

DescriptionNumber of DS recon



Number Of Tracks Reconnected attribute

DescriptionNumber of tracks recon




Disk capacity planning for historical dataDisk capacity planning for a monitoring agent is a prediction of the amount of diskspace to be consumed for each attribute group whose historical data is beingcollected. Required disk storage is an important factor to consider when you aredefining data collection rules and your strategy for historical data collection.

The table in this chapter provides the following information required to calculatedisk space for this monitoring agent:v Table is the table name as it is displayed in the warehouse database, if the

attribute group is configured to be written to the warehouse.v Attribute group is the name of the attribute group as it is displayed in the

warehouse configuration panel.v Bytes per instance (agent) is an estimate of the record length for each row or

instance written to the agent disk for historical data collection. This estimate canbe used for agent disk space planning purposes.

v Database bytes per instance (warehouse) is an estimate of the record length fordetailed records written to the warehouse database, if the attribute group isconfigured to be written to the warehouse. Detailed records are those that havebeen uploaded from the agent for long-term historical data collection. Thisestimate can be used for warehouse disk space planning purposes.

v Aggregate bytes per instance (warehouse) is an estimate of the record length foraggregate records written to the warehouse database, if the attribute group isconfigured to be written to the warehouse. Aggregate records are created by theSummarization agent for attribute groups that have been configured forsummarization. This estimate can be used for warehouse disk space planningpurposes.

In addition to the information in the tables, you must know the number ofinstances of data that you plan to collect. An attribute group can have single ormultiple instances of data depending on the application environment that is beingmonitored. For example, if your attribute group is monitoring each processor inyour computer and you have a dual processor computer, the number of instancesis two.

The following table contains capacity planning information for the data logged byIBM Tivoli Advanced Reporting for DFSMShsm.

Table 1. Capacity planning for historical data logged by component Advanced Reporting for DFSMShsm

Table Attribute group

Bytes perinstance(agent)

Databasebytes perinstance(warehouse)

Aggregatebytes perinstance(warehouse)

KRHACTLOGS KRH_ACTIVITY_LOGS 154 156 208


Table 1. Capacity planning for historical data logged by component Advanced Reporting for DFSMShsm (continued)





KRHAREVENT KRH_ADVANCED_REPORTING_EVENT_DATA 294 298 365

KRHARMSGS KRH_ADVANCED_REPORTING_MESSAGES 192 193 260

KRHBKUPDSN KRH_BACKUP_DATA_SETS 240 260 507

KRHBKUPVER KRH_BACKUP_VERSIONS 220 234 316

KRHBKUPVOL KRH_BACKUP_VOLUMES 240 261 463

KRHBCDSDET KRH_BCDS_DETAILS 228 235 302

KRHBCDSSUM KRH_BCDS_VOLUME_SUMMARY 98 97 134

KRHCDSSUM KRH_CDS_SMS_CLASS_SUMMARY 106 106 158

KRHHSMCDSS KRH_CONTROL_DATA_SETS 168 173 210

KRHDSRFUNC KRH_DAILY_FUNCTION_STATS 184 199 461

KRHDSMDET KRH_DAILY_SPACE_MANAGEMENT_DETAIL 150 169 347

KRHDSMSUM KRH_DAILY_SPACE_MANAGEMENT_SUMMARY 110 138 352

KRHDAILYST KRH_DAILY_STATISTICS 240 273 805

KRHVSRFUNC KRH_DAILY_VOLUME_STATS 179 193 410

KRHHSMFUNC KRH_DFSMSHSM_FUNCTIONS 145 149 186

KRHSMSSMRY KRH_DFSMS_CLASS_SUMMARY 184 190 272

KRHDUMPCLS KRH_DUMP_CLASSES 160 171 283

KRHDUMPDSN KRH_DUMP_DATA_SETS 212 223 305

KRHDUMPVER KRH_DUMP_VERSIONS 500 527 684

KRHDUMPVOL KRH_DUMP_VOLUMES 204 225 322

KRHHSMEXIT KRH_EXIT_INFORMATION 307 323 390

KRHCOLEXTR KRH_EXTENT_REDUCTIONS 315 347 579

KRHXTRSUM KRH_EXTENT_REDUCTION_SUMMARY 150 153 250

KRHFILTER KRH_FILTER_ATTRIBUTE_GROUP 436 437 474

KRHCOLFNCS KRH_FUNCTION_RECORDS 325 355 527

KRHCOLSUMM KRH_FUNCTION_SUMMARY 148 150 217

KRHHLTBKUP KRH_HSM_BACKUP_REPORTS 161 162 214

KRHCDSBCKP KRH_HSM_CDS_BACKUPS 258 263 315

KRHCDSSPCE KRH_HSM_CDS_SPACE 543 611 1203

KRHCDSENQS KRH_HSM_CDS_USERS 256 272 369

KRHHLTDET KRH_HSM_HEALTH_DETAIL_REPORTS 298 342 664

KRHHSMHOST KRH_HSM_HOST_INFO 412 460 722

KRHHLTMIG KRH_HSM_MIGRATION_REPORTS 161 162 214

KRHHLTDUMP KRH_HSM_VOLUME_DUMP_REPORTS 161 162 214

KRHHSMCMDS KRH_ISSUE_HSM_COMMANDS 356 360 397

KRHHSMLOGS KRH_LOG_DATA_SETS 168 171 208

KRHLMIGDET KRH_LOG_MIGRATION_DETAIL 176 182 294

KRHLRECDET KRH_LOG_RECALL_DETAIL 208 219 361


Table 1. Capacity planning for historical data logged by component Advanced Reporting for DFSMShsm (continued)





KRHMCDDET KRH_MCDS_DETAILS 223 238 350

KRHMMVSUM KRH_MCDS_VOLUME_SUMMARY 90 88 125

KRHMGRTDSN KRH_MIGRATED_DATA_SETS 511 559 896

KRHMGRTVOL KRH_MIGRATION_VOLUMES 314 356 708

KRHHSMVOLS KRH_MOUNTED_VOLUMES 266 305 627

KRHHSMMWES KRH_MWE_QUEUE_CONTENTS 346 377 459

KRHHSMPTCH KRH_PATCHES 260 265 302

KRHPOBJST KRH_PERFORMANCE_OBJECT_STATUS 288 289 326

KRHRCSUM KRH_RETURN_CODE_SUMMARY 160 161 213

KRHHSMSSYS KRH_SETSYS_VALUES 206 210 247

KRHHLTHVST KRH_SMS_HSM_MOUNTED_VOLUME_REPORTS 161 162 214

KRHTAPECPY KRH_TAPE_COPY_NEEDED 128 132 184

KRHTAPEVOL KRH_TAPE_VOLUMES 163 175 287

KRHCOLTHRS KRH_THRASHING_REPORT 162 166 233

KRHVOLEST KRH_VOLUME_STATISTICS_RECORDS 203 231 598

For more information about historical data collection, see the IBM Tivoli MonitoringAdministrator's Guide.


Chapter 5. Situations reference

This chapter contains an overview of situations, references for detailed informationabout situations, and descriptions of the predefined situations included in thismonitoring agent.

About situationsA situation is a logical expression involving one or more system conditions.Situations are used to monitor the condition of systems in your network. You canmanage situations from Tivoli Enterprise Portal by using the Situation Editor.

The monitoring agents that you use to monitor your system environment aredelivered with a set of predefined situations that you can use as-is or you cancreate new situations to meet your requirements. Predefined situations containattributes that check for system conditions common to many enterprises.

Using predefined situations can improve the speed with which you can beginusing the IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent. Youcan examine and, if necessary, change the conditions or values being monitored bya predefined situation to those best suited to your enterprise.

You can display predefined situations and create your own situations using theSituation Editor. The left frame of the Situation editor initially lists the situationsassociated with the Navigator item that you selected. When you click a situationname or create a new situation, the right frame opens with the following tabs:

FormulaFormula describing condition being tested

DistributionList of managed systems (operating systems, subsystems, or applications)to which the situation can be distributed. All of the IBM Tivoli AdvancedReporting for DFSMShsm Monitoring Agent managed systems are assignedby default.

Expert adviceComments and instructions to be read in the event workspace

ActionCommand to be sent to the system

Until Options to close the event after a period of time, or when another situationbecomes true

More information about situationsTivoli Enterprise Portal User's Guide contains more information about predefinedand custom situations and how to use them to respond to alerts.

For a list of the predefined situations for this monitoring agent and a descriptionof each situation, see the Predefined situations section in this chapter and theinformation in that section for each individual situation.


Predefined situationsThis monitoring agent contains the following predefined situations, which areorganized by Navigator item.v IBM Tivoli Advanced Reporting for DFSMShsm

– Not applicablev Advanced Reporting Event Information

– Not applicablev BCDS Details

– Not applicablev BCDS Volume Summary

– Not applicablev CDS SMS Class Summary

– Not applicablev Daily Space Management Detail

– Not applicablev Daily Space Management Summary

– Not applicablev DFSMShsm Collection Data

– Not applicablev Extent Reduction Summary

– Not applicablev Filter Attribute Group

– Not applicablev Health Reports

– Not applicablev HSM Host Information

– Not applicablev Log Migration Detail

– Not applicablev Log Recall Detail

– KRH_Error_Editing_CDS– KRH_Mig_Vol_Not_Avail– KRH_No_Pri_Vol_Avail– KRH_Request_Vol_Not_Avail– KRH_Insuff_Sp_On_Trg_Vol– KRH_No_Unit_Avail– KRH_Cant_Recover_w_NewName– KRH_Recover_Failed– KRH_Recall_Delete_Held– KRH_Restore_Failed– KRH_Recall_Recover_Error– KRH_No_Pri_Vol_Avail– KRH_No_Uni_Avail– KRH_Recover_Failed


– KRH_Existing_DS_Delete_Err– KRH_Recall_Delete_Held– KRH_Recall_Recovery_Err

v MCDS Details– Not applicable

v MCDS Volume Summary– Not applicable

v Reports From The CDSS– Not applicable

v Return Code Summary– KRH_No_Mig_Vol_Available– KRH_Duplicate_DSN_In_MCDS– KRH_Mig_Copy_Already_Exist– KRH_Data_Set_In_Use– KRH_No_Space_In_Mig_Vol– KRH_L0_Vol_Not_Available– KRH_Migration_Held– KRH_Unsupported_Data_Set– KRH_Cant_Mv_Bkup_Miss_Vol– KRH_No_Vol_For_Bkup– KRH_Data_Set_In_Use– KRH_DS_Not_Elig_For_Bkup– KRH_Ext_Record_Missing– KRH_No_Space_On_Bkup_Vol– KRH_Bkup_Funct_Disabled– KRH_Bkup_Failed_For_DSN– KRH_Backup_Held– KRH_BCDS_Record_Not_Found– KRH_Fail_In_Bkvol_Dump– KRH_Unsupported_Data_Set

The remaining sections of this chapter contain descriptions of each of thesesituations. The situations are organized by Navigator item. The followinginformation is provided about each situation:

DescriptionInformation about the conditions that the situation tests

FormulaSyntax that contains one or more logical expressions describing theconditions for the situation to monitor

Run at startupWhether the situation is automatically distributed to instances of the agentor is available for manual distribution

Sampling intervalNumber of seconds that elapses between one sample of data that themonitoring agent collects for the server and the next sample

Chapter 5. Situations reference 205

Situation persistenceWhether the conditions specified in the situation evaluate to "true" for thedefined number of occurrences in a row before the situation is raised. Thedefault of 1 means no persistence checking takes place.

SeveritySeverity of the predefined events: Warning, Informational, or Critical

Clearing conditionsControls when a true situation closes: after a period of time, when anothersituation is true, or whichever occurs first if both are selected.

IBM Tivoli Advanced Reporting for DFSMShsm Navigator itemThere are no predefined situations for this Navigator item.

Advanced Reporting Event Information Navigator itemThere are no predefined situations for this Navigator item.

BCDS Details Navigator itemThere are no predefined situations for this Navigator item.

BCDS Volume Summary Navigator itemThere are no predefined situations for this Navigator item.

CDS SMS Class Summary Navigator itemThere are no predefined situations for this Navigator item.

Daily Space Management Detail Navigator itemThere are no predefined situations for this Navigator item.

Daily Space Management Summary Navigator itemThere are no predefined situations for this Navigator item.

DFSMShsm Collection Data Navigator itemThere are no predefined situations for this Navigator item.

Extent Reduction Summary Navigator itemThere are no predefined situations for this Navigator item.

Filter Attribute Group Navigator itemThere are no predefined situations for this Navigator item.

Health Reports Navigator itemThere are no predefined situations for this Navigator item.


HSM Host Information Navigator itemThere are no predefined situations for this Navigator item.

Log Migration Detail Navigator itemThere are no predefined situations for this Navigator item.

Log Recall Detail Navigator item

KRH_Error_Editing_CDS situation

DescriptionThe action request on a data set failed with a return code = 1

The situation will be evaluated for each distinct value of the DSNAME attribute.

Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 1 ) )

See “Attribute groups and attributes for the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent” on page 21 for descriptions of the attributes in thisformula.

Run at startupThis situation is available for distribution.

Sampling interval1 minute

Situation persistenceThe number of times the conditions of the situation must occur for the situation tobe true is 1.

SeverityCritical

Clearing conditionsThe situation clears when the condition becomes false.

KRH_Mig_Vol_Not_Avail situation









SeverityCritical


KRH_No_Pri_Vol_Avail situation








SeverityCritical


KRH_Request_Vol_Not_Avail situation









SeverityCritical


KRH_Insuff_Sp_On_Trg_Vol situation








SeverityCritical



KRH_No_Unit_Avail situation








SeverityCritical


KRH_Cant_Recover_w_NewName situation

DescriptionThe backup request for a data set failed with a return code = 57








SeverityCritical


KRH_Recover_Failed situation








SeverityCritical


KRH_Recall_Delete_Held situation









SeverityCritical


KRH_Restore_Failed situation








SeverityCritical


KRH_Recall_Recover_Error situation









SeverityCritical


KRH_No_Pri_Vol_Avail situation



Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) )





SeverityCritical



KRH_No_Uni_Avail situation








SeverityCritical


KRH_Recover_Failed situation









SeverityCritical


KRH_Existing_DS_Delete_Err situation

DescriptionDeletion request of a data set failed with a return code = 59







SeverityCritical


KRH_Recall_Delete_Held situation

DescriptionAction request on a data set failed with a return code = 74








SeverityCritical


KRH_Recall_Recovery_Err situation

DescriptionAction request on a data set failed with a return code = 99







SeverityCritical


MCDS Details Navigator itemThere are no predefined situations for this Navigator item.

MCDS Volume Summary Navigator itemThere are no predefined situations for this Navigator item.

Reports From The CDSS Navigator itemThere are no predefined situations for this Navigator item.


Return Code Summary Navigator item

KRH_No_Mig_Vol_Available situation

DescriptionThe action request a dataset failed with a return code = 5

The situation will be evaluated for each distinct value of the RETCODE attribute.

Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUEKRH_RETURN_CODE_SUMMARY.RETCODE *EQ 5 ) )





SeverityCritical


KRH_Duplicate_DSN_In_MCDS situation

DescriptionThe migration request of a dataset failed with a return code = 6








SeverityCritical


KRH_Mig_Copy_Already_Exist situation

DescriptionThe migration request of a dataset failed with return code = 12







SeverityCritical


KRH_Data_Set_In_Use situation

DescriptionThe action requested on a dataset had a return code = 19








SeverityCritical


KRH_No_Space_In_Mig_Vol situation








SeverityCritical


KRH_L0_Vol_Not_Available situation









SeverityCritical


KRH_Migration_Held situation








SeverityCritical



KRH_Unsupported_Data_Set situation








SeverityCritical


KRH_Cant_Mv_Bkup_Miss_Vol situation

DescriptionThe backup request for a dataset failed with a return code = 4


Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 4 ) )






SeverityCritical


KRH_No_Vol_For_Bkup situation

DescriptionThe action request on a dataset failed with a return code = 5







SeverityCritical


KRH_Data_Set_In_Use situation

DescriptionThe action request on a dataset failed with a return code = 19








SeverityCritical


KRH_DS_Not_Elig_For_Bkup situation

DescriptionThe backup request on a dataset failed with a return code = 20







SeverityCritical


KRH_Ext_Record_Missing situation









SeverityCritical


KRH_No_Space_On_Bkup_Vol situation

DescriptionThe backup request of a dataset failed with a return code = 37







SeverityCritical



KRH_Bkup_Funct_Disabled situation

DescriptionThe backup request for the data set failed with return code = 40







SeverityCritical


KRH_Bkup_Failed_For_DSN situation









SeverityCritical


KRH_Backup_Held situation








SeverityCritical


KRH_BCDS_Record_Not_Found situation









SeverityCritical


KRH_Fail_In_Bkvol_Dump situation

DescriptionThe action request a volume failed with a return code = 84







SeverityCritical


KRH_Unsupported_Data_Set situation



Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND ( *VALUEKRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) )






SeverityCritical



Chapter 6. Take Action commands reference

This chapter contains an overview of Take Action commands, references fordetailed information about Take Action commands, and descriptions of the TakeAction commands included in this monitoring agent, if any.

About Take Action commandsTake Action commands can be run from the portal client or included in a situationor a policy.

When included in a situation, the command runs when the situation becomes true.A Take Action command in a situation is also referred to as reflex automation.When you enable a Take Action command in a situation, you automate a responseto system conditions. For example, you can use a Take Action command to send acommand to restart a process on the managed system or to send a text message toa cell phone.

Advanced automation uses policies to perform actions, schedule work, andautomate manual tasks. A policy comprises a series of automated steps calledactivities that are connected to create a workflow. After an activity is completed,Tivoli Enterprise Portal receives return code feedback, and advanced automationlogic responds with subsequent activities prescribed by the feedback.

A basic Take Action command displays the return code of the operation in amessage box that is displayed after the action completes or in a log file. After youclose this window, no further information is available for this action.

More information about Take Action commandsFor more information about working with Take Action commands, see the TivoliEnterprise Portal User's Guide.

For a list of the Take Action commands for this monitoring agent and a descriptionof each command, see the Predefined Take Action commands section in thischapter and the information in that section for each individual command.

Predefined Take Action commandsThis monitoring agent contains the following Take Action commands:v HBACKDSv HBDELETEv HCANCELv HDELETEv HMIGRATEv HRECALLv HRECOVER

The remaining sections of this chapter contain descriptions of these Take Actioncommands, which are listed alphabetically. The following information is providedabout each Take Action command:


DescriptionWhich actions the command performs on the system to which it is sent,and the permissions required for the Take Action command to function

Return codesInformation that the Take Action command returns

HBACKDS action

DescriptionUsed to create a backup version of a specific data set.

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HBACKDS \

[DSNAME]

[WAIT]

[TARGET]

[VOLUME]

[UNITNAME]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:HBACKDS \

[&{DSNAME}] \

[&{WAIT}] \

[&{TARGET}] \

[&{VOLUME}] \

[&{UNITNAME}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HBACKDS \

[&WaitOnSituation:DSNAME] \

[&WaitOnSituation:WAIT] \

[&WaitOnSituation:TARGET] \

[&WaitOnSituation:VOLUME] \

[&WaitOnSituation:UNITNAME]

Argumentsv Name: DSNAME

Description: Required - Specify the name of the data set you want to backup.


Default:

v Name: WAITDescription: Optional - Specifies that you want to wait for HBACKDScommand to complete. Default is NO.Default: YES

v Name: TARGETDescription: Optional - Identifies the type of volume to use for the request.Either TAPE, DASD, or HSM.Default: HSM

v Name: VOLUMEDescription: Optional - Specify the volume where an uncataloged data set isto be backed up resides You must specify the VOLUME parameter if anydata set to be backed up is uncataloged data set. Do not specify theVOLUME parameter if all data sets to be backed up are cataloged.Default:

v Name: UNITNAMEDescription: Optional - Specifies the type of unit on which the volume canbe allocated for an uncataloged data set. Valid types are: 3330, 3330-1, 3330V,3350, 3375, 3380, 3390, and 9345. UNITNAME and VOLUME must bespecified if any data set to be backed up is an uncataloged data set. Do notspecify the UNITNAME parameter if all data sets to be backed up arecataloged. If you specify the UNIT parameter, you must specify theVOLUME paramenter.Default: 3390

Return codesv Return Code: 0000

Return Code Type: OKOperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0000Message: Take Action was successfully issued.

v Return Code: 0004Return Code Type: INSUFFICIENT_USER_AUTHORITYOperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0004Message: User ID Translation failed.

v Return Code: 0008Return Code Type: GENERAL_ERROROperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0008Message: Bad Parameter List.

v Return Code: 0012Return Code Type: NOT_RUNNINGOperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0012Message: Bad KRS Environment.

HBDELETE action

DescriptionDelete backup versions of a specific data set or specific backup versions by versionnumber.

Chapter 6. Take Action commands reference 231

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HBDELETE \

[DSNAME]

[WAIT]

[FROMVOLUME]

[VERSION]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:HBDELETE \

[&{DSNAME}] \

[&{WAIT}] \

[&{FROMVOLUME}] \

[&{VERSION}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HBDELETE \



[&WaitOnSituation:FROMVOLUME] \

[&WaitOnSituation:VERSION]


Description: Required - Specify the name of the data set whose backupversions you want to delete. To delete all the backup version of a catalogeddata set, except for retired versions, you specify only teh data set name. Theonly way you can delete a retired version is to specify its version number.Default:

v Name: WAITDescription: Optional - Specifies that you want to wait for the HDELETEcommand to complete. Default is NO.Default: YES

v Name: FROMVOLUMEDescription: Optional - Should only be included if DFSMShsm created thespecified backup version from an uncataloged data set. Specifies the volumeon which an uncataloged data set resided when DFSMShsm created thebackup versions. To delete all backup versions of an uncataloged data setexcept for retired versions, specify the data set name and the serial numberof the volume from which the data set was backed up.Default: NO

v Name: VERSION


Description: Optional - To delete specific backup versions of a data set. Youcan specify multiple backup version numbers. If you do not specifyVERSIONS, DFSMShsm deletes all backup versions of the specified data setexcept for the retired versions. You can obtain backup version number byissuing an HLIST command and specifying the data set name and theBACKUPCONTROLDATASET parameter.Default:






HCANCEL action

DescriptionCancel queued DFSMShsm data movement requests. Unless you are a DFSMShsmauthorized user, you may only cancel requests submitted by your own userid

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HCANCEL \

[DSNAME]

[REQNUM]

[USERID]

[WAIT]

[HOSTID]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:


HCANCEL \

[&{DSNAME}] \

[&{REQNUM}] \

[&{USERID}] \

[&{WAIT}] \

[&{HOSTID}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HCANCEL \


[&WaitOnSituation:REQNUM] \

[&WaitOnSituation:USERID] \


[&WaitOnSituation:HOSTID]


Description: Optional - Specifies that all requests to process a given data setshould be cancelled. If you do not put the data set name in quotes, then TSOwill prefix the name you give with your high level qualifier.Default:

v Name: REQNUMDescription: Optional - Specifies a particular request number of a request tobe cancelled. To find the request numbers of queued requests, issue theHQUERY command.Default:

v Name: USERIDDescription: Optional - Specifies that all requests submitted by the givenuserid should be cancelled.Default:

v Name: WAITDescription: Optional - Specifies that you want to wait for HBACKDScommand to complete. Default is NO.Default: YES

v Name: HOSTIDDescription: Optional - ID of the DFSMShsm host to send the request to.Default:



v Return Code: 0004Return Code Type: INSUFFICIENT_USER_AUTHORITY


Operating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0004Message: User ID Translation failed.



HDELETE action

DescriptionDelete a migrated data set from migration volumes. Data set is deleted withoutrecalling it to primary volume. Any backup versions and information in the BCDSare maintained.

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HDELETE \

[DSNAME]

[WAIT]

[PURGE]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:HDELETE \

[&{DSNAME}] \

[&{WAIT}] \

[&{PURGE}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HDELETE \



[&WaitOnSituation:PURGE]


Description: Required - Specifies the name of a migrated data set to delete.Default:


v Name: WAITDescription: Optional - Specifies that you want to wait for the HDELETEcommand to complete. Default is YES.Default: YES

v Name: PURGEDescription: Optional - Specifies that you want the migrated data set deletedeven if hte data sets have expiration dates that have not yet occurred.Default: NO






HMIGRATE action

DescriptionMigrate one or more data sets to a migration volume

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HMIGRATE \

[DSNAME]

[WAIT]

[MIGLEVEL]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:HMIGRATE \

[&{DSNAME}] \


[&{WAIT}] \

[&{MIGLEVEL}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HMIGRATE \



[&WaitOnSituation:MIGLEVEL]


Description: Required - Specifies the name of the cataloged data set tomigrate.Default:

v Name: WAITDescription: Optional - Specifies if you want to wait for the HMIGRATEcommand to complete. Default is NO.Default: YES

v Name: MIGLEVELDescription: Optional - Migration level to send data set directly to.Default: ML1






HRECALL action

DescriptionRecall a migrated data set.


System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HRECALL \

[DSNAME]

[WAIT]

[TOVOLUME]

[UNITNAME]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:HRECALL \

[&{DSNAME}] \

[&{WAIT}] \

[&{TOVOLUME}] \

[&{UNITNAME}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HRECALL \



[&WaitOnSituation:TOVOLUME] \



Description: Required - Specifies the data set to recall.Default:

v Name: WAITDescription: Optional - Specifies that you want to wait for the HRECALLcommand to complete. Not recommended if the data set is from tape.Default: YES

v Name: TOVOLUMEDescription: Optional - Specifies volume that is to receive the recalled dataset. Volume does not have to be managed by DFSMShsm. If the data set isSMS manged the parameter is ignored. If this parameter is specified thenUNITNAME must also be specifiedDefault:

v Name: UNITNAMEDescription: Optional - Specifies type of unit where the receiving volume canbe allocated. Valid types are: 3330, 3330-1, 3330V, 3350, 3375, 3380, 3390, and9345. If UNITNAME is specified then TOVOLUME must also be specified.This parameter is ignored if the data set is SMS managedDefault: 3390







HRECOVER action

DescriptionRecover a dataset from a backup version or restore a data set froma dump copy.

System commandTo include the Take Action command in a situation or workflow policy, use thefollowing syntax for the system command:HRECOVER \

[DSNAME]

[WAIT]

[FROMVOLUME]

[GENERATION]

[DATE]

[VERSION]

[NEWNAME]

[REPLACE]

[TOVOLUME]

[UNITNAME]

You can use attribute substitution to supply the Take Action command argumentsfrom the situation, for example:


HRECOVER \

[&{DSNAME}] \

[&{WAIT}] \

[&{FROMVOLUME}] \

[&{GENERATION}] \

[&{DATE}] \

[&{VERSION}] \

[&{NEWNAME}] \

[&{REPLACE}] \

[&{TOVOLUME}] \

[&{UNITNAME}]

You can also use attribute substitution in a workflow policy though the format isslightly different:HRECOVER \



[&WaitOnSituation:FROMVOLUME] \

[&WaitOnSituation:GENERATION] \

[&WaitOnSituation:DATE] \

[&WaitOnSituation:VERSION] \

[&WaitOnSituation:NEWNAME] \

[&WaitOnSituation:REPLACE] \

[&WaitOnSituation:TOVOLUME] \



Description: Required - Name of the data set to process.Default:

v Name: WAITDescription: Optional - Specifies that you want to wait for the HRECOVERcommand to complete. Default is NO.Default: YES

v Name: FROMVOLUMEDescription: Optional - Specifies that data set was uncataloged and resideson specified volume.Default:

v Name: GENERATION


Description: Optional - Specifies which particular backup version of data setto recover. Use relative generation number with 0 being most recent anddefault.Default:

v Name: DATEDescription: Optional - Specifies the version to recover be created on orbefore particular date. Use the format yy/mm/dd. If no date is specified thelatest created backup is recovered.Default:

v Name: VERSIONDescription: Optional - Specifies the particular backup version of a data setto recover. Recover will be done from backup version and not a dump copy.If left blank the most recent version will be recovered.Default:

v Name: NEWNAMEDescription: Optional - Specify new data set name for recovered backupversion of the data set. If the data set already exists with same name as newname, you must specify the REPLACE parameter to replace the existing dataset.Default:

v Name: REPLACEDescription: Optional - Specify that recoverd backup version of data setreplace any existing data set with the same data set name. The data set to bereplaced must have the same data set organization as the data set fromwhich backup was made.Default: NO

v Name: TOVOLUMEDescription: Optional - Specify volume that is to receive the recovered dataset. If this is specified UNITNAME must also be specified.Default:

v Name: UNITNAMEDescription: Optional - Specify the type of unit where the receiving volumecan be allocated. alid types of units are: 3330, 3330-1, 3330V, 3350, 3375, 3380,3390, and 9345. The parameter is ignored if data set is SMS mangedDefault: 3390





v Return Code: 0012


Return Code Type: NOT_RUNNINGOperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0012Message: Bad KRS Environment.


Chapter 7. Policies reference

This chapter contains an overview of policies, references for detailed informationabout policies, and descriptions of the predefined policies included in thismonitoring agent, if any.

About policiesPolicies are an advanced automation technique for implementing more complexworkflow strategies than you can create through simple automation.

A policy is a set of automated system processes that can perform actions, schedulework for users, or automate manual tasks. You use the Workflow Editor to designpolicies. You control the order in which the policy executes a series of automatedsteps, which are also called activities. Policies are connected to create a workflow.After an activity is completed, Tivoli Enterprise Portal receives return codefeedback and advanced automation logic responds with subsequent activitiesprescribed by the feedback.

More information about policiesThis monitoring agent does not provide predefined policies. For more informationabout working with policies, see the Tivoli Enterprise Portal User's Guide.

For information about using the Workflow Editor, see the IBM Tivoli MonitoringAdministrator's Guide or the Tivoli Enterprise Portal online help.

Predefined policiesThe IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent does notprovide predefined policies.



Chapter 8. Troubleshooting

This chapter provides agent-specific troubleshooting information. See the IBMTivoli Monitoring Troubleshooting Guide for general troubleshooting information. Alsosee “Support information” on page 260 for other problem-solving options.

Note: You can resolve some problems by ensuring that your system matches thesystem requirements listed in Chapter 2, “Requirements for the monitoringagent,” on page 5.

Built-in troubleshooting featuresThe primary troubleshooting feature in the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent is logging. Logging refers to the text messages andtrace data generated by the IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent. Messages and trace data are sent to a file.

Trace data captures transient information about the current operating environmentwhen a component or application fails to operate as designed. See “Trace logging”for more information.

Problem classificationThe following types of problems might occur with the IBM Tivoli AdvancedReporting for DFSMShsm Monitoring Agent:v Installation and configurationv General usage and operationv Display of monitoring datav Take Action commands

This chapter provides symptom descriptions and detailed workarounds for theseproblems, as well as describing the logging capabilities of the monitoring agent.See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshootinginformation.

Trace loggingTrace logs capture information about the operating environment when componentsoftware fails to operate as intended. The principal log type is the RAS (Reliability,Availability, and Serviceability) trace log. These logs are in the English languageonly. The RAS trace log mechanism is available for all components of IBM TivoliMonitoring. Most logs are located in a logs subdirectory on the host computer. Seethe following sections to learn how to configure and use trace logging:v “Principal trace log files” on page 246v “Examples: using trace logs” on page 248v “Setting RAS trace parameters” on page 249

Note: The documentation refers to the RAS facility in IBM Tivoli Monitoring as"RAS1".


All components in the IBM Tivoli Monitoring environment have a default tracinglevel. The tracing level can be changed on a per-component level to adjust the typeof trace information collected, the degree of trace detail, the number of trace logsto be kept, and the amount of disk space used for tracing.

Overview of log file managementTable 2 provides the names, locations, and descriptions of RAS1 log files. The logfile names adhere to the following naming convention:

Windows systemshostname_productcode_program_HEXtimestamp-nn.log

Linux and UNIX systemshostname_productcode_HEXtimestamp-nn.log

where:v hostname is the host name of the computer where the monitoring component is

running.v productcode is the two-character product code. For IBM Tivoli Advanced

Reporting for DFSMShsm, the product code is rh.v program is the name of the program being run.v HEXtimestamp is a hexadecimal time stamp representing the time at which the

program started.v nn is a rolling log suffix.

Principal trace log files

Table 2 contains locations, file names, and descriptions of trace logs that can helpdetermine the source of problems with agents.

Table 2. Trace log files for troubleshooting agents

System where logis located

File name and path Description

On the TivoliEnterpriseMonitoring Server

v Windows: The file in theinstall_dir\InstallITM path

v UNIX: The candle_installation.log file inthe install_dir/logs path

Provides details about products that areinstalled.Note: Trace logging is enabled by default. Aconfiguration step is not required to enable thistracing.

The Warehouse_Configuration.log file is inthe following location on Windows systems:install_dir\InstallITM

Provides details about the configuration of datawarehousing for historical reporting.

The name of the RAS log file is as follows:

v Windows: install_dir\logs\hostname_ms_timestamp-nn.log

v UNIX: install_dir/logs/hostname_productcode_timestamp.log

Note: File names for RAS1 logs include ahexadecimal time stamp.

Also on UNIX, a log with a decimal timestamp is provided:hostname_productcode_timestamp.log andhostname_productcode_ timestamp.pidnnnnn inthe install_dir/logs path, where nnnnn is theprocess ID number.

Traces activity on the monitoring server.


Table 2. Trace log files for troubleshooting agents (continued)



On the TivoliEnterprise PortalServer

The name of the RAS log file is as follows:

v Windows: install_dir\logs\hostname_cq_HEXtimestamp-nn.log

v UNIX®: install_dir/logs/hostname_cq_HEXtimestamp-nn.log

Note: File names for RAS1 logs include ahexadecimal time stamp.

Also on UNIX, a log with a decimal timestamp is provided:hostname_productcode_timestamp.log andhostname_productcode_ timestamp.pidnnnnn inthe install_dir/logs path, where nnnnn is theprocess ID number.

Traces activity on the portal server.

The teps_odbc.log file is located in thefollowing path

v Windows: install_dir\InstallITM path.

v UNIX: install_dir/logs

When you enable historical reporting, this logfile traces the status of the warehouse proxyagent.

On the computerthat hosts themonitoring agent

The RAS1 log files are as follows:

v Windows: hostname_rh_krhagent_HEXtimestamp-nn.log in theinstall_dir\tmaitm6\logs directory

v UNIX: hostname_rh_HEXtimestamp-nn.log in the install_dir/logs directory

These logs are in the following directories:

v Windows: install_dir\tmaitm6\logs


Traces activity of the monitoring agent.

The agent operations log files are as follows:

instance_hostname_RH.LG0 is the current logcreated when the agent was started

instance_hostname_RH.LG1 is the backup ofthe previous log

These logs are in the following directorydepending on the operating system that youare using:



Shows whether the agent was able to connect tothe monitoring server. Shows which situationsare started and stopped, and shows other eventswhile the agent is running. A new version of thisfile is generated every time the agent isrestarted.

IBM Tivoli Monitoring generates one backupcopy of the *.LG0 file with the tag .LG1. View.LG1 to learn the following details regarding theprevious monitoring session:v Status of connectivity with the monitoring

server.v Situations that were running.v The success or failure status of Take Action

commands.

The Take Action command log files are asfollows:

v host_rh_takeactioncommand.log

The logs are in the following directories:



Traces activity each time a Take Actioncommand runs. For example, when ahypothetical start_command Take Actioncommand runs, IBM Tivoli Monitoring generatesa start_command.log file.

Chapter 8. Troubleshooting 247

Table 2. Trace log files for troubleshooting agents (continued)



Definitions of variables:

timestamp is time stamp whose format includes year (y), month (m), day (d), hour (h), and minute (m), asfollows: yyyymmdd hhmm

HEXtimestamp is a hexadecimal representation of the time at which the process was started.

install_dir represents the directory path where you installed the IBM Tivoli Monitoring component. install_dir canrepresent a path on the computer that host the monitoring system, the monitoring agent, or the portal.

instance refers to the name of the database instance that you are monitoring.

hostname refers to the name of the computer on which the IBM Tivoli Monitoring component runs.

nn represents the circular sequence in which logs are rotated. Ranges from 1-5, by default, though the first isalways retained, because it includes configuration parameters.

productcode specifies the product codes, for example, um for Universal Agent or nt for Windows.

See the IBM Tivoli Monitoring Installation and Setup Guide for more information onthe complete set of trace logs that are maintained on the monitoring server.

Examples: using trace logsYou can open trace logs in a text editor to learn some basic facts about your IBMTivoli Monitoring environment. The following examples are from the TivoliEnterprise Monitoring Server log.

Example oneThis excerpt shows the typical log for a failed connection between amonitoring agent and a monitoring server with the host name server1a:

(Thursday, August 11, 2005, 08:21:30-{94C}kdcl0cl.c,105,"KDCL0_ClientLookup") status=1c020006,"location server unavailable", ncs/KDC1_STC_SERVER_UNAVAILABLE

(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1157,"LookupProxy") Unable to connect tobroker at ip.pipe:: status=0, "success", ncs/KDC1_STC_OK

(Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1402,"FindProxyUsingLocalLookup") Unableto find running CMS on CT_CMSLIST <IP.PIPE:#server1a>

Example twoThe following excerpts from the trace log for the monitoring server show thestatus of an agent, identified here as "Remote node." The name of thecomputer where the agent is running is SERVER5B:

(42C039F9.0000-6A4:kpxreqhb.cpp,649,"HeartbeatInserter") Remote node SERVER5B:RH is ON-LINE.. . .(42C3079B.0000-6A4:kpxreqhb.cpp,644,"HeartbeatInserter") Remote node SERVER5B:RH is OFF-LINE.

Key points regarding the preceding excerpt:v The monitoring server appends the RH product code to the server name

to form a unique name (SERVER5B:RH) for this instance of the IBM TivoliAdvanced Reporting for DFSMShsm Monitoring Agent. This uniquename enables you to distinguish multiple monitoring products thatmight be running on SERVER5B.

v The log shows when the agent started (ON-LINE) and later stopped(OFF-LINE) in the environment.

v For the sake of brevity an ellipsis (...) represents the series of trace logentries that were generated while the agent was running.

v Between the ON-LINE and OFF-LINE log entries, the agent wascommunicating with the monitoring server.


v The ON-LINE and OFF-LINE log entries are always available in thetrace log. All trace levels that are described in “Setting RAS traceparameters” provide these entries.

On Windows, you can use the following alternate method to view trace logs:1. In the Windows Start menu, choose Program Files > IBM Tivoli Monitoring >

Manage Tivoli Enterprise Monitoring Services. The Manage Tivoli EnterpriseMonitoring Services window is displayed.

2. Right-click a component and select Advanced > View Trace Log in the pop-upmenu. For example, if you want to view the trace log of the IBM TivoliAdvanced Reporting for DFSMShsm agent, right-click the name of the thatagent in the window. You can also use the viewer to access remote logs.

Note: The viewer converts time stamps in the logs to a format that is easier toread.

Setting RAS trace parameters

ObjectivePinpoint a problem by setting detailed tracing of individual components of themonitoring agent and modules.

Background InformationThe IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent uses RAS1tracing and generates the logs described in Table 2 on page 246. The default RAS1trace level is ERROR.

Before you beginSee “Overview of log file management” on page 246 to ensure that you understandlog rolling and can reference the correct log files when you manage log filegeneration.

After you finishMonitor the size of the logs directory. Default behavior can generate a total of 45 to60 MB for each agent that is running on a computer. For example, each databaseinstance that you monitor can generate 45 to 60 MB of log data. See the"Procedure" section to learn how to adjust file size and numbers of log files toprevent logging activity from occupying too much disk space.

Regularly prune log files other than the RAS1 log files in the logs directory. Unlikethe RAS1 log files that are pruned automatically, other log types can growindefinitely, for example, the logs in Table 2 on page 246 that include a process IDnumber (PID).

Consider using collector trace logs as an additional source of troubleshootinginformation.

Note: The KDC_DEBUG setting and the Maximum error tracing setting cangenerate a large amount of trace logging. Use them only temporarily, whileyou are troubleshooting problems. Otherwise, the logs can occupy excessiveamounts of hard disk space.

ProcedureOn Windows systems, you can use the graphical user interface to set trace options:1. Open the Manage Tivoli Enterprise Monitoring Services window.


2. Right-click the icon of the monitoring agent whose logging you want to modify.3. Select Advanced > Edit Trace Parms. The Tivoli Enterprise Monitoring Server

Trace Parameters window is displayed.4. Select a new trace setting in the pull-down menu in the Enter RAS1 Filters

field or type a valid string.The selections are as follows:v General error tracing. KBB_RAS1=ERRORv Intensive error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL)

v Maximum error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL)

Notes: As this example shows, you can set multiple RAS tracing options in asingle statement.

5. Modify the value for 'Maximum Log Size Per File (MB)" to change the log filesize (changes LIMIT value).

6. Modify the value for 'Maximum Number of Log Files Per Session" to changethe number of log files per startup of a program (changes COUNT value).

7. Modify the value for 'Maximum Number of Log Files Total" to change thenumber of log files for all startups of a program (changes MAXFILES value).

8. (Optional) Click Y (Yes) in the KDC_DEBUG Setting menu to log informationthat can help you diagnose communications and connectivity problemsbetween the monitoring agent and the monitoring server.

Note: The KDC_DEBUG setting and the Maximum error tracing setting cangenerate a large amount of trace logging. Use them only temporarily,while you are troubleshooting problems. Otherwise, the logs can occupyexcessive amounts of hard disk space.

9. Click OK. You see a message reporting a restart of the monitoring agent so thatyour changes take effect.

You can also manually edit the RAS1 trace logging parameters using this method:1. Open the trace options file:

Windows: install_dir\tmaitm6\KRHENVUNIX: install_dir/config/rh.ini

2. Edit the line that begins with KBB_RAS1= to set trace logging preferences. Forexample, if you want detailed trace logging, set the Maximum Tracingoption:KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL)

3. Edit the line that begins with KBB_RAS1_LOG= to manage the generation oflog files:v MAXFILES: the total number of files that are to be kept for all startups of a

given program. When this value is exceeded, the oldest log files arediscarded. Default value is 9.

v LIMIT: the maximum size, in megabytes (MB) of a RAS1 log file. Defaultvalue is 5.

Notes: The KBB_RAS1_LOG parameter also provides for the specification ofthe log file directory, log file name, and the inventory control filedirectory and name. Do not modify these values or log information canbe lost.

4. Restart the monitoring agent so that your changes take effect.


Problems and workaroundsThe following sections provide symptoms and workarounds for problems thatmight occur with the IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent:v “Installation and configuration troubleshooting” on page 251v “Remote deployment troubleshooting” on page 253v “Agent troubleshooting” on page 254v “Workspace troubleshooting” on page 255v “Situation troubleshooting” on page 257

Note: You can resolve some problems by ensuring that your system matches thesystem requirements listed in Chapter 2, “Requirements for the monitoringagent,” on page 5.

This chapter provides agent-specific troubleshooting information. See the IBMTivoli Monitoring Troubleshooting Guide for general troubleshooting information.

Installation and configuration troubleshootingThis section provides tables that show solutions for installation, configuration, anduninstallation problems.

Table 3. Problems and solutions for installation and configuration

Problem Solution

(UNIX only) During a command-line installation, youchoose to install a component that is already installed,and you see the following warning:

WARNING - you are about to installthe SAME version of "component_name"

where component_name is the name of the componentthat you are attempting to install.Note: This problem affects UNIX command-lineinstallations. If you monitor only Windowsenvironments, you see this problem if you choose toinstall a product component (for example, a monitoringserver) on UNIX.

You must exit and restart the installation process. Youcannot return to the list where you selected componentsto install. When you run the installer again, do notattempt to install any component that is already installed.

A problem can arise when you install and configure anew monitoring agent to a computer where other agentsare running as described in this example:

v Agents are running on computer and communicatingwith a Tivoli Enterprise Monitoring Server, calledTEMS1.

v You install a new agent on the same computer andyou want this agent to communicate with a differentmonitoring server, called TEMS2.

v When you configure the new agent to communicatewith TEMS2, all the existing agents are re-configuredto communicate with TEMS2.

You must reconfigure the previously existing agents torestore their communication connection with TEMS1. Forexample, you can right-click the row for a specific agentin the Manage Tivoli Enterprise Monitoring Services, andselect Reconfigure. See the IBM Tivoli MonitoringInstallation and Setup Guide for more information onreconfiguration.


Table 3. Problems and solutions for installation and configuration (continued)

Problem Solution

Diagnosing problems with product browse settings(Windows systems only).

When you have problems with browse settings, performthe following steps:

1. Click Start > Programs > IBM Tivoli Monitoring >Manage Tivoli Enterprise Monitoring Services. TheManage Tivoli Enterprise Monitoring Services windowis displayed.

2. Right-click the Windows agent and select BrowseSettings. A text window is displayed.

3. Click Save As and save the information in the text file.

A message similar to "Unable to find running CMS onCT_CMSLIST" in the log file is displayed.

If a message similar to "Unable to find running CMS onCT_CMSLIST" is displayed in the Log file, the agent isnot able to connect to the monitoring server. Confirm thefollowing points:

v Do multiple network interface cards (NICs) exist on thesystem?

v If multiple NICs exist on the system, find out whichone is configured for the monitoring server. Ensure thatyou specify the correct host name and port settings forcommunication in the IBM Tivoli Monitoringenvironment.

The system is experiencing high CPU usage. Agent process: View the memory usage of the KRHCMAprocess. If CPU usage seems to be excessive, recycle themonitoring agent.

Network Cards: The network card configurations candecrease the performance of a system. Each of the streamof packets that a network card receives (assuming it is abroadcast or destined for the under-performing system)must generate a CPU interrupt and transfer the datathrough the I/O bus. If the network card in question is abus-mastering card, work can be off-loaded and a datatransfer between memory and the network card cancontinue without using CPU processing power.Bus-mastering cards are generally 32-bit and are based onPCI or EISA bus architectures.


Table 4. General problems and solutions for uninstallation

Problem Solution

On Windows, uninstallation ofIBM Tivoli Monitoring fails touninstall the entire environment.

Be sure that you follow the general uninstallation process described in the IBMTivoli Monitoring Installation and Setup Guide:

1. Remove Tivoli Enterprise Monitoring Server Application support bycompleting the following steps:

a. Use Manage Tivoli Enterprise Monitoring Services.

b. Select Tivoli Enterprise Monitoring Server.

c. Right-click and select Advanced.

d. Select Remove TEMS application support.

e. Select the agent to remove its application support.

2. Uninstall monitoring agents first, as in the following examples:

v Uninstall a single monitoring agent for a specific database.

-OR-

v Uninstall all instances of a monitoring product, such as IBM TivoliMonitoring for Databases.

3. Uninstall IBM Tivoli Monitoring.

The way to remove inactivemanaged systems (systems whosestatus is OFFLINE) from theNavigator tree in the portal is notobvious.

Use the following steps to remove, but not uninstall, an offline managed systemfrom the Navigator tree:

1. Click the Enterprise icon in the Navigator tree.

2. Right-click, then click Workspace > Managed System Status.

3. Right-click the offline managed system, and select Clear offline entry.

If you also want to uninstall the monitoring agent, use the procedure describedin the IBM Tivoli Monitoring Installation and Setup Guide.

Remote deployment troubleshootingTable 5 lists problems that might occur with remote deployment. This sectionprovides information about troubleshooting remote deployment of the monitoringagent. See the IBM Tivoli Monitoring Troubleshooting Guide for generaltroubleshooting information.

This section describes problems and solutions for remote deployment and removalof agent software using Agent Remote Deploy.

Table 5. Remote deployment problems and solutions

Problem Solution

While you are using the remote deployment featureto install the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent, an empty commandwindow is displayed on the target computer. Thisproblem occurs when the target of remotedeployment is a Windows computer. (See the IBMTivoli Monitoring Installation and Setup Guide for moreinformation on the remote deployment feature.)

Do not close or modify this window. It is part of theinstallation process and is dismissed automatically.

The removal of a monitoring agent fails when youuse the remote removal process in the TivoliEnterprise Portal desktop or browser.

This problem might occur when you attempt the remoteremoval process immediately after you have restarted theTivoli Enterprise Monitoring Server. You must allow time forthe monitoring agent to refresh its connection with the TivoliEnterprise Monitoring Server before you begin the remoteremoval process.


Agent troubleshootingThis section lists problems that might occur with agents.

This chapter provides agent-specific troubleshooting information. See the IBMTivoli Monitoring Troubleshooting Guide for general troubleshooting information.

Table 6. Agent problems and solutions

Problem Solution

Log data accumulates toorapidly.

Check the RAS trace option settings, which are described in “Setting RAS traceparameters” on page 249. The trace options settings that you can set on theKBB_RAS1= and KDC_DEBUG= lines potentially generate large amounts of data.

When using the F1 key orselecting Help --> Contents andIndex, you receive a message inyour Microsoft Internet Explorerbrowser which states, "It seemsjavascript is disabled in yourbrowser, please enable it andreload again, or click here toview without javascript." If youselect 'here', the Tivoli EnterprisePortal V6.1 Help is displayed,but the agent help is not.

Ensure that the local site is added to the trusted site for the browser, and thenenable the javascript.

If you want to receive multipletrace logs for separateinvocations of the same TakeAction command, leaving thissetting on permanently fills theavailable disk space.

Do not leave this setting on permanently. By doing so, you create a new log filefor each invocation of the Take Action command and ALL of them are left on theagent system.


Table 6. Agent problems and solutions (continued)

Problem Solution

A configured and runninginstance of the monitoring agentis not displayed in the TivoliEnterprise Portal, but otherinstances of the monitoring agenton the same system do appear inthe portal.

Tivoli Monitoring products use Remote Procedure Call (RPC) to define andcontrol product behavior. RPC is the mechanism that allows a client process tomake a subroutine call (such as GetTimeOfDay or ShutdownServer) to a serverprocess somewhere in the network. Tivoli processes can be configured to useTCP/UDP, TCP/IP, SNA, and SSL as the desired protocol (or deliverymechanism) for RPCs.

"IP.PIPE" is the name given to Tivoli TCP/IP protocol for RPCs. The RPCs aresocket-based operations that use TCP/IP ports to form socket addresses. IP.PIPEimplements virtual sockets and multiplexes all virtual socket traffic across asingle physical TCP/IP port (visible from the netstat command).

A Tivoli process derives the physical port for IP.PIPE communications based onthe configured, well-known port for the HUB Tivoli Enterprise MonitoringServer. (This well-known port or BASE_PORT is configured using the 'PORT:'keyword on the KDC_FAMILIES / KDE_TRANSPORT environment variable anddefaults to '1918'.)

The physical port allocation method is defined as (BASE_PORT + 4096*N) whereN=0 for a Tivoli Enterprise Monitoring Server process and N={1, 2, ..., 15} for anon-Tivoli Enterprise Monitoring Server. Two architectural limits result as aconsequence of the physical port allocation method:

v No more than one Tivoli Enterprise Monitoring Server reporting to a specificTivoli Enterprise Monitoring Server HUB can be active on a system image.

v No more than 15 IP.PIPE processes can be active on a single system image.

A single system image can support any number of Tivoli Enterprise MonitoringServer processes (address spaces) provided that each Tivoli EnterpriseMonitoring Server on that image reports to a different HUB. By definition, thereis one Tivoli Enterprise Monitoring Server HUB per monitoring Enterprise, sothis architecture limit has been simplified to one Tivoli Enterprise MonitoringServer per system image.

No more that 15 IP.PIPE processes or address spaces can be active on a singlesystem image. With the first limit expressed above, this second limitation refersspecifically to Tivoli Enterprise Monitoring Agent processes: no more that 15agents per system image.

This limitation can be circumvented (at current maintenance levels, IBM® TivoliMonitoring V6.1 Fix Pack 4 and later) if the Tivoli Enterprise Monitoring Agentprocess is configured to use EPHEMERAL IP.PIPE. (This is IP.PIPE configuredwith the 'EPHEMERAL:Y' keyword in the KDC_FAMILIES / KDE_TRANSPORTenvironment variable). There is no limitation to the number of ephemeral IP.PIPEconnections per system image. If ephemeral endpoints are used, the WarehouseProxy Agent is accessible from the Tivoli Enterprise Monitoring Server associatedwith the agents using ephemeral connections either by running the WarehouseProxy Agent on the same computer or by using the Firewall Gateway feature.(The Firewall Gateway feature relays the Warehouse Proxy Agent connectionfrom the Tivoli Enterprise Monitoring Server computer to the Warehouse ProxyAgent computer if the Warehouse Proxy Agent cannot coexist on the samecomputer.)

Workspace troubleshootingTable 7 on page 256 shows problems that might occur with workspaces. Thischapter provides agent-specific troubleshooting information. See the IBM TivoliMonitoring Troubleshooting Guide for general troubleshooting information.


Table 7. Workspace problems and solutions

Problem Solution

The process application components areavailable, but the Availability status showsPROCESS_DATA_NOT_ AVAILABLE.

This problem occurs because the PerfProc performance object isdisabled. When this condition exists, IBM Tivoli Monitoringcannot collect performance data for this process. Do thefollowing to confirm that this problem exists and resolve it:

1. Choose Run in the Windows Start menu.

2. Type perfmon.exe in the Open field of the Run window. ThePerformance window is displayed.

3. Click the plus sign (+) in the tool bar located above the rightpane. The Add Counters window is displayed.

4. Look for Process in the Performance object pull-down menu.

5. Perform one of the following actions:

v If you see Process in the pull-down menu, the PerfProcperformance object is enabled and the problem is comingfrom a different source.

v If you do not see Process in the pull-down menu, use theMicrosoft utility from the following Web site to enable thePerfProc performance object:

http://www.microsoft.com/windows2000/techinfo/reskit/tools/existing/exctrlst-o.asp

The Process performance object becomes visible in thePerformance object pull-down menu of the Add Counterswindows, and IBM Tivoli Monitoring is able to detectAvailability data.

6. Restart the monitoring agent.

The name of the attribute does not display in abar chart or graph view.

When a chart or graph view that includes the attribute is scaledto a small size, a blank space is displayed instead of a truncatedname. To see the name of the attribute, expand the view of thechart until there is sufficient space to display all characters of theattribute name.

You start collection of historical data but the datacannot be seen.

Managing options for historical data collection:

v Basic historical data collection populates the Warehouse withraw data. This type of data collection is turned off by default.See the IBM Tivoli Monitoring Administrator's Guide forinformation on managing this feature including how to set theinterval at which data is collected. By setting a more frequentinterval for data collection you reduce the load on the systemincurred every time data is uploaded.

v You use the Summarization and Pruning monitoring agent tocollect specific amounts and types of historical data. Be awarethat historical data is not displayed until the Summarizationand Pruning monitoring agent begins collecting the data. Bydefault, this agent begins collection at 2 AM daily. At thatpoint, data is visible in the workspace view. See the IBM TivoliMonitoring Administrator's Guide to learn how to modify thedefault collection settings.


Table 7. Workspace problems and solutions (continued)

Problem Solution

Historical data collection is unavailable becauseof incorrect queries in the Tivoli EnterprisePortal.

The column, Sort By, Group By, and First/Last functions are notcompatible with the historical data collection feature. Use ofthese advanced functions makes a query ineligible for historicaldata collection.

Even if data collection has been started, you cannot use the timespan feature if the query for the chart or table includes columnfunctions or advanced query options (Sort By, Group By, First /Last).

To ensure support of historical data collection, do not use theSort By, Group By, or First/Last functions in your queries.

See the IBM Tivoli Monitoring Administrator's Guide or the TivoliEnterprise Portal online help for information about the HistoricalData Collection function.

When you use a long process name in thesituation, the process name is truncated.

Truncation of process or service names for situations in theAvailability table in the portal display is the expected behavior.100 bytes is the maximum name length.

Regular (non-historical) monitoring data fails tobe displayed.

Check the formation of the queries you use to gather data. Forexample, look for invalid SQL statements.

Navigator items and workspace titles are labeledwith internal names such as Kr6:KR60000 orKnt:KNT0000 rather than the correct names (suchas Disk).

Ensure application support has been added on the monitoringserver, portal server, and portal client.

For more information and instruction on installing applicationsupport see "Installing and enabling application support" in theIBM Tivoli Monitoring Installation and Setup Guide.

Situation troubleshootingThis section provides information about both general situation problems andproblems with the configuration of situations. See the IBM Tivoli MonitoringTroubleshooting Guide for more information about troubleshooting for situations.

General situation problemsTable 8 lists general problems that might occur with situations.

Table 8. General situation problems and solutions

Problem Solution

Monitoring activity requires too muchdisk space.

Check the RAS trace logging settings that are described in “Setting RAStrace parameters” on page 249. For example, trace logs grow rapidlywhen you apply the ALL logging option.

Monitoring activity requires too manysystem resources.

“Disk capacity planning for historical data” on page 200 describes theperformance impact of specific attribute groups. If possible, decrease youruse of the attribute groups that require greater system resources.

A formula that uses mathematicaloperators appears to be incorrect. Forexample, if you were monitoring Linux,a formula that calculates when FreeMemory falls under 10 percent of TotalMemory does not work: LT#'Linux_VM_Stats.Total_Memory' / 10

This formula is incorrect because situation predicates support only logicaloperators. Your formulas cannot have mathematical operators.Note: The Situation Editor provides alternatives to math operators.Regarding the example, you can select % Memory Free attribute andavoid the need for math operators.


Table 8. General situation problems and solutions (continued)

Problem Solution

You want to change the appearance ofsituations when they are displayed inthe Navigation tree.

1. Right-click an item in the Navigation tree.

2. Select Situations in the pop-up menu. The Situation Editor window isdisplayed.

3. Select the situation that you want to modify.

4. Use the State pull-down menu in the lower right of the window to setthe status and appearance of the Situation when it triggers.Note: The State setting is not related to severity settings in IBM TivoliEnterprise Console.

When a situation is triggered in theEvent Log attribute group, it remains inthe Situation Event Console as long asthe event ID entry is present in theEvent Log workspace. When this eventID entry is removed from the Event Logworkspace on the Tivoli EnterprisePortal, the situation is also cleared evenif the actual problem that caused theevent is not resolved, and the event IDentry is also present in the WindowsEvent Viewer.

There is a timeout on the cache of events for the NT Event Log group.Increase the cache time of Event Log collection to meet your requirementsby adding the following variable and timeout value to the KXXENV filefor the agent: CDP_NT_EVENT_LOG_CACHE_TIMEOUT=3600

This variable determines how long events from the NT Event Log arekept.

Problems with configuration of situationsTable 9 lists problems that might occur with configuring situations.

This section provides information for troubleshooting for agents. Be sure to consultthe IBM Tivoli Monitoring Troubleshooting Guide for more general troubleshootinginformation.

Table 9. Problems with configuring situations that you solve in the Situation Editor

Problem Solution

Note: To get started with the solutions in this section, perform these steps:1. Launch the Tivoli Enterprise Portal.2. Click Edit > Situation Editor.3. In the tree view, choose the agent whose situation you want to modify.4. Choose the situation in the list. The Situation Editor view is displayed.

The situation for a specific agent isnot visible in the Tivoli EnterprisePortal.

Open the Situation Editor. Access the All managed servers view. If the situationis absent, confirm that the monitoring server has been seeded for the agent. Ifnot, seed the server, as described in the IBM Tivoli Monitoring Installation andSetup Guide.

The monitoring interval is toolong.

Access the Situation Editor view for the situation that you want to modify.Check the Sampling interval area in the Formula tab. Adjust the time intervalas needed.

The situation did not activate atstartup.

Manually recycle the situation as follows:

1. Right-click the situation and choose Stop Situation.

2. Right-click the situation and choose Start Situation.

Note: You can permanently avoid this problem by placing a check mark in theRun at Startup option of the Situation Editor view for a specific situation.

The situation is not displayed. Click the Action tab and check whether the situation has an automatedcorrective action. This action can occur directly or through a policy. Thesituation might be resolving so quickly that you do not see the event or theupdate in the graphical user interface.


Table 9. Problems with configuring situations that you solve in the Situation Editor (continued)

Problem Solution

An Alert event has not occurredeven though the predicate has beenproperly specified.

Check the logs, reports, and workspaces.

A situation fires on an unexpectedmanaged object.

Confirm that you have distributed and started the situation on the correctmanaged system.

The product did not distribute thesituation to a managed system.

Click the Distribution tab and check the distribution settings for the situation.

The situation does not fire. This problem can be caused when incorrect predicates are present in theformula that defines the situation. For example, the managed object shows astate that normally triggers a monitoring event, but the situation is not truebecause the wrong attribute is specified in the formula.

In the Formula tab, analyze predicates as follows:

1. Click the fx icon in the upper-right corner of the Formula area. The Showformula window is displayed.

a. Confirm the following details in the Formula area at the top of thewindow:v The attributes that you intend to monitor are specified in the formula.v The situations that you intend to monitor are specified in the formula.v The logical operators in the formula match your monitoring goal.v The numerical values in the formula match your monitoring goal.

b. (Optional) Click the Show detailed formula check box in the lower leftof the window to see the original names of attributes in the applicationor operating system that you are monitoring.

c. Click OK to dismiss the Show formula window.

2. (Optional) In the Formula area of the Formula tab, temporarily assignnumerical values that immediately trigger a monitoring event. Thetriggering of the event confirms that other predicates in the formula arevalid.Note: After you complete this test, you must restore the numerical valuesto valid levels so that you do not generate excessive monitoring data basedon your temporary settings.

See the IBM Tivoli Monitoring Troubleshooting Guide for additional informationabout situations that do not fire.

Table 10. Problems with configuration of situations that you solve in the Workspace area

Problem Solution

Situation events are not displayedin the Events Console view of theworkspace.

Associate the situation with a workspace.Note: The situation does not need to be displayed in the workspace. It issufficient that the situation be associated with any workspace.

You do not have access to asituation.

Note: You must have administrator privileges to perform these steps.

1. Select Edit > Administer Users to access the Administer Users window.

2. In the Users area, select the user whose privileges you want to modify.

3. In the Permissions tab, Applications tab, and Navigator Views tab, selectthe permissions or privileges that correspond to the user role.

4. Click OK.


Table 10. Problems with configuration of situations that you solve in the Workspace area (continued)

Problem Solution

A managed system seems to beoffline.

1. Select Physical View and highlight the Enterprise Level of the navigatortree.

2. Select View > Workspace > Managed System Status to see a list ofmanaged systems and their status.

3. If a system is offline, check network connectivity and the status of thespecific system or application.

Take Action commands troubleshootingTable 11 lists general problems that might occur with Take Action commands.When each Take Action command runs it generates the log file listed in Table 2 onpage 246. This chapter provides agent-specific troubleshooting information.

See the IBM Tivoli Monitoring Troubleshooting Guide for general troubleshootinginformation.

Table 11. Take Action commands problems and solutions

Problem Solution

Take Action commands often require severalminutes to complete.

Allow several minutes. If you do not see a pop-up messageadvising you of completion, try to run the command manually.

Situations fail to trigger Take Action commands. Attempt to manually run the Take Action command in the TivoliEnterprise Portal. If the Take Action command works, look forconfiguration problems in the situation. See “Situationtroubleshooting” on page 257. If the Take Action command fails,see IBM Tivoli Monitoring Troubleshooting Guide for generalinformation on troubleshooting Take Action commands.

Tivoli Common Reporting troubleshootingTable 12 contains a list of problems that might occur with the Tivoli CommonReporting predefined reports for IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent.

For information about troubleshooting for the Tivoli Common Reporting tool, seehttp://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.tivoli.tcr.doc/tcr_welcome.html.

Table 12. Tivoli Common Reporting for IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent problemsand solutions

Problem Solution

Support informationIf you have a problem with your IBM software, you want to resolve it quickly. IBMprovides the following ways for you to obtain the support you need:

OnlineGo to the IBM Software Support site at http://www.ibm.com/software/support/probsub.html and follow the instructions.


http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.tivoli.tcr.doc/tcr_welcome.html

http://publib.boulder.ibm.com/infocenter/tivihelp/v3r1/topic/com.ibm.tivoli.tcr.doc/tcr_welcome.html

http://www.ibm.com/software/support/probsub.html


IBM Support AssistantThe IBM Support Assistant (ISA) is a free local software serviceabilityworkbench that helps you resolve questions and problems with IBMsoftware products. The ISA provides quick access to support-relatedinformation and serviceability tools for problem determination. To installthe ISA software, go to http://www.ibm.com/software/support/isa.

Informational, warning, and error messagesThis chapter introduces message logging and explains how to gather informationfrom those logs.

Message logging refers to the text and numeric messages created by the software.These messages relay information about how the system or application isperforming and can alert you to exceptional conditions when they occur. Messagesare sent to an output destination, such as a file, database, or console screen.

If you receive a warning or error message, you can do one of the following:v Follow the instructions listed in the Detail window of the message if this

information is included there.v Consult the message details listed in this chapter to see what action you can take

to correct the problem.v Consult the message log for message ID and text, time and date of the message,

as well as other data you can use to diagnose the problem.

Message formatIBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent messages havethe following format:

Message ID and textExplanationOperator Response

The message ID has the following format:CCC####severity

where:

CCC Prefix that indicates the component to which the message applies. Thecomponent is one of the following:

KRH General IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent messages.

KRS Messages from the TEDA server.

#### Number of the message

severitySeverity of the message. There are three levels of severity:

I Informational messages provide feedback about something thathappened in the product or system that might be important. Thesemessages can provide guidance when you are requesting a specificaction from the product.


http://www.ibm.com/software/support/isa

W Warning messages call your attention to an exception condition.The condition might not be an error but can cause problems if notresolved.

E Error messages indicate that an action cannot be completedbecause of a user or system error. These messages require userresponse.

The Text of the message provides a general statement regarding the problem orcondition that occurred. The Explanation provides additional information about themessage and what might have caused the condition. The Operator Responseprovides actions to take in response to the condition, particularly for errormessages (messages with the "E" suffix).

Note: Many message texts and explanations contain variables, such as the specificname of a server or application. Those variables are represented in thischapter as symbols, such as "&1." Actual messages contain values for thesevariables.

This chapter includes the messages for the following software:v IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent

IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent messages

KRH0000 Take Action was successfully issued.

Explanation: The Take Action was successfully issued, check the Advanced Reporting Event Data Workspace for theresult.

Operator response: Check the Advanced Report Event Data Workspace for the result.

KRH0004 User ID Translation failed.

Explanation: An invalid User ID was used for the Take Action

Operator response: Check to make sure the user ID being used has sufficient authority for the Take Action to beused. For more specific information check the TEDA log.

KRH0008 Bad Parameter List.

Explanation: Parameter list is invalid.

Operator response: Check to make sure the parameters used are valid. For more specific reason check the TEDAlog.

KRH0012 Bad KRS Environment.

Explanation: The invalid KRS environment was encountered.

Operator response: Check to make sure the KRS environment is up and running. For more specific reason check theTEDA log.

IBM Tivoli Common Data Collection Agent (TEDA) messages

KRH0000 • KRH0012


KRS0001E id Required LE module module not loaded

Explanation: The indicated load module module is required by the Language Environment interface cannot be foundor loaded.

Operator response: Validate that the indicated load module can be found in either the JOBLIB/STEPLIB data sets orthe z/OS system linklist. A server restart will be required to resolve the problem.

KRS0002E id LE Environment initialization failed RC=rc

Explanation: An attempt to initialize Language Environment for this task has failed with the indicated return coderc. The return code is issued from the init_sub_dp function call to CEEPIPI.

Operator response: Please refer to the z/OS Language Environment Programming Guide for an explanation of thereturn codes and possible corrective actions. A server restart will be required to resolve the problem.

KRS0003E id LE Environment termination failed RC=rc

Explanation: An attempt to initialize Language Environment for this task has failed with the indicated return coderc. The return code is issued from the term function call to CEEPIPI.

Operator response: Please refer to the z/OS Language Environment Programming Guide for an explanation of thereturn codes and possible corrective actions.

KRS0004E id CEEPIPI add of module failed RC=rc

Explanation: An attempt to add the indicated load module module to the Language Environment function table hasfailed with the indicated return code rc. The return code is issued from the add_entry function call to CEEPIPI.


KRS0005E id CEEPIPI function module missing

Explanation: The required Language Environment function load module module could not be found.

Operator response: There should be an AGENT statement of type "PIPI" for the indicated load module module in theKppPRDxx member that is being used by the TEDA server. A server restart will be required to resolve the problem.

KRS0006E id CEEPIPI call of module failed RC=rc

Explanation: An attempt to call the indicated load module module to the Language Environment function table hasfailed with the indicated return code rc. The return code is issued from the call_sub function call to CEEPIPI.


KRS0007I id Agent agent using port portnum

Explanation: The indicated TEP agent agent is using the indicated port number portnum. The value of the portnumber is taken from the PORT keyword on the PRODUCT statement in the KppPRDxx member.

Operator response: No action is required.

KRS0008I id Agent agent connected to TEMA

Explanation: The indicated TEP agent agent has successfully connected to the TEMA address space.



KRS0009I id Agent agent disconnected from TEMA

Explanation: The indicated TEP agent agent has successfully disconnected from the TEMA address space.


KRS0010E id Agent agent service function failed RC=rc

Explanation: The indicated agent agent encountered a non-zero return code rc when calling the indicated CPCIfunction function.

Operator response: Refer to the following list of return codes

v CP_PORT_NOT_SET

v CP_SOCKET_OPEN_FAILED

v CP_STATE_ERROR

v CP_WRITE_ERROR

v CP_PARSING_ERROR

v CP_ATTRIBUTE_GROUP_NOT_REGISTERED

v CP_HANDLE_NOT_FOUND

v CP_ID_NOT_FOUND

v CP_MALLOC_FAILED

For CP_SOCKET_OPEN_FAILED, check that the TEMA address space is active and accepting connections from the"Kpp" product. When this condition is received, the TEDA address space retries every 30 seconds. For all other returncodes, please contact IBM Support.

KRS0011E id Attribute group register not found

Explanation: The internal attribute group register was not found. All attribute groups will not be registered withTEP.

Operator response: Ensure that the KppTEP00 agent statement is present in the KppPRDxx member. A server restartwill be required to resolve the problem.

KRS0012E id Attribute group register is full

Explanation: There is no more room in the internal attribute group register. All subsequent attribute groups will notbe registered with TEP.

Operator response: Contact IBM Support.

KRS0013E id Attribute group module module not found

Explanation: One or more attribute groups require the indicated load module module and it could not be found orloaded.

Operator response: Verify that the indicated load module can be found in either the JOBLIB or STEPLIB data sets orthe z/OS system linklist. A server restart will be required to resolve the problem.

KRS0014I id:product Attribute group group assigned handle handle

Explanation: The indicated attribute group group has been assigned the indicated handle handle for the indicatedproduct.

Note: This message is only shown for MsgLevel(1) and above.



KRS0015I id:product Attribute group group inactivated

Explanation: The indicated attribute group group has been inactivated and no further requests will be handled. Thismessage is normally issued during server termination.


KRS0016E id:product Attribute group group already registered

Explanation: An attempt to register the indicated attribute group group has been made when there is already one ofthe same name registered. The register request will be refused.


KRS0017I id:product Attribute group group registered with TEMA

Explanation: An attempt to register the indicated attribute group group has been made successfully. Data can nowflow between TEP and the TEDA server for this attribute group.


KRH0018I id Attribute group registration complete for agent

Explanation: The indicated agent agent has completed its registration phase.


KRS0019I id text

Explanation: This message is issued in response to a Take Action TEP request. The text of text varies depending onthe context of the action.

Operator response: It is intended that this message is processed by your automated operations software.

KRS0020W id Agent agent has no associated attribute groups

Explanation: The indicated agent agent has completed its registration phase and has not registered any attributegroups. This happens when all of the attribute groups are asynchronous in nature (pure event table) but theKppSYNC agent is defined so that it can respond to the TEP shutdown requests.


KRS0021W id TaskRequest received but no handler defined for product

Explanation: A take action request from TEP has been received for this product but there are no take actionhandlers defined for this product.


KRS0022E id Required product product missing

Explanation: The indicated product has not been declared in the TEDA KppPRDxx PARMLIB member.

Operator response: Ensure that the KppPRDxx PARMLIB member is present and has been specified in theKRSSYSxx member.

KRS0023E id TaskRequest product text

Explanation: The indicated product has received a task request with the indicated action text.

Operator response: This is an informational message issued when the MsgLevel setting is greater than zero.


KRS0030W TEDA Kpp not found - Retrying every 60 seconds

Explanation: The KRSSIGNL utility program could not find the TEDA server specified on the runtime parameter. Itwill retry in 60 seconds.

Operator response: Start the indicated TEDA server.

KRS0031E TEDA Kpp not found and maximum retry attempts exceeded

Explanation: The KRSSIGNL utility program could not find the TEDA server specified on the runtime parameterand the maximum number of retry attempts has been exceeded. The KRSSIGNL program will terminate with areturn code of 8.

Operator response: Start the indicated TEDA server.

KRS0032W TEDA Kpp not found - Retry or Cancel (R/C)

Explanation: The KRSSIGNL utility program could not find the TEDA server specified on the runtime parameterand RETRY(WTOR) was either specified or defaulted to.

Operator response: Start the TEDA server indicated. Specify R to retry or C to cancel the wait for the TEDA server.

KRS0033W TEDA Kpp not found and retry cancelled by operator

Explanation: The KRSSIGNL utility program could not find the TEDA server specified on the runtime parameterand RETRY(WTOR) was either specified or defaulted to. The operator then replied C to Kpp0032W.


KRS0034I Signal service failed RC=rc RSN=rsn

Explanation: The KRSSIGNL utility program failed with the indicated return code rc and reason code rsn.

Operator response: Examine any previous messages issued by the KppSIGNL utility.

KRS0035W Signal signal not found for teda

Explanation: The KRSSIGNL utility program could not find the indicated signal signal the TEDA teda.

Operator response: Check that the signal name is correct and has been defined as a resource for the TEDA server.

KRS0036I Signal signal updated for teda

Explanation: The KRSSIGNL utility program found the indicated signal signal for the TEDA teda and its value hasbeen updated.


KRS0040I {id} datatype refreshed successfully - nnn records

Explanation: The data collection routine for datatype has refreshed its cache of data, nnn records were collected.


KRS0041I {id} interface established to jobname (product)

Explanation: The TEDA has established an interface to the base product API jobname jobname product name product.



KRS0042I {id} SMF Record number for product is number.

Explanation: The SMF Record number used by this product for reporting is number.


KRS0050I {id} Device Monitor has detected SMS system number number.

Explanation: An SMS System numbernumber has been detected.


KRS0051E {id} Device Monitor SMS BCD locate error code RC+code.

Explanation: An error codecode has been returned while trying to detect an SMS BCD.

Operator response: Find out why the Device Monitor SMS BCDS data set is missing and recreate or restore it ifnecessary.

KRS0053I id agent initializing

Explanation: The indicated agent agent is initializing.


KRS0054I id agent initialization complete

Explanation: The indicated agent agent has completed its initialization phase.


KRS0055W id agent invalid runtime keyword keyword ignored

Explanation: The indicated agent agent has encountered an invalid runtime keyword keyword. The keyword will beignored.

Operator response: Correct the specification of the runtime keyword or contact IBM Support. A server restart willbe required to resolve the problem.

KRS0056I id agent terminating

Explanation: The indicated agent agent is terminating.


KRSH0057I id agent termination complete

Explanation: The indicated agent agent has completed its termination phase.


KRS0059I id Current user ASID id Jobname Jobname

Explanation: During shutdown, the TEDA server has detected that some address spaces that still have outstandingactive connections. Each address space is listed by the KRS0059I message. The TEDA server will retry shutdown in 30seconds.



KRS0060I id There are no current users

Explanation: During shutdown, the TEDA server has detected that there are no current connections—terminationcan now proceed.


KRS0062E id Operating system level not supported

Explanation: The TEDA server has detected a level of z/OS that is not supported. The server will terminate.

Operator response: Check the installation instructions for the software prerequisites.

KRS0063E id Architecture level not supported

Explanation: The TEDA server has detected a level of hardware that is not supported. The server will terminate.

Operator response: Check the installation instructions for the hardware prerequisites.

KRS0064W id Shutdown prevented by active users : Retry/Ignore (R, I)

Explanation: The TEDA server shutdown is prevented because there are still active sessions with other addressspaces. The TEDA server will automatically retry every 30 seconds if the operator does not reply to this message.

Operator response: Reply R to retry or I to ignore. Replying I should be used with extreme caution and only in anemergency situation or when the z/OS system is being shutdown in preparation for an IPL. If you specify I, theTEDA server termination will remove critical resources from the system without attempting normal serialization andit will not free the common storage control blocks — leaving approximately 240K of orphaned E-CSA. The TEDAserver will also not be able to restart until the address spaces that were in session have completely disconnected.Therefore, it is strongly recommended that you reply R or wait for the TEDA server to retry every 30 seconds.

KRS0074I id TEDA initialization complete

Explanation: The TEDA server has successfully completed its initialization phase.


KRS0075I id Waiting for active connections to terminate

Explanation: The TEDA server is terminating but cannot continue until all active connections are terminated. Ifactive connections are present, message KRS0064W will be issued.


KRSH0078I id TEDA shutdown proceeding

Explanation: The TEDA server is shutting down and is about to pass control to its termination routines.


KRS0080I id TEDA removing services

Explanation: All active connections are terminated. The TEDA server is now removing internal services.


KRS0082I id Dataspace dataspace created successfully

Explanation: The indicated dataspace dataspace has been successfully created.




KRS0083I id Dataspace dataspace removed

Explanation: The indicated dataspace dataspace has been successfully removed.



KRS0084E {id} Unknown operation.

Explanation: An unknown or invalid MODIFY command was received.

Operator response: Correct the command and retry.

KRS0087E {id} Server server already started.

Explanation: A request to start a server was received but a server of that name was already running.

Operator response: If required, correct the server name and retry.

KRS0085E id Required keywords not specified

Explanation: Required keywords on the TEDA server modify command were not specified.

Operator response: Check the TEDA server modify command syntax and re-specify the required keywords.

KRS0086E id Unknown server server specified

Explanation: An agent specified a server server that is not valid.

Operator response: Correct the agent statement and restart the server.

KRS0088I id Command accepted: command

Explanation: The TEDA server operator command has been accepted.


KRS0089E id Invalid command command

Explanation: The TEDA server operator command command is not valid.

Operator response: Check the TEDA server modify command syntax and re-issue the command.

KRS0090I id TEDA starting

Explanation: The TEDA server is starting.


KRS0091I {id} TCP/IP Server using port port.

Explanation: An unknown or invalid MODIFY command was received.

Operator response: Correct the command and retry.

KRS0092I id Server server control task terminated

Explanation: The indicated server server control task has terminated.



KRS0093E id Server server already stopped

Explanation: An attempt was made to stop a server that was already stopped. The request was ignored.

Operator response: No action is required

KRS0095I {id} TCP/IP Server host address address.

Explanation: The IP Address address is being used by this host for communications.


KRS0096W {id} TCP/IP SERVER|CLIENT RC=code ERRNO=hcode (decode:text)

Explanation: A TCP/IP Error occurred in the Server or the Client, hcode, decode and text give additional informationabout the error.

Operator response: Take steps to correct the TCP/IP error dependent upon the particular error codes and textmessage displayed in the message.

KRS0097I id Agent agent in server server quiesced

Explanation: The indicated agent named agent in server server is now quiesced. This message is issued for allmatching agents when the TEDA server quiesce command has been issued. If the agent code supports the quiescecommand, it will cease activity until its is resumed.


KRS0098I id Agent agent in server server already quiesced - no action taken

Explanation: The indicated agent named agent in server server was already quiesced when a new attempt to quiesceit was received. No action was taken.


KRS0099I id No matches for Agent agent in server server

Explanation: There was no matches for the agent mask agent for the indicated server server.

Operator response: Re-specify the AGENT() keyword on the TEDA server operator modify command.

KRS0100I id No action taken for agent agent in server server

Explanation: There was no actions taken against any agent agent in the indicated server server. This is usuallycaused by the agents already being in the desired state when the quiesce or resume commands were issued.

Operator response: Verify that the correct modify command was issued to the TEDA server.

KRS0102I id Agent task name agent heartbeat

Explanation: Trace message written by the indicated agent agent when the MsgLevel is greater than 0.


KRS0103E id Common Dataspace dataspace ALESERV failed RC=rc

Explanation: During initialization the TEDA server could not perform the ALESERV ADD for the TEDA commondataspace. All SMF record intercept functions will be disabled.



KRS0104E id Required type name missing

Explanation: The required object of type type named name could not be found.

Operator response: Ensure that the associated statement is present in the KppPRDxx PARMLIB member. A serverrestart will be required to resolve the problem.

KRS0105E id Required keyword type missing for command

Explanation: The required keyword of type type is missing for the operator modify command command.

Operator response: Verify the syntax of the modify command and re-issue the command.

KRS0107I id agent msgtext

Explanation: Trace message written by the indicated agent agent when the MsgLevel is greater than 0.


KRS0109I id Agent task name agent terminated RC=rc

Explanation: The indicated agent agent has terminated with the specified return code rc.

Operator response: If the return code is non-zero and unexpected please contact IBM Support.

KRS0110I {id} TCP/IP Server waiting for in-use port {1}.

Explanation: The server is trying to bind to port port, which is already in use.

Operator response: None, the Server will retry the connection again..

KRS0112W {id} TCP/IP Server connection to host failed RC=code ERRNO=hcode (decode:text)

Explanation: An error occurred trying to connect to hostname host, code, hcode, decode and text give additionalinformation about the error.

Operator response: Take steps to correct the TCP/IP error dependent on the particular error codes and text messagedisplayed in the message.

KRS0113I {id} TCP/IP Server host name host

Explanation: The host name host is being used by this host for communications.

Operator response: None is required.

KRS0114I {id} Agent agent established connection to host using protocol.

Explanation: The Agent agent has successfully connected to host host using the protocol protocol.

Operator response: None is required.

KRS0115I id Agent agent : Quiesced(Y/N) Address (address)

Explanation: Issued as the response from the D AGENT(mask) modify command, this message shows the quiescedstate and the address address in common storage of the agent block for the indicated agent agent.


KRS0118I id Agent agent in server server resumed

Explanation: The indicated agent agent in server server has been resumed and will restart its work.



KRS0119I id Agent agent in server server already active - no action taken

Explanation: The indicated agent agent in server server is already active and an attempt was made to resume it. Therequest is ignored.

Operator response: Ensure that the R AGENT(mask) command was issued correctly.

KRS0121I {id} TCP/IP Server waiting for host TCP/IP initialization RSN=code.

Explanation: The serveris trying to connect to a host which has not completed TCP/IP initialization, code gives moreinformation.

Operator response: None is required, the Server will retry the connection.

KRS0126I id IBM Tivoli/product TEDA version

Explanation: The version version or the IBM Tivoli product product shown at TEDA server startup.


KRS0127I id Agent task name agent initialization complete

Explanation: The indicated agent agent has completed its initialization phase.


KRS0134E id Unknown keyword keyword

Explanation: An unknown keyword was discovered in the TEDA KppPRDxx PARMLIB member or as part of the TAGENT(mask) operator command.

Operator response: Re-specify the keyword and restart the server or re-issue the operator command.

KRS0135E id Error in statement : statement

Explanation: During the process of reading the KppPRDxx PARMLIB member, the TEDA server encountered one ormore errors in the statement shown statement.

Operator response: Examine earlier messages that explain the errors discovered.

KRS0139I {id} (cont) :text

Explanation: This message is a continuation of a previously issued message.

Operator response: Refer to the previously issued message.

KRS0143E id One or more parameters missing from the type statement

Explanation: During the process of reading the KppPRDxx PARMLIB member, the TEDA server encountered one ormore missing parameters for the indicated statement type type.

Operator response: Correct the statement in error and restart the TEDA server.

KRS0144E id Dataspace dataspace DSPSERV failed RC=rc RSN=rsn

Explanation: During the creation of the indicated dataspace dataspace, the DSPSERV service failed with return coderc and reason code rsn.



KRS0145E id ALESERV failed RC=rc

Explanation: During an attempt to add a dataspace ALET to the access list, the ALESERV service failed with returncode rc.


KRS0147I id Agent task name agent initializing

Explanation: The indicated agent agent is beginning its initialization phase.


KRS0151E id Required keyword keyword missing from type for agent

Explanation: During the process of reading the KppPRDxx PARMLIB member, the required keyword keyword wasmissing from the statement type type for the indicated agent agent.

Operator response: Correct the statement in error and restart the TEDA server.

KRS0152I id Module module loaded successfully at address address

Explanation: The indicated load module module has been loaded at address address.



KRS0153E id Agent task name agent storage obtain failed

Explanation: The indicated agent agent could not obtain the required storage to perform its actions. Processing issuspended and retried during the next sampling interval.

Operator response: Increase the REGION size allocated to the TEDA server.

KRS0157W id Agent task name agent disabled - maximum restart count exceeded

Explanation: The indicated agent agent has terminated unexpectedly too many times and has exceeded its Restart()value. The agent will not be restarted.

Operator response: Examine the cause of the unexpected termination and contact IBM Support.

KRS0161E id Fatal error error in module module

Explanation: There has been a non-recoverable error error in server module module. The TEDA server will terminate.

Operator response: Contact IBM support.

KRS0162I id Agent agent in server TEDA updated with new value

Explanation: The indicated agent agent has been updated with a new value using the SET modify operatorcommand.


KRS0164E id Agent task name agent data collection failed RC=rc RSN=rsn

Explanation: The indicated agent agent has encountered problems during its data collection processing, the returncode rc and reason code rsn is shown.



KRS0166I id PC Routine routine installed for index index

Explanation: The indicated PC Routine routine has been installed and its index value index is shown.



KRS0167I id Invoking initialization routine routine

Explanation: The indicated initialization routine routine has been invoked.



KRS0168I id Invoking termination routine routine

Explanation: The indicated termination routine routine has been invoked.



KRS0176I id Dealt SMF record type number

Explanation: The SMF record number number has been intercepted by the TEDA server and successfully dealt to aSMF record handler agent.



KRS0177W id Discarded SMF record type number

Explanation: The SMF record number number has been intercepted by the TEDA server but was not given to anyinterested SMF record handler agent.



KRS0178E id Duplicate name name found for type statement.

Explanation: While processing a statement type from parmlib, a duplicate name was discovered.

Note: Change the name on the statement to be unique.


KRS0179E id Duplicate keyword name specified.

Explanation: While processing statements from parmlib, a duplicate keyword name was discovered.

Operator response: Correct or remove the duplicate keyword.

KRS0180E id No supplied parameters for statement

Explanation: During the process of reading the KppPRDxx PARMLIB member, the indicated statement statement didnot contain any valid parameters.

Operator response: Refer to the Monitoring Agent Planning and Configuration Guide for more information on thekeywords and expected values and formats. Correct the statement and restart the TEDA server.


KRS0181E id Maximum number of object reached

Explanation: The maximum number of items has been reached for the indicated object object. All following items ofthe same type will be ignored.


KRS0182E id Invalid length of keyword_or_statement

Explanation: An invalid length was detected for the indicated keyword or statement keyword_or_statement.

Operator response: Refer to the Monitoring Agent Planning and Configuration Guide for more information on thekeywords and expected values and formats. Re-specify the keyword with valid values.

KRS0183E id Non-Hexadecimal characters in keyword

Explanation: A keyword keyword was expecting only hexadecimal characters (0-9 and A-F) its value, howevernon-hexadecimal characters have been detected.


KRS0184E id Value of value greater than maximum allowed maximum

Explanation: The keyword value value is greater than the allowed maximum maximum. The value is rejected.


KRS0185E id Value of value less than minimum allowed minimum

Explanation: The keyword value value is less than the allowed minimum minimum. The value is rejected.


KRS0186E id Non-Numeric characters in keyword

Explanation: A keyword keyword was expecting only numerical characters (0-9) in its value, however non-numericalcharacters have been detected.


KRS0187E id Invalid time specification in keyword

Explanation: A keyword was expecting a time format value and it detected an invalid value. The time format is :hh:mm:ss.th with all leading zeros included.


KRS0188E id Invalid range specification in keyword

Explanation: The value in keyword keyword is not in a valid range as required by the keyword.



KRS0189E id Invalid value specification in keyword

Explanation: The value in keyword keyword is invalid.


KRS0190W id Bad statement found : Abort, Continue or Ignore (A,C,I)

Explanation: During the process of reading the KppPRDxx PARMLIB member, there has been an error encounteredin at least one statement.

Operator response: Examine earlier error messages to determine the reason for the failure. Refer to the MonitoringAgent Planning and Configuration Guide for more information on the keywords and expected values and formats.Reply with one of the following choices :

v A — Abort the server startup.

v C — Continue with startup and ignore this statement only.

v I — Continue with startup and ignore all following statement errors.

KRS0191E id Load failed for module module RC=rc RSN=rsn

Explanation: The indicated load module module could not be loaded. The return code rc and reason code rsn isshown.

Operator response: Verify that the indicated load module can be found in either the JOBLIB or STEPLIB data sets orthe z/OS system linklist. A server restart will be required to resolve the problem.

KRS0192E id Invalid reply

Explanation: The reply to the TEDA server WTOR did not match one of the valid value. The reply will be ignored.

Operator response: Reply to the WTOR with one of the listed values.

KRS0194I id Server Abend ac RSN=rsn

Explanation: The TEDA server abended with the indicated abend code ac and reason code rsn.

Operator response: Please contact IBM Support.

KRS0195I id SMF Exit exit installed successfully

Explanation: The indicated SMF exit exit has been installed successfully.


KRS0196E id CSVDYNEX DEFINE for exit failed RC=rc RSN=rsn

Explanation: During the DEFINE for the indicated SMF exit exit, the TEDA server received an unexpected returncode rc and reason code rsn.


KRS0197E id CSVDYNEX ADD for exit failed RC=rc RSN=rsn

Explanation: During the ADD for the indicated SMF exit exit, the TEDA server received an unexpected return coderc and reason code rsn.



KRS0198E id Service service failed RC=rc RSN=rsn

Explanation: The indicated service service failed with return code rc and reason code rsn.


KRS0199E id text.

Explanation: This is a general purpose error message. The text gives the specific error encountered..

Operator response: Review the contents of the message and take any steps indicated to correct the error.

KRS0999I id msgtext

Explanation: This is a trace message written by the various agents when the MsgLevel is greater than 0.




Appendix A. IBM Tivoli Enterprise Console event mapping

Each event class corresponds to an attribute group in the IBM Tivoli EnterpriseConsole. For a description of the event slots for each event class, see the lists inthis appendix. For more information about mapping attribute groups to eventclasses, see the IBM Tivoli Monitoring Administrator's Guide.

Generic event mapping provides useful event class and attribute information forsituations that do not have specific event mapping defined. BAROC files are foundon the Tivoli Enterprise Monitoring Server in the installation directory in TECLIB(that is, install_dir/cms/TECLIB for Windows systems and install_dir/tables/TEMS_hostname/TECLIB for UNIX systems). IBM Tivoli Enterprise Console eventsynchronization provides a collection of ready-to-use rule sets that you can deploywith minimal configuration. Be sure to install IBM Tivoli Enterprise Console eventsynchronization to access the correct Sentry.baroc, which is automatically includedduring base configuration of IBM Tivoli Enterprise Console rules if you indicatethat you want to use an existing rulebase. See the IBM Tivoli Monitoring Installationand Setup Guide for details.

Each of the event classes is a child of KRH_Base and is defined in the krh.barocfile. The KRH_Base event class can be used for generic rules processing for anyevent from the IBM Tivoli Advanced Reporting for DFSMShsm.

For events generated by situations in the Activity Logs attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_ACTIVITY_LOGS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv dsn: STRINGv cdate: STRINGv cdays: INTEGERv vol: STRING

For events generated by situations in the Advanced Reporting Event Data attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_ADVANCED_REPORTING_EVENT_DATA class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv command: STRINGv datetime: STRINGv userid: STRINGv retcode: INTEGERv reacode: INTEGERv dsname: STRINGv product: STRING


v krh_msg: STRING

For events generated by situations in the Advanced Reporting Messages attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_ADVANCED_REPORTING_MESSAGES class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv command: STRINGv retcode: INTEGERv reacode: INTEGERv retmsg: STRINGv reamsg: STRING

For events generated by situations in the Backup Data Sets attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_BACKUP_DATA_SETSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv dsn: STRINGv volsr: STRINGv bkpnum: INTEGERv dbkup: STRINGv dsorg: STRINGv blksz: INTEGERv keyln: INTEGERv recfm: STRINGv compr: INTEGERv size: INTEGERv sizeb: INTEGERv csz: INTEGERv sms: STRINGv ver: INTEGERv nbc: INTEGERv tbc: INTEGERv freq: INTEGERv dlrpb: STRINGv scrd: STRINGv dbud: INTEGERv dlrpd: INTEGERv scrdd: INTEGER

For events generated by situations in the Backup Versions attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_BACKUP_VERSIONSclass. This class contains the following slots:


v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv dsn: STRINGv volsr: STRINGv gennum: INTEGERv bdsn: STRINGv uvol: STRINGv cdate: STRINGv vernum: INTEGERv onl1: STRINGv fcat: STRINGv vsds: STRINGv ftape: STRINGv fdbuv: STRINGv fprof: STRINGv fvsms: STRINGv fexpd: STRINGv dbud: INTEGER

For events generated by situations in the Backup Volumes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_BACKUP_VOLUMESclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv unit: STRINGv voltype: STRINGv volfull: STRINGv volcap: STRINGv hsmwrite: STRINGv perfull: INTEGERv fstbkup: STRINGv fstbkud: INTEGERv lstbkup: STRINGv lstbkud: INTEGERv altvol: STRINGv tottrks: INTEGERv freetrk: INTEGERv trklen: INTEGERv lwm: INTEGERv fragidx: INTEGERv density: INTEGER

Appendix A. IBM Tivoli Enterprise Console event mapping 281

v devtype: STRINGv lstspill: STRINGv lstspild: INTEGERv lstclean: STRINGv lstclead: INTEGER

For events generated by situations in the BCDS Details attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_BCDS_DETAILS class. Thisclass contains the following slots:v node: STRINGv timestamp: STRINGv dsname: STRINGv trksbackup: INTEGERv version: INTEGERv bkupvolume: STRINGv srcvolume: STRINGv bkuptime: STRINGv alias: STRINGv vsam: INTEGERv vsam_enum: STRINGv dataclas: STRINGv mgmtclas: STRINGv storclas: STRING

For events generated by situations in the BCDS Volume Summary attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_BCDS_VOLUME_SUMMARY class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv volser: STRINGv unit: STRINGv esoteric: STRING

For events generated by situations in the CDS SMS Class Summary attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_CDS_SMS_CLASS_SUMMARY class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv smsclass: STRINGv classname: STRINGv occurrences: INTEGERv krh_source: STRING

For events generated by situations in the Control Data Sets attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_CONTROL_DATA_SETSclass. This class contains the following slots:


v node: STRINGv timestamp: STRINGv sysid: STRINGv plxid: STRINGv name: STRINGv id: STRINGv host: STRINGv dsn: STRINGv rls: STRINGv typ: STRINGv vol: STRING

For events generated by situations in the Daily Function Stats attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_DAILY_FUNCTION_STATS class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv ddate: STRINGv funcn: STRINGv nds: INTEGERv ntrkr: INTEGERv ntrkw: INTEGERv nbytr: INTEGERv nbytw: INTEGERv tage: INTEGERv ttinq: INTEGERv ttwv: INTEGERv ttinp: INTEGERv ttot: INTEGERv ngbr: INTEGERv ngbw: INTEGERv ndsf: INTEGERv nvol: INTEGERv nsys: INTEGER

For events generated by situations in the Daily Space Management Detail attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_DAILY_SPACE_MANAGEMENT_DETAIL class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv volser: STRINGv starttime: STRINGv endtime: STRING


v elapsed: STRINGv dsncnt: INTEGERv tracks: INTEGERv minage: INTEGERv freepct: INTEGERv freetrk: INTEGERv freecyl: INTEGERv fragix: INTEGER

For events generated by situations in the Daily Space Management Summaryattribute group, Tivoli Enterprise Console events are sent using theITM_KRH_DAILY_SPACE_MANAGEMENT_SUMMARY class. This class containsthe following slots:v node: STRINGv timestamp: STRINGv volser: STRINGv proccnt: INTEGERv hifree: INTEGERv lowfree: INTEGERv hicyls: INTEGERv lowcyls: INTEGERv hifrag: INTEGERv lowfrag: INTEGER

For events generated by situations in the Daily Statistics attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DAILY_STATISTICS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv ddate: STRINGv ipl: INTEGERv abend: INTEGERv shutd: INTEGERv nmwe: INTEGERv nprcl: INTEGERv nprcv: INTEGERv ejst: INTEGERv event: INTEGERv time: STRINGv nvmg: INTEGERv nvmgf: INTEGERv nvbu: INTEGERv nbvrc: INTEGERv nmvrc: INTEGERv dumps: INTEGER


v dumpu: INTEGERv dumpf: INTEGERv dcops: INTEGERv dcopu: INTEGERv dcopf: INTEGERv dtinq: INTEGERv dtwva: INTEGERv dtinp: INTEGERv dttot: INTEGERv rest: INTEGERv restf: INTEGERv dsre: INTEGERv dsref: INTEGERv exred: INTEGERv abak: INTEGERv abakf: INTEGERv abxtr: INTEGERv dsrcn: INTEGERv trrcn: INTEGER

For events generated by situations in the Daily Volume Stats attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DAILY_VOLUME_STATSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv ddate: STRINGv funcn: STRINGv zerof: STRINGv nds: INTEGERv ntrkr: INTEGERv ntrkw: INTEGERv nbytr: INTEGERv nbytw: INTEGERv ndsf: INTEGERv nvol: INTEGERv nsys: INTEGERv tage: INTEGERv ttinq: INTEGERv ttwv: INTEGERv ttinp: INTEGER


For events generated by situations in the DFSMS Class Summary attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_DFSMS_CLASS_SUMMARY class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv cls: STRINGv type: STRINGv krh_date: STRINGv bdsnum: INTEGERv mdsnum: INTEGERv bdsz: STRINGv mdsz: STRINGv dateint: INTEGER

For events generated by situations in the DFSMShsm Functions attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_DFSMSHSM_FUNCTIONS class. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv ascb: STRINGv host: STRINGv func: STRINGv stat: STRING

For events generated by situations in the Dump Classes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DUMP_CLASSES class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv dclas: STRINGv farus: STRINGv fdsre: STRINGv frset: STRINGv fncpr: STRINGv freq: INTEGERv retpd: INTEGERv daynum: INTEGERv unit: STRING


v disp: STRINGv displ: INTEGERv expdt: STRINGv vcpynum: INTEGER

For events generated by situations in the Dump Data Sets attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DUMP_DATA_SETS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv tsdd: STRINGv tsddy: INTEGERv utype: STRINGv ucbty: STRINGv trkln: INTEGERv ml1vs: STRINGv dsn: STRINGv crdt: STRINGv xpdt: STRINGv lrdt: STRINGv noepv: INTEGERv dsorg: STRING

For events generated by situations in the Dump Versions attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DUMP_VERSIONS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv tsdt: STRINGv tsddy: INTEGERv fvtoc: STRINGv frset: STRINGv fcmd: STRINGv fsms: STRINGv fcomp: STRINGv blks: INTEGERv recs: INTEGERv bprfx: STRINGv bpfxl: INTEGERv ml1vs: STRING


v utype: STRINGv ucbty: STRINGv trkln: INTEGERv cyldt: STRINGv cyldy: INTEGERv dcl: STRINGv unit: STRINGv expdt: STRINGv expdy: INTEGERv texpd: STRINGv nvsn: INTEGERv dvsn: STRING

For events generated by situations in the Dump Volumes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_DUMP_VOLUMES class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv unit: STRINGv funav: STRINGv fcucs: STRINGv fwrit: STRINGv fused: STRINGv ftpsw: STRINGv ftsrf: STRINGv tvext: STRINGv fvald: STRINGv utype: STRINGv ucbty: STRINGv den: INTEGERv dclas: STRINGv expdt: STRINGv expdd: INTEGERv dgnky: STRINGv svsn: STRINGv stype: STRINGv sucbt: STRINGv tsdt: STRINGv tsddy: INTEGERv trkln: INTEGER


For events generated by situations in the Exit Information attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_EXIT_INFORMATIONclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv host: STRINGv xname: STRINGv xdesc: STRINGv xdata: STRINGv xstat: STRINGv maddr: STRINGv xamod: STRINGv xrmod: STRINGv xrent: STRINGv xloc: STRINGv xreus: STRINGv xauth: STRINGv xmaut: STRINGv xusenum: INTEGERv xsize: INTEGERv xdsn: STRING

For events generated by situations in the Extent Reduction Summary attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_EXTENT_REDUCTION_SUMMARY class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv privol: STRINGv kb2: INTEGERv trksmigr: INTEGERv trksrcll: INTEGERv retcode: INTEGERv dsname: STRINGv type: STRING

For events generated by situations in the Extent Reductions attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_EXTENT_REDUCTIONSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRING


v actn: STRINGv rcn: INTEGERv uid: STRINGv dsn: STRINGv tvol: STRINGv devt: STRINGv ucbty: STRINGv fvol: STRINGv reas: INTEGERv abcc: STRINGv grp: STRINGv rqn: INTEGERv datr: INTEGERv timr: INTEGERv tims: INTEGERv time: INTEGERv bytr: INTEGERv bytw: INTEGERv trkr: INTEGERv trkw: INTEGERv dsorg: STRINGv tso: STRINGv user: STRINGv wait: STRINGv cpu: INTEGERv age: INTEGERv recfm: STRINGv scnam: STRINGv mcnam: STRINGv dclas: STRINGv host: STRINGv sysid: STRINGv lvls: STRINGv krh_date: STRING

For events generated by situations in the Filter Attribute Group attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_FILTER_ATTRIBUTE_GROUP class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv target: STRINGv filter: STRINGv ibm: INTEGERv ibm_enum: STRINGv filterid: STRING


v descript: STRING

For events generated by situations in the Function Records attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_FUNCTION_RECORDSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv actn: STRINGv rcn: INTEGERv uid: STRINGv dsn: STRINGv tvol: STRINGv devt: STRINGv ucbty: STRINGv fvol: STRINGv reas: INTEGERv abcc: STRINGv grp: STRINGv rqn: INTEGERv datr: STRINGv tims: STRINGv time: STRINGv bytr: INTEGERv bytw: INTEGERv trkr: INTEGERv trkw: INTEGERv dsorg: STRINGv tso: STRINGv user: STRINGv wait: STRINGv cpu: INTEGERv age: INTEGERv recfm: STRINGv scnam: STRINGv mcnam: STRINGv dclas: STRINGv host: STRINGv sysid: STRINGv lvls: STRING

For events generated by situations in the Function Summary attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_FUNCTION_SUMMARYclass. This class contains the following slots:v node: STRING


v timestamp: STRINGv system: STRINGv plexnm: STRINGv actn: STRINGv rcn: INTEGERv num: INTEGERv desc: STRING

For events generated by situations in the HSM Backup Reports attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_HSM_BACKUP_REPORTS class. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vmst: STRINGv nvols: INTEGERv desc: STRING

For events generated by situations in the HSM CDS Backups attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_HSM_CDS_BACKUPSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv type: STRINGv bdsn: STRINGv cdate: STRINGv cdays: INTEGERv dsn: STRINGv cdsn: STRINGv vol: STRING

For events generated by situations in the HSM CDS Space attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_HSM_CDS_SPACE class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv comp: STRINGv entyp: STRINGv text: STRINGv cat: STRINGv catnm: STRINGv vol: STRING


v ucbaddr: STRINGv lkrc: STRINGv lkrs: STRINGv speed: STRINGv uniq: STRINGv reuse: STRINGv erase: STRINGv rgshr: STRINGv syshr: STRINGv open: STRINGv bufsz: INTEGERv prisp: INTEGERv secsp: INTEGERv spcfg: STRINGv dshu: INTEGERv dsha: INTEGERv dshp: STRINGv lrecl: INTEGERv sc: STRINGv dc: STRINGv mc: STRINGv clsty: STRINGv dsorg: STRINGv wck: STRINGv imb: STRINGv repl: STRINGv spnd: STRINGv order: STRINGv rkp: INTEGERv keylen: INTEGERv ca_pcnt: INTEGERv ci_pcnt: INTEGERv ci_per_ca: INTEGERv cisz: INTEGERv maxlrecl: INTEGERv levels: INTEGERv records: INTEGERv extents: INTEGERv deletes: INTEGERv inserts: INTEGERv updates: INTEGERv retrieved: INTEGERv cisplits: INTEGERv casplits: INTEGERv io: INTEGER


v noext: INTEGERv hkrba: INTEGERv urbat: INTEGERv arbat: INTEGERv blksz: INTEGERv blktk: INTEGERv tycyl: INTEGERv byttk: INTEGERv fbytes: INTEGERv datetime: STRINGv trkau: INTEGERv tpext: INTEGERv ent_sect: INTEGERv seq_set: INTEGERv vltyp: STRINGv dvtyp: STRINGv devty: STRINGv hi_level: INTEGERv upgrade: STRING

For events generated by situations in the HSM CDS Users attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_HSM_CDS_USERS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv qname: STRINGv rname: STRINGv type: STRINGv waitnum: INTEGERv waite: INTEGERv waits: INTEGERv stat: STRINGv level: STRINGv jobnm: STRINGv sysnm: STRINGv tcb: STRINGv asid: STRINGv scope: STRINGv ownnum: INTEGERv ecb: STRINGv svrb: STRINGv mc: STRINGv unit: STRING


For events generated by situations in the HSM Health Detail Reports attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_HSM_HEALTH_DETAIL_REPORTS class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vmstv: STRINGv volsr: STRINGv sysid: STRINGv stgr: STRINGv devtc: STRINGv smsm: STRINGv hsmm: STRINGv fmvt: STRINGv mcvlv: STRINGv fsdsp: STRINGv lspmd: STRINGv fautm: STRINGv autbd: STRINGv fautb: STRINGv autdd: STRINGv fautd: STRINGv imigd: STRINGv fintm: STRINGv hwm: STRINGv lwm: STRINGv ocpct: INTEGERv captr: INTEGERv freetrk: INTEGERv mignum: INTEGERv migtnum: INTEGERv mign: INTEGERv migtn: INTEGERv miga: INTEGERv migf: INTEGERv rcla: INTEGERv rclf: INTEGERv dlta: INTEGERv dltf: INTEGERv bupa: INTEGERv bupf: INTEGERv dmpa: INTEGERv dmpf: INTEGER


v fcach: STRINGv fctr: STRINGv fcdc: STRINGv fcdf: STRINGv fvidx: STRINGv fidxe: STRINGv vsrd: STRINGv hdys: INTEGERv hlim: INTEGER

For events generated by situations in the HSM Host Info attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_HSM_HOST_INFO class.This class contains the following slots:v node: STRINGv timestamp: STRINGv sysid: STRINGv plxid: STRINGv name: STRINGv id: STRINGv host: STRINGv ver: STRINGv type: STRINGv stat: STRINGv mcvta: STRINGv qct: STRINGv qcte: STRINGv asid: STRINGv ascb: STRINGv membr: STRINGv smf: INTEGERv bkpfx: STRINGv mgpfx: STRINGv mbts: INTEGERv mdts: INTEGERv mrt: INTEGERv tmrt: INTEGERv mmtk: INTEGERv mitk: INTEGERv mdsr: INTEGERv mxrcy: INTEGERv mxcsa: INTEGERv actlm: INTEGERv inalm: INTEGERv csaus: INTEGERv csaunum: INTEGERv mwesnum: INTEGER


v audit: STRINGv abkup: STRINGv adump: STRINGv amig: STRINGv bkup: STRINGv dump: STRINGv list: STRINGv mig: STRINGv recal: STRINGv recov: STRINGv recyc: STRINGv reprt: STRINGv tapec: STRINGv tprcl: STRINGv tprcv: STRINGv tprep: STRINGv tsotp: STRINGv bcdsb: STRINGv mcdsb: STRINGv ocdsb: STRINGv jrnlb: STRING

For events generated by situations in the HSM Migration Reports attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_HSM_MIGRATION_REPORTS class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vmst: STRINGv nvols: INTEGERv desc: STRING

For events generated by situations in the HSM Volume Dump Reports attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_HSM_VOLUME_DUMP_REPORTS class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vmst: STRINGv nvols: INTEGERv desc: STRING


For events generated by situations in the Issue HSM Commands attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_ISSUE_HSM_COMMANDS class. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv host: STRINGv msg1: STRINGv msg2: STRINGv cmdl: STRINGv cmd: STRING

For events generated by situations in the Log Data Sets attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_LOG_DATA_SETS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv dsn: STRINGv typ: STRINGv src: STRING

For events generated by situations in the Log Migration Detail attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_LOG_MIGRATION_DETAIL class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv dsname: STRINGv action: STRINGv retcode: INTEGERv reacode: INTEGERv trks: INTEGERv age: INTEGERv datetime: STRINGv fromvol: STRINGv tovol: STRINGv cpu: INTEGER

For events generated by situations in the Log Recall Detail attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_LOG_RECALL_DETAILclass. This class contains the following slots:v node: STRING


v timestamp: STRINGv dsname: STRINGv action: STRINGv retcode: INTEGERv reacode: INTEGERv tracks: INTEGERv age: INTEGERv datetime: STRINGv rtime: STRINGv kb2: INTEGERv level: INTEGERv user: STRINGv btso: STRINGv fromvol: STRINGv tovol: STRINGv cpu: INTEGER

For events generated by situations in the MCDS Details attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_MCDS_DETAILS class.This class contains the following slots:v node: STRINGv timestamp: STRINGv dsname: STRINGv migrated: INTEGERv migrated_enum: STRINGv createdate: STRINGv refdate: STRINGv migdate: STRINGv expdate: STRINGv lastbkup: STRINGv migvol: STRINGv ml0vol: STRINGv migtime: INTEGERv thrindex: INTEGERv miglvl: INTEGERv vsam: INTEGERv vsam_enum: STRINGv trksml0: INTEGERv migkb2: INTEGERv dataclas: STRINGv mgmtclas: STRINGv storclas: STRINGv sdsp: INTEGERv sdsp_enum: STRING


For events generated by situations in the MCDS Volume Summary attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_MCDS_VOLUME_SUMMARY class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv volser: STRINGv unittype: STRING

For events generated by situations in the Migrated Data Sets attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_MIGRATED_DATA_SETSclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv dsn: STRINGv vol: STRINGv fasn: STRINGv fdel: STRINGv fsdp: STRINGv miglv: STRINGv compr: INTEGERv dlc: STRINGv dtlr: STRINGv dtlu: STRINGv tmig: STRINGv tlbu: STRINGv dlbud: INTEGERv dsorg: STRINGv blksz: INTEGERv keyln: INTEGERv recfm: STRINGv size: INTEGERv sizeb: INTEGERv csz: INTEGERv nmig: INTEGERv days: INTEGERv frvsn: STRINGv utype: STRINGv ucbty: STRINGv tres: STRINGv mtype: STRINGv mdevt: STRINGv jct: INTEGERv expdt: STRING


v fmvol: STRINGv fsms: STRINGv scal1: STRINGv scal3: INTEGERv mcanm: STRINGv nvsn: INTEGERv tpblk: INTEGERv fstrp: STRINGv dcnam: STRINGv scnam: STRINGv mcnam: STRINGv fmco: STRINGv dlcd: INTEGERv dlrd: INTEGERv dlud: INTEGERv dmigd: INTEGERv dresd: INTEGERv expdd: INTEGERv trkln: INTEGERv fmcl: STRING

For events generated by situations in the Migration Volumes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_MIGRATION_VOLUMESclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv unit: STRINGv voltype: STRINGv miglvl: STRINGv sdsp: STRINGv narecal: STRINGv volfull: STRINGv ncmdmig: STRINGv tpewrit: STRINGv tpeempt: STRINGv tpeused: STRINGv tpeunav: STRINGv tpenupd: STRINGv primthr: STRINGv hwm: INTEGERv lwm: INTEGERv timedate: STRINGv daysmig: INTEGER


v tottrks: INTEGERv freetrk: INTEGERv devtype: STRINGv blksize: INTEGERv numcyln: INTEGERv trkscyl: INTEGERv trklen: INTEGERv num2kblk: INTEGERv tpeperf: INTEGERv minage: INTEGERv numds: INTEGERv numtrks: INTEGERv fragidx: INTEGERv dbadays: INTEGERv tpedens: INTEGERv lsptime: STRINGv lspdays: INTEGERv sms: STRINGv altvol: STRINGv autoprim: STRINGv autoprid: INTEGERv autobkup: STRINGv autobkud: INTEGERv autodump: STRINGv autodmpd: INTEGERv intmigr: STRING

For events generated by situations in the Mounted Volumes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_MOUNTED_VOLUMESclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv host: STRINGv type: STRINGv volsr: STRINGv ucbaddr: STRINGv vtype: STRINGv ftrks: INTEGERv vlseq: INTEGERv migrq: STRINGv natmg: STRINGv sdsp: STRING


v vtocf: STRINGv noar: STRINGv abckp: STRINGv nocmd: STRINGv unit: STRINGv totsp: INTEGERv fresp: INTEGERv lwm: INTEGERv hwm: INTEGERv devty: STRINGv utype: STRINGv blk: INTEGERv ncyl: INTEGERv ntrk: INTEGERv trkl: INTEGERv num2kb: INTEGERv obsz: INTEGERv gbf: INTEGERv minag: INTEGERv frag: INTEGERv rsvct: INTEGERv ml1ov: STRINGv dsmig: STRINGv uhst: STRINGv dbady: INTEGERv vsnformig: STRINGv day: STRINGv den: INTEGERv lfbid: INTEGER

For events generated by situations in the MWE Queue Contents attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_MWE_QUEUE_CONTENTS class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv host: STRINGv type: STRINGv timestmp: STRINGv func: STRINGv vsam: STRINGv nowt: STRING


v mcsa: STRINGv tso: STRINGv ml2: STRINGv volw: STRINGv auth: STRINGv stat: STRINGv rqn: INTEGERv uascb: STRINGv hrc: STRINGv hrs: STRINGv hab: STRINGv racfg: STRINGv jbn: STRINGv prty: INTEGERv dsn: STRINGv sgn: STRINGv altu: STRINGv vol: STRINGv uid: STRINGv mweaddr: STRINGv pos: INTEGERv rcb: STRINGv tcb: STRINGv tid: STRINGv dtype: STRING

For events generated by situations in the Patches attribute group, Tivoli EnterpriseConsole events are sent using the ITM_KRH_PATCHES class. This class containsthe following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv patch: STRINGv verfy: STRINGv desc: STRINGv activ: STRINGv name: STRINGv id: STRINGv host: STRING

For events generated by situations in the Performance Object Status attributegroup, Tivoli Enterprise Console events are sent using theITM_KRH_PERFORMANCE_OBJECT_STATUS class. This class contains thefollowing slots:v node: STRINGv timestamp: STRING


v query_name: STRINGv object_name: STRINGv object_type: INTEGERv object_type_enum: STRINGv object_status: INTEGERv object_status_enum: STRINGv error_code: INTEGERv error_code_enum: STRING

For events generated by situations in the Return Code Summary attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_RETURN_CODE_SUMMARY class. This class contains the followingslots:v node: STRINGv timestamp: STRINGv retcode: INTEGERv count: INTEGERv message: STRINGv action: STRINGv type: STRING

For events generated by situations in the SETSYS Values attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_SETSYS_VALUES class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv name: STRINGv id: STRINGv host: STRINGv keywd: STRINGv krh_value: STRINGv pdsc: STRING

For events generated by situations in the SMS HSM Mounted Volume Reportsattribute group, Tivoli Enterprise Console events are sent using theITM_KRH_SMS_HSM_MOUNTED_VOLUME_REPORTS class. This class containsthe following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vmst: STRINGv nvols: INTEGERv desc: STRING


For events generated by situations in the Tape Copy Needed attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_TAPE_COPY_NEEDEDclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv type: STRINGv krh_date: STRINGv days: INTEGERv unit: STRINGv nta: STRING

For events generated by situations in the Tape Volumes attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_TAPE_VOLUMES class.This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv vol: STRINGv type: STRINGv ffull: STRINGv cpcty: STRINGv unit: STRINGv dsnum: INTEGERv tblk: INTEGERv vblk: INTEGERv prevl: STRINGv sucvl: STRINGv imagt: STRINGv aunit: STRINGv vsamnum: INTEGERv numvald: INTEGER

For events generated by situations in the Thrashing Report attribute group, TivoliEnterprise Console events are sent using the ITM_KRH_THRASHING_REPORTclass. This class contains the following slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv uid: STRINGv dsn: STRINGv host: STRINGv sysid: STRING


v rnum: INTEGERv mnum: INTEGER

For events generated by situations in the Volume Statistics Records attribute group,Tivoli Enterprise Console events are sent using theITM_KRH_VOLUME_STATISTICS_RECORDS class. This class contains thefollowing slots:v node: STRINGv timestamp: STRINGv system: STRINGv plexnm: STRINGv volser: STRINGv krh_date: STRINGv voltype: STRINGv numumig: INTEGERv numsmig: INTEGERv numnvsam: INTEGERv minage: INTEGERv allotrk: INTEGERv freetrk: INTEGERv lwm: INTEGERv hwm: INTEGERv obm: INTEGERv oam: INTEGERv perelig: INTEGERv numimig: INTEGERv numimet: INTEGERv fragidx: INTEGERv migtime: INTEGERv unitname: STRINGv dumpatmp: STRINGv dumpfail: STRINGv resatmp: STRINGv resfail: STRINGv dumpcpy: INTEGERv dmpcpyf: INTEGERv numrest: INTEGERv numresf: INTEGERv totcap: INTEGERv numdsrec: INTEGERv numtrkrec: INTEGER



Appendix B. Documentation library

This appendix contains information about the publications related to the IBMTivoli Advanced Reporting for DFSMShsm Monitoring Agent. These publicationsare listed in the following categories:v IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent libraryv Prerequisite publicationsv Related publications

See the IBM Tivoli Monitoring and OMEGAMON XE products: Documentation Guide,SC23-8816, for information about accessing and using publications. You can findthe Documentation Guide in the IBM Tivoli Monitoring and OMEGAMON® XEInformation Center at http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.docguide.doc/DocGuide.htm.

To find a list of new and changed publications, click What's new on the Welcomepage of the IBM Tivoli Monitoring and OMEGAMON XE Information Center. Tofind publications from the previous version of a product, click Previousinformation centers on the Welcome page for the product.

IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agentlibrary

There is one document specific to the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent: IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent User's Guide. This publication provides agent-specific informationfor configuring, using, and troubleshooting the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent

Use the configuration chapter in this guide with the IBM Tivoli MonitoringInstallation and Setup Guide to set up the software.

Use the information in this guide with the Tivoli Enterprise Portal User's Guide tomonitor IBM Tivoli Advanced Reporting for DFSMShsm resources.

Prerequisite publicationsTo use the information in this publication effectively, you must have someprerequisite knowledge, which you can obtain from the following IBM TivoliMonitoring publications:v Exploring IBM Tivoli Monitoring

v IBM Tivoli Monitoring Administrator's Guide

v IBM Tivoli Monitoring Agent Builder User’s Guide

v IBM Tivoli Monitoring Command Reference

v IBM Tivoli Monitoring: Configuring Tivoli Enterprise Monitoring Server on z/OS

v IBM Tivoli Monitoring Installation and Setup Guide

v IBM Tivoli Monitoring: Messages

v IBM Tivoli Monitoring Troubleshooting Guide

v IBM Tivoli Monitoring: Upgrading from Tivoli Distributed Monitoring


http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.docguide.doc/DocGuide.htm

http://publib.boulder.ibm.com/infocenter/tivihelp/v15r1/topic/com.ibm.docguide.doc/DocGuide.htm

v IBM Tivoli Monitoring: Upgrading from V5.1.2

v Tivoli Enterprise Portal User's Guide

v IBM Tivoli Monitoring: i5/OS® Agent User's Guide

v IBM Tivoli Monitoring: Linux OS Agent User's Guide

v IBM Tivoli Monitoring: UNIX Log OS Agent User's Guide

v IBM Tivoli Monitoring: UNIX OS Agent User's Guide

v IBM Tivoli Monitoring: Windows OS Agent User's Guide

v IBM Tivoli Monitoring Universal Agent User's Guide

v IBM Tivoli Monitoring Universal Agent API and Command Programming ReferenceGuide

Related publicationsThe following documents also provide useful information:v IBM Tivoli Enterprise Console Adapters Guide

v IBM Tivoli Enterprise Console Event Integration Facility User’s Guide

v IBM Tivoli Enterprise Console Reference Manual

v IBM Tivoli Enterprise Console Rule Builder’s Guide

Other sources of documentationYou can also obtain technical documentation about Tivoli Monitoring andOMEGAMON XE products from the following sources:v IBM Tivoli Open Process Automation Library (OPAL)

http://www.ibm.com/software/tivoli/opalOPAL is an online catalog that contains integration documentation as well asother downloadable product extensions. This library is updated daily.

v Redbookshttp://www.redbooks.ibm.com/IBM Redbooks®, Redpapers, and Redbooks Technotes provide information aboutproducts from platform and solution perspectives.

v TechnotesYou can find Technotes through the IBM Software Support Web site athttp://www.ibm.com/software/support/probsub.html, or more directly throughyour product Web site, which contains a link to Technotes (under Solve aproblem).Technotes provide the latest information about known product limitations andworkarounds.


http://www.ibm.com/software/tivoli/opal

http://www.redbooks.ibm.com/


Appendix C. Accessibility

Accessibility features help users with physical disabilities, such as restrictedmobility or limited vision, to use software products successfully. The majoraccessibility features in this product enable users to do the following:v Use assistive technologies, such as screen-reader software and digital speech

synthesizer, to hear what is displayed on the screen. Consult the productdocumentation of the assistive technology for details on using those technologieswith this product.

v Operate specific or equivalent features using only the keyboard.v Magnify what is displayed on the screen.

In addition, the product documentation was modified to include the followingfeatures to aid accessibility:v All documentation is available in both HTML and convertible PDF formats to

give the maximum opportunity for users to apply screen-reader software.v All images in the documentation are provided with alternative text so that users

with vision impairments can understand the contents of the images.

Navigating the interface using the keyboardStandard shortcut and accelerator keys are used by the product and aredocumented by the operating system. See the documentation provided by youroperating system for more information.

Magnifying what is displayed on the screenYou can enlarge information on the product windows using facilities provided bythe operating systems on which the product is run. For example, in a Microsoft®

Windows environment, you can lower the resolution of the screen to enlarge thefont sizes of the text on the screen. See the documentation provided by youroperating system for more information.



Appendix D. Notices

This information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed in this document inother countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBMproduct, program, or service is not intended to state or imply that only that IBMproduct, program, or service may be used. Any functionally equivalent product,program, or service that does not infringe any IBM intellectual property right maybe used instead. However, it is the user's responsibility to evaluate and verify theoperation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matterdescribed in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785 U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBMIntellectual Property Department in your country or send inquiries, in writing, to:

IBM World Trade Asia CorporationLicensing2-31 Roppongi 3-chome, Minato-kuTokyo 106, Japan

The following paragraph does not apply to the United Kingdom or any othercountry where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THISPUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESSFOR A PARTICULAR PURPOSE.

Some states do not allow disclaimer of express or implied warranties in certaintransactions, therefore, this statement might not apply to you.

This information could include technical inaccuracies or typographical errors.Changes are periodically made to the information herein; these changes will beincorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispublication at any time without notice.

Any references in this information to non-IBM Web sites are provided forconvenience only and do not in any manner serve as an endorsement of those Websites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk.


IBM may use or distribute any of the information you supply in any way itbelieves appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purposeof enabling: (i) the exchange of information between independently createdprograms and other programs (including this one) and (ii) the mutual use of theinformation which has been exchanged, should contact:

IBM Corporation2Z4A/10111400 Burnet RoadAustin, TX 78758 U.S.A.

Such information may be available, subject to appropriate terms and conditions,including in some cases payment of a fee.

The licensed program described in this document and all licensed materialavailable for it are provided by IBM under terms of the IBM Customer Agreement,IBM International Program License Agreement or any equivalent agreementbetween us.

This information contains examples of data and reports used in daily businessoperations. To illustrate them as completely as possible, the examples include thenames of individuals, companies, brands, and products. All of these names arefictitious and any similarity to the names and addresses used by an actual businessenterprise is entirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, whichillustrate programming techniques on various operating systems. You may copy,modify, and distribute these sample programs in any form without payment toIBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operatingsystem for which the sample programs are written. These examples have not beenthoroughly tested under all conditions. IBM, therefore, cannot guarantee or implyreliability, serviceability, or function of these programs. You may copy, modify, anddistribute these sample programs in any form without payment to IBM for thepurposes of developing, using, marketing, or distributing application programsconforming to IBM's application programming interfaces.

If you are viewing this information in softcopy form, the photographs and colorillustrations might not appear.

TrademarksIBM, the IBM logo, and ibm.com® are trademarks or registered trademarks ofInternational Business Machines Corp., registered in many jurisdictions worldwide.Other product and service names might be trademarks of IBM or other companies.A current list of IBM trademarks is available on the Web at "Copyright andtrademark information" at www.ibm.com/legal/copytrade.shtml.

Adobe, the Adobe logo, PostScript, and the PostScript logo are either registeredtrademarks or trademarks of Adobe Systems Incorporated in the United States,and/or other countries.


www.ibm.com/legal/copytrade.shtml

www.ibm.com/legal/copytrade.shtml

Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo,Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks orregistered trademarks of Intel Corporation or its subsidiaries in the United Statesand other countries.

Java and all Java-based trademarks and logos are trademarks orregistered trademarks of Sun Microsystems, Inc. in the United States,other countries, or both.

Linux is a registered trademark of Linus Torvalds in the United States, othercountries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.

UNIX is a registered trademark of The Open Group in the United States and othercountries.

Other company, product, and service names may be trademarks or service marksof others.

Appendix D. Notices 315


Index

Special characters#2k Blk Per Trk attribute 172

AAbend code attribute 178Abend Code attribute 91, 98accessibility 311Action attribute 142, 144, 185actions

See Take Action commandsActive Limit attribute 134Activity Logs attribute group 26Activity Logs workspace 16Additional Volumes attribute 157Addr Mode attribute 86Advanced Reporting Event Data

workspacesdescriptions 11

Advanced Reporting Event Data attribute group 27Advanced Reporting Event Information

situations 204, 206workspaces

list 9Advanced Reporting Event Information workspace 11Advanced Reporting Event Messages workspace 12Advanced Reporting Messages attribute group 28Age attribute 94, 101, 143, 145Age Of Data Sets Processed attribute 49, 68agent

trace logs 246agents

troubleshooting 254AIX Upgrade attribute 118Alias attribute 43All Numbers Zeroes attribute 66Allocated Tracks attribute 195Allocation Type attribute 108Alternate Unit attribute 178, 191Alternate Unit Name attribute 188Alternate Volume attribute 39, 166, 191ASCB Address attribute 72, 131, 177ASID attribute 121attribute groups

Activity Logs 26Advanced Reporting Event Data 27Advanced Reporting Messages 28Backup Data Sets 30Backup Versions 34Backup Volumes 37BCDS Details 42BCDS Volume Summary 44CDS SMS Class Summary 44Control Data Sets 45Daily Function Stats 47Daily Space Management Detail 51Daily Space Management Summary 54Daily Statistics 56Daily Volume Stats 65DFSMS Class Summary 69

attribute groups (continued)DFSMShsm Functions 71Dump Classes 72Dump Data Sets 75Dump Versions 77Dump Volumes 81Exit Information 85Extent Reduction Summary 88Extent Reductions 89Filter Attribute Group 95Function Records 96Function Summary 102HSM Backup Reports 103HSM CDS Backups 104HSM CDS Space 105HSM CDS Users 118HSM Health Detail Reports 121HSM Host Info 129HSM Migration Reports 137HSM Volume Dump Reports 138Issue HSM Commands 139list of all 21Log Data Sets 141Log Migration Detail 142Log Recall Detail 144MCDS Details 147MCDS Volume Summary 150Migrated Data Sets 151Migration Volumes 160more information 21Mounted Volumes 168MWE Queue Contents 175new 2overview 21Patches 179Performance Object Status 181Return Code Summary 184SETSYS Values 185SMS HSM Mounted Volume Reports 186Tape Copy Needed 187Tape Volumes 189Thrashing Report 191Volume Statistics Records 193

attributes#2k Blk Per Trk 172Abend code 178Abend Code 91, 98Action 142, 144, 185Active Limit 134Activity Logs 26Additional Volumes 157Addr Mode 86Advanced Reporting Event Data 27Advanced Reporting Messages 28Age 94, 101, 143, 145Age Of Data Sets Processed 49, 68AIX Upgrade 118Alias 43All Numbers Zeroes 66Allocated Tracks 195Allocation Type 108


attributes (continued)Alternate Unit 178, 191Alternate Unit Name 188Alternate Volume 39, 166, 191ASCB Address 72, 131, 177ASID 121Audit Status 135Auto Backup 123, 170Auto Backup Days 167Auto Backup Status 135Auto Backup Timestamp 167Auto Dump 124Auto Dump Date 167Auto Dump Days 167Auto Dump Status 135Auto Management 123Auto Migration Status 135Auto Prim Days 167Auto Prim Timestamp 166Auto Reuse 73Average Lrecl 109Backup Attempts 127Backup Data Set Name 105Backup Data Set Size 70Backup Data Sets 30, 70Backup Day 174Backup Failures 127Backup Frequency 33Backup Prefix 79, 131Backup Prefix Length 79Backup Profile 36Backup Status 135Backup Timestamp 43, 105Backup Version Data Set Name 35Backup Versions 35Backup Volser 30, 35Backup Volume 43Backup Volumes 37BCDS Backup Status 137BCDS Details 42BCDS Volume Summary 44Block Size 115, 163, 171Blocks Per Track 116BTSO 146Buffer Size 108Bytes Per Track 116CA Percent Free Space 111CA Splits 114Cached 128Capacity 190Capacity In Tracks 124Catalog Flag 106Catalog Name 105, 106Cataloged 36CDS SMS Class Summary 45CI Per CA 111CI Percent Free Space 111CI Size 111CI Splits 114Class Name 45, 70Class Type 70Cluster Type 110Cmd Suffix 131Command 27, 29Command Initiation 78Command Length 140Command To Issue 140

attributes (continued)Compacted Data 82Complete Time 92, 99Compressed 79Control Data Set Name 106, 119Control Data Sets 46Count 102, 104, 138, 139, 184, 187CPU Seconds 144, 147Cpu Time .01 94, 100Creation Date 26, 76, 148Current Occupancy 124Cycle Date 80Cylinders Free 53Daily Function Stats 47Daily Space Management Detail 51Daily Space Management Summary 54Daily Statistics 56Daily Volume Stats 65DASD Fast Write 128Data Class 43, 109, 150Data Class Name 157Data Set Count 52Data Set Name 26, 28, 30, 35, 42, 46, 76, 88, 89, 90, 97, 105,

141, 142, 144, 147, 152, 178, 192Data Set Number 190Data Set Organization 31, 77, 94, 100, 110, 153Data Set Restore 73Date 47, 57, 66, 194Date Backed Up 31, 36Date Created 152Date Interval For Class 71Date Last Referenced 33Date Migrated 148Date Uncataloged 33Day 74Days Since Backed Up 34, 37Days Since Backup 105Days Since Created 26, 158Days Since Cycle 80Days Since Dump 76, 78, 84Days Since First Backup 39Days Since Last Backup 39, 153Days Since Last Clean 41Days Since Last Referenced 34Days Since Last Spill 41Days Since Last Used 158Days Since Migrate 162Days Since Migrated 158Days Since Recalled 159Days Since Tapecopy 188Days Since Uncataloged 34Days Since VSAM Last Used 158Days Til Migrated 155Days Till Expire 81, 84Days Till Expired 159DBA Days 165Delete Attempts 127Delete Days 174Delete Failures 127Deleted 152Deletes 113Density 40, 83Description 86, 96, 103, 104, 138, 139, 180, 186, 187Descriptive Type 179Device Number 121Device Type 41, 76, 83, 118, 122, 163, 171Device type from UCB 80


attributes (continued)Device Type from UCB 83Device type of volume 80Device Type-hex 91Device Type-Hex 76, 98, 118, 171Device Type(char) 91Device Type(Char) 98DFSMS Class Summary 69DFSMShsm Functions 71DGN Key 84Disposition 74Disposition Length 74Dual Copy 128Dump Attempted 198Dump Attempts 128Dump Class 73, 80, 83, 95, 101Dump Classes 72Dump Copies 198Dump Copies Failed 198Dump Data Sets 75Dump Date 76Dump Failed 198Dump Failures 128Dump Status 135Dump Timestamp 78, 84Dump Versions 77Dump Volumes 82ECB Address 121Elapsed Time 52Elpased Time To Process Requests 69End Date and Time 52Entries Per Section 117Entry Type 106Entry Type Description 106Erase 107Error Code 182Esoteric Name 44EXCP Count 114Exit Information 85Exit Name 86Exit Status 86Expiration Date 77, 148, 156Expire Date 74, 81, 84Expired Data Set 37Extent Reduction Summary 88Extent Reductions 90Extent Type 117Extents 112File Type 46Filter 96Filter Attribute Group 96Filter ID 96Fragmentation Index 40, 53, 165, 173, 197Free Bytes 116Free Space (Trks) 170Free Tracks 40, 163, 169, 195Frequency 73From Volume 91, 98, 146From Volume Serial 143Full 189Full VTOC 170Function 47, 66, 72Function code 176Function Records 97Function Summary 102Generation Number 35Guaranteed Backup Frequency 173

attributes (continued)Health Days 129Health Limit 129High Allocated RBA 109, 115High Level RBA 115, 118High Thresh 171High Threshold 124High Used RBA 108, 115Highest % of Free Space 55Highest # of Free Cylinders 55Highest Fragmentation Index 56Host ASID 131Host ID 46, 72, 86, 95, 101, 130, 168, 176, 181, 186, 192Host Identifier 140HSM Action 90, 97, 102HSM Backup Reports 103HSM CDS Backups 104HSM CDS Space 106HSM CDS Users 119HSM Health Detail Reports 122HSM Host Info 130HSM Managed 123HSM Migration Reports 137HSM Type 105, 130HSM Volume Dump Reports 138HSM Volume Type 169HSM Write 38, 82Hwm 196HWM 162IBM Provided 96If ML1/SDSP 123Imbed 110In CSA 176In Mounted Volume Table 123In Use 83In Use By DS Migration 174Inactive Limit 134Index Enabled 129Index Levels 112Inserts 113Int Migration Timestamp 167Interval Date 70Interval Migration 124Issue HSM Commands 140Job Name 46, 71, 86, 130, 140, 141, 168, 176, 180, 186Job Number 46, 72, 86, 130, 141, 168, 176, 180, 186Journal Backup Status 137Kbytes Read 93, 99Kbytes Written 93, 99Key Length 31, 111, 154Key Position 110Keyword 186Last Automatic Backup Timestamp 123Last Automatic Dump Timestamp 123Last Backup 148Last File Sequence # 175Last Interval Migration Timestamp 124Last Referenced Date 77, 148Last Space Management Timestamp 123Last Updated (VSAM) 153Last Used Timestamp 153Level 120, 146Levels 95, 101Lib Auth 87List Status 136Load Location 87Log Data Sets 141

Index 319

attributes (continued)Log Migration Detail 142Log Recall Detail 144Low Thresh 171Low Threshold 124Lowest % of Free Space 55Lowest # of Free Cylinders 55Lowest Fragmentation Index 56Lspace Days 166Lspace Timestamp 166Lwm 195LWM 40, 162Management Class 43, 95, 101, 109Management Class Name 150, 157Max Backup Tasks 132Max Blocksize 153Max Copies 30Max CSA Usage 134Max Dump Tasks 132Max Interval Migration Tasks 133Max Migration Tasks 133Max MWEs 135Max Recall Tasks 132Max Recover Tasks 133Max Recycle Tasks 133Max Tape Recall Tasks 132Maximum Blocksize 31Maximum Lrecl 112MCDS Backup Status 137MCDS Details 147MCDS Volume Summary 151MCL Exists 159MCO Exists 158MCVT Address 131Message 28, 185Message Text 140Message Text (Cont) 140Migrate Convert Volser 174Migrate ML2 177Migrate Prefix 132Migrate Status 136Migrated 147Migrated Data Sets 151Migrated KB2 Bytes 150Migration Attempts 126Migration Copy Data Set Name 157Migration Data Set Size 70Migration Data Sets 70Migration Failures 126Migration Level 149, 152, 160Migration Required 169Migration Time 148, 197Migration Volser 152Migration Volser Device Type 156Migration Volser Device Type-Hex 156Migration Volume 148Migration Volumes 160Minimum Age 53, 164, 173, 195ML0 Volume 148ML1 Overflow 174ML1 Volume 76, 80Mod Auth 87Module Address 86Module Header 86Module Length 87more information 21Mounted Volumes 168

attributes (continued)Multi Volume 156Must Complete 121MWE Address 179MWE Entry Type 176MWE Queue Contents 175MWE Status 177new or changed 2New Tape Architecture 189Next Volume 191No Auto Migration 170No Auto Recall 161, 170No Command Migration 161, 170No Compression 73No Wait 176Node 26, 27, 28, 30, 35, 37, 42, 44, 45, 46, 47, 51, 54, 56, 65,

69, 71, 72, 75, 77, 82, 85, 88, 90, 96, 97, 102, 103, 104, 106,119, 122, 130, 137, 138, 140, 141, 142, 144, 147, 151, 160,168, 175, 180, 181, 184, 185, 186, 187, 189, 192, 193

Num 2k Blocks 79Num Owners 121Num Wait 119Number Backup Versions 33Number Extents 77, 114Number Of 16 Blks For Backup Version 157Number Of 2K Blocks 164Number of 2KB Blocks 88, 146Number Of ABACKUPs 64Number Of ABACKUPs Failed 64Number Of ABACKUPs ML2 Extra 64Number Of Abends 57Number Of Backup Recycled 60Number Of Backups 59Number Of Bytes Read 48, 67Number Of Bytes Written 49, 67Number Of Cylinders 163, 172Number Of Data Set Reconnnected 199Number Of Data Set Restores 63Number Of Data Set Restores Failed 63Number Of Data Sets 165Number Of Data Sets Migrated 125Number Of Data Sets Processed 48, 66Number Of Data Sets Reconnected 64Number Of Dump Copies Failed 61Number Of Dump Volumes 81Number Of Events 58Number Of Extent Reductions 63Number Of Failed Dumps 60Number Of Failing Requests 50, 67Number Of Gigabytes Read 50Number Of Gigabytes Written 50Number Of Int Met 197Number Of Int Migration 197Number Of Migrates 193Number Of Migration Recycled 60Number Of Migrations 59, 125Number Of MWEs 57Number Of Non-VSAM Data Set 194Number Of recalls 192Number Of Records 79Number Of Requests Initiated By System 51Number Of Restores 62, 198Number Of Restores Failed 63, 199Number Of Shutdowns 57Number Of Space N/A Migrations 59Number Of Starts 57Number Of Successful Recalls 58


attributes (continued)Number Of Successful Recovers 58Number Of System Migrates 194Number Of System Requests 68Number Of System-Requested Dump Copies 61Number Of System-Requested Dumps 60Number Of Tracks 165Number of Tracks Migrated 88Number Of Tracks Migrated 125Number Of Tracks Read 48, 66Number of Tracks Recalled 89Number Of Tracks Reconnected 65, 199Number Of Tracks Written 48, 66Number Of User Migrates 194Number Of User Reqeusts 67Number Of User-Requested Dump Copies 61Number Of User-Requested Dumps 60Number Of Valid Blocks 190Number Of Valid Data Sets 191Number Of Voluntary Requests 51Number Of VSAM Files 191Oam 196Object Name 181Object Status 182Object Type 181Obm 196Occurrences 45OCDS Backup Status 137On ML1 Volume 36On Tape 36Open 108Opt Blksz for 2k Blks 173overview 21Parm Value 186Password Protected 83Patch Active 180Patch Command 180Patches 180Percent Compressed 31, 152Percent Eligible 196Percent Free 53Percent Full 38Performance Object Status 181Plex ID 46, 130Plex Name 26, 30, 35, 38, 47, 57, 65, 69, 71, 73, 75, 78, 82,

85, 90, 97, 102, 103, 104, 106, 119, 122, 138, 139, 140, 141,152, 160, 168, 176, 180, 185, 187, 188, 189, 192, 193

Previous Volume 191Primary Allocation 108Primary Threshold 161Primary Volume 88Proc Count 54Processing Unit 174Product Release 28QCT Address 131QCT Element Address 131Query Name 181Queue Position 179RACF Group 91, 98, 178RACF Protected 83RCB Address 179Reason Code 28, 29, 91, 98, 143, 145Reason Code Message 29Reason ode 177Recall Attempts 126Recall Failures 126Recall Status 136

attributes (continued)Record Format 31, 95, 101, 154Records 112Recover Status 136Recycle Status 136Regional Share Options 107Release 130Rent Attr 87Replicate 110Report Status 136Request Date 92, 95, 99Request Jobname 120Request Number 91, 98, 177Request Priority 178Request QNAME 119Request System Name 120Request Time 92Request Timestamp 176Request Type 119Requestor Job Name 178Res Mode 86Reserve Count 174Reset 73Reset Option 78Restore Attempted 198Restore Failed 198Retired Dataset 36Retpd 73Retrieved 113Return Code 27, 29, 90, 97, 102, 142, 145, 177, 184Return Code Message 29Return Code of HSM Action 89Return Code Summary 184Reus Attr 87Reuse 107RLS Flag 46Run Time 146Scope 121SDSP 123, 150, 161, 170SDSP Data Set 152Secondary Allocation 108Secondary Allocation Amount 156Secondary Allocation Type 156Sequence Set RBA 117SETSYS Values 185Size In Kilobytes 32, 154Size In Tracks 32, 154Size Migrated 125SMF Number 131SMS Class 45SMS HSM Mounted Volume Reports 186SMS Managed 32, 37, 79, 123, 156, 166Source 45Source Device Type 84Source Device Type-Hex 84Source of Data 89Source Product 142Source Volser 84Source Volume 43Span 110Speed 107Start Date and Time 52Start Time 92, 99Status 72, 103, 120, 122, 130, 138, 139, 187Storage Class 43, 95, 101, 109Storage Class Name 150, 157Storage Group 122

Index 321

attributes (continued)Storage Group Name 178Stripe/Data Set 157SVRB Address 121System ID 46, 95, 101, 122, 130, 192System Name 26, 30, 35, 37, 47, 56, 65, 69, 71, 73, 75, 78,

82, 85, 90, 97, 102, 103, 104, 106, 119, 122, 138, 139, 140,141, 151, 160, 168, 175, 180, 185, 187, 188, 189, 192, 193

System Share Options 107System Timestamp 117Tape Copy Needed 187Tape Density 166, 174Tape Empty 161Tape Exit 83Tape Expire Date 81Tape No Update 161Tape Percent Full 164Tape Replace Status 136Tape Unavailable 161Tape Used 161Tape Volumes 189Tape Write 161TapeCopy Status 136TapeCopy Timestamp 188TapeDSN Recall Status 136TapeDSN Recover Status 136Target 96Task ID 179TCB Address 120, 179Thrashing Index 149Thrashing Report 192Time Last Backup 153Time Migrated 153Time Of Last DSR Log 59Time Recalled 155Time Requests In Queue 49, 68Time Requests Processed 49Time Requests Waited for Volume 49Time Requests Waiting For Volume Mount 68Times Dump In Process 62Times Dump In Volume Allocation Wait 62Times Dump Requests Queued 61Times Migrated 155Timestamp 26, 27, 29, 30, 35, 37, 42, 44, 45, 46, 47, 52, 54,

56, 65, 69, 71, 72, 75, 77, 82, 85, 88, 90, 96, 97, 102, 103,104, 106, 119, 122, 130, 137, 139, 140, 141, 142, 143, 144,145, 147, 151, 160, 168, 175, 180, 181, 184, 185, 186, 188,189, 192, 193

Timestamp Of First Backup 38Timestamp Of Last Backup 39Timestamp Of Last Cleaned 41Timestamp Of Last Migration 162Timestamp Of Last Spilled 41To Volume 91, 98, 146To Volume Serial 144Total Backup Versions 33Total Blocks 190Total Capacity 199Total Jobstep Time 58Total Space (Trks) 170Total Time Dump 62Total Time For Requests 50Total Tracks 39, 162Track Caching 128Track Length 40, 76, 80, 85, 159, 164, 172Tracks 52, 143, 145Tracks Backed Up 42

attributes (continued)Tracks Free 53, 124Tracks Occupied 149Tracks Per CA 117Tracks Per Cylinder 116, 163, 172Tracks Read 93, 99Tracks Written 93, 100TSO Request 94, 100, 176TSO TapeDsn Status 137TSO User 146Type 185Type File 141UCB Address 107, 169UCBLOOK Reason Code 107UCBLOOK Return Code 107Unique Keys 107Unit 44Unit Name 38, 74, 81, 82, 160, 170, 190, 197Unit Type 151Updates 113Use Count 87Use Volumes In Order 110Used CSA 134Used Percent 109, 135User Authorized 177User ID 27, 90, 97, 178, 192User Requested 94, 100User Volser 36, 155User Volser Device Type 155User Volser Device Type-Hex 155Valid Data Set 152Valid Dump 83Verify Command 180Version Number 32, 36, 42Version Size(2K Blks) 32, 154Volser 27, 38, 47, 66, 75, 78, 82, 105, 107, 122, 160, 169, 178,

188, 189, 194Volume Capacity 38Volume Full 38, 161Volume List 81Volume Sequence Number 169Volume Serial 44, 151Volume Serial Number 52, 54Volume Statistics Records 193Volume Type 38, 118, 160, 169, 188, 189, 194Volume Unavailable 82Volumes Available For Recall 156VSAM Data Set 36VSAM DSN 176VSAM Indicator 43, 149VSR Date 129VTOC Copies 75VTOC Copy 78VTOC Indexed 129Wait 94, 100Wait Exclusive 120Wait For Volume 177Wait Shared 120Write Check 110

Audit Status attribute 135Auto Backup attribute 123, 170Auto Backup Days attribute 167Auto Backup Status attribute 135Auto Backup Timestamp attribute 167Auto Dump attribute 124Auto Dump Date attribute 167Auto Dump Days attribute 167


Auto Dump Status attribute 135Auto Management attribute 123Auto Migration Status attribute 135Auto Prim Days attribute 167Auto Prim Timestamp attribute 166Auto Reuse attribute 73Average Lrecl attribute 109

BBackup Attempts attribute 127Backup Data Set Name attribute 105Backup Data Set Size attribute 70Backup Data Sets attribute 70Backup Data Sets attribute group 30Backup Data Sets workspace 17Backup Day attribute 174Backup Failures attribute 127Backup Frequency attribute 33Backup Prefix attribute 79, 131Backup Prefix Length attribute 79Backup Profile attribute 36Backup Status attribute 135Backup Timestamp attribute 43, 105Backup Version Data Set Name attribute 35Backup Versions attribute group 34Backup Volser attribute 30, 35Backup Volume attribute 43Backup Volumes attribute group 37Backup Volumes workspace 18BCDS Backup Status attribute 137BCDS Details


descriptions 12list 9

BCDS Details attribute group 42BCDS Details workspace 12BCDS Volume Summary



BCDS Volume Summary attribute group 44BCDS Volume Summary workspace 12Block Size attribute 115, 163, 171Blocks Per Track attribute 116BTSO attribute 146Buffer Size attribute 108built-in troubleshooting features 245Bytes Per Track attribute 116

CCA Percent Free Space attribute 111CA Splits attribute 114Cached attribute 128calculate historical data disk space 200Capacity attribute 190Capacity In Tracks attribute 124capacity planning

IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent 200

capacity planning for historical data 200Catalog Flag attribute 106Catalog Name attribute 105, 106

Cataloged attribute 36CDS SMS Class Summary



CDS SMS Class Summary attribute group 44CDS SMS Class Summary workspace 12changes

attribute groups, new 2attributes 2baroc file updated 2

CI Per CA attribute 111CI Percent Free Space attribute 111CI Size attribute 111CI Splits attribute 114Class Name attribute 45, 70Class Type attribute 70Cluster Type attribute 110Cmd Suffix attribute 131Command attribute 27, 29Command Initiation attribute 78Command Length attribute 140Command To Issue attribute 140commands, Take Action 229Compacted Data attribute 82Complete Time attribute 92, 99components 2Compressed attribute 79configuration 5Control Data Set Name attribute 106, 119Control Data Sets attribute group 45Control Data Sets workspace 15Count attribute 102, 104, 138, 139, 184, 187CPU Seconds attribute 144, 147Cpu Time .01 attribute 94, 100Creation Date attribute 26, 76, 148Current Occupancy attribute 124Cycle Date attribute 80Cylinders Free attribute 53

DDaily Function Statistics workspace 19Daily Function Stats attribute group 47Daily Space Management Detail



Daily Space Management Detail attribute group 51Daily Space Management Detail workspace 12Daily Space Management Summary



Daily Space Management Summary attribute group 54Daily Space Management Summary workspace 12, 13Daily Statistics attribute group 56Daily Statistics workspace 19Daily Volume Statistics workspace 19Daily Volume Stats attribute group 65DASD Fast Write attribute 128data

trace logs 245Data Class attribute 43, 109, 150

Index 323

Data Class Name attribute 157data logged


data provider logsSee agent

Data Set Count attribute 52Data Set Name attribute 26, 28, 30, 35, 42, 46, 76, 88, 89, 90,

97, 105, 141, 142, 144, 147, 152, 178, 192Data Set Number attribute 190Data Set Organization attribute 31, 77, 94, 100, 110, 153Data Set Restore attribute 73Date attribute 47, 57, 66, 194Date Backed Up attribute 31, 36Date Created attribute 152Date Interval For Class attribute 71Date Last Referenced attribute 33Date Migrated attribute 148Date Uncataloged attribute 33Day attribute 74Days Since Backed Up attribute 34, 37Days Since Backup attribute 105Days Since Created attribute 26, 158Days Since Cycle attribute 80Days Since Dump attribute 76, 78, 84Days Since First Backup attribute 39Days Since Last Backup attribute 39, 153Days Since Last Clean attribute 41Days Since Last Referenced attribute 34Days Since Last Spill attribute 41Days Since Last Used attribute 158Days Since Migrate attribute 162Days Since Migrated attribute 158Days Since Recalled attribute 159Days Since Tapecopy attribute 188Days Since Uncataloged attribute 34Days Since VSAM Last Used attribute 158Days Til Migrated attribute 155Days Till Expire attribute 81, 84Days Till Expired attribute 159DBA Days attribute 165Delete Attempts attribute 127Delete Days attribute 174Delete Failures attribute 127Deleted attribute 152Deletes attribute 113Density attribute 40, 83Description attribute 86, 96, 103, 104, 138, 139, 180, 186, 187Descriptive Type attribute 179Device Number attribute 121Device Type attribute 41, 76, 83, 118, 122, 163, 171Device type from UCB attribute 80Device Type from UCB attribute 83Device type of volume attribute 80Device Type-hex attribute 91Device Type-Hex attribute 76, 98, 118, 171Device Type(char) attribute 91Device Type(Char) attribute 98DFSMS Class Summary attribute group 69DFSMS Class Summary workspace 19DFSMShsm Collection Data



DFSMShsm Collection Data workspace 13DFSMShsm Functions attribute group 71

DFSMShsm Functions workspace 16DGN Key attribute 84disk capacity planning

See capacity planningdisk capacity planning for historical data 200Disposition attribute 74Disposition Length attribute 74documentation

See publicationsDual Copy attribute 128Dump Attempted attribute 198Dump Attempts attribute 128Dump Class attribute 73, 80, 83, 95, 101Dump Classes attribute group 72Dump Classes workspace 18Dump Copies attribute 198Dump Copies Failed attribute 198Dump Data Sets attribute group 75Dump Data Sets workspace 18Dump Date attribute 76Dump Failed attribute 198Dump Failures attribute 128Dump Status attribute 135Dump Timestamp attribute 78, 84Dump Versions attribute group 77Dump Versions workspace 18Dump Volumes attribute group 81Dump Volumes workspace 18

EECB Address attribute 121Elapsed Time attribute 52Elpased Time To Process Requests attribute 69End Date and Time attribute 52Entries Per Section attribute 117Entry Type attribute 106Entry Type Description attribute 106environment

features 1functions 1

Erase attribute 107Error Code attribute 182Esoteric Name attribute 44event

mapping 279EXCP Count attribute 114Exit Information attribute group 85Exit Information workspace 15Exit Name attribute 86Exit Status attribute 86Expiration Date attribute 77, 148, 156Expire Date attribute 74, 81, 84Expired Data Set attribute 37Extent Reduction Summary



Extent Reduction Summary attribute group 88Extent Reduction Summary workspace 13Extent Reductions attribute group 89Extent Type attribute 117Extents attribute 112


Ffeatures, IBM Tivoli Advanced Reporting for DFSMShsm

Monitoring Agent 1File Type attribute 46files

agent trace 246installation trace 246other trace log 246trace logs 245

Filter attribute 96Filter Attribute Group



Filter Attribute Group attribute group 95Filter Attribute Group workspace 14Filter ID attribute 96Fragmentation Index attribute 40, 53, 165, 173, 197Free Bytes attribute 116Free Space (Trks) attribute 170Free Tracks attribute 40, 163, 169, 195Frequency attribute 73From Volume attribute 91, 98, 146From Volume Serial attribute 143Full attribute 189Full VTOC attribute 170Function attribute 47, 66, 72Function code attribute 176Function Records attribute group 96Function Records workspace 13Function Summary attribute group 102Function Summary workspace 13functions, IBM Tivoli Advanced Reporting for DFSMShsm

Monitoring Agent 1

GGeneration Number attribute 35Guaranteed Backup Frequency attribute 173

HHBACKDS action 230HBDELETE action 231HCANCEL action 233HDELETE action 235Health Days attribute 129Health Limit attribute 129Health Reports



Health Reports workspace 14, 15High Allocated RBA attribute 109, 115High Level RBA attribute 115, 118High Thresh attribute 171High Threshold attribute 124High Used RBA attribute 108, 115Highest % of Free Space attribute 55Highest # of Free Cylinders attribute 55Highest Fragmentation Index attribute 56historical data

calculate disk space 200

historical data (continued)capacity planning

IBM Tivoli Advanced Reporting for DFSMShsmMonitoring Agent 200

disk capacity planning 200HMIGRATE action 236Host ASID attribute 131Host ID attribute 46, 72, 86, 95, 101, 130, 168, 176, 181, 186,

192Host Identifier attribute 140HRECALL action 237HRECOVER action 239HSM Action attribute 90, 97, 102HSM Backup Reports attribute group 103HSM Backup Reports workspace 14HSM CDS Backups attribute group 104HSM CDS Backups workspace 17HSM CDS Space attribute group 105HSM CDS Space workspace 17HSM CDS Users attribute group 118HSM CDS Users workspace 17HSM Health Detail Reports attribute group 121HSM Health Detail Reports workspace 14HSM Host Info attribute group 129HSM Host Information



HSM Host Information workspace 15HSM Managed attribute 123HSM Migration Reports attribute group 137HSM Migration Reports workspace 14HSM Type attribute 105, 130HSM Volume Dump Reports attribute group 138HSM Volume Dump Reports workspace 14HSM Volume Type attribute 169HSM Write attribute 38, 82Hwm attribute 196HWM attribute 162

IIBM Provided attribute 96IBM Software Support

See supportIBM Support Assistant 261IBM Tivoli Advanced Reporting for DFSMShsm



IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent

components 2features 1functions 1performance considerations 257

IBM Tivoli Advanced Reporting for DFSMShsmworkspace 11

IBM Tivoli Enterprise Consoleevent mapping 279

If ML1/SDSP attribute 123Imbed attribute 110In CSA attribute 176In Mounted Volume Table attribute 123In Use attribute 83

Index 325

In Use By DS Migration attribute 174Inactive Limit attribute 134Index Enabled attribute 129Index Levels attribute 112information

troubleshooting 245information, additional

attributes 21policies 243situations 203Take Action commands 229workspaces 9

Inserts attribute 113installation

log file 246problems 251silent 5

Int Migration Timestamp attribute 167interface, user 2Interval Date attribute 70Interval Migration attribute 124ISA 261Issue HSM Commands attribute group 139

JJob Name attribute 46, 71, 86, 130, 140, 141, 168, 176, 180, 186Job Number attribute 46, 72, 86, 130, 141, 168, 176, 180, 186Journal Backup Status attribute 137

KKbytes Read attribute 93, 99Kbytes Written attribute 93, 99Key Length attribute 31, 111, 154Key Position attribute 110Keyword attribute 186KRH_Backup_Held situation 226KRH_BCDS_Record_Not_Found situation 226KRH_Bkup_Failed_For_DSN situation 225KRH_Bkup_Funct_Disabled situation 225KRH_Cant_Mv_Bkup_Miss_Vol situation 221KRH_Cant_Recover_w_NewName situation 210KRH_Data_Set_In_Use situation 218, 222KRH_DS_Not_Elig_For_Bkup situation 223KRH_Duplicate_DSN_In_MCDS situation 217KRH_Error_Editing_CDS situation 207KRH_Existing_DS_Delete_Err situation 215KRH_Ext_Record_Missing situation 223KRH_Fail_In_Bkvol_Dump situation 227KRH_Insuff_Sp_On_Trg_Vol situation 209KRH_L0_Vol_Not_Available situation 219KRH_Mig_Copy_Already_Exist situation 218KRH_Mig_Vol_Not_Avail situation 207KRH_Migration_Held situation 220KRH_No_Mig_Vol_Available situation 217KRH_No_Pri_Vol_Avail situation 208, 213KRH_No_Space_In_Mig_Vol situation 219KRH_No_Space_On_Bkup_Vol situation 224KRH_No_Uni_Avail situation 214KRH_No_Unit_Avail situation 210KRH_No_Vol_For_Bkup situation 222KRH_Recall_Delete_Held situation 211, 215KRH_Recall_Recover_Error situation 212KRH_Recall_Recovery_Err situation 216KRH_Recover_Failed situation 211, 214

KRH_Request_Vol_Not_Avail situation 208KRH_Restore_Failed situation 212KRH_Unsupported_Data_Set situation 221, 227

LLast Automatic Backup Timestamp attribute 123Last Automatic Dump Timestamp attribute 123Last Backup attribute 148Last File Sequence # attribute 175Last Interval Migration Timestamp attribute 124Last Referenced Date attribute 77, 148Last Space Management Timestamp attribute 123Last Updated (VSAM) attribute 153Last Used Timestamp attribute 153legal notices 313Level attribute 120, 146Levels attribute 95, 101Lib Auth attribute 87library, IBM Tivoli Advanced Reporting for DFSMShsm

Monitoring Agent 309list of messages 262List Status attribute 136Load Location attribute 87Log Data Sets attribute group 141Log Data Sets workspace 15Log Migration Detail



Log Migration Detail attribute group 142Log Migration Detail workspace 16Log Recall Detail



Log Recall Detail attribute group 144Log Recall Detail workspace 16logged data


loggingagent trace logs 246built-in features 245installation log files 246trace log files 245

Low Thresh attribute 171Low Threshold attribute 124Lowest % of Free Space attribute 55Lowest # of Free Cylinders attribute 55Lowest Fragmentation Index attribute 56Lspace Days attribute 166Lspace Timestamp attribute 166Lwm attribute 195LWM attribute 40, 162

MManagement Class attribute 43, 95, 101, 109Management Class Name attribute 150, 157Max Backup Tasks attribute 132Max Blocksize attribute 153Max Copies attribute 30Max CSA Usage attribute 134


Max Dump Tasks attribute 132Max Interval Migration Tasks attribute 133Max Migration Tasks attribute 133Max MWEs attribute 135Max Recall Tasks attribute 132Max Recover Tasks attribute 133Max Recycle Tasks attribute 133Max Tape Recall Tasks attribute 132Maximum Blocksize attribute 31Maximum Lrecl attribute 112MCDS Backup Status attribute 137MCDS Details



MCDS Details attribute group 147MCDS Details workspace 16MCDS Volume Summary



MCDS Volume Summary attribute group 150MCDS Volume Summary workspace 16MCL Exists attribute 159MCO Exists attribute 158MCVT Address attribute 131Message attribute 28, 185Message Text (Cont) attribute 140Message Text attribute 140messages

built-in features 245for IBM Tivoli Advanced Reporting for DFSMShsm

Monitoring Agent 262for TEDA (Common Data Collection Agent) 262format 261overview 261syntax 261

Migrate Convert Volser attribute 174Migrate ML2 attribute 177Migrate Prefix attribute 132Migrate Status attribute 136Migrated attribute 147Migrated Data Sets attribute group 151Migrated Data Sets workspace 17Migrated KB2 Bytes attribute 150Migration Attempts attribute 126Migration Copy Data Set Name attribute 157Migration Data Set Size attribute 70Migration Data Sets attribute 70Migration Failures attribute 126Migration Level attribute 149, 152, 160Migration Required attribute 169Migration Time attribute 148, 197Migration Volser attribute 152Migration Volser Device Type attribute 156Migration Volser Device Type-Hex attribute 156Migration Volume attribute 148Migration Volumes attribute group 160Migration Volumes workspace 18Minimum Age attribute 53, 164, 173, 195ML0 Volume attribute 148ML1 Overflow attribute 174ML1 Volume attribute 76, 80Mod Auth attribute 87Module Address attribute 86

Module Header attribute 86Module Length attribute 87Mounted Volumes attribute group 168Mounted Volumes workspace 15Multi Volume attribute 156Must Complete attribute 121MWE Address attribute 179MWE Entry Type attribute 176MWE Queue Contents attribute group 175MWE Queue Contents workspace 15MWE Status attribute 177

Nnew attribute groups 2new or changed attributes 2New Tape Architecture attribute 189Next Volume attribute 191No Auto Migration attribute 170No Auto Recall attribute 161, 170No Command Migration attribute 161, 170No Compression attribute 73No Wait attribute 176Node attribute 26, 27, 28, 30, 35, 37, 42, 44, 45, 46, 47, 51, 54,

56, 65, 69, 71, 72, 75, 77, 82, 85, 88, 90, 96, 97, 102, 103, 104,106, 119, 122, 130, 137, 138, 140, 141, 142, 144, 147, 151, 160,168, 175, 180, 181, 184, 185, 186, 187, 189, 192, 193

Num 2k Blocks attribute 79Num Owners attribute 121Num Wait attribute 119Number Backup Versions attribute 33Number Extents attribute 77, 114Number Of 16 Blks For Backup Version attribute 157Number Of 2K Blocks attribute 164Number of 2KB Blocks attribute 88, 146Number Of ABACKUPs attribute 64Number Of ABACKUPs Failed attribute 64Number Of ABACKUPs ML2 Extra attribute 64Number Of Abends attribute 57Number Of Backup Recycled attribute 60Number Of Backups attribute 59Number Of Bytes Read attribute 48, 67Number Of Bytes Written attribute 49, 67Number Of Cylinders attribute 163, 172Number Of Data Set Reconnnected attribute 199Number Of Data Set Restores attribute 63Number Of Data Set Restores Failed attribute 63Number Of Data Sets attribute 165Number Of Data Sets Migrated attribute 125Number Of Data Sets Processed attribute 48, 66Number Of Data Sets Reconnected attribute 64Number Of Dump Copies Failed attribute 61Number Of Dump Volumes attribute 81Number Of Events attribute 58Number Of Extent Reductions attribute 63Number Of Failed Dumps attribute 60Number Of Failing Requests attribute 50, 67Number Of Gigabytes Read attribute 50Number Of Gigabytes Written attribute 50Number Of Int Met attribute 197Number Of Int Migration attribute 197Number Of Migrates attribute 193Number Of Migration Recycled attribute 60Number Of Migrations attribute 59, 125Number Of MWEs attribute 57Number Of Non-VSAM Data Set attribute 194Number Of recalls attribute 192

Index 327

Number Of Records attribute 79Number Of Requests Initiated By System attribute 51Number Of Restores attribute 62, 198Number Of Restores Failed attribute 63, 199Number Of Shutdowns attribute 57Number Of Space N/A Migrations attribute 59Number Of Starts attribute 57Number Of Successful Recalls attribute 58Number Of Successful Recovers attribute 58Number Of System Migrates attribute 194Number Of System Requests attribute 68Number Of System-Requested Dump Copies attribute 61Number Of System-Requested Dumps attribute 60Number Of Tracks attribute 165Number of Tracks Migrated attribute 88Number Of Tracks Migrated attribute 125Number Of Tracks Read attribute 48, 66Number of Tracks Recalled attribute 89Number Of Tracks Reconnected attribute 65, 199Number Of Tracks Written attribute 48, 66Number Of User Migrates attribute 194Number Of User Reqeusts attribute 67Number Of User-Requested Dump Copies attribute 61Number Of User-Requested Dumps attribute 60Number Of Valid Blocks attribute 190Number Of Valid Data Sets attribute 191Number Of Voluntary Requests attribute 51Number Of VSAM Files attribute 191

OOam attribute 196Object Name attribute 181Object Status attribute 182Object Type attribute 181Obm attribute 196Occurrences attribute 45OCDS Backup Status attribute 137On ML1 Volume attribute 36On Tape attribute 36OPAL documentation 310Open attribute 108Opt Blksz for 2k Blks attribute 173

PParm Value attribute 186Password Protected attribute 83Patch Active attribute 180Patch Command attribute 180Patches attribute group 179Patches workspace 16Percent Compressed attribute 31, 152Percent Eligible attribute 196Percent Free attribute 53Percent Full attribute 38performance considerations 257Performance Object Status attribute group 181Plex ID attribute 46, 130Plex Name attribute 26, 30, 35, 38, 47, 57, 65, 69, 71, 73, 75,

78, 82, 85, 90, 97, 102, 103, 104, 106, 119, 122, 138, 139, 140,141, 152, 160, 168, 176, 180, 185, 187, 188, 189, 192, 193

policiesmore information 243overview 243

Previous Volume attribute 191

Primary Allocation attribute 108Primary Threshold attribute 161Primary Volume attribute 88problems and workarounds 251Proc Count attribute 54Processing Unit attribute 174Product Release attribute 28publications


OPAL 310prerequisite 309Redbooks 310related 310Technotes 310types 309

purposestroubleshooting 245

QQCT Address attribute 131QCT Element Address attribute 131queries, using attributes 21Query Name attribute 181Queue Position attribute 179

RRACF Group attribute 91, 98, 178RACF Protected attribute 83RCB Address attribute 179Reason Code attribute 28, 29, 91, 98, 143, 145Reason Code Message attribute 29Reason ode attribute 177Recall Attempts attribute 126Recall Failures attribute 126Recall Status attribute 136Record Format attribute 31, 95, 101, 154Records attribute 112Recover Status attribute 136Recycle Status attribute 136Redbooks 310Regional Share Options attribute 107Release attribute 130remote deployment

troubleshooting 253Rent Attr attribute 87Replicate attribute 110Report Status attribute 136Reports From The CDSS



Reports From The CDSS workspace 17Request Date attribute 92, 95, 99Request Jobname attribute 120Request Number attribute 91, 98, 177Request Priority attribute 178Request QNAME attribute 119Request System Name attribute 120Request Time attribute 92Request Timestamp attribute 176Request Type attribute 119Requestor Job Name attribute 178


requirements 5Res Mode attribute 86Reserve Count attribute 174Reset attribute 73Reset Option attribute 78Restore Attempted attribute 198Restore Failed attribute 198Retired Dataset attribute 36Retpd attribute 73Retrieved attribute 113Return Code attribute 27, 29, 90, 97, 102, 142, 145, 177, 184Return Code Message attribute 29Return Code of HSM Action attribute 89Return Code Summary



Return Code Summary attribute group 184Return Code Summary workspace 19Reus Attr attribute 87Reuse attribute 107RLS Flag attribute 46Run Time attribute 146

SScope attribute 121SDSP attribute 123, 150, 161, 170SDSP Data Set attribute 152Secondary Allocation Amount attribute 156Secondary Allocation attribute 108Secondary Allocation Type attribute 156Sequence Set RBA attribute 117SETSYS Values attribute group 185SETSYS Values workspace 15silent installation 5situations

general troubleshooting 257, 258KRH_Backup_Held 226KRH_BCDS_Record_Not_Found 226KRH_Bkup_Failed_For_DSN 225KRH_Bkup_Funct_Disabled 225KRH_Cant_Mv_Bkup_Miss_Vol 221KRH_Cant_Recover_w_NewName 210KRH_Data_Set_In_Use 218, 222KRH_DS_Not_Elig_For_Bkup 223KRH_Duplicate_DSN_In_MCDS 217KRH_Error_Editing_CDS 207KRH_Existing_DS_Delete_Err 215KRH_Ext_Record_Missing 223KRH_Fail_In_Bkvol_Dump 227KRH_Insuff_Sp_On_Trg_Vol 209KRH_L0_Vol_Not_Available 219KRH_Mig_Copy_Already_Exist 218KRH_Mig_Vol_Not_Avail 207KRH_Migration_Held 220KRH_No_Mig_Vol_Available 217KRH_No_Pri_Vol_Avail 208, 213KRH_No_Space_In_Mig_Vol 219KRH_No_Space_On_Bkup_Vol 224KRH_No_Uni_Avail 214KRH_No_Unit_Avail 210KRH_No_Vol_For_Bkup 222KRH_Recall_Delete_Held 211, 215KRH_Recall_Recover_Error 212KRH_Recall_Recovery_Err 216

situations (continued)KRH_Recover_Failed 211, 214KRH_Request_Vol_Not_Avail 208KRH_Restore_Failed 212KRH_Unsupported_Data_Set 221, 227list of all 204, 205more information 203overview 203predefined 204

situations, using attributes 21Size In Kilobytes attribute 32, 154Size In Tracks attribute 32, 154Size Migrated attribute 125SMF Number attribute 131SMS Class attribute 45SMS HSM Mounted Volume Reports attribute group 186SMS HSM Mounted Volume Reports workspace 14SMS Managed attribute 32, 37, 79, 123, 156, 166Software Support 260Source attribute 45Source Device Type attribute 84Source Device Type-Hex attribute 84Source of Data attribute 89Source Product attribute 142Source Volser attribute 84Source Volume attribute 43Span attribute 110Speed attribute 107Start Date and Time attribute 52Start Time attribute 92, 99Status attribute 72, 103, 120, 122, 130, 138, 139, 187Storage Class attribute 43, 95, 101, 109Storage Class Name attribute 150, 157Storage Group attribute 122Storage Group Name attribute 178Stripe/Data Set attribute 157support

list of messages 262messages 261

support assistant 261SVRB Address attribute 121syntax

messages 261System ID attribute 46, 95, 101, 122, 130, 192System Name attribute 26, 30, 35, 37, 47, 56, 65, 69, 71, 73, 75,

78, 82, 85, 90, 97, 102, 103, 104, 106, 119, 122, 138, 139, 140,141, 151, 160, 168, 175, 180, 185, 187, 188, 189, 192, 193

System Share Options attribute 107System Timestamp attribute 117

TTake Action commands

HBACKDS 230HBDELETE 231HCANCEL 233HDELETE 235HMIGRATE 236HRECALL 237HRECOVER 239list of all 229more information 229overview 229predefined 229troubleshooting 260

Tape Copy Needed attribute group 187Tape Copy Needed workspace 18

Index 329

Tape Density attribute 166, 174Tape Empty attribute 161Tape Exit attribute 83Tape Expire Date attribute 81Tape No Update attribute 161Tape Percent Full attribute 164Tape Replace Status attribute 136Tape Unavailable attribute 161Tape Used attribute 161Tape Volumes attribute group 189Tape Volumes workspace 18Tape Write attribute 161TapeCopy Status attribute 136TapeCopy Timestamp attribute 188TapeDSN Recall Status attribute 136TapeDSN Recover Status attribute 136Target attribute 96Task ID attribute 179TCB Address attribute 120, 179Technotes 310Thrashing Index attribute 149Thrashing Report attribute group 191Thrashing Report workspace 13Time Last Backup attribute 153Time Migrated attribute 153Time Of Last DSR Log attribute 59Time Recalled attribute 155Time Requests In Queue attribute 49, 68Time Requests Processed attribute 49Time Requests Waited for Volume attribute 49Time Requests Waiting For Volume Mount attribute 68Times Dump In Process attribute 62Times Dump In Volume Allocation Wait attribute 62Times Dump Requests Queued attribute 61Times Migrated attribute 155Timestamp attribute 26, 27, 29, 30, 35, 37, 42, 44, 45, 46, 47,

52, 54, 56, 65, 69, 71, 72, 75, 77, 82, 85, 88, 90, 96, 97, 102, 103,104, 106, 119, 122, 130, 137, 139, 140, 141, 142, 143, 144, 145,147, 151, 160, 168, 175, 180, 181, 184, 185, 186, 188, 189, 192,193

Timestamp Of First Backup attribute 38Timestamp Of Last Backup attribute 39Timestamp Of Last Cleaned attribute 41Timestamp Of Last Migration attribute 162Timestamp Of Last Spilled attribute 41Tivoli Common Reporting

troubleshooting 260To Volume attribute 91, 98, 146To Volume Serial attribute 144Total Backup Versions attribute 33Total Blocks attribute 190Total Capacity attribute 199Total Jobstep Time attribute 58Total Space (Trks) attribute 170Total Time Dump attribute 62Total Time For Requests attribute 50Total Tracks attribute 39, 162trace logs 245Track Caching attribute 128Track Length attribute 40, 76, 80, 85, 159, 164, 172Tracks attribute 52, 143, 145Tracks Backed Up attribute 42Tracks Free attribute 53, 124Tracks Occupied attribute 149Tracks Per CA attribute 117Tracks Per Cylinder attribute 116, 163, 172Tracks Read attribute 93, 99

Tracks Written attribute 93, 100trademarks 314troubleshooting 245, 251

agents 254built-in features 245installation 251installation logs 246messages 261remote deployment 253situations 257, 258Take Action commands 260Tivoli Common Reporting 260uninstallation 251uninstallation logs 246workspaces 255

TSO Request attribute 94, 100, 176TSO TapeDsn Status attribute 137TSO User attribute 146Type attribute 185Type File attribute 141

UUCB Address attribute 107, 169UCBLOOK Reason Code attribute 107UCBLOOK Return Code attribute 107uninstallation

log file 246problems 251

Unique Keys attribute 107Unit attribute 44Unit Name attribute 38, 74, 81, 82, 160, 170, 190, 197Unit Type attribute 151Updates attribute 113Use Count attribute 87Use Volumes In Order attribute 110Used CSA attribute 134Used Percent attribute 109, 135User Authorized attribute 177User ID attribute 27, 90, 97, 178, 192user interfaces options 2User Requested attribute 94, 100User Volser attribute 36, 155User Volser Device Type attribute 155User Volser Device Type-Hex attribute 155

VValid Data Set attribute 152Valid Dump attribute 83Verify Command attribute 180Version Number attribute 32, 36, 42Version Size(2K Blks) attribute 32, 154views

Activity Logs workspace 16Advanced Reporting Event Information workspace 11Advanced Reporting Event Messages workspace 12Backup Data Sets workspace 17, 18Backup Volumes workspace 18BCDS Details workspace 12BCDS Volume Summary workspace 12CDS SMS Class Summary workspace 12Control Data Sets workspace 15Daily Function Statistics workspace 19Daily Space Management Detail workspace 12Daily Space Management Summary workspace 12, 13


views (continued)Daily Statistics workspace 19Daily Volume Statistics workspace 19DFSMS Class Summary workspace 19DFSMShsm Collection Data workspace 13DFSMShsm Function sworkspace 16Dump Classes workspace 18Dump Versions workspace 18Dump volumes workspace 18Exit Information workspace 15Extent Reduction Summary workspace 13Filter Attribute Group workspace 14Function Records workspace 13Function Summary workspace 13Health Reports workspace 14, 15HSM Backup Reports workspace 14HSM CDS Backups workspace 17HSM CDS Space workspace 17HSM CDS Users workspace 17HSM Health Detail Reports workspace 14HSM Host Information workspace 15HSM Migration Reports workspace 14HSM Volume Dump Reports workspace 14IBM Tivoli Advanced Reporting for DFSMShsm

workspace 11Log Data Sets workspace 15Log Migration Detail workspace 16Log Recall Detail workspace 16MCDS Details workspace 16MCDS Volume Summary workspace 16Migrated Data Sets workspace 17Migration Volumes workspace 18Mounted Volumes workspace 15MWE Queue workspace 15Patches workspace 16Reports From The CDSS workspace 17Return Code Summary workspace 19SETSYS Values workspace 15SMS HSM Mounted Volume Reports workspace 14Tape Copy Needed workspace 18Tape Volumes workspace 18Thrashing Report workspace 13Volume Statistics Records workspace 19

Volser attribute 27, 38, 47, 66, 75, 78, 82, 105, 107, 122, 160,169, 178, 188, 189, 194

Volume Capacity attribute 38Volume Full attribute 38, 161Volume List attribute 81Volume Sequence Number attribute 169Volume Serial attribute 44, 151Volume Serial Number attribute 52, 54Volume Statistics Records attribute group 193Volume Statistics Records workspace 19Volume Type attribute 38, 118, 160, 169, 188, 189, 194Volume Unavailable attribute 82Volumes Available For Recall attribute 156VSAM Data Set attribute 36VSAM DSN attribute 176VSAM Indicator attribute 43, 149VSR Date attribute 129VTOC Copies attribute 75VTOC Copy attribute 78VTOC Indexed attribute 129

WWait attribute 94, 100Wait Exclusive attribute 120Wait For Volume attribute 177Wait Shared attribute 120workarounds 251

agents 254remote deployment 253situations 257Take Action commands 260Tivoli Common Reporting 260workspaces 255

workspacesActivity Logs 16Advanced Reporting Event Data 11Advanced Reporting Event Information 11Advanced Reporting Event Messages 12Backup Data Sets workspace 17Backup Volumes workspace 18BCDS Details 12BCDS Volume Summary 12CDS SMS Class Summary 12Control Data Sets 15Daily Function Statistics workspace 19Daily Space Management Detail 12Daily Space Management Summary 12, 13Daily Statistics workspace 19Daily Volume Statistics workspace 19DFSMS Class Summary workspace 19DFSMShsm Collection Data 13DFSMShsm Functions 16Dump Classes workspace 18Dump Data Sets workspace 18Dump Versions workspace 18Dump Volumes workspace 18Exit Information 15Extent Reduction Summary 13Filter Attribute Group 14Function Records 13Function Summary 13Health Reports 14, 15HSM Backup Reports 14HSM CDS Backups workspace 17HSM CDS Space workspace 17HSM CDS Users workspace 17HSM Health Detail Reports 14HSM Host Information 15HSM Migration Reports 14HSM Volume Dump Reports 14IBM Tivoli Advanced Reporting for DFSMShsm 11list of all 9Log Data Sets 15Log Migration Detail 16Log Recall Detail 16MCDS Details 16MCDS Volume Summary 16Migrated Data Sets workspace 17Migration Volumes workspace 18more information 9Mounted Volumes 15MWE Queue Contents 15overview 9Patches 16predefined 9Reports From The CDSS 17Return Code Summary 19SETSYS Values 15

Index 331

workspaces (continued)SMS HSM Mounted Volume Reports 14Tape Copy Needed workspace 18Tape Volumes workspace 18Thrashing Report 13troubleshooting 255Volume Statistics Records workspace 19

Write Check attribute 110


��

Printed in USA

SC27-2352-01

Documents

IBM Tivoli Advanced Reporting for DFSMShsm …publib.boulder.ibm.com/tividd/td/TARfDFSM/SC27-2352-01/en_US/PDF… · ® IBMTivoliAdvanced Reporting for DFSMShsm Monitoring Agent