ibm tivoli advanced reporting for dfsmshsm...
TRANSCRIPT
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
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
© Copyright IBM Corp. 2008 5
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.
6 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
© Copyright IBM Corp. 2008 9
– 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
10 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
This workspace contains the following view:
Advanced Reporting Event MessagesAdvanced Reporting Event Message details.
BCDS Details Navigator itemBCDS Details workspace
BCDS Detail workspace showing the details
This workspace contains the following view:
BCDS DetailDetails for BCDS.
BCDS Volume Summary Navigator itemBCDS Volume Summary workspace
The BCDS Volume Summary workspace provides volume summaryinformation for the BCDS.
This workspace contains the following view:
BCDS Volume SummaryBCDS volume summary.
CDS SMS Class Summary Navigator itemCDS SMS Class Summary workspace
CDS Summary by SMS Class workspace showing the summary
This workspace contains the following view:
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
This workspace contains the following view:
Daily Space Management SummaryDaily Space Management Summary.
Daily Space Management Summary workspaceThe Daily Space Management Summary workspace provides detailinformation for the daily space management.
This workspace contains the following view:
Daily Space Management SummaryDaily Space Management Summary.
12 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Daily Space Management Summary Navigator itemDaily Space Management Summary workspace
The Daily Space Management Summary workspace provides detailinformation for the daily space management.
This workspace contains the following view:
Daily Space Management SummaryDaily space management summary.
DFSMShsm Collection Data Navigator itemDFSMShsm Collection Data workspace
DFSMShsm Collection Data workspace showing reports on DFSMShsmActivity
This workspace contains the following view:
DFSMShsm CollectionDFSMShsm Collection.
Thrashing Report workspaceThrashing Report workspace shows information about migration/recallthrashing activity.
This workspace contains the following view:
Migration/Recall ThrashingShows information about migration/recall thrashing activity.
Function Summary workspaceFunction Summary workspace shows a summarization of DFSMShsmfunction activity.
This workspace contains the following view:
Function SummaryShows a summarization of DFSMShsm function activity.
Function Records workspaceThrashing Report workspace shows detailed information about functionactivity.
This workspace contains the following view:
Function Activity DetailsShows detailed information about function activity.
Extent Reduction workspaceExtent Reduction workspace shows information about extent reductionactivity.
This workspace contains the following view:
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.
This workspace contains the following view:
Chapter 3. Workspaces reference 13
Extent Reduction SummaryExtent reduction summary.
Filter Attribute Group Navigator itemFilter Attribute Group workspace
Filter Attribute Group workspace showing the available filters
This workspace contains the following view:
Filter Attribute GroupFilter Attribute Group.
Health Reports Navigator itemHealth Reports workspace
Health Reports workspace showing reports on DFSMShsm health
This workspace contains the following view:
Health ReportsHealth Reports.
SMS HSM Mounted Volume Reports workspaceSMS HSM Mounted Volume Reports workspace showing summaryinformation for the mounted volumes.
This workspace contains the following view:
SMS HSM Mounted Volume ReportsShows summary information for mounted volumes.
HSM Migration Reports workspaceHSM Migration Reports workspace showing a summary of migrationstatus
This workspace contains the following view:
HSM Migration ReportsShows a summary of migration status.
HSM Backup Reports workspaceHSM Backup Reports workspace showing a summary of backup activity.
This workspace contains the following view:
HSM Backup ReportsShows a summary of backup activity.
HSM Volume Dump Reports workspaceHSM Volume Dump Reports workspace showing a summary of volumedump activity.
This workspace contains the following view:
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.
This workspace contains the following view:
HSM Health Detail ReportsShows detailed health information for specific volumes.
14 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Health Reports workspaceHealth Reports workspace showing summary information for the mountedvolumes.
This workspace contains the following view:
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
This workspace contains the following view:
HSM Host InformationLists active HSM hosts.
Control Data Sets workspaceControl Data Sets workspace shows a list of the HSM control data sets.
This workspace contains the following view:
Control Data SetsLists the HSM control data sets.
Log Data Sets workspaceLog Data Sets workspace showing a list of HSM ARCLOG data sets.
This workspace contains the following view:
Log Data SetsShows a list of HSM ARCLOG data sets.
Mounted Volumes workspaceMounted Volumes workspace showing a list of volumes used in HSMprocessing.
This workspace contains the following view:
Mounted VolumesShows a list of volumes used in HSM processing.
MWE Queue Contents workspaceMWE Queue Contents workspace showing current HSM work elements.
This workspace contains the following view:
MWE Queue ContentsShows current HSM work elements.
SETSYS Values workspaceSETSYS Values workspace showing current SETSYS processing values.
This workspace contains the following view:
SETSYS ValuesShows current SETSYS processing values.
Exit Information workspaceExit Information workspace showing a list of HSM exits in use.
This workspace contains the following view:
Chapter 3. Workspaces reference 15
Exit InformationShows a list of HSM exits in use.
Patches workspacePatches workspace showing a list of patches available to DFSMShsm.
This workspace contains the following view:
PatchesShows a list of patches available to DFSMShsm.
Activity Logs workspaceActivity Logs workspace showing a list of DFSMShsm activity logs.
This workspace contains the following view:
Activity LogsShows a list of DFSMShsm activity logs.
DFSMShsm Functions workspaceDFSMShsm Functions workspace showing status information for a list ofDFSMShsm functions.
This workspace contains the following view:
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
This workspace contains the following view:
Log migration detailLog migration detail.
Log Recall Detail Navigator itemLog Recall Detail workspace
Log Recall Detail workspace showing the details
This workspace contains the following view:
Log Recall DetailDetail of recall log.
MCDS Details Navigator itemMCDS Details workspace
The MCDS Details workspace provides detail information for the MCDS.
This workspace contains the following view:
MCDS DetailMCDS details.
MCDS Volume Summary Navigator itemMCDS Volume Summary workspace
The MCDS Volume Summary workspace provides volume summaryinformation for the MCDS.
16 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
This workspace contains the following view:
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
This workspace contains the following view:
Reports From The CDSSReports From The CDSS.
HSM CDS Users workspaceHSM CDS Users workspace shows information from DFSMShsm ControlData Sets.
This workspace contains the following view:
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.
This workspace contains the following view:
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.
This workspace contains the following view:
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.
This workspace contains the following view:
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.
This workspace contains the following view:
Backup Data SetsShows data set-level backup information from DFSMShsmControl Data Sets.
Chapter 3. Workspaces reference 17
Dump Data Sets workspaceDump Data Sets workspace shows information about the data setson dump volumes.
This workspace contains the following view:
Dump Data SetsShows information about the data sets on dump volumes.
Migration Volumes workspaceMigration Volumes workspace shows information about thevolumes used in MIGRATE commands.
This workspace contains the following view:
Migration VolumesShows information about the volumes used in MIGRATEcommands.
Backup Volumes workspaceBackup Volumes workspace shows information about volumescontaining backup data.
This workspace contains the following view:
Backup VolumesShows information about the volumes containing backupdata.
Dump Volumes workspaceDump Volumes workspace contains volume dump copies.
This workspace contains the following view:
Dump VolumesContains volume dump copies.
Dump Versions workspaceDump Versions workspace lists versions of dump copies.
This workspace contains the following view:
Dump VersionsLists versions of dump copies.
Tape Volumes workspaceTape Volumes workspace shows tape volume information.
This workspace contains the following view:
Tape VolumesShows tape volume information.
Tape Copy Needed workspaceTape Copy Needed workspace shows information about tapevolumes that need updating.
This workspace contains the following view:
Tape Copy NeededShows information about tape volumes that need updating.
Dump Classes workspaceDump Classes workspace shows information about dump classesand their attributes.
This workspace contains the following view:
18 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Dump ClassesShows information about dump classes and their attributes.
Daily Statistics workspaceDaily Statistics workspace shows the daily statistics kept by HSM.
This workspace contains the following view:
Daily StatisticsShows daily statistics kept by HSM.
Daily Function Statistics workspaceDaily Function Statistics workspace shows the daily statistics forfunctions.
This workspace contains the following view:
Daily Function StatisticsShows the daily statistics for functions.
Volume Statistics Records workspaceVolume Statistics Records workspace shows statistics records forvolumes.
This workspace contains the following view:
Volume Statistics RecordsShows statistics records for volumes.
Daily Volume Statistics workspaceDaily Volume Statistics workspace shows volume statistics byfunction.
This workspace contains the following view:
Daily Volume StatisticsShows volume statistics by function.
DFSMS Class Summary workspaceDFSMS Class Summary workspace shows a summary of DFSMSclasses.
This workspace contains the following view:
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.
This workspace contains the following view:
Return Code SummaryReturn code summary.
Chapter 3. Workspaces reference 19
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
© Copyright IBM Corp. 2008 21
– 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
22 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
– 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
24 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 4. Attributes reference 25
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)
26 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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 AdvancedReporting Event Data attribute 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
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.
Chapter 4. Attributes reference 27
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.
Reason Code attribute
DescriptionReason 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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Data Set Name attribute
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.
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 AdvancedReporting Messages attribute group:
Node attribute - This attribute is a key attribute.
28 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionThe managed system name of the agent.
Type String
Timestamp attribute
DescriptionThe local time at the agent when the data was collected.
Type String
Command attribute - This attribute is a key attribute.
DescriptionCommand issued.
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Reason Code attribute
DescriptionReason 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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Return Code Message attribute
DescriptionMessage for the associated Return Code.
Type String
Reason Code Message attribute
DescriptionMessage for the associated Reason Code.
Type String
Chapter 4. Attributes reference 29
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.
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 Backup DataSets attribute 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
DescriptionDataset name
Type String
Backup Volser attribute
DescriptionVolser
Type String
Max Copies attribute
DescriptionMax backup copies
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)
30 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Date Backed Up attribute
DescriptionDate backup was made
Type Timestamp
Data Set Organization attribute
DescriptionDataset organization
Type String
Maximum Blocksize attribute
DescriptionMaximum blocksize
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.
Key Length attribute
DescriptionKey length
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.
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:
Chapter 4. Attributes reference 31
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.
Size In Tracks attribute
DescriptionTracks on user volume
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.
Size In Kilobytes attribute
DescriptionKbytes on user volume
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.
Version Size(2K Blks) attribute
DescriptionSize of curr version in 2k blks
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.
SMS Managed attribute
DescriptionSMS managed
Type String
Version Number attribute
DescriptionCurrent version
Type Integer (Counter) with enumerated values. The strings are
32 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Number Backup Versions attribute
DescriptionNumber of backup versions
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.
Total Backup Versions attribute
DescriptionTotal number of backup versions
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.
Backup Frequency attribute
DescriptionBackup frequency in days
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.
Date Last Referenced attribute
DescriptionDate last referenced
Type String
Date Uncataloged attribute
Chapter 4. Attributes reference 33
DescriptionDate uncataloged
Type String
Days Since Backed Up attribute
DescriptionDays since backed up
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.
Days Since Last Referenced attribute
DescriptionDays since last referenced
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.
Days Since Uncataloged attribute
DescriptionDays since uncataloged
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.
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
34 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Attribute descriptionsThe following list contains information about each attribute in the Backup Versionsattribute 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
DescriptionDataset name
Type String
Backup Volser attribute
DescriptionBackup volser
Type String
Generation Number attribute
DescriptionGeneration number
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.
Backup Version Data Set Name attribute
DescriptionBackup dsname
Type String
Chapter 4. Attributes reference 35
User Volser attribute
DescriptionUser volser
Type String
Date Backed Up attribute
DescriptionDate backup version was made
Type String
Version Number attribute
DescriptionVersion number
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.
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
36 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
SMS Managed attribute
DescriptionVersion is SMS managed
Type String
Expired Data Set attribute
DescriptionExpired dataset
Type String
Days Since Backed Up attribute
DescriptionDays since backed up
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.
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.
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 Backup Volumesattribute 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
Chapter 4. Attributes reference 37
Type String
Plex Name attribute
DescriptionPlex\Name
Type String
Volser attribute
DescriptionVolume serial number
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
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.
Timestamp Of First Backup attribute
38 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionTimestamp of first backup
Type Timestamp
Days Since First Backup attribute
DescriptionDays since first backup
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.
Timestamp Of Last Backup attribute
DescriptionTimestamp of last backup
Type Timestamp
Days Since Last Backup attribute
DescriptionDays since last backup
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.
Alternate Volume attribute
DescriptionAlternate volume
Type String
Total Tracks attribute
DescriptionTotal tracks
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.
Chapter 4. Attributes reference 39
Free Tracks attribute
DescriptionFree tracks
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.
Track Length attribute
DescriptionTrack length
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.
LWM attribute
DescriptionLwm
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.
Fragmentation Index attribute
DescriptionFragmentation index
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.
Density attribute
40 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionDensity
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.
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
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.
Timestamp Of Last Cleaned attribute
DescriptionTimestamp of last cleaned
Type Timestamp
Days Since Last Clean attribute
DescriptionDays since last clean
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.
Chapter 4. Attributes reference 41
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.
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 BCDS Detailsattribute 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
Data Set Name attribute - This attribute is a key attribute.
DescriptionData set name.
Type String
Tracks Backed Up attribute
DescriptionNumber of tracks backed up.
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.
Version Number attribute
DescriptionThe version number of this backup copy.
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)
42 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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
Chapter 4. Attributes reference 43
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.
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 BCDS VolumeSummary attribute 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
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
44 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Attribute descriptionsThe following list contains information about each attribute in the CDS SMS ClassSummary attribute 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
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.
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.
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
Chapter 4. Attributes reference 45
Attribute descriptionsThe following list contains information about each attribute in the Control DataSets attribute 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 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
Data Set Name attribute
DescriptionDataset name to use
Type String
RLS Flag attribute
DescriptionRLS flag
Type String
File Type attribute
46 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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 Daily FunctionStats attribute 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
Date attribute
DescriptionConverted Date
Type String
Function attribute
DescriptionFull function name
Chapter 4. Attributes reference 47
Type String
Number Of Data Sets Processed attribute
DescriptionNum non-VSAM DSs processed
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.
Number Of Tracks Read attribute
DescriptionNum tracks read
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.
Number Of Tracks Written attribute
DescriptionNum tracks written
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.
Number Of Bytes Read attribute
DescriptionNum bytes read below 1 gigabyte
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.
48 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Number Of Bytes Written attribute
DescriptionNum bytes written below 1 gigabyte
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.
Age Of Data Sets Processed attribute
DescriptionAge of the DSs processed
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.
Time Requests In Queue attribute
DescriptionTime in queue before processing
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.
Time Requests Waited for Volume attribute
DescriptionTime in queue waiting for vol mounts
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.
Time Requests Processed attribute
Chapter 4. Attributes reference 49
DescriptionNum elpsd time to process requests
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.
Total Time For Requests attribute
DescriptionTotal time for requests
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.
Number Of Gigabytes Read attribute
DescriptionNum of gigabytes read
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.
Number Of Gigabytes Written attribute
DescriptionNum of gigabytes written
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.
Number Of Failing Requests attribute
DescriptionNum failing requests
50 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Number Of Voluntary Requests attribute
DescriptionNum voluntary requests initd by user
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.
Number Of Requests Initiated By System attribute
DescriptionNum requests initiated by the system
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.
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.
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 Daily SpaceManagement Detail attribute group:
Node attribute - This attribute is a key attribute.
DescriptionThe managed system name of the agent.
Chapter 4. Attributes reference 51
Type String
Timestamp attribute
DescriptionThe local time at the agent when the data was collected.
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.
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.
Tracks attribute
DescriptionNumber of tracks freed by HSM.
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.
52 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Minimum Age attribute
DescriptionMinimum age of data sets.
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.
Percent Free attribute
DescriptionPercent free space on volume.
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.
Tracks Free attribute
DescriptionNumber of free tracks on volume.
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.
Cylinders Free attribute
DescriptionNumber of free cylinders on volume.
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.
Fragmentation Index attribute
Chapter 4. Attributes reference 53
DescriptionFragmentation index.
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.
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.
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 Daily SpaceManagement Summary attribute 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
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.
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)
54 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Highest % of Free Space attribute
DescriptionHighest percentage of free space found on this volume.
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.
Lowest % of Free Space attribute
DescriptionLowest percentage of free space found on this volume.
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.
Highest # of Free Cylinders attribute
DescriptionHighest number of free cylinders found on this volume.
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.
Lowest # of Free Cylinders attribute
DescriptionLowest number of free cylinders found on this volume.
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.
Chapter 4. Attributes reference 55
Highest Fragmentation Index attribute
DescriptionHighest fragmentation index for this volume.
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.
Lowest Fragmentation Index attribute
DescriptionLowest fragmentation index for this volume.
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.
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.
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 Daily Statisticsattribute 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
56 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
Plex Name attribute
DescriptionPlex\Name
Type String
Date attribute
DescriptionDate for record
Type String
Number Of Starts attribute
DescriptionNum HSM Startups this day
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.
Number Of Abends attribute
DescriptionNum DFSMShsm subtask abends
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.
Number Of Shutdowns attribute
DescriptionNum DFSMShsm shutdowns this day
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.
Number Of MWEs attribute
Chapter 4. Attributes reference 57
DescriptionNum management work elements (SVC)
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.
Number Of Successful Recalls attribute
DescriptionNum times Recall was satisfied
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.
Number Of Successful Recovers attribute
DescriptionNum times Recover was satisfied
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.
Total Jobstep Time attribute
DescriptionTotal elapsed Jobstep time - in mss
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.
Number Of Events attribute
DescriptionEvent count for writing DSR to SMF
58 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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
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.
Number Of Space N/A Migrations attribute
DescriptionNum vol migrations forced because space was N/A
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.
Number Of Backups attribute
DescriptionNum volumes backed up
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.
Chapter 4. Attributes reference 59
Number Of Backup Recycled attribute
DescriptionNum tape backup volumes recycled this day
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.
Number Of Migration Recycled attribute
DescriptionNum tape migration level 2 volumes recycled today
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.
Number Of System-Requested Dumps attribute
DescriptionNum system-requested volume dumps
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.
Number Of User-Requested Dumps attribute
DescriptionNum user-requested volume dumps
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.
Number Of Failed Dumps attribute
60 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNum volume dumps that failed
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.
Number Of System-Requested Dump Copies attribute
DescriptionNum system-requested dump copies
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.
Number Of User-Requested Dump Copies attribute
DescriptionNum user-requested dump copies
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.
Number Of Dump Copies Failed attribute
DescriptionNum dump copies that failed
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.
Times Dump Requests Queued attribute
DescriptionNum of dump requests waited in queue
Chapter 4. Attributes reference 61
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.
Times Dump In Volume Allocation Wait attribute
DescriptionNum of dump requests waited for volume allocation
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.
Times Dump In Process attribute
DescriptionTime dump request took to process
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.
Total Time Dump attribute
DescriptionTot. elpsd time for all dump requests 2be process
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.
Number Of Restores attribute
DescriptionNum volume restores requested
Type Integer (Counter) with enumerated values. The strings are
62 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Number Of Restores Failed attribute
DescriptionNum volume restores that failed
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.
Number Of Data Set Restores attribute
DescriptionNum data set restores requested
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.
Number Of Data Set Restores Failed attribute
DescriptionNum data set restores that failed
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.
Number Of Extent Reductions attribute
DescriptionNum extent reductions
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 63
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Number Of ABACKUPs attribute
DescriptionNum ABACKUPs requested
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.
Number Of ABACKUPs Failed attribute
DescriptionNum ABACKUPs that failed
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.
Number Of ABACKUPs ML2 Extra attribute
DescriptionNum extra ML2 vols mounts by ABACKUP (rcl takeaway)
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.
Number Of Data Sets Reconnected attribute
DescriptionNum data sets reconnected
Type Integer (Counter) with enumerated values. The strings are
64 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Number Of Tracks Reconnected attribute
DescriptionNum tracks reconnected to tape
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.
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.
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 Daily VolumeStats attribute 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
Chapter 4. Attributes reference 65
DescriptionPlex\Name
Type String
Volser attribute
DescriptionVolume serial number
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
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.
Number Of Tracks Read attribute
DescriptionNum tracks read
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.
Number Of Tracks Written attribute
66 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNum tracks written
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.
Number Of Bytes Read attribute
DescriptionNum bytes read below 1 gigabyte
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.
Number Of Bytes Written attribute
DescriptionNum bytes written below 1 gigabyte
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.
Number Of Failing Requests attribute
DescriptionNum failing requests
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.
Number Of User Reqeusts attribute
DescriptionNum vol requests initd by user
Chapter 4. Attributes reference 67
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.
Number Of System Requests attribute
DescriptionNum requests initiated by the sys
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.
Age Of Data Sets Processed attribute
DescriptionAge of the DSs processed
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.
Time Requests In Queue attribute
DescriptionTime in queue before processing
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.
Time Requests Waiting For Volume Mount attribute
DescriptionTime queue waiting for vol mnt
Type Integer (Counter) with enumerated values. The strings are
68 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Elpased Time To Process Requests attribute
DescriptionNum elpsd time to process requests
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.
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.
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 DFSMS ClassSummary attribute 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
Chapter 4. Attributes reference 69
DescriptionPlex\Name
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
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.
Migration Data Sets attribute
DescriptionMigration data sets
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.
Backup Data Set Size attribute
DescriptionBackup data set size
Type String
Migration Data Set Size attribute
70 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionMigration data set size
Type String
Date Interval For Class attribute
DescriptionDate interval for particular class
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.
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.
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 DFSMShsmFunctions attribute 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
Job Name attribute
Chapter 4. Attributes reference 71
DescriptionTask using DSN
Type String
Job Number attribute
DescriptionTask job number
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.
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 Dump Classesattribute 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.
72 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
System Name attribute
DescriptionSystem\Name
Type String
Plex Name attribute
DescriptionPlex\Name
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
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.
Retpd attribute
Chapter 4. Attributes reference 73
DescriptionRETPD
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.
Day attribute
DescriptionDAY
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.
Unit Name attribute
DescriptionUNIT
Type String
Disposition attribute
DescriptionDISPOSITION
Type String
Disposition Length attribute
DescriptionDISPOSITION length
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.
Expire Date attribute
DescriptionExpiration date
Type String
74 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
VTOC Copies attribute
DescriptionVTOCCOPIES
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.
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.
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 Dump Data Setsattribute 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
Volser attribute
DescriptionVolume serial number
Type String
Chapter 4. Attributes reference 75
Dump Date attribute
DescriptionDump date
Type Timestamp
Days Since Dump attribute
DescriptionDays since dump 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.
Device Type-Hex attribute
DescriptionDevice type from UCB
Type String
Device Type attribute
DescriptionDevice type of volume in hex
Type String
Track Length attribute
DescriptionTrack length (for HRMAU030 call)
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.
ML1 Volume attribute
DescriptionML1 volume where VTOC copy is
Type String
Data Set Name attribute
DescriptionDS name from VTOC copy
Type String
Creation Date attribute
76 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
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.
Data Set Organization attribute
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.
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 Dump Versionsattribute group:
Node attribute - This attribute is a key attribute.
DescriptionThe managed system name of the agent.
Type String
Timestamp attribute
Chapter 4. Attributes reference 77
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
Volser attribute
DescriptionVolume serial number
Type String
Dump Timestamp attribute
DescriptionDump time
Type Timestamp
Days Since Dump attribute
DescriptionDays since dump 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.
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
78 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
SMS Managed attribute
DescriptionDump generation is SMS managed
Type String
Compressed attribute
DescriptionVolume is compressed
Type String
Num 2k Blocks attribute
DescriptionNum 2k blocks Vtoc copy occupies
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.
Number Of Records attribute
DescriptionNum records in VTOC copy
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.
Backup Prefix attribute
DescriptionBackup prefix
Type String
Backup Prefix Length attribute
DescriptionBackup prefix length
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)
Chapter 4. Attributes reference 79
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
ML1 Volume attribute
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
Track Length attribute
DescriptionTrack length
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.
Cycle Date attribute
DescriptionCycle date when dump began
Type String
Days Since Cycle attribute
DescriptionNum days since cycle date
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.
Dump Class attribute
DescriptionDump class
80 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
Unit Name attribute
DescriptionUnit name
Type String
Expire Date attribute
DescriptionVolume expiration date
Type String
Days Till Expire attribute
DescriptionDays till expiration
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.
Tape Expire Date attribute
DescriptionTape expiration date
Type String
Number Of Dump Volumes attribute
DescriptionNum dump volumes containing dump
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.
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.
Chapter 4. Attributes reference 81
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 Dump Volumesattribute 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
Volser attribute
DescriptionVolume serial number
Type String
Unit Name attribute
DescriptionUnit name
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
82 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Device Type attribute
DescriptionDevice type of volume
Type String
Density attribute
DescriptionDensity of tape
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.
Dump Class attribute
Chapter 4. Attributes reference 83
DescriptionDump class
Type String
Expire Date attribute
DescriptionVolume expiration date
Type String
Days Till Expire attribute
DescriptionDays till expiration
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.
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
Days Since Dump attribute
DescriptionDays since dump created
Type Integer (Counter) with enumerated values. The strings are
84 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Track Length attribute
DescriptionTrack length
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.
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.
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 Exit Informationattribute 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
Chapter 4. Attributes reference 85
DescriptionPlex\Name
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
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
86 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
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.
Module Length attribute
DescriptionModule length
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)
Chapter 4. Attributes reference 87
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Data Set Name attribute
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.
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 ExtentReduction Summary attribute 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
Primary Volume attribute
DescriptionPrimary volume the data set resides on.
Type String
Number of 2KB Blocks attribute
DescriptionThe count of 2 kilobyte blocks processed.
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.
Number of Tracks Migrated attribute
88 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNumber of tracks migrated.
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.
Number of Tracks Recalled attribute
DescriptionNumber of tracks recalled.
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.
Return Code of HSM Action attribute
DescriptionReturn code of HSM action. If blank, HSM kept the data setmigrated.
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.
Data Set Name attribute - This attribute is a key attribute.
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.
Chapter 4. Attributes reference 89
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 ExtentReductions attribute 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
HSM Action attribute
DescriptionHSM\Action
Type String
Return Code attribute
DescriptionReturn code
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.
User ID attribute
DescriptionUser ID requesting function
Type String
Data Set Name attribute
90 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Reason Code attribute
DescriptionReason code
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.
Abend Code attribute
DescriptionAbend code
Type String
RACF Group attribute
DescriptionRACF group
Type String
Request Number attribute
DescriptionRequest number
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 91
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Request Date attribute
DescriptionDate user made request
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.
Request Time attribute
DescriptionTime user made request
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.
Start Time attribute
DescriptionTime HSM started processing
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.
Complete Time attribute
DescriptionTime request was completed
Type Integer (Counter) with enumerated values. The strings are
92 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Kbytes Read attribute
DescriptionKilobytes read
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.
Kbytes Written attribute
DescriptionKilobytes written
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.
Tracks Read attribute
DescriptionTracks read/freed
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.
Tracks Written attribute
DescriptionTracks written
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 93
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Data Set Organization attribute
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
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.
Age attribute
DescriptionAge
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)
94 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Record Format attribute
DescriptionRecord format
Type String
Storage Class attribute
DescriptionStorage class name
Type String
Management Class attribute
DescriptionMgmt class name
Type String
Dump Class attribute
DescriptionDump class
Type String
Host ID attribute
DescriptionHost id
Type String
System ID attribute
DescriptionSystem id
Type String
Levels attribute
DescriptionLevel movement
Type String
Request Date attribute
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
Chapter 4. Attributes reference 95
Attribute descriptionsThe following list contains information about each attribute in the Filter AttributeGroup attribute 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
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Filter ID attribute
DescriptionInternal number for identifying the filter.
Type String
Description attribute
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.
96 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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 FunctionRecords attribute 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
HSM Action attribute
DescriptionHSM\Action
Type String
Return Code attribute
DescriptionReturn code
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.
User ID attribute
DescriptionUser ID requesting function
Type String
Data Set Name attribute
Chapter 4. Attributes reference 97
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 characters
Type String
From Volume attribute
DescriptionFrom volume
Type String
Reason Code attribute
DescriptionReason code
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.
Abend Code attribute
DescriptionAbend code
Type String
RACF Group attribute
DescriptionRACF group
Type String
Request Number attribute
DescriptionRequest number
Type Integer (Counter) with enumerated values. The strings are
98 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Request Date attribute
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
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.
Kbytes Written attribute
DescriptionKilobytes written
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.
Tracks Read attribute
DescriptionTracks read/freed
Chapter 4. Attributes reference 99
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.
Tracks Written attribute
DescriptionTracks written
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.
Data Set Organization attribute
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 complete
Type String
Cpu Time .01 attribute
DescriptionCpu time used .01
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)
100 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Age attribute
DescriptionAge
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.
Record Format attribute
DescriptionRecord format
Type String
Storage Class attribute
DescriptionStorage class name
Type String
Management Class attribute
DescriptionMgmt class name
Type String
Dump Class attribute
DescriptionDump class
Type String
Host ID attribute
DescriptionHost id
Type String
System ID attribute
DescriptionSystem id
Type String
Levels attribute
DescriptionLevel movement
Type String
Chapter 4. Attributes reference 101
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.
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 FunctionSummary attribute 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
HSM Action attribute
DescriptionHSM Action
Type String
Return Code attribute
DescriptionReturn code
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.
Count attribute
102 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNumber of matching records
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.
Description attribute
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.
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 HSM BackupReports attribute 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
Status attribute
Chapter 4. Attributes reference 103
DescriptionVolume management status
Type String
Count attribute
DescriptionNumber of volumes for given stat
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.
Description attribute
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.
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 HSM CDSBackups attribute 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
104 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionPlex\Name
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
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.
Data Set Name attribute
DescriptionControl data set name
Type String
Catalog Name attribute
DescriptionCatalog name
Type String
Volser attribute
DescriptionVolume serial number
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.
Chapter 4. Attributes reference 105
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 HSM CDS Spaceattribute 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
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
106 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
Volser attribute
DescriptionVolume serial number
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
Chapter 4. Attributes reference 107
Open attribute
DescriptionData set is open
Type String
Buffer Size attribute
DescriptionMinimum buffer size
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.
Primary Allocation attribute
DescriptionPrimary allocation
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.
Secondary Allocation attribute
DescriptionSecondary allocation
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.
Allocation Type attribute
DescriptionAllocation type
Type String
High Used RBA attribute
DescriptionHigh used RBA
108 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
High Allocated RBA attribute
DescriptionHigh allocated RBA
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.
Used Percent attribute
DescriptionUsed percentage
Type String
Average Lrecl attribute
DescriptionAverage lrecl
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.
Storage Class attribute
DescriptionStorage class name
Type String
Data Class attribute
DescriptionData class name
Type String
Management Class attribute
Chapter 4. Attributes reference 109
DescriptionManagement class name
Type String
Cluster Type attribute
DescriptionCluster type
Type String
Data Set Organization attribute
DescriptionData set organization
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
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.
110 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Key Length attribute
DescriptionKey length
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.
CA Percent Free Space attribute
DescriptionFreespace CA percent
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.
CI Percent Free Space attribute
DescriptionFreespace CI percent
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.
CI Per CA attribute
DescriptionCI per CA
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.
CI Size attribute
Chapter 4. Attributes reference 111
DescriptionCI size
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.
Maximum Lrecl attribute
DescriptionMaximum lrecl
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.
Index Levels attribute
DescriptionFor index - number of levels
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.
Records attribute
DescriptionNumber of records
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.
Extents attribute
DescriptionNumber of extents
112 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Deletes attribute
DescriptionNumber of deletes
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.
Inserts attribute
DescriptionNumber of inserts
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.
Updates attribute
DescriptionNumber of updates
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.
Retrieved attribute
DescriptionNumber retrieved
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 113
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
CI Splits attribute
DescriptionNumber CI splits
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.
CA Splits attribute
DescriptionNumber CA splits
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.
EXCP Count attribute
DescriptionEXCP count
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.
Number Extents attribute
DescriptionNumber of extents
Type Integer (Counter) with enumerated values. The strings are
114 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
High Level RBA attribute
DescriptionHigh key RBA
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.
High Used RBA attribute
DescriptionHigh used RBA
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.
High Allocated RBA attribute
DescriptionHigh allocated RBA
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.
Block Size attribute
DescriptionBlocksize
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 115
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Blocks Per Track attribute
DescriptionBlocks per track
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.
Tracks Per Cylinder attribute
DescriptionTracks per cylinder
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.
Bytes Per Track attribute
DescriptionBytes per track
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.
Free Bytes attribute
DescriptionFree bytes
Type Integer (Counter) with enumerated values. The strings are
116 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
System Timestamp attribute
DescriptionSystem time stamp
Type Timestamp
Tracks Per CA attribute
DescriptionTracks per CA
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.
Extent Type attribute
DescriptionType extent
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.
Entries Per Section attribute
DescriptionEntries per section
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.
Sequence Set RBA attribute
Chapter 4. Attributes reference 117
DescriptionSequence set RBA
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.
Volume Type attribute
DescriptionVolume type
Type String
Device Type-Hex attribute
DescriptionDevice type in hex
Type String
Device Type attribute
DescriptionCharacter device type
Type String
High Level RBA attribute
DescriptionIndex high level RBA
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.
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.
118 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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 HSM CDS Usersattribute 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
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
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)
Chapter 4. Attributes reference 119
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Wait Exclusive attribute
DescriptionNum of exclusive requests
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.
Wait Shared attribute
DescriptionNum of shared requests
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.
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
120 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
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.
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.
Chapter 4. Attributes reference 121
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 HSM HealthDetail Reports attribute 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
Status attribute
DescriptionVolume management status
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
Device Type attribute
DescriptionDevice type
122 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
SMS Managed attribute
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
Chapter 4. Attributes reference 123
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
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.
Capacity In Tracks attribute
DescriptionVolume capacity in tracks
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.
Tracks Free attribute
124 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNumber of free tracks
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.
Number Of Migrations attribute
DescriptionCount of successful migrns
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.
Number Of Tracks Migrated attribute
DescriptionCount of tracks migrated
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.
Number Of Data Sets Migrated attribute
DescriptionCount of DSs migrated
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.
Size Migrated attribute
DescriptionSize of DSs migrated
Chapter 4. Attributes reference 125
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.
Migration Attempts attribute
DescriptionMigration attempts from VSR
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.
Migration Failures attribute
DescriptionMigration failures from VSR
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.
Recall Attempts attribute
DescriptionRecall attempts from VSR
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.
Recall Failures attribute
DescriptionRecall failures from VSR
Type Integer (Counter) with enumerated values. The strings are
126 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Delete Attempts attribute
DescriptionDelete attempts from VSR
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.
Delete Failures attribute
DescriptionDelete failures from VSR
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.
Backup Attempts attribute
DescriptionBackup attempts from VSR
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.
Backup Failures attribute
DescriptionBackup failures from VSR
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 127
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Dump Attempts attribute
DescriptionDump attempts from VSR
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.
Dump Failures attribute
DescriptionDump failures from VSR
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.
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
128 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
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.
Health Limit attribute
DescriptionHealth limit
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.
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
Chapter 4. Attributes reference 129
Attribute descriptionsThe following list contains information about each attribute in the HSM Host Infoattribute 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 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
Release attribute
DescriptionRelease of DFHSM
Type String
HSM Type attribute
DescriptionTask type
Type String
Status attribute
130 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
ASCB Address attribute
DescriptionASCB address
Type String
Cmd Suffix attribute
DescriptionARCCMD suffix
Type String
SMF Number attribute
DescriptionSMF number
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.
Backup Prefix attribute
DescriptionBackup prefix
Type String
Chapter 4. Attributes reference 131
Migrate Prefix attribute
DescriptionMigration prefix
Type String
Max Backup Tasks attribute
DescriptionMax backup tasks
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.
Max Dump Tasks attribute
DescriptionMax dump tasks
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.
Max Recall Tasks attribute
DescriptionMax recall tasks
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.
Max Tape Recall Tasks attribute
DescriptionMax tape recall tasks
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)
132 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Max Migration Tasks attribute
DescriptionMax migration tasks
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.
Max Interval Migration Tasks attribute
DescriptionMax interval migration tasks
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.
Max Recover Tasks attribute
DescriptionMax recover tasks
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.
Max Recycle Tasks attribute
DescriptionMax recycle tasks
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)
Chapter 4. Attributes reference 133
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Max CSA Usage attribute
DescriptionMax CSA byte count
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.
Active Limit attribute
DescriptionActive CSA limit
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.
Inactive Limit attribute
DescriptionInactive CSA limit
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.
Used CSA attribute
DescriptionCSA in use
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.
134 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Used Percent attribute
DescriptionUsed percentage
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.
Max MWEs attribute
DescriptionMWEs per address space
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.
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
Chapter 4. Attributes reference 135
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
136 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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 HSM MigrationReports attribute 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.
Chapter 4. Attributes reference 137
Type String
System Name attribute
DescriptionSystem\Name
Type String
Plex Name attribute
DescriptionPlex\Name
Type String
Status attribute
DescriptionVolume management status
Type String
Count attribute
DescriptionNumber of volumes for given stat
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.
Description attribute
DescriptionStatus description
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.
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 HSM VolumeDump Reports attribute group:
Node attribute - This attribute is a key attribute.
DescriptionThe managed system name of the agent.
138 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Status attribute
DescriptionVolume management status
Type String
Count attribute
DescriptionNumber of volumes for given stat
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.
Description attribute
DescriptionStatus description
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
Chapter 4. Attributes reference 139
Attribute descriptionsThe following list contains information about each attribute in the Issue HSMCommands attribute 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
Job Name attribute
DescriptionTask using DSN
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
140 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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 Log Data Setsattribute 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
Job Name attribute
DescriptionTask using DSN
Type String
Job Number attribute
DescriptionTask job number
Type String
Data Set Name attribute
DescriptionDataset name to use
Type String
Type File attribute
Chapter 4. Attributes reference 141
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.
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 Log MigrationDetail attribute 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
Data Set Name attribute - This attribute is a key attribute.
DescriptionThe name of the data set.
Type String
Action attribute
DescriptionAction performed on the data set.
Type String
Return Code attribute
DescriptionReturn code for the action perfomed.
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)
142 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Reason Code attribute
DescriptionReason code for the action performed.
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.
Tracks attribute
DescriptionThe data set size in tracks.
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.
Age attribute
DescriptionAge of the data set when the action was performed.
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.
Timestamp attribute
DescriptionThe date/time when the action was performed.
Type Timestamp
From Volume Serial attribute
DescriptionVolume serial number of primary volume.
Type String
Chapter 4. Attributes reference 143
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.
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.
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.
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 Log RecallDetail attribute 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
Data Set Name attribute - This attribute is a key attribute.
DescriptionThe data set name.
Type String
Action attribute
DescriptionThe action performed on the data set.
Type String
144 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Return Code attribute
DescriptionThe return code for the action performed.
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.
Reason Code attribute
DescriptionThe reason code for the action performed.
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.
Tracks attribute
DescriptionThe size of the data set in tracks.
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.
Age attribute
DescriptionThe age of the data set when the action was performed.
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.
Timestamp attribute
Chapter 4. Attributes reference 145
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.
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.
Level attribute
DescriptionThe level from which the data set was recalled.
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.
TSO User attribute
DescriptionThe TSO user making the request.
Type String
BTSO attribute
DescriptionThe address space from which the request was made.
Type String
From Volume attribute
DescriptionThe volume from which the recalled was performed.
Type String
To Volume attribute
146 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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.
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.
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 MCDS Detailsattribute 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
Data Set Name attribute - This attribute is a key attribute.
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
Chapter 4. Attributes reference 147
Tivoli Enterprise Portal. The warehouse and queries return thevalues shown in parentheses. The following values are defined:v No (0)v Yes (1)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Creation Date attribute
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
Expiration Date attribute
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
ML0 Volume attribute
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.
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)
148 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Thrashing Index attribute
DescriptionThrashing index based off the number of times migrated.
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.
Migration Level attribute
DescriptionCurrent migration level of data set.
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.
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Tracks Occupied attribute
DescriptionThe number of tracks the data set occupies the primary volume.
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)
Chapter 4. Attributes reference 149
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Migrated KB2 Bytes attribute
DescriptionThe number of 2K blocks this data set occupies on the migrationvolume.
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.
Data Class attribute
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
150 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Attribute descriptionsThe following list contains information about each attribute in the MCDS VolumeSummary attribute 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
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.
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 Migrated DataSets attribute 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
Chapter 4. Attributes reference 151
Type String
Plex Name attribute
DescriptionPlex\Name
Type String
Data Set Name attribute
DescriptionDataset name
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
Migration Level attribute
DescriptionMigration level
Type String
Percent Compressed attribute
DescriptionSpace 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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Date Created attribute
152 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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 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.
Data Set Organization attribute
DescriptionData set organization
Type String
Max Blocksize attribute
DescriptionMaximum blocksize
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)
Chapter 4. Attributes reference 153
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Key Length attribute
DescriptionKey length
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.
Record Format attribute
DescriptionRecord format
Type String
Size In Tracks attribute
DescriptionTracks on user volume
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.
Size In Kilobytes attribute
DescriptionKbytes on user volume
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.
Version Size(2K Blks) attribute
DescriptionSize of curr version in 2k blks
Type Integer (Counter) with enumerated values. The strings are
154 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Times Migrated attribute
DescriptionNumber of times migrated
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.
Days Til Migrated attribute
DescriptionDays until eligible for migration
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.
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
Chapter 4. Attributes reference 155
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
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.
Expiration Date attribute
DescriptionExpiration date
Type String
Multi Volume attribute
DescriptionMulti-volume data set
Type String
SMS Managed attribute
DescriptionSMS managed data set
Type String
Secondary Allocation Type attribute
DescriptionSecondary allocation type
Type String
Secondary Allocation Amount attribute
DescriptionSecondary allocation amount
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:
156 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Migration Copy Data Set Name attribute
DescriptionMigration dsname
Type String
Additional Volumes attribute
DescriptionAdditional migration volumes
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.
Number Of 16 Blks For Backup Version attribute
DescriptionTotal number of 16 blocks for backup version
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.
Stripe/Data Set attribute
DescriptionDataset is striped
Type String
Data Class Name attribute
DescriptionData class name
Type String
Storage Class Name attribute
DescriptionStorage class name
Type String
Management Class Name attribute
Chapter 4. Attributes reference 157
DescriptionManagement class name
Type String
MCO Exists attribute
DescriptionMCO Exists
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.
Days Since Last Used attribute
DescriptionDays since last used
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.
Days Since VSAM Last Used attribute
DescriptionDays since VSAM last used
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.
Days Since Migrated attribute
DescriptionDays since migrated
Type Integer (Counter) with enumerated values. The strings are
158 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Days Since Recalled attribute
DescriptionDays since recalled
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.
Days Till Expired attribute
DescriptionDays until expiration
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.
Track Length attribute
DescriptionLength of track on this device
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.
MCL Exists attribute
DescriptionMCL Exists
Type String
Chapter 4. Attributes reference 159
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.
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 MigrationVolumes attribute 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
Volser attribute
DescriptionVolume serial number
Type String
Unit Name attribute
DescriptionUnit Name
Type String
Volume Type attribute
DescriptionVolume Type
Type String
Migration Level attribute
DescriptionMigration Level
160 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Chapter 4. Attributes reference 161
HWM attribute
DescriptionHWM
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.
LWM attribute
DescriptionLWM
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.
Timestamp Of Last Migration attribute
DescriptionTimestamp of last migration
Type Timestamp
Days Since Migrate attribute
DescriptionDays since migration
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.
Total Tracks attribute
DescriptionTotal Tracks
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)
162 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
v Value_Exceeds_Minimum (-2147483648)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Free Tracks attribute
DescriptionFree Tracks
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.
Device Type attribute
DescriptionDevice Type
Type String, 8 characters in length.
Block Size attribute
DescriptionBlock Size
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.
Number Of Cylinders attribute
DescriptionNumber of cylinders
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.
Tracks Per Cylinder attribute
DescriptionTracks per cylinder
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 163
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Track Length attribute
DescriptionTrack length
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.
Number Of 2K Blocks attribute
DescriptionNumber of 2k blocks
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.
Tape Percent Full attribute
DescriptionTape percent full
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.
Minimum Age attribute
DescriptionMinimum Age
Type Integer (Counter) with enumerated values. The strings are
164 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Number Of Data Sets attribute
DescriptionNumber of data sets
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.
Number Of Tracks attribute
DescriptionNumber of tracks
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.
Fragmentation Index attribute
DescriptionFragmentation index
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.
DBA Days attribute
DescriptionDBADays
Type Integer (Counter) with enumerated values. The strings are
Chapter 4. Attributes reference 165
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Tape Density attribute
DescriptionTape density
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.
Lspace Timestamp attribute
DescriptionLspace timestamp
Type Timestamp
Lspace Days attribute
DescriptionLspace days
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.
SMS Managed attribute
DescriptionSMS managed
Type String
Alternate Volume attribute
DescriptionAlternate volume
Type String
Auto Prim Timestamp attribute
DescriptionLast auto prim timestamp
166 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type Timestamp
Auto Prim Days attribute
DescriptionDays since last auto prim
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.
Auto Backup Timestamp attribute
DescriptionLast auto backup timestamp
Type Timestamp
Auto Backup Days attribute
DescriptionDays since last auto backup
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.
Auto Dump Date attribute
DescriptionLast auto dump date
Type Timestamp
Auto Dump Days attribute
DescriptionDays since last auto dump
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.
Int Migration Timestamp attribute
Chapter 4. Attributes reference 167
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.
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 MountedVolumes attribute 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
Job Name attribute
DescriptionTask using DSN
Type String
Job Number attribute
DescriptionTask job number
Type String
Host ID attribute
DescriptionHost Id
168 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
HSM Volume Type attribute
DescriptionHSM Type MVT entry
Type String
Volser attribute
DescriptionVolser
Type String
UCB Address attribute
DescriptionUCB address
Type String
Volume Type attribute
DescriptionVolume type
Type String
Free Tracks attribute
DescriptionFree tracks
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.
Volume Sequence Number attribute
DescriptionVolume sequence number
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.
Migration Required attribute
DescriptionMigration required flag
Type String
Chapter 4. Attributes reference 169
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
DescriptionUnit name
Type String
Total Space (Trks) attribute
DescriptionTotal space (in tracks)
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.
Free Space (Trks) attribute
DescriptionFree space (in tracks)
170 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Low Thresh attribute
DescriptionLow threshold
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.
High Thresh attribute
DescriptionHigh threshold
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.
Device Type attribute
DescriptionDevice type
Type String
Device Type-Hex attribute
DescriptionDevice type in hex
Type String
Block Size attribute
DescriptionMax blocksize
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:
Chapter 4. Attributes reference 171
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.
Number Of Cylinders attribute
DescriptionNumber of cylinders
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.
Tracks Per Cylinder attribute
DescriptionNumber of tracks per cylinder
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.
Track Length attribute
DescriptionTrack length
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.
#2k Blk Per Trk attribute
DescriptionNum 2k blocks per track
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)
172 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Opt Blksz for 2k Blks attribute
DescriptionOptional blocksize for 2k blocks
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.
Guaranteed Backup Frequency attribute
DescriptionGuaranteed backup freq in days
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.
Minimum Age attribute
DescriptionMinimum age to migrate from vol
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.
Fragmentation Index attribute
DescriptionFragmentation index
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.
Chapter 4. Attributes reference 173
Reserve Count attribute
DescriptionReserve count on volume
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.
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
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.
Migrate Convert Volser attribute
DescriptionVolser for migrate convert cmd
Type String
Backup Day attribute
DescriptionDay of backup cycle
Type String
Tape Density attribute
174 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionDensity of tape
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.
Last File Sequence # attribute
DescriptionFile seq of last file written
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.
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.
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 MWE QueueContents attribute 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
Chapter 4. Attributes reference 175
Plex Name attribute
DescriptionPlex\Name
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
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
TSO Request attribute
176 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Request Number attribute
DescriptionRequest number
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.
ASCB Address attribute
DescriptionASCB address of the requestor
Type String
Return Code attribute
DescriptionMWE completion code
Type String
Reason ode attribute
DescriptionMWE reason code
Type String
Chapter 4. Attributes reference 177
Abend code attribute
DescriptionMWE system abend code
Type String
RACF Group attribute
DescriptionRACF group name
Type String
Requestor Job Name attribute
DescriptionRequestor jobname
Type String
Request Priority attribute
DescriptionRequest priority
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.
Data Set Name attribute
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
178 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Type String
MWE Address attribute
DescriptionAddress of MWE
Type String
Queue Position attribute
DescriptionPosition in queue - character
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.
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.
Historical groupThis attribute group is part of the default historical group, and is eligible for usewith Tivoli Data Warehouse.
Chapter 4. Attributes reference 179
Attribute descriptionsThe following list contains information about each attribute in the Patches attributegroup:
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
Patch Command attribute
DescriptionPatch command
Type String
Verify Command attribute
DescriptionVerify command
Type String
Description attribute
DescriptionDescription of patch command
Type String
Patch Active attribute
DescriptionPatch is active in host
Type String
Job Name attribute
DescriptionTask using DSN
Type String
Job Number attribute
180 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionTask job number
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.
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 PerformanceObject Status attribute 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
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
Chapter 4. Attributes reference 181
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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)
182 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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)
Chapter 4. Attributes reference 183
v GENERAL_RESPONSE_ERROR (50)v SCRIPT_NONZERO_RETURN (51)v SCRIPT_NOT_FOUND (52)v SCRIPT_LAUNCH_ERROR (53)
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
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.
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 Return CodeSummary attribute 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
Return Code attribute - This attribute is a key attribute.
DescriptionThe return code of the function performed.
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.
Count attribute
DescriptionThe count of datasets.
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:
184 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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.
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 SETSYS Valuesattribute 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
Chapter 4. Attributes reference 185
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
Keyword attribute
DescriptionKeyword from JCL/ARCCMD member
Type String
Parm Value attribute
DescriptionValue associated with keyword
Type String
Description attribute
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.
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 SMS HSMMounted Volume Reports attribute group:
Node attribute - This attribute is a key attribute.
DescriptionThe managed system name of the agent.
Type String
Timestamp attribute
186 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Status attribute
DescriptionVolume management status
Type String
Count attribute
DescriptionNumber of volumes for given stat
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.
Description attribute
DescriptionStatus description
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.
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 Tape CopyNeeded attribute group:
Node attribute - This attribute is a key attribute.
Chapter 4. Attributes reference 187
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
Volser attribute
DescriptionVolume serial number
Type String
Volume Type attribute
DescriptionType volume
Type String
TapeCopy Timestamp attribute
DescriptionDate of last auto Tapecopy
Type Timestamp
Days Since Tapecopy attribute
DescriptionDays since last auto Tapecopy
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.
Alternate Unit Name attribute
DescriptionAlternate volume unit name
Type String
188 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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 Tape Volumesattribute 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
Volser attribute
DescriptionVolume serial number
Type String
Volume Type attribute
DescriptionType volume
Type String
Full attribute
Chapter 4. Attributes reference 189
DescriptionIf volume is full
Type String
Capacity attribute
DescriptionVolume capacity type
Type String
Unit Name attribute
DescriptionUnit name
Type String
Data Set Number attribute
DescriptionNumber of data sets
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.
Total Blocks attribute
DescriptionTotal number of blocks
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.
Number Of Valid Blocks attribute
DescriptionValid number of blocks
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.
190 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Previous Volume attribute
DescriptionPrevious volume
Type String
Next Volume attribute
DescriptionNext volume
Type String
Alternate Volume attribute
DescriptionAlternate volume
Type String
Alternate Unit attribute
DescriptionUnit name for alternate volume
Type String
Number Of VSAM Files attribute
DescriptionNum of VSAM files
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.
Number Of Valid Data Sets attribute
DescriptionNumber of valid data sets
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.
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.
Chapter 4. Attributes reference 191
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 ThrashingReport attribute 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
User ID attribute
DescriptionUser id requesting function
Type String
Data Set Name attribute
DescriptionData set name being processed
Type String
Host ID attribute
DescriptionHost id
Type String
System ID attribute
DescriptionSystem id
Type String
Number Of recalls attribute
DescriptionNumber of recalls
192 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Number Of Migrates attribute
DescriptionNumber of migrates
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.
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.
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 Volume StatisticsRecords attribute 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
Chapter 4. Attributes reference 193
DescriptionPlex\Name
Type String
Volser attribute
DescriptionVolume serial number
Type String
Date attribute
DescriptionDate
Type String
Volume Type attribute
DescriptionVolume type
Type String
Number Of User Migrates attribute
DescriptionNumber of user migrates
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.
Number Of System Migrates attribute
DescriptionNumber of system migrates
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.
Number Of Non-VSAM Data Set attribute
DescriptionNumber of non-VSAM data set
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:
194 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Minimum Age attribute
DescriptionMinimum age
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.
Allocated Tracks attribute
DescriptionAllocated tracks
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.
Free Tracks attribute
DescriptionFree tracks
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.
Lwm attribute
DescriptionLwm
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)
Chapter 4. Attributes reference 195
Any other values will display the actual value returned by theagent in the Tivoli Enterprise Portal.
Hwm attribute
DescriptionHwm
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.
Obm attribute
DescriptionObm
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.
Oam attribute
DescriptionOam
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.
Percent Eligible attribute
DescriptionPercent eligible
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.
196 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Number Of Int Migration attribute
DescriptionNumber of int migration
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.
Number Of Int Met attribute
DescriptionNumber of int met
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.
Fragmentation Index attribute
DescriptionFragmentation index
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.
Migration Time attribute
DescriptionMigration time
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.
Unit Name attribute
Chapter 4. Attributes reference 197
DescriptionUnit name
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
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.
Dump Copies Failed attribute
DescriptionDump copies failed
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.
Number Of Restores attribute
198 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
DescriptionNumber of restores
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.
Number Of Restores Failed attribute
DescriptionNumber of restores failed
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.
Total Capacity attribute
DescriptionTotal capacity
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.
Number Of Data Set Reconnnected attribute
DescriptionNumber of DS recon
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.
Number Of Tracks Reconnected attribute
DescriptionNumber of tracks recon
Chapter 4. Attributes reference 199
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.
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
200 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Table 1. Capacity planning for historical data logged by component Advanced Reporting for DFSMShsm (continued)
Table Attribute group
Bytes perinstance(agent)
Databasebytes perinstance(warehouse)
Aggregatebytes perinstance(warehouse)
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
Chapter 4. Attributes reference 201
Table 1. Capacity planning for historical data logged by component Advanced Reporting for DFSMShsm (continued)
Table Attribute group
Bytes perinstance(agent)
Databasebytes perinstance(warehouse)
Aggregatebytes perinstance(warehouse)
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.
202 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User'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.
© Copyright IBM Corp. 2008 203
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
204 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
– 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.
206 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
DescriptionThe action request on a data set failed with a return code = 3
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 3 ) )
See “Attribute groups and attributes for the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent” on page 21 for descriptions of the attributes in thisformula.
Chapter 5. Situations reference 207
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_No_Pri_Vol_Avail situation
DescriptionThe action request on a data set failed with a return code = 4
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 4 ) )
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_Request_Vol_Not_Avail situation
DescriptionThe action request on a data set failed with a return code = 21
The situation will be evaluated for each distinct value of the DSNAME attribute.
208 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECALL' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 21 ) )
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_Insuff_Sp_On_Trg_Vol situation
DescriptionThe action request on a data set failed with a return code = 24
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 24 ) )
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.
Chapter 5. Situations reference 209
KRH_No_Unit_Avail situation
DescriptionThe action request on a data set failed with a return code = 50
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 50 ) )
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_Cant_Recover_w_NewName situation
DescriptionThe backup request for a data set failed with a return code = 57
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 57 ) )
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.
210 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
SeverityCritical
Clearing conditionsThe situation clears when the condition becomes false.
KRH_Recover_Failed situation
DescriptionThe action request on a data set failed with a return code = 58
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 58 ) )
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_Recall_Delete_Held situation
DescriptionThe action request on a data set failed with a return code = 74
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 74 ) )
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.
Chapter 5. Situations reference 211
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_Restore_Failed situation
DescriptionThe action request on a data set failed with a return code = 88
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 88 ) )
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_Recall_Recover_Error situation
DescriptionThe action request on a data set failed with a return code = 99
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 99 ) )
212 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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_No_Pri_Vol_Avail situation
DescriptionThe action request on a data set failed with a return code = 4
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 4 ) )
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.
Chapter 5. Situations reference 213
KRH_No_Uni_Avail situation
DescriptionThe action request on a data set failed with a return code = 50
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 50 ) )
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_Recover_Failed situation
DescriptionThe action request on a data set failed with a return code = 58
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 58 ) )
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.
214 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
SeverityCritical
Clearing conditionsThe situation clears when the condition becomes false.
KRH_Existing_DS_Delete_Err situation
DescriptionDeletion request of a data set failed with a return code = 59
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 59 ) )
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_Recall_Delete_Held situation
DescriptionAction request on a data set failed with a return code = 74
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 74 ) )
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.
Chapter 5. Situations reference 215
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_Recall_Recovery_Err situation
DescriptionAction request on a data set failed with a return code = 99
The situation will be evaluated for each distinct value of the DSNAME attribute.
Formula*IF ( ( *VALUE KRH_LOG_RECALL_DETAIL.ACTION *EQ 'RECOVER' ) *AND ( *VALUEKRH_LOG_RECALL_DETAIL.RETCODE *EQ 99 ) )
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.
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.
216 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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 ) )
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_Duplicate_DSN_In_MCDS situation
DescriptionThe migration request of a dataset failed with a return code = 6
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 6 ) )
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
Chapter 5. Situations reference 217
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_Copy_Already_Exist situation
DescriptionThe migration request of a dataset failed with return code = 12
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 12 ) )
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_Data_Set_In_Use situation
DescriptionThe action requested on a dataset had a return code = 19
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 19 ) )
See “Attribute groups and attributes for the IBM Tivoli Advanced Reporting forDFSMShsm Monitoring Agent” on page 21 for descriptions of the attributes in thisformula.
218 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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_No_Space_In_Mig_Vol situation
DescriptionThe migration request of a dataset failed with return code = 37
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 37 ) )
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_L0_Vol_Not_Available situation
DescriptionThe action request on a data set failed with a return code = 66
The situation will be evaluated for each distinct value of the RETCODE attribute.
Chapter 5. Situations reference 219
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'MIGRATE' ) *AND ( *VALUEKRH_RETURN_CODE_SUMMARY.RETCODE *EQ 66 ) )
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_Migration_Held situation
DescriptionThe migration request of a dataset failed with return code = 74
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 74 ) )
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.
220 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
KRH_Unsupported_Data_Set situation
DescriptionThe action request on a data set failed with a return code = 99
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 99 ) )
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_Cant_Mv_Bkup_Miss_Vol situation
DescriptionThe backup request for a dataset failed with a return code = 4
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 4 ) )
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.
Chapter 5. Situations reference 221
SeverityCritical
Clearing conditionsThe situation clears when the condition becomes false.
KRH_No_Vol_For_Bkup situation
DescriptionThe action request on 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 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 5 ) )
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_Data_Set_In_Use situation
DescriptionThe action request on a dataset failed with a return code = 19
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 19 ) )
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.
222 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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_DS_Not_Elig_For_Bkup situation
DescriptionThe backup request on a dataset failed with a return code = 20
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 20 ) )
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_Ext_Record_Missing situation
DescriptionThe migration request of a dataset failed with return code = 31
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 31 ) )
Chapter 5. Situations reference 223
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_No_Space_On_Bkup_Vol situation
DescriptionThe backup request of a dataset failed with a return code = 37
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 37 ) )
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.
224 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
KRH_Bkup_Funct_Disabled situation
DescriptionThe backup request for the data set failed with return code = 40
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 40 ) )
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_Bkup_Failed_For_DSN situation
DescriptionThe backup request for a data set failed with a return code = 58
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 58 ) )
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.
Chapter 5. Situations reference 225
SeverityCritical
Clearing conditionsThe situation clears when the condition becomes false.
KRH_Backup_Held situation
DescriptionThe backup request for a data set failed with a return code = 74
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 74 ) )
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_BCDS_Record_Not_Found situation
DescriptionThe backup request for a data set failed with a return code = 80
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 80 ) )
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.
226 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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_Fail_In_Bkvol_Dump situation
DescriptionThe action request a volume failed with a return code = 84
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND (*VALUE KRH_RETURN_CODE_SUMMARY.RETCODE *EQ 84 ) )
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_Unsupported_Data_Set situation
DescriptionThe action request on a data set failed with a return code = 99
The situation will be evaluated for each distinct value of the RETCODE attribute.
Formula*IF ( ( *VALUE KRH_RETURN_CODE_SUMMARY.ACTION *EQ 'BACK-UP' ) *AND ( *VALUEKRH_RETURN_CODE_SUMMARY.RETCODE *EQ 99 ) )
Chapter 5. Situations reference 227
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.
228 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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:
© Copyright IBM Corp. 2008 229
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.
230 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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:DSNAME] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:FROMVOLUME] \
[&WaitOnSituation:VERSION]
Argumentsv Name: DSNAME
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
232 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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:
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.
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:
Chapter 6. Take Action commands reference 233
HCANCEL \
[&{DSNAME}] \
[&{REQNUM}] \
[&{USERID}] \
[&{WAIT}] \
[&{HOSTID}]
You can also use attribute substitution in a workflow policy though the format isslightly different:HCANCEL \
[&WaitOnSituation:DSNAME] \
[&WaitOnSituation:REQNUM] \
[&WaitOnSituation:USERID] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:HOSTID]
Argumentsv Name: DSNAME
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:
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_AUTHORITY
234 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Operating 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.
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:DSNAME] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:PURGE]
Argumentsv Name: DSNAME
Description: Required - Specifies the name of a migrated data set to delete.Default:
Chapter 6. Take Action commands reference 235
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
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.
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}] \
236 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
[&{WAIT}] \
[&{MIGLEVEL}]
You can also use attribute substitution in a workflow policy though the format isslightly different:HMIGRATE \
[&WaitOnSituation:DSNAME] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:MIGLEVEL]
Argumentsv Name: DSNAME
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
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.
HRECALL action
DescriptionRecall a migrated data set.
Chapter 6. Take Action commands reference 237
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:DSNAME] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:TOVOLUME] \
[&WaitOnSituation:UNITNAME]
Argumentsv Name: DSNAME
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
238 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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:
Chapter 6. Take Action commands reference 239
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:DSNAME] \
[&WaitOnSituation:WAIT] \
[&WaitOnSituation:FROMVOLUME] \
[&WaitOnSituation:GENERATION] \
[&WaitOnSituation:DATE] \
[&WaitOnSituation:VERSION] \
[&WaitOnSituation:NEWNAME] \
[&WaitOnSituation:REPLACE] \
[&WaitOnSituation:TOVOLUME] \
[&WaitOnSituation:UNITNAME]
Argumentsv Name: DSNAME
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
240 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
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: 0012
Chapter 6. Take Action commands reference 241
Return Code Type: NOT_RUNNINGOperating systems: Linux 2.4 (Intel), WindowsMessage ID: KRH0012Message: Bad KRS Environment.
242 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
© Copyright IBM Corp. 2008 243
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".
© Copyright IBM Corp. 2008 245
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.
246 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
Table 2. Trace log files for troubleshooting agents (continued)
System where logis located
File name and path Description
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
v UNIX: install_dir/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:
v Windows: install_dir\tmaitm6\logs
v UNIX: install_dir/logs
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:
v Windows: install_dir\tmaitm6\logs
v UNIX: install_dir/logs
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)
System where logis located
File name and path Description
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.
248 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 249
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.
250 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 251
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.
252 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 253
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.
254 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 255
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.
256 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 257
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.
258 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 259
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.
260 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Chapter 8. Troubleshooting 261
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
262 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
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.
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.
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.
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.
Operator response: No action is required.
Chapter 8. Troubleshooting 263
KRS0009I id Agent agent disconnected from TEMA
Explanation: The indicated TEP agent agent has successfully disconnected from the TEMA address space.
Operator response: No action is required.
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.
Operator response: No action is required.
264 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Operator response: No action is required.
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.
Operator response: Contact IBM Support.
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.
Operator response: No action is required.
KRH0018I id Attribute group registration complete for agent
Explanation: The indicated agent agent has completed its registration phase.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: Contact IBM Support.
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.
Chapter 8. Troubleshooting 265
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.
Operator response: No action is required.
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.
Operator response: No action is required.
KRS0040I {id} datatype refreshed successfully - nnn records
Explanation: The data collection routine for datatype has refreshed its cache of data, nnn records were collected.
Operator response: No action is required.
KRS0041I {id} interface established to jobname (product)
Explanation: The TEDA has established an interface to the base product API jobname jobname product name product.
Operator response: No action is required.
266 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
KRS0042I {id} SMF Record number for product is number.
Explanation: The SMF Record number used by this product for reporting is number.
Operator response: No action is required.
KRS0050I {id} Device Monitor has detected SMS system number number.
Explanation: An SMS System numbernumber has been detected.
Operator response: No action is required.
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.
Operator response: No action is required.
KRS0054I id agent initialization complete
Explanation: The indicated agent agent has completed its initialization phase.
Operator response: No action is required.
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.
Operator response: No action is required.
KRSH0057I id agent termination complete
Explanation: The indicated agent agent has completed its termination phase.
Operator response: No action is required.
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.
Operator response: No action is required.
Chapter 8. Troubleshooting 267
KRS0060I id There are no current users
Explanation: During shutdown, the TEDA server has detected that there are no current connections—terminationcan now proceed.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: No action is required.
KRSH0078I id TEDA shutdown proceeding
Explanation: The TEDA server is shutting down and is about to pass control to its termination routines.
Operator response: No action is required.
KRS0080I id TEDA removing services
Explanation: All active connections are terminated. The TEDA server is now removing internal services.
Operator response: No action is required.
KRS0082I id Dataspace dataspace created successfully
Explanation: The indicated dataspace dataspace has been successfully created.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
268 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
KRS0083I id Dataspace dataspace removed
Explanation: The indicated dataspace dataspace has been successfully removed.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: No action is required.
Chapter 8. Troubleshooting 269
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.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: Contact IBM Support.
270 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Operator response: No action is required.
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.
Operator response: No action is required.
KRS0118I id Agent agent in server server resumed
Explanation: The indicated agent agent in server server has been resumed and will restart its work.
Operator response: No action is required.
Chapter 8. Troubleshooting 271
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.
Operator response: No action is required.
KRS0127I id Agent task name agent initialization complete
Explanation: The indicated agent agent has completed its initialization phase.
Operator response: No action is required.
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.
Operator response: Contact IBM Support.
272 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Operator response: Contact IBM Support.
KRS0147I id Agent task name agent initializing
Explanation: The indicated agent agent is beginning its initialization phase.
Operator response: No action is required.
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.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
Operator response: Contact IBM Support.
Chapter 8. Troubleshooting 273
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.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
KRS0167I id Invoking initialization routine routine
Explanation: The indicated initialization routine routine has been invoked.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
KRS0168I id Invoking termination routine routine
Explanation: The indicated termination routine routine has been invoked.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
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.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
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.
Note: This message is only shown for MsgLevel(1) and above.
Operator response: No action is required.
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.
Operator response: No action is required.
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.
274 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
Operator response: Contact IBM Support.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
KRS0188E id Invalid range specification in keyword
Explanation: The value in keyword keyword is not in a valid range as required by the keyword.
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.
Chapter 8. Troubleshooting 275
KRS0189E id Invalid value specification in keyword
Explanation: The value in keyword keyword is invalid.
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.
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.
Operator response: No action is required.
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.
Operator response: Please contact IBM Support.
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.
Operator response: Please contact IBM Support.
276 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
KRS0198E id Service service failed RC=rc RSN=rsn
Explanation: The indicated service service failed with return code rc and reason code rsn.
Operator response: Please contact IBM Support.
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.
Operator response: No action is required.
Chapter 8. Troubleshooting 277
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
© Copyright IBM Corp. 2008 279
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:
280 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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:
282 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 283
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
284 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 285
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
286 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 287
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
288 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 289
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
290 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 291
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
292 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 293
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
294 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 295
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
296 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 297
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
298 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 299
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
300 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 301
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
302 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 303
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
304 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
Appendix A. IBM Tivoli Enterprise Console event mapping 305
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
306 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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 A. IBM Tivoli Enterprise Console event mapping 307
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
© Copyright IBM Corp. 2008 309
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.
310 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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.
© Copyright IBM Corp. 2008 311
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.
© Copyright IBM Corp. 2008 313
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.
314 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
© Copyright IBM Corp. 2008 317
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
318 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
320 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
322 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
situations 204, 206workspaces
descriptions 12list 9
BCDS Details attribute group 42BCDS Details workspace 12BCDS Volume Summary
situations 204, 206workspaces
descriptions 12list 10
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
situations 204, 206workspaces
descriptions 12list 10
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
situations 204, 206workspaces
descriptions 12list 10
Daily Space Management Detail attribute group 51Daily Space Management Detail workspace 12Daily Space Management Summary
situations 204, 206workspaces
descriptions 13list 10
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
IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent 200
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
situations 204, 206workspaces
descriptions 13list 10
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
situations 204, 206workspaces
descriptions 13list 10
Extent Reduction Summary attribute group 88Extent Reduction Summary workspace 13Extent Reductions attribute group 89Extent Type attribute 117Extents attribute 112
324 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
situations 204, 206workspaces
descriptions 14list 10
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
situations 204, 206workspaces
descriptions 14list 10
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
situations 204, 207workspaces
descriptions 15list 10
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
situations 204, 206workspaces
descriptions 11list 9
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
situations 204, 207workspaces
descriptions 16list 10
Log Migration Detail attribute group 142Log Migration Detail workspace 16Log Recall Detail
situations 204, 207workspaces
descriptions 16list 10
Log Recall Detail attribute group 144Log Recall Detail workspace 16logged data
IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent 200
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
326 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
situations 205, 216workspaces
descriptions 16list 10
MCDS Details attribute group 147MCDS Details workspace 16MCDS Volume Summary
situations 205, 216workspaces
descriptions 16list 11
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
IBM Tivoli Advanced Reporting for DFSMShsm MonitoringAgent 309
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
situations 205, 216workspaces
descriptions 17list 11
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
328 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
situations 205, 217workspaces
descriptions 19list 11
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
330 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide
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
332 IBM Tivoli Advanced Reporting for DFSMShsm Monitoring Agent: User's Guide