HP Database Manager (HPDM) User Guide

Transcription

1 HP Database Manager (HPDM) User Guide HP Part Number: Published: March 2010 Edition: HP Neoview Release 2.4 Service Pack 2

2 Copyright 2010 Hewlett-Packard Development Company, L.P. Legal Notice Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR and , Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor s standard commercial license. The information contained herein is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. Export of the information contained in this publication may require authorization from the U.S. Department of Commerce. Microsoft, Windows, and Windows NT are U.S. registered trademarks of Microsoft Corporation. Intel, Pentium, and Celeron are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Java is a U.S. trademark of Sun Microsystems, Inc. Motif, OSF/1, UNIX, X/Open, and the "X" device are registered trademarks, and IT DialTone and The Open Group are trademarks of The Open Group in the U.S. and other countries. Open Software Foundation, OSF, the OSF logo, OSF/1, OSF/Motif, and Motif are trademarks of the Open Software Foundation, Inc. OSF MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THE OSF MATERIAL PROVIDED HEREIN, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. OSF shall not be liable for errors contained herein or for incidental consequential damages in connection with the furnishing, performance, or use of this material. 1990, 1991, 1992, 1993 Open Software Foundation, Inc. The OSF documentation and the OSF software to which it relates are derived in part from materials supplied by the following: 1987, 1988, 1989 Carnegie-Mellon University. 1989, 1990, 1991 Digital Equipment Corporation. 1985, 1988, 1989, 1990 Encore Computer Corporation Free Software Foundation, Inc. 1987, 1988, 1989, 1990, 1991 Hewlett-Packard Company. 1985, 1987, 1988, 1989, 1990, 1991, 1992 International Business Machines Corporation. 1988, 1989 Massachusetts Institute of Technology. 1988, 1989, 1990 Mentat Inc Microsoft Corporation. 1987, 1988, 1989, 1990, 1991, 1992 SecureWare, Inc. 1990, 1991 Siemens Nixdorf Informationssysteme AG. 1986, 1989, 1996, 1997 Sun Microsystems, Inc. 1989, 1990, 1991 Transarc Corporation.OSF software and documentation are based in part on the Fourth Berkeley Software Distribution under license from The Regents of the University of California. OSF acknowledges the following individuals and institutions for their role in its development: Kenneth C.R.C. Arnold, Gregory S. Couch, Conrad C. Huang, Ed James, Symmetric Computer Systems, Robert Elz. 1980, 1981, 1982, 1983, 1985, 1986, 1987, 1988, 1989 Regents of the University of California.

3 Table of Contents Learn About This Document...9 Publishing History...9 New and Changed Information...9 Intended Audience...9 Related Documentation...9 Neoview Customer Library...10 Resources on the Web...11 Send Feedback to HP Install and Start HPDM...13 What is the HP Database Manager?...13 Install the HP Database Manager...14 Uninstall the HP Database Manager...14 Start the HP Database Manager...14 Use Menu Bar Commands...15 Exit the HP Database Manager Connect and Disconnect...17 Connect to a System...17 Use the Connect / Edit System Dialog Box...17 Disconnect From a System...18 Log On and Off...19 Use the Systems Tool...19 Add a System...20 Use the Add System Dialog Box...21 Edit a System...22 Add a System Like...23 Remove a System...23 Test a System Navigate HPDM...25 See the Parts of the HPDM Interface...25 Select an Area...25 Control the Display of an Area...26 Use the Navigation Tree Pane...27 Understand My Active Systems...27 Understand My Other Systems...28 Use the Right Pane...29 Use the My Favorites Pane...30 Create a Favorite...31 Use a Favorite...31 View a List of Favorites...31 Create a Folder to Store Favorites...31 Add a Favorite to a Folder...31 Share Your Favorites With Others...32 Remove a Favorite...32 Remove a Favorites Folder...32 See the HPDM Header...32 Table of Contents 3

4 Customize HPDM Windows...32 Manage Windows...32 Get Version and Build Information Perform Basic HPDM Operations...35 Sort and Move Data Columns...35 Clone a Tab...36 Export Data...36 Export Data to the Clipboard...36 Export Data to a File...36 Save Data in CSV Format...36 Save Data in HTML Format...36 Save Data to a Spreadsheet...37 Export Data to a Browser...37 Communicate System Messages to Users...37 Learn About the Monitoring Area...37 Use the System Message Tab...37 Navigate the System Message Tab...38 Create a System Message...38 Clone the System Message Tab...39 Save and Import System Definitions...39 View Event Messages...40 View Dial Out and Database Events...40 See the Trace Event Message Format...40 Resource Statistics Event Message Format...41 Session Statistics: Connection Information...42 Session Statistics: Session Summary Information...42 Statement Statistics: SQL Statement...43 Statement Statistics: SQLExecute...43 Statement Statistics: SQLExecDirect...44 Statement Statistics: SQLPrepare...45 Statement Statistics: SQLFetch Manage Database Objects...47 Display Schemas and Their Objects...47 Attributes Tab...48 Tables Tab...48 Materialized Views Tab...48 Materialized View Groups Tab...48 Views Tab...49 Procedures Tab...49 Synonyms Tab...49 DDL Tab...49 Privileges Tab...50 Schema Size...50 Display Tables and Their Properties...50 Columns Tab...51 Primary Key Tab...52 Hash Key Tab...52 Unique Constraints Tab...52 Foreign Keys Tab...52 Attributes Tab...53 Partitions Tab Table of Contents

5 Usage Tab...53 DDL Tab...54 Statistics Tab...54 Privileges Tab...54 Tables Summary...55 Display Table Indexes and Their Properties...55 Columns Tab...56 Attributes Tab...56 DDL Tab...57 Partitions Tab...57 Table Indexes Summary...57 Display Views and Their Properties...58 Columns Tab...58 Usage Tab...59 DDL Tab...59 Privileges Tab...59 Display Materialized Views and Their Properties...60 Attributes Tab...61 Partitions Tab...62 Usage Tab...62 DDL Tab...62 Privileges Tab...63 Materialized Views Summary...63 Display Materialized View Indexes and Their Properties...63 Columns Tab...64 Attributes Tab...64 DDL Tab...64 Partitions Tab...65 Materialized View Indexes Summary...65 Display Materialized View Groups and Their Properties...65 Attributes Tab...66 Members Tab...66 DDL Tab...67 Display Procedures and Their Properties...67 Attributes Tab...68 Parameters Tab...69 Privileges Tab...69 Display Synonyms and Their Properties...69 Attributes Tab...70 Usage Tab...70 DDL Tab...71 Display Triggers and Their Properties...71 Attributes Tab...72 Usage Tab...73 DDL Tab...73 Display Schema DDL and Their Properties...73 DDL Tab...73 Show DDL...74 Display Table Statistics and Their Properties...75 Display Table Column Statistics...75 Viewing Sampled Statistics Use the System Monitor...77 Display the System Monitor...77 Table of Contents 5

6 See the Parts of the System Monitor...77 Understand the Performance Metrics...78 Use Tooltips to Show the Value of a Performance Metric...79 About the Timeline Tab...79 About the Hybrid Tab...80 Understand the System Status Icons...80 Get Details About System Status Icons...81 Configure System Monitor Options...82 Use the System Monitor With Segment Aggregation...84 Change a Color Option Respond to Alerts...87 Display the Alerts Tab...87 See the Parts of the Alerts Tab...87 Understand Alerts...88 Understand Privileges for Viewing and Updating Alerts...88 Get Information About Alerts...89 Understand Row Detail Information for Alerts...90 Use the Alerts Options Dialog Box...92 Control the Refresh of Alerts...93 Use the Update Alert Dialog Box...94 Update an Alert...95 Update Multiple Alerts...96 Make Notes About an Alert...96 About the Console Tab Find Offending Processes and Queries...99 About System Offender...99 Display the System Offender Tab...99 See the Parts of the System Offender Understand System Offender Privileges Find Offending Processes and Queries Get Process Detail Information Get Pstate Information Get Children Process Information Use the Children Processes Dialog Box Understand Row Details for System Offender Get Query Workload Information Use the Workload Detail Dialog Box Cancel a Query From System Offender Alter System Offender Parameters Use the Alter Offender Parameters Dialog Box Control the Refresh of System Offender Use the System Offender History Work With Data Grids About Data Grids Get Row Details for a Data Grid Copy Data-Grid Information Customize the Data Grid Search the Data Grid Table of Contents

7 10 Use the SQL Whiteboard About the SQL Whiteboard Display the SQL Whiteboard Learn About the SQL Whiteboard Panes Learn About the Statement List Pane Learn About the Statement Pane Understand Parameter Prompts Cut, Copy, Paste, Undo, and Redo Execute Highlighted Text Cancel a Query From the SQL Whiteboard Learn About the Statement Details Pane Reuse a Connection Load and Save SQL Statements to a File Highlight SQL Syntax Manage the Layout of Panes Launch the Neoview Command Interface (NCI) Learn About NCI Locate the NCI Program Launch NCI Set Auto Logon Options Manage Disk Space About Space Management Display the Space Management Area See the Parts of Space Management Understand Space Usage Statistics Get Version and Build Information for Space Management About the Monitoring Tab View the Over Threshold Summary View the System Overall View the System Detail View SQL Objects View the SQL Objects Detail View Partition Distribution Across Disks View Table Growth By Table Tab Top Fastest Growing Tables Tab Understand Historical Space Data About the Configuration Tab About the General Tab Inventory Control Space Reference Settings Inventory Process Detail Status About the Advanced Tab Inventory Options Update Space Reference Tables Snapshot Periods Table Tab Classification Rule Table Tab About Space Management Tracing Options Glossary Table of Contents 7

8 Index Table of Contents

9 Learn About This Document This guide describes how to use the HP Database Manager (HPDM) to monitor and manage a Neoview Data Warehousing Platform for Business Intelligence. Publishing History This guide supports HP Neoview Release 2.4 Service Pack 2 and all subsequent Release 2.4 product versions until otherwise indicated by its replacement publication. The publication date and part number indicate this document s current edition: Part Number Product Version HP Neoview Release 2.4 Service Pack 2 HP Neoview Release 2.4 Service Pack 1 HP Neoview Release 2.4 Publication Date March 2010 October 2009 April 2009 Online Help Build Date: February 15, 2010 New and Changed Information The README for the current release or service pack describes the new features for this update of HPDM. You can find the README with the rest of the Neoview documentation. See Resources on the Web (page 11). These are the principal changes for this edition of the HPDM documentation: Added these new chapters and all the topics within them: Manage Disk Space (page 125) Made these miscellaneous changes: Updated the Neoview Customer Library (page 10). Updated the customer documentation URL in Resources on the Web (page 11). Updated these topics: Added Space Management information to Select an Area (page 25). Added information about the new Fixed Incoming option to Configure System Monitor Options (page 82). Added information about acknowledging and closing alerts to Update an Alert (page 95). Added these new glossary terms: active command Intended Audience This guide is intended for those who perform standard database administration tasks. It provides basic concepts and task information to get you started quickly and easily. Related Documentation This manual is part of the HP Neoview customer library. Publishing History 9

10 Neoview Customer Library The manuals in the Neoview customer library are listed here for your convenience. Customer library manuals are available on the customer documentation Web site. Resources on the Web (page 11). Administration Neoview Character Sets Administrator's Guide Neoview Database Administrator s Guide Neoview Guide to Stored Procedures in Java Neoview Query Guide Neoview Transporter User Guide Information for database administrators and end users of the Neoview Character Sets product, including rules for defining and managing character data using SQL language elements, capabilities and limitations of Neoview client applications, troubleshooting character set-related problems, and enabling Pass-Through mode in the ISO88591 configuration. Information about how to load and manage the Neoview database by using the Neoview DB Admin and other tools. Information about how to use stored procedures that are written in Java within a Neoview database. Information about reviewing query execution plans and investigating query performance of Neoview databases. Information about processes and commands for loading data into your Neoview platform or extracting data from it. README files for installing Administration client products README for the HP Neoview Windows Client Package README for the HP Neoview Transporter Java Client Management HP Database Manager (HPDM) Online Help HP Database Manager (HPDM) User Guide Neoview Command Interface (NCI) Guide Neoview Command Interface (NCI) Online Help Neoview DB Admin Online Help Neoview Management Dashboard Client Guide for Database Administrators Neoview Management Dashboard Online Help Neoview Performance Analysis Tools Online Help Neoview Performance Analysis Tools User Guide Neoview Reports Online Help Neoview Repository User Guide Help topics that describe how to use the HP Database Manager client to monitor and manage a Neoview data warehousing platform. Information for database administrators about how to monitor and manage a Neoview data warehousing platform using the HP Database Manager. Information about using the HP Neoview Command Interface to run SQL statements interactively or from script files. Command-line help that describes the commands supported in the current operating mode of Neoview Command Interface. Context-sensitive help topics that describe how to use the HP Neoview DB Admin management interface. Information on using the Dashboard Client, including how to install the Client, start and configure the Client Server Gateway (CSG), use the Client windows and property sheets, interpret entity screen information, and use Command and Control to manage queries from the Client. Context-sensitive help topics that describe how to use the Neoview Management Dashboard Client. Context-sensitive help topics that describe how to use the Neoview Performance Analysis Tools to analyze and troubleshoot query-related issues on the Neoview data warehousing platform. Information about how to use the Neoview Performance Analysis Tools to analyze and troubleshoot query-related issues on the Neoview data warehousing platform. Help topics that describe how to use the HP Neoview Reports Tool. Information about using the Repository, including descriptions of Repository views and guidelines for writing Neoview SQL queries against the views. 10

11 Neoview System Monitor Quick Start Neoview User Management Information Neoview Workload Management Services Guide README files for installing Management client products Instructions for starting, using, customizing, and troubleshooting the Neoview System Monitor. Information about the logging of user-management actions on the Neoview platform and the facilities available for monitoring such actions. Information about using Neoview Workload Management Services (WMS) to manage workload and resources on a Neoview data warehousing platform. README for the HP Neoview Windows Client Package README for the HP Database Manager (HPDM) README for the HP Neoview Management Dashboard Client README for the HP Neoview Command Interface (NCI) README for the HP Neoview Reports Client README for the HP Neoview Performance Analysis Tools README for the HP Neoview System Monitor Connectivity Neoview JDBC Type 4 Driver API Reference Neoview JDBC Type 4 Driver Programmer s Reference Neoview ODBC Drivers Manual ODBC Client Administrator Online Help README files for installing Connectivity client products Reference information about the HP Neoview JDBC Type 4 Driver API. Information about using the HP Neoview JDBC Type 4 driver, which provides Java applications on client workstations access to a Neoview database. Information about using HP Neoview ODBC drivers on a client workstation to access a Neoview database. Context-sensitive help topics that describe how to use the ODBC Data Source Administrator. README for the HP Neoview Windows Client Package README for the HP Neoview JDBC Type 4 Driver README for the HP Neoview ODBC Driver for Windows README for the HP Neoview ODBC Drivers for UNIX Reference Mapping Tables for Neoview Character Sets Neoview SQL Reference Manual Neoview Messages Manual README for HP Neoview Release 2.4 Service Pack 2 A hyperlinked collection of East Asian characters supported by Neoview character set functionality. Reference information about the syntax of SQL statements, functions, and other SQL language elements supported by the Neoview database software. Cause, effect, and recovery information for error messages. Information about new features for the current release, including where to download software and obtain documentation. Resources on the Web Neoview Customer Documentation HP Software Depot Send Feedback to HP HP encourages your comments concerning this document or this product. We are committed to providing products and documentation that meet your needs. Send any errors found or suggestions for improvement to docsfeedback@hp.com. Resources on the Web 11

12 Include the document title and part number shown below: Document Title: HP Database Manager (HPDM) User Guide Part Number:

13 1 Install and Start HPDM What is the HP Database Manager? The HP Database Manager (HPDM) is an integrated graphical client that allows you to connect to and manage multiple HP Neoview platforms. HPDM provides database-object browsing and monitoring capabilities that are superior to the Neoview DB Admin product. HPDM requires the HP ODBC 2.0 client driver for Windows to connect to an HP Neoview platform. Download the HP ODBC 2.0 client driver from the HP Software Depot download site and install it prior to running the HP Database Manager. See Resources on the Web (page 11). HPDM provides these features: Platform Monitoring Provides performance monitoring capabilities Provides the ability to monitor alerts and alarms. Enables the monitoring of offending workloads. Database-Object Browsing Provides database-object browsing capabilities Displays partition information for individual Neoview SQL objects Displays a partition summary for groups of objects (for example, all tables in a schema) Displays schema size information Displays sequence numbers in table columns Provides a DDL tool to generate and save the DDL script for a group of Neoview SQL objects Displays table profile and statistics information Generates and displays system status messages Space Management Allows you to monitor and display SQL space-related data Displays six panels of detailed SQL-space usage statistics Presents SQL space by user, by schema, by table, and by partition Helps you identify and react to fast-growing tables by looking at historical trends SQL Whiteboard Executes DDL/DML statements Persists queries across sessions for reuse Exports query results to a spreadsheet Allows a portion of an SQL statement to be highlighted and executed (syntax highlighting) Cancels an executing query Opens/saves query text to a file HPDM Framework Provides connection management for widgets Supports persistence for widget and application data Includes menu management Implements area management (hide, show, and deploy) Exports grid contents to a spreadsheet Manages options for an HPDM application as a whole and for individual areas and widgets What is the HP Database Manager? 13

14 Launches the Neoview Command Interface (NCI) Supports character sets for ISO, SJIS, or Unicode based on a single-client locale (only one character set can be configured for each install). Install the HP Database Manager The HP Database Manager is installed with a Windows installer. You can install the client by itself or as part of a bundle of Neoview clients provided by the Neoview Windows Client Package. Information about the installers can be found on the HP Software Depot web site. Instructions for installing the software are contained in the README for the HP Database Manager (HPDM). See Resources on the Web (page 11). HPDM has these installation requirements: Requirement Computer Display resolution Memory Disk space Operating system ODBC Additional HP Neoview release Description Windows compatible PC workstation 1024 x 768 pixels Recommended minimum 512 MB Minimum 10 MB for installation and 64 MB free space Microsoft Windows XP/Microsoft Windows Vista 32/64 bit ODBC driver for Neoview Release 2.4 Service Pack 2 Microsoft.NET Framework 2.0 or later Release 2.4 Service Pack 2 Uninstall the HP Database Manager After HP Database Manager is installed, you can uninstall it by using the Uninstall feature in the Start > All Programs > HP Database Manager menu or use the Control Panel, Add and Remove Programs feature. Note these considerations for uninstalling: Normally, you do not have to uninstall the client before installing a new client application. When upgrading from an older version to a newer version, HPDM overwrites the files for the older version. When downgrading from a newer version to an older version of HPDM, HP recommends that you uninstall the current version before installing the down-rev version. Uninstalling does not remove favorites or system definitions. However, uninstalling and then installing a down-rev client can remove the system definitions. If you uninstall from the Start menu, a prompt asks if you want to repair or remove the HP Database Manager. Selecting Repair is non-destructive and simply verifies the program files. Selecting Remove begins the uninstall process. Related Topics Get Version and Build Information (page 33) Save and Import System Definitions (page 39) Start the HP Database Manager To start the HP Database Manager, use either of these methods: Double-click the HP Database Manager icon on your desktop: 14 Install and Start HPDM

15 From the Start menu, select Start > All Programs > HP Database Manager > HP Database Manager. NOTE: Most HPDM features require you to connect to the Neoview data warehousing platform through the ODBC client driver. For more information, see Connect to a System (page 17). Use Menu Bar Commands The menu bar is the list of commands at the top of the HPDM main window. The menu bar commands are: File, Edit, Tools, Windows, and Help. The File menu options are: Menu Option Import Persistence Save Persistence Export Persistence Description Imports persistence data from a file that was saved earlier by HPDM. NOTE: All of the current settings are replaced by the settings in the file being imported. See Save and Import System Definitions (page 39). Saves the configuration. The current state is saved when the application closes or when certain events happen within HPDM. Saves the configuration to any file. The Export Persistence option can be used when exporting a specific configuration to other users in the organization. See Save and Import System Definitions (page 39). Related Topics See the Parts of the HPDM Interface (page 25) Save and Import System Definitions (page 39) Terms menu bar persistence file system definition Exit the HP Database Manager To exit HPDM, close the HP Database Manager main window by selecting File > Exit or clicking the Close ([ X ]) button in the upper right corner of the main window. Exiting the application securely disconnects all active sessions. To disconnect from a single active session without exiting HPDM or closing other active sessions, use the Disconnect command. See Disconnect From a System (page 18). Use Menu Bar Commands 15

16 16

17 2 Connect and Disconnect Connect to a System If this is the first time you are attempting to connect to a system, you must create a system definition. See Add a System (page 20). If a system definition is already created, use these steps to connect: 1. Enter the Connect command by using either of these methods: In the My Other Systems folder, right-click the system name, and select Connect. The Connect / Edit System dialog box appears. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Then double-click the system definition that you want to connect to. Or select the system definition, and click [ Edit ]. The Connect / Edit System dialog box appears. 2. Enter connection information into the Connect / Edit System dialog box. See the descriptions of each field in Use the Connect / Edit System Dialog Box (page 17). 3. Click one of these buttons: Button [ Save ] [ Connect ] [ Cancel ] Description Creates the new system definition, but does not attempt to connect to the system. Attempts to connect to the system using the entries specified in the Connect / Edit System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. The system name also is added to the My Active Systems folder. If the connection attempt is not successful, a Connection Test Result dialog box opens and indicates the test failed for the Neoview platform specified in the Connect / Edit System dialog box. Click [ OK ] to close the Connection Test Result dialog box. Cancels the operation. Related Topics Add a System (page 20) Use the Connect / Edit System Dialog Box (page 17) Log On and Off (page 19) Disconnect From a System (page 18) Terms My Active Systems Systems Tool system definition Use the Connect / Edit System Dialog Box This table shows reference information for the Connect / Edit System dialog box: Fields Your Name for System Data Source Description An alias to identify this Neoview platform. The name can be up to 32 characters in length and consist of letters, digits, and the underscore character. Specifies the name of the data source. If no data source is specified, or if the specified client-side data source cannot be found on the server, the client connects to the default data source (TDM_Default_DataSource). Connect to a System 17

18 Fields User Name Password Host Port Number Default Schema Driver Description Your user name. Your Neoview password. The DNS name or IP address for the target Neoview platform. The NDCS server port number. The default schema to use if composing a query. For the current release, if this field is left blank, the default schema is typically the schema matching your user name with any lowercase characters upshifted. The installed Neoview ODBC driver to be used with this Neoview platform. In the Connect / Edit System dialog box, these buttons allow you to add a new system definition, connect to a system, or close the system definition. Button [ Save ] [ Connect ] [ Cancel ] Description Creates the new system definition but does not attempt to connect to the system. Attempts to create the new system using the entries specified in the fields of the Connect / Edit System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. The system name also is added to the My Active Systems folder. If the connection attempt is not successful, a Connection Test Result dialog box opens to indicate the test failed for the Neoview platform specified in the Connect / Edit System dialog box. Click [ OK ] to close the Connection Test Result dialog box. Closes the dialog box without making changes. Related Topics Edit a System (page 22) Connect to a System (page 17) Terms My Active Systems system definition TDM_Default_DataSource Disconnect From a System Disconnecting closes all ODBC connections with a system. To disconnect from a selected system: 1. Enter the Disconnect command by using either of these methods: In the My Active Systems folder, right-click the system name in the My Active Systems folder, and select Disconnect. The Confirm dialog box appears. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Select a system definition, then click [ Disconnect ]. The Confirm dialog box appears. 2. In the Confirm dialog box: Click [ Yes ] to disconnect the selected system, and close the Confirm dialog box. Click [ No ] to retain a connection with the selected system, and close the Confirm dialog box. Once you have disconnected, the system is moved under the My Other Systems folder. To disconnect from all systems, see Exit the HP Database Manager (page 15). Related Topics Use the Systems Tool (page 19) Exit the HP Database Manager (page 15) 18 Connect and Disconnect

19 Terms disconnect Systems Tool Log On and Off You log on to HPDM as part of connecting to a system. See Connect to a System (page 17). To connect to a system, you must create a system definition. The system definition is saved and can be reused over and over again. After a system definition is created, you need only specify a password to connect to a system. The tool you use to work with system definitions is the Systems Tool. See Use the Systems Tool (page 19). You log off from a system by performing either of these operations: Disconnecting. Disconnecting closes all ODBC connections with a system without removing the system definition or exiting the HPDM client application. See Disconnect From a System (page 18). Exiting the HPDM client application. Exiting disconnects all active sessions (all systems) simultaneously without removing the system definitions. See Exit the HP Database Manager (page 15). Related Topics Connect to a System (page 17) Use the Systems Tool (page 19) Disconnect From a System (page 18) Exit the HP Database Manager (page 15) Terms system definition Systems Tool Use the Systems Tool The Systems Tool contains the components used to define, add, edit, remove, duplicate, test, and open existing systems on the Neoview platform. To open the Systems Tool, select Tools > Systems Tool. The Systems Tool window displays these settings: Setting State System Name Data Source User Name Host Port Number Default Schema DriverString Description Specifies the current state of the system definition as one of: Password not specified Not tested Test failed Test succeeded Specifies an alias to identify this Neoview platform. The system name can be up to 32 characters in length, and can consist of letters, digits, and the underscore character. Specifies the name of the data source. If no data source is specified, or if the specified client-side data source cannot be found on the server, the client connects to the default data source (TDM_Default_DataSource). Your user name. The DNS name or IP address for the target Neoview platform. Contains the ODBC server port number. Contains the default entry for the system (optional). Specifies the ODBC driver. Log On and Off 19

20 The button options for the Systems Tool are: Button [ Test ] [ Edit ] [ Add ] [ Add Like ] [ Remove ] [ Disconnect ] [ Done ] Function Tests a selected system and displays the results in the Connection Test Result dialog box. [ Test ] is enabled if one or more systems are selected. Launches the Connect / Edit System dialog box with the selected systems current settings. [ Edit ] is enabled if one or more systems are selected. Launches the Add System dialog box with blank settings, except for the port number (which defaults to 18650). The ODBC driver defaults to 2.0. [ Add ] is always enabled. Launches the Add System Like dialog box with the selected systems current settings. You can use these settings as a starting point for adding a new system. [ Add Like ] is enabled if only one system is selected. Launches the Confirm dialog box. [ Remove ] is enabled if one or more systems is selected. Launches the Confirm dialog box. [ Disconnect ] is enabled if one or more systems is selected. Closes the Systems Tool. Terms system data source TDM_Default_DataSource Add a System If no system definitions are present from a previous session, regardless of whether the currently running version of HPDM is a new, updated, or an existing installation, you must create a new system definition. NOTE: HPDM can connect to platforms running Neoview Release 2.3 and later. However, not all features available in the current release are available in down-rev releases. If a feature is not available, HPDM returns an error message. To create a new system definition: 1. Use either of these methods to open the Add System dialog box: In the navigation tree pane, right-click the My Active Systems or My Other Systems folder, and select Add System. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Then click [ Add ]. 2. Enter information into the Add System dialog box. See the descriptions of each field in Use the Add System Dialog Box (page 21). 20 Connect and Disconnect

21 3. Click one of these buttons: NOTE: Once a system is added, the system definition persists from session to session unless it is removed. Button [ Add] [ Connect ] [ Cancel ] Description Creates the new system definition, but does not attempt to connect to the system. Attempts to create the new system using the entries specified in the Add System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. If the connection attempt is not successful, a Connection Test Result dialog box opens and indicates the test failed for the Neoview platform specified in the Add System dialog box. Click [ OK ] to close the Connection Test Result dialog box. Cancels the operation. Related Topics Use the Add System Dialog Box (page 21) Connect to a System (page 17) Terms system definition Use the Add System Dialog Box This table shows reference information for the Add System dialog box: Field Your Name for System Data Source User Name Password Host Port Number Default Schema Driver Description An alias to identify this Neoview platform. The name can be up to 32 characters in length and can consist of letters, digits, and the underscore character. Specifies the name of the data source. If no data source is specified, or if the specified client-side data source cannot be found on the server, the client connects to the default data source (TDM_Default_DataSource). Your user name. Neoview password. The DNS name or IP address for the target Neoview platform. The ODBC server port number. The default schema to use if composing a query. For the current release, if this field is left blank, the default schema is typically the schema matching your user name with any lowercase characters upshifted. The installed Neoview ODBC driver to be used with this Neoview platform. Use the Add System Dialog Box 21

22 In the Add System dialog box, these buttons allow you to add a new system, add and connect to a new system, or cancel the operation. Button [ Add ] [ Connect ] [ Cancel ] Description Creates the new system definition, but does not attempt to connect to the system. Attempts to create the new system using the entries specified in the Add System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. If the connection attempt is not successful, a Connection Test Result dialog box opens and indicates the test failed for the Neoview platform specified in the Add System dialog box. Click [ OK ] to close the Connection Test Result dialog box. Cancels the operation. Related Topics Add a System (page 20) Terms system definition TDM_Default_DataSource Edit a System You cannot edit an active system definition. If you need to edit a system definition that is currently in the My Active Systems folder, you must first disconnect from the system. To edit a system definition: 1. Use either of these methods to open the Connect / Edit System dialog box: In the navigation tree pane, right-click a system name in the My Other Systems folder, and select Connect or Edit. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Select a system definition that is currently inactive, then click [ Edit ]. 2. Enter information into the Connect / Edit System dialog box. See the descriptions of each field in Use the Connect / Edit System Dialog Box (page 17). 3. Click one of these buttons: Button [ Save ] [ Connect ] [ Cancel ] Description Creates the new system definition, but does not attempt to connect to the system. Attempts to create the new system using the entries specified in the Add System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. If the connection attempt is not successful, a Connection Test Result dialog box opens and indicates the test failed for the Neoview platform specified in the Connect / Edit System dialog box. Click [ OK ] to close the Connection Test Result dialog box. Cancels the operation. Related Topics Disconnect From a System (page 18) Use the Connect / Edit System Dialog Box (page 17) 22 Connect and Disconnect

23 Add a System Like... To add a system by modifying a copy of another system definition: 1. Use either of these methods to open the Add System Like dialog box: In the navigation tree pane, right-click any system name, and select Add System Like This. The Add System Like dialog box is displayed. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Select the system definition that you want to copy. Then click [ Add Like ]. The Add System Like dialog box is displayed. 2. In the Add System Like dialog box: a. Specify a new name in the Your name for system field. b. Validate the information specified for the selected system, changing the required fields as needed. The title bar displays the system whose settings are being used as a template for the new system. For reference, see Use the Add System Dialog Box (page 21). c. Click one of these buttons: Button [ Add ] [ Connect ] [ Cancel ] Description Creates the new system definition, but does not attempt to connect to the system. Attempts to create the new system using the entries specified in the Add System dialog box: If the connection is successful, the entry for the system is created and appears in the Systems Tool window. If the connection attempt is not successful, a Connection Test Result dialog box opens and indicates the test failed for the Neoview platform specified in the Add System Like dialog box. Click [ OK ] to close the Connection Test Result dialog box. Cancels the operation. Related Topics Use the Add System Dialog Box (page 21) Terms system definition Remove a System To remove a selected system: 1. Use either of these methods to issue the Remove System command: In the navigation tree pane, right-click the system, and select Remove System. The Confirm dialog box is displayed. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. Select the system that you want to remove, and click [ Remove ]. The Confirm dialog box is displayed. 2. In the Confirm dialog box, click one of these buttons: [ Yes ] removes the system definition, and closes the Confirm dialog box. [ No ] retains the system definition and closes the Confirm dialog box. Test a System To test the validity of the ODBC connection to a system, use either of these methods: Initiate a test from the navigation tree pane: Add a System Like... 23

24 1. Connect to the system as described in Connect to a System (page 17). 2. In the My Active Systems folder, right-click the system, and select Test System. Initiate a test from the Systems Tool: 1. Connect to the system as described in Connect to a System (page 17). 2. Display the Systems Tool by selecting Tools > Systems Tool from the menu bar. 3. Select the connected system that you want to test. 4. Click [ Test ]. Selecting the Test System or [ Test ] command: Causes an attempt to make a connection to the Neoview platform specified in the selected system definition. Returns a validating result in the Connection Test Result dialog box that indicates the following: Result Connection test succeeded Test failed Password not specified Not tested Meaning The system definition settings have been tested, and the system can support an ODBC connection. The settings have been tested, and the test failed. If the test failed, the reason for the failure is also provided in the Connection Test Result dialog box. The system is added to the My Other Systems folder. The password has not been specified. If the password is empty, you must have clicked in this field to explicitly set an empty password. The entry is possibly empty and has not been tested. Terms system definition My Active Systems My Other Systems 24 Connect and Disconnect

25 3 Navigate HPDM See the Parts of the HPDM Interface Related Topics Use the Navigation Tree Pane (page 27) Use the Right Pane (page 29) Use the My Favorites Pane (page 30) Use Menu Bar Commands (page 15) Select an Area To select an area, click one of the blue bars below the navigation tree pane: See the Parts of the HPDM Interface 25

26 Areas are broad categories of features that you can monitor or manage using HPDM. The supported areas are: Area Space Management Monitoring Database Description Provides information about SQL-space usage on the system. See Manage Disk Space (page 125). Provides alert and alarm information for the system. Provides the system message, as well as any other system-wide information that might be informative to an administrator or user. Each aspect of the system that is displayed in the Monitoring area is contained within its own tab. See Use the System Monitor (page 77). Provides information about the database objects. See Manage Database Objects (page 47). HPDM displays the currently selected area below the menu bar ( See the Parts of the HPDM Interface (page 25)). When an area is selected, HPDM displays the characteristics of that area for all defined systems. Related Topics Control the Display of an Area (page 26) Terms area Control the Display of an Area By default, HPDM displays all of the areas that the currently installed server software supports displaying. However, any user can show or hide an area by using the Options menu. To display the Options menu, select Tools > Options: 26 Navigate HPDM

27 To hide an area: 1. Deselect the option for the area in the Show/Hide Area Options group box. 2. Click [ OK ]. To show an area that is hidden: 1. Select the option for the area in the Show/Hide Area Options group box. 2. Click [ OK ]. Related Topics Select an Area (page 25) Terms area Use the Navigation Tree Pane The navigation tree pane is the left pane of HPDM below the My Favorites pane. See the Parts of the HPDM Interface (page 25). The navigation tree pane displays a tree of the database objects in hierarchical form. The navigation tree pane allows you to select a platform (system) and display the associated database objects in the right pane. Through the use of displays, you can switch between different systems and manage multiple Neoview platforms from one user interface. The navigation tree pane divides systems into two categories, or folders : My Active Systems folder My Other Systems folder Understand My Active Systems My Active Systems refers to the group of Neoview platforms that are defined and currently connected. If no systems are connected and you select the My Active Systems folder, the right pane displays this message: In order to use a system you must have added it. You can do so by clicking the Add System button below. If you add a system and its settings are complete and correct, it will be added to the My Active Systems folder. If the system s settings are incomplete and/or incorrect, it will be added to the My Other Systems folder. In either case, you will be able to edit the system later. To add a new system, click [ Add System ] at the bottom of the dialog box. If systems have been added previously, the right pane displays the active systems. Use the Navigation Tree Pane 27

28 To display the My Active Systems folder options, right-click the My Active Systems heading. The options are: Menu Item Add to Favorites Refresh Add System Description Opens the New Favorite dialog box if a system definition is present and selected. If no system definition is present or selected, this command has no effect. Refreshes the selected object and all children for the object in the navigation tree. Opens the Add System dialog box, allowing you to create a new system. See Add a System (page 20). To display options for an active system in the My Active Systems folder, right-click a system definition and the options are: Menu Item Add to Favorites Refresh Disconnect Test System Add System Like This Remove System Dial Out Events Database Events Description Creates a shortcut for the object under My Favorites. The New Favorite dialog box is launched to provide an alias for the object. See Use the My Favorites Pane (page 30). Refreshes the object and all children for the object in the navigation tree. Closes all ODBC communication with the system. See Disconnect From a System (page 18). Tests the validity of a system. See Test a System (page 23). Adds a system like the selected system s current settings. See Add a System Like... (page 23). Removes a selected system. See Remove a System (page 23). Opens a browser window allowing you to view system events that are dialed out to HP Support. See View Dial Out and Database Events (page 40). Opens a browser window allowing you to view events related to database activity, data loads, and queries. See View Dial Out and Database Events (page 40). Related Topics See the Parts of the HPDM Interface (page 25) Add a System (page 20) Use the My Favorites Pane (page 30) Disconnect From a System (page 18) View Dial Out and Database Events (page 40) Terms My Active Systems My Other Systems Understand My Other Systems My Other Systems refers to the group of Neoview platforms that are defined but not currently connected. If you select the My Other Systems folder, the right pane displays the systems where the system settings are incomplete or incorrect. If systems have been previously added, the right pane displays these systems. 28 Navigate HPDM

29 To display the My Other Systems folder options, right-click the My Other Systems folder and the options are: Menu Item Add to Favorites Refresh Add System Description Opens the New Favorite dialog box if a system definition is present and selected. If no system definition is present or selected, this command has no effect. Refreshes the object and all children for the object in the navigation tree. Creates a new system. See Add a System (page 20). To display options for a system in the My Other Systems folder, right-click a system and the options are: Menu Item Add to Favorites Refresh Connect Edit Add System Like This Remove System Description Creates a shortcut to the selected system on the navigation tree pane. See Use the My Favorites Pane (page 30). Refreshes the object and all children for the object in the navigation tree. Uses the values defined in the system definition to establish an ODBC connection with the system. See Connect to a System (page 17). Edits an active system. See Edit a System (page 22). Adds a system like the selected system s current settings. See Add a System Like... (page 23). Removes a selected system. See Remove a System (page 23). If you select a system from the My Other Systems folder, the right pane displays the Edit System dialog box. You can edit the system configuration and select [ Test ] or [ Apply ]. Related Topics See the Parts of the HPDM Interface (page 25) Add a System (page 20) Terms My Active Systems My Other Systems Use the Right Pane The right pane displays information about the selected objects in the My Favorites pane or the navigation tree pane. The navigation buttons displayed in the top right pane are: Button [ Parent ] [ Previous ] [ Next ] Function Displays the schema folder and all folders for that system. Takes you to the previous schema (if any). If no other schemas exist, [ Previous ] is disabled. Takes you to the next schema (if any). If no other schemas exist, [ Next ] is disabled. Use the Right Pane 29

30 When My Active Systems or My Other Systems are selected, the buttons that are displayed in the bottom right pane are: Button [ Test ] [ Edit ] [ Add ] [ Add Like ] [ Remove ] [ Disconnect ] Function Tests a selected system and displays the results in the Connection Test Result dialog box. [ Test ] is enabled if one or more systems is selected. Launches the Edit System dialog box with the selected systems current settings. [ Edit ] is enabled if one or more systems is selected. Launches the Add System dialog box with blank settings, except for the port number (which defaults to 18650). The ODBC driver defaults to 2.0. [ Add ] is always enabled. Launches the Add Like System dialog box with selected systems current settings. You can use these settings as a starting point for adding a new system. [ Add Like ] is enabled if only one system is selected. Launches the Confirm dialog box. [ Remove ] is enabled if one or more systems is selected. Launches the Confirm dialog box. [ Disconnect ] is enabled if one or more systems is selected. If tabular data is displayed in the right pane, the buttons available in the bottom right pane are: Button [ Data to Clipboard ] [ Data to Browser ] [ Data to Spreadsheet ] [ Data to File ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). Related Topics See the Parts of the HPDM Interface (page 25) Export Data (page 36) Terms right pane navigation tree pane Use the My Favorites Pane A favorite is a shortcut to an object on the navigation tree pane. Favorites save you the trouble of having to scroll through and expand numerous parent objects. Favorites are displayed in the My Favorites pane. HPDM enables you to create favorites and organize them in folders. NOTE: The My Favorites pane is not present when the Monitoring area is selected. Related Topics Use the Navigation Tree Pane (page 27) See the Parts of the HPDM Interface (page 25) Select an Area (page 25) Terms favorite My Favorites pane 30 Navigate HPDM

31 Create a Favorite Use a Favorite To create a favorite, use either of these methods: Drag and drop an object into the My Favorites pane: 1. Optional: If you want the favorite to reside in a folder in the My Favorites pane, and the folder does not exist yet, you must create the folder first. See Create a Folder to Store Favorites (page 31). 2. In the navigation tree pane, navigate to the object. 3. Click and drag the object into the My Favorites pane, letting go of the object when your cursor is above either a folder name or My Favorites. A dialog box asks you to enter a name for the favorite. 4. Type a name for the favorite (names must be less than 256 characters), and click [ OK ]. If you selected a folder in the first step, the favorite is added to the folder. If not, the favorite is added to the My Favorites top-level hierarchy. Right-click an object and use menu commands to create the favorite: 1. Optional: If you want the favorite to reside in a folder in the My Favorites pane, select the folder. If the folder does not exist, see Create a Folder to Store Favorites (page 31). 2. In the navigation tree pane, navigate to the object. 3. Right click the object, and select Add To Favorites. A dialog box asks you to enter a name for the favorite. 4. Type a name for the favorite (names must be less than 256 characters), and click [ OK ]. If you selected a folder in the first step, the favorite is added to the folder. If not, the favorite is added to the My Favorites top-level hierarchy. To use a favorite, click the favorite in the My Favorites pane. Information about the favorite is displayed in the right pane. View a List of Favorites To view a list of current favorites and folders in the My Favorites top-level hierarchy, including the path to each favorite, double-click My Favorites In the My Favorites pane. To view a list of favorites contained in a folder, including the path to each favorite, double-click the folder. Create a Folder to Store Favorites In the My Favorites pane, you can create folders at the top level or folders within folders: 1. In the My Favorites pane, right-click My Favorites, and select New Folder. NOTE: To create a folder within a previously configured folder, right-click the folder, and select New Folder. 2. Type a name for the folder, and click [ OK ]. Add a Favorite to a Folder You can create a favorite and store it in a folder, but you cannot: Move a favorite from one folder to another folder. Move a favorite that already exists in the top-level hierarchy of the My Favorites pane into a folder. To add a favorite to a folder: Use the My Favorites Pane 31

32 1. If necessary, create the folder. See Create a Folder to Store Favorites (page 31). 2. Create a favorite in the desired folder by performing the steps in Create a Favorite (page 31). Share Your Favorites With Others You can save your favorites (and other personalized client settings) by saving and sharing a copy of your system definitions. See Save and Import System Definitions (page 39). Remove a Favorite To remove a favorite, right-click the favorite, and select Remove. Remove a Favorites Folder To remove a folder, right-click the folder, and select Remove. The folder and all favorites contained within it are removed. See the HPDM Header The HPDM header appears at the top of the right pane. See the Parts of the HPDM Interface (page 25). The header displays: The name of the system definition Host and port information for the current connection User name The selected area or information about the database object currently selected in the navigation tree pane Customize HPDM Windows HPDM allows you to customize and resize areas that are displayed. HPDM scrolls continuously in any direction, when the appropriate scroll arrow is clicked and held. The relative position of the window is changed by selecting and moving the scroll box along the scroll bar. HPDM retains area settings between sessions. HPDM windows can be resized by dragging the window corner or border. If a border is dragged, the window size changes only on the side of the border. If a corner is dragged, the two adjoining sides to the corner change size at the same time. When a window is resized, graphical objects in a window get resized, if necessary. When a window is resized, vertical and horizontal scroll bars in a window get resized, if necessary. If a window has a minimum size, it cannot be resized smaller than the minimum size. Manage Windows The HPDM cloning feature makes it easy to display any information in a separate window without having to launch a new instance of HPDM. To help you manage multiple windows, HPDM provides a Windows Manager that lists all of the open windows and provides functions for displaying and closing these windows. 32 Navigate HPDM

33 To open the Windows Manager, select Windows > Windows Manager from the menu bar. The Windows Manager buttons are: Button [ Window(s) To Front ] [ Close Window(s) ] [ Main Window To Front ] [ OK ] Description Moves the selected windows to the front. Closes the selected windows but leaves the main window open. Displays the main window. Closes the Windows Manager. Related Topics Clone a Tab (page 36) Get Version and Build Information Version and build information appears in the About box. To access the About box, select the Help > About menu in HPDM. The About HP Database Manager dialog box displays the current build information about HPDM. The HPDM.exe version information and the version procedure (VPROC) information is displayed, for example: The About dialog box also displays information about the installed components: Installed Components displays the components currently installed in this HPDM product version. Description describes the components. Click the installed component to view a brief description of the component. Get Version and Build Information 33

34 34

35 4 Perform Basic HPDM Operations Sort and Move Data Columns You might want to see rows in an HPDM display (for example, a list of schemas) grouped by a specific type of information. You can sort the displayed data based on column values. You can also change the order of the columns by dragging a column heading to the left or right. To change the sort order of a displayed column: Click the title of the column that you want to sort. A triangle appears to the right of the heading to indicate ascending or descending order: To sort on multiple columns: 1. Click a column heading. 2. Hold down the Ctrl key and click another column heading. 3. Continue holding down the Ctrl key and clicking additional column headings until you have selected all of the desired columns for the multicolumn sort. HPDM numbers the selected columns and sorts the data based on the selected columns: To move a displayed data column: 1. Click and drag a column heading to the left or right, and release the column in a new position. A shaded outline of the column heading facilitates placement: Sort and Move Data Columns 35

36 2. Repeat as necessary until the columns are arranged the way you want them. Clone a Tab HPDM allows you to clone some tabs in a new window. This feature creates a copy of the selected tab and its information in a new window that can be resized and compared side-by-side with other cloned windows. This feature is especially useful if you want to monitor multiple systems or multiple aspects of the same system at the same time. To clone a tab, double-click the tab name, or right-click a tab name and select Clone in Window. NOTE: Cloning is not currently supported for these tabs: Bar Graph tab Timeline tab Hybrid tab System Offender tab Privileges tab Tabs in the Space Management area Export Data Export Data to the Clipboard [ Data to Clipboard ] saves the data to the clipboard. Each value is a double-quoted string. The clipboard can then be pasted to any Windows document (for example, Excel, Notepad, or Word). Export Data to a File [ Data to File ] (if enabled) displays a window to export the contents to a file. There are two format types available for [ Data to File ]: Save Data in CSV Format (page 36) Save Data in HTML Format (page 36) Save Data in CSV Format In Comma Separated File Format (CSV) the data is saved in a comma separated format [.csv]. In the Save As dialog box: Navigate to a location where a copy of the data can be saved. Enter a name for the content in the Save As box. Select Save As Type (with the.csv extension) The default location is %HOME% dir or the users default application directory if %HOME% is not defined. Save Data in HTML Format In HTML format the data is saved using the table <tr>, <td> tags. In the Save As dialog box: Navigate to a location where a copy of the data can be saved. Enter a name for the content in the Save As box. Select Save As Type (with the.html extension) The default location is %HOME% dir or the users default application directory if %HOME% is not defined. 36 Perform Basic HPDM Operations

37 Save Data to a Spreadsheet [ Data to Spreadsheet ] transparently saves the table data to a temporary local file in standard HTML table format and then executes the file. Executing the temporary local file into an Excel file launches Excel on a windows system if Excel is installed. Export Data to a Browser [ Data to Browser ] invokes Internet Explorer or a default browser displaying the table data. The data is exported internally in standard HTML format. Internet Explorer is then invoked on this HTML file. The file is a temporary file. You can then use Internet Explorer to save the contents. NOTE: The Export buttons are disabled if the table has no data. Communicate System Messages to Users If you are an administrator for a Neoview platform, you may need to communicate information to users of HPDM. For example, this information might include current software configuration or maintenance notifications. HPDM provides a location, activated by clicking the System Message tab in Monitoring area (see Select an Area (page 25)) where users can obtain the latest information provided by system administrators. Learn About the Monitoring Area The Monitoring area provides information about the system, such as the system message, as well as any other system-wide information that is deemed informative to an administrator or user. When you select the System Message tab in the Monitoring area, the right pane shows this information. Each aspect of the system that is displayed has its own tab in the right pane. Use the System Message Tab The System Message tab contains a system message control to convey information to users. The system message can be updated by a special role of user called a Publisher. The list of publishers is fixed and is comprised of: super.services ROLE.MGR ROLE.DBA Any of these users can modify a system message. All other users can only view messages. The system message is updated by a publisher and is comprised of the message body and the time of its last update. The message body is a text area The text area supports cut, copy, paste, undo and redo capabilities that are accessible through keyboard shortcuts and a context menu that appears when the text area is right-clicked. This figure shows a system message and context menu: Communicate System Messages to Users 37

38 Navigate the System Message Tab The navigation of the System Message tab contains a tree of active and other systems. The right pane displays the system message for the selected active system. If an other system is selected, the system s definition is displayed. Otherwise, selecting the My Active Systems or the My Other Systems folders displays a table displaying information about the systems under the folder. Create a System Message To create a system message: 1. Log on as a Publisher user (super.services, or a member of ROLE.MGR or ROLE.DBA). 2. Click the Monitoring area. For more information, see Select an Area (page 25). 3. Type the system message text in the right pane. 4. Click [ Apply ]. The right pane has a header section that displays the system definition used to communicate with the system. It also has a tab called System Message, which is comprised of a header section, text area that displays rich-text, and a button bar at the bottom. The header section displays the message last updated time when docked within the main HPDM window. When cloned into another window, the header displays the connection name and the last updated time. NOTE: In HPDM, all date times are converted to the UTC local time. The text area is displayed as an editable window if the user is connecting to the system as a Publisher user. Otherwise, the text area is read-only for all other users. The button bar contains [ Apply ] and [ Refresh ]. [ Apply ] is enabled if a Publisher modifies the text within the text area. When clicked, the text is updated to the server. [ Refresh ] causes the text area to be synchronized with the data from the server. If there are changes made to the text area since the last refresh, a confirmation dialog box asks if it is okay to lose the local changes. For all other users, [ Apply ] is hidden and only [ Refresh ] appears. Related Topics See the HPDM Header (page 32) 38 Perform Basic HPDM Operations

39 Clone the System Message Tab If you double-click on the System Message tab, the control is cloned into a new window. When the contents of the system message are modified in any window (the main HPDM window or any cloned window), the change is immediately visible in all copies. Therefore, if the user types in one window, all of the other windows show the updated text. In addition, applying and refreshing any window affects the behavior in all other copies. Save and Import System Definitions Suppose that your company has many different HPDM users, and you have used the Systems Tool to configure numerous system definitions. HPDM allows you to save these definitions and share them for use on other workstations. System definitions are saved in a persistence file. The persistence file is a binary file that contains state and user preference information. This information includes: System definitions User-specified options Favorites Statements executed from the SQL Whiteboard SQL Whiteboard layout information The persistence file typically is located in the default directory for your Windows user name. For example, if your user name is janedoe, the persistence file is located at: Windows XP: C:\Documents and Settings\janedoe\HPDatabaseManager Windows Vista: C:\Users\janedoe\HPDatabaseManager However, the persistence file might be saved to a different location if a different directory is specified for the HOME environment variable for your workstation. To save the currently defined system definitions, click File > Save Persistence on the menu bar. NOTE: Normally, it is not necessary to use this command. The persistence file is saved automatically when you exit HPDM. To save a copy of the currently defined system definitions: NOTE: The file you save by performing these steps is not a true persistence file. It is simply a data file that can be used to transfer new information to the true persistence file. 1. On the menu bar, click File > Export Persistence. The Export Persistence dialog box appears. 2. Specify a file name and location for the copied persistence file. 3. Click [ OK ]. The file is saved with the.hpdm extension. To import system definitions from a saved.hpdm file: 1. On the menu bar, select File > Import Persistence. The Import dialog box appears. 2. Select the previously saved.hpdm file, and click [ Open ]. The Confirm dialog box appears. 3. Click [ Yes ] to proceed or [ No ] to cancel the operation. If you click [ Yes ], HPDM loads the information from the.hpdm file into the persistence file and requires you to reconnect if you were connected to active systems. Related Topics Use Menu Bar Commands (page 15) Terms Save and Import System Definitions 39

40 persistence file system definition Systems Tool View Event Messages View Dial Out and Database Events You can view dial out and database events with any area selected. Dial out events are system events that are dialed out to HP Support. Database events are events related to database activity, data loads, and queries. In the current release, only these users can view dial out and database events: super.super super.services Any user having administrative privileges NOTE: Event-message diagnostic information is primarily for use by HP support. If you have questions about event messages, contact your HP support representative. To view dial out or database events: 1. Under My Active Systems, right-click the Neoview platform for which you want to view events, and select Dial Out Events or Database Events. A browser window appears. 2. Enable the browser window to run JavaScript. (JavaScript is used to process the user name and password.) Usually, this can be done by activating a menu near the top of the page and selecting Allow Blocked Content. However, some browsers might require other steps. If you are unsure how to enable JavaScript, check your browser documentation. 3. Enter your user name and password, and click [ Submit ]. A new window opens to display events. Messages in red are critical. Messages in green are informational. 4. For more detail about a message, click a message number. NOTE: Event information does not update automatically. You must either click Refresh or close and reopen the window to ensure the most current information. For more information about messages, see the Neoview Messages Manual in the Neoview Customer Library, located on the customer documentation Web site. See Resources on the Web (page 11). See the Trace Event Message Format This is the message format for: Message Parameter NDCS Trace session-id function Attribute Session ID: session-id Function: Enterfunction Sequence Number: sequence-number function-input-parameters or Session ID: session-id Function: Exitfunction Sequence Number: sequence-number function-exit-parameters Unique session ID generated by the SQL server at the time the connection is established. The SQL server function that is being traced. 40 Perform Basic HPDM Operations

41 Parameter sequence number function-input-parameters function-exit-parameters Attribute Messages too large for one message template are divided into smaller messages. Sequence number indicates which part of the message you are viewing. The sequence number is 0 for the first or only part of a message, and 1 for the additional parts, if any. List of input parameters to the function. List of output parameters from the function See above. Cause A trace informational message. Effect None Recovery Informational message only; no corrective action is needed. Resource Statistics Event Message Format Message Parameter NDCS Statistics message-attribute session-id message-attribute sequence number statistics-information Attribute Session ID: session-id Message Attribute: message-attribute Sequence Number:sequence-number Message Info:statistics-information { SESSION:ConnectionInformation } { SESSION: SessionSummary } { Statement: SQLStatement } { Statement: SQLExecDirect } { Statement: SQLExecute } { Statement: SQLPrepare } { Statement: SQLFetch } Unique session ID generated by the Neoview SQL server at the time the connection is established. Name of the statistics option you selected. Messages too large for one message template are divided into smaller messages. Sequence number indicates which part of the message you are viewing. The sequence number is 0 for the first or only part of a message, and 1 for additional parts, if any. The statistics collected for the session or statement options selected See above. Cause A resource statistics informational message. Effect None Recovery Informational message only; no corrective action is needed. View Event Messages 41

42 Session Statistics: Connection Information Session statistics are written to the alternate EMS collector at the time the connection is made (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number Component UserName UserId ClientId ApplicationId DataSource NodeName CpuPin Description Unique session ID generated by the NDCS server at the time the connection is established. SESSION:ConnectionInformation (the statistics option that was selected). Message sequence number generated by NDCS. The number begins with zero (0) and is incremented by 1 with each new record. Name of the NDCS component to which the statistics apply. User name logged into the session (the logical name used at the time of connection). User ID that is logged into the session. Client workstation TCP/IP name or the NetBios/network name. Client application name or the main window caption. Client data source name used at the time of connection. Name of the Neoview platform used by the data source. Operating system CPU number in which the NDCS server is running, followed by the process ID of the server. Session Statistics: Session Summary Information Session statistics are written to the alternate EMS collector when the session is terminated (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StartTime EndTime StartPriority TotalOdbcExecution Time TotalOdbcElapsedTime TotalInsertStmtsExecuted TotalDeleteStmtsExecuted TotalUpdateStmtsExecuted Description Unique session ID generated by the NDCS SQL server at the time the connection is established. SESSION:Summary (the statistics option that was selected). Message sequence number generated by NDCS. The number begins with zero (0) and is incremented by 1 with each new record. Time when the connection request was received. Time when the session was terminated due to an application request or a server idle timeout. Execution priority of the NDCS process at the time the connection request is received. Total NDCS SQL server CPU process time, in microseconds, from the time the connection started to the time the connection closed; does not include Neoview SQL compiler time. Total NDCS SQL server real time, in microseconds, from the time the connection started to the time the connection closed. Total number of SQL INSERT statements sent by the HP ODBC driver to the NDCS SQL server; does not include internally generated SQL statements. Total number of SQL DELETE statements sent by the HP ODBC driver to the NDCS SQL server; does not include internally generated SQL statements. Total number of SQL UPDATE statements sent by the HP ODBC driver to the NDCS SQL server; does not include internally generated SQL statements. 42 Perform Basic HPDM Operations

43 Statistic TotalSelectStmtsExecuted TotalCatalogStmts TotalPrepares TotalExecutes TotalFetches TotalCloses TotalExecDirects TotalErrors TotalWarnings Description Total number of SQL SELECT statements sent by the HP ODBC driver to the NDCS SQL server; does not include internally generated SQL statements. Total number of SQL Catalog statements sent by the HP ODBC driver to the NDCS SQL server. Total number of SQLPrepare calls. Total number of SQLExecute calls. Total number of SQLFetch calls. Total number of SQLClose calls. Total number of SQLExecDirect calls. Total number of SQL statement execution errors detected by the NDCS SQL server. Total number of SQL statement execution warnings detected by the NDCS SQL server. Statement Statistics: SQL Statement Statement statistics are written to the alternate EMS collector at the time a PREPARE statement is received (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StatementID SQL Text Description Unique session ID generated by the NDCS SQL server at the time the connection is established. STATEMENT:SQLStatement (the statistics option that was selected). Message sequence number generated by NDCS. The number begins with zero (0) and is incremented by 1 with each new record. Unique statement ID generated by the NDCS SQL server at the time the PREPARE statement is received. Text of the SQL statement. This field can be distributed in multiple messages. Statement Statistics: SQLExecute SQLExecute statistics are written to the alternate EMS collector at the time an EXECUTE statement is received (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StatementID ODBCElapsedTime ODBCExecutionTime NumberOfRows Description Unique session ID generated by the NDCS server at the time the connection is established. STATEMENT:SQLExecute (Statistics option that was selected.) Message sequence number generated by NDCS. The number begins with zero (0) and is incremented by 1 with each new record. Unique statement ID generated by the NDCS SQL server at the time the PREPARE statement is received. Total NDCS SQL server real time, in microseconds, from the time the execute started to the time the results are sent back. Total NDCS SQL server CPU process time, in microseconds, from the time the execute started to the time the response is sent back to the client with the results error code. (ins/upd/del) Number of rows that were inserted, updated, or deleted. View Event Messages 43

44 Statistic ErrorCode RowsAccessed RowsRetrieved DiscReads MsgsToDisc MsgsBytesToDisc LockWaits LockEscalation Description Execute error code, if any. A zero (0) indicates that the execute was successful. Cumulative number of rows accessed. Cumulative number of rows retrieved. Cumulative number of disk reads. Number of messages sent to the disk process. Size, in bytes, of the total number of messages sent to the disk process. Number of lock waits (this is the concurrency cost). Cumulative number of times record locks are escalated to file locks. Statement Statistics: SQLExecDirect SQLExecDirect statistics are written to the alternate EMS collector at the time an EXECUTE statement is received (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StatementID EstimatedCost StatementType ODBCElapsedTime ODBCExecutionTime NumberOfRows ErrorCode RowsAccessed RowsRetrieved DiscReads MsgsToDisc MsgsBytesToDisc LockWaits LockEscalation Description Unique session ID generated by the NDCS SQL server at the time the connection is established. STATEMENT:SQLExecDirect (Statistics option that was selected.) Message sequence number generated by NDCS. The number begins with zero (0) and is incremented by 1 with each new record. Unique statement ID generated by the NDCS SQL server at the time the PREPARE statement is received. Estimated query cost returned by the SQL compiler. Valid types are: Insert, Delete, Update, Select. Total NDCS SQL server real time, in microseconds, from the time the execdirect started to the time the results are sent back. Total NDCS SQL server CPU process time, in microseconds, from the time the execdirect started to the time the results are sent back. (ins/upd/del) Number of rows that were inserted, updated, or deleted. Execdirect error code, if any. A zero (0) indicates that the execdirect was successful. Cumulative number of rows accessed. Cumulative number of rows retrieved. Cumulative number of disk reads. Number of messages sent to the disk process. Size, in bytes, of the total number of messages sent to the disk process. Number of lock waits (this is the concurrency cost). Cumulative number of times record locks are escalated to file locks. 44 Perform Basic HPDM Operations

45 Statement Statistics: SQLPrepare SQLPrepare statistics are written to the alternate EMS collector at the time a PREPARE statement is received (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StatementID EstimatedCost StatementType SQLCompileTime ErrorCode Description Unique session ID generated by the NDCS SQL server at the time the connection is established. STATEMENT:SQLPrepare (Statistics option that was selected.) Message sequence number generated by NDCS The number begins with zero (0) and is incremented by 1 with each new record. Unique statement ID generated by the NDCS SQL server at the time the PREPARE statement is received. Estimated query cost. Valid types are: Insert, Delete, Update, Select. Total NDCS SQL server real time, in microseconds, from the time the prepare started to the time it returns to the client with the compile results. Prepare error code, if any. A zero (0) indicates that the prepare was successful. Statement Statistics: SQLFetch SQLFetch statistics are written to the alternate EMS collector at the time a statement is closed (listed in the order written in the event message): Statistic Session ID Message Attribute Sequence Number StatementID RowsAccessed RowsRetrieved DiscReads MsgsToDisc MsgsBytesToDisc LockWaits LockEscalation TotalOdbcElapsedTime TotalOdbcExecutionTime TotalExecutes Description Unique session ID generated by the NDCS SQL server at the time the connection is established. STATEMENT:SQLFetch/SQLClose (Statistics option that was selected.) Message sequence number generated by NDCS The number begins with zero (0) and is incremented by 1 with each new record. Unique statement ID generated by the NDCS SQL server at the time the PREPARE statement is received. Cumulative number of rows accessed. Cumulative number of rows retrieved. Cumulative number of disk reads. Number of messages sent to the disk process. Size, in bytes, of the total number of messages sent to the disk process. Number of lock waits (this is the concurrency cost). Cumulative number of times record locks are escalated to file locks. Total NDCS SQL server real time, in microseconds, from the time the fetch was prepared to the time it was closed. Total NDCS SQL server CPU process time, in microseconds, from the time the fetch was prepared to the time it was closed. Total number of executes performed on the statement. View Event Messages 45

46 46

47 5 Manage Database Objects This section describes how to display schemas, tables, table indexes, views, materialized views, materialized view indexes, materialized view groups, procedures, synonyms, and triggers in HPDM. Display Schemas and Their Objects To display the schema names and attributes for the schema: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. HPDM displays a list of existing schemas and their owners. 3. Select a system in My Active Systems in the navigation tree. 4. Navigate to a Schema folder and click the name of the schema to see information about the schema and its objects. In the right pane, these tabs are displayed: Attributes tab Tables tab Materialized Views tab Materialized View Groups tab Views tab Procedures tab Synonyms tab DDL tab Privileges tab Display Schemas and Their Objects 47

48 Attributes Tab Tables Tab To display the schema attributes and values that belong to the schema: 1. Navigate to the Schema folder and click the name of the schema to see information about the schema and its objects. 2. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the schema. Owner: The owner of the schema. Version: Specfies the version of the schema. To display the table names that belong to the schema: 1. Select a Schema in the navigation tree. 2. Click the Tables tab in the right pane, or open the Tables folder. In the right pane, these attributes are displayed: Name: Name of the table. Each table name is hyperlinked and detailed information about the table is displayed. Creation Time: Time and date when the table was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the table was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Materialized Views Tab To display the materialized views that belong to the schema: 1. Select aschema in the navigation tree. 2. Click the Materialized Views tab in the right pane, or open the Materialized Views folder. In the right pane, these attributes are displayed: Name: Name of the materialized view. Each materialized view is hyperlinked and detailed information about the materialized view is displayed. Creation Time: Time and date when the materialized view was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Materialized View Groups Tab To display the materialized view groups that belong to the schema: 1. Select aschema in the navigation tree. 2. Click the Materialized View Groups tab in the right pane, or open the Materialized View Groups folder. In the right pane, these attributes are displayed: Name: Name of the materialized view groups. Each materialized view group is hyperlinked and detailed information about the materialized view group is displayed. Creation Time: Time and date when the materialized view groups was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view groups was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). 48 Manage Database Objects

49 Views Tab To display the views that belong to the schema: 1. Select aschema in the navigation tree. 2. Click the Views tab in the right pane, or open the Views folder. Procedures Tab In the right pane, these attributes are displayed: Name: Name of the view. Each view is hyperlinked and detailed information about the view is displayed. Creation Time: Time and date when the view was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the view was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the procedures that belong to the schema: 1. Select a Schema in the navigation tree. 2. Click the Procedures tab in the right pane, or open the Procedures folder. Synonyms Tab DDL Tab In the right pane, these attributes are displayed: Name: Name of the procedure. Each procedure name is hyperlinked and detailed information about the procedure is displayed. Creation Time: Time and date when the procedure was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the procedure was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the synonyms that belong to the schema: 1. Select a Schema in the navigation tree. 2. Click the Synonyms tab in the right pane, or open the Synonyms folder. In the right pane, these attributes are displayed: Name: Name of the synonym. Each synonym name is hyperlinked and detailed information about the synonym is displayed. Creation Time: Time and date when the synonym was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the synonym was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for the schema: 1. Select a Schema in the navigation tree. 2. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). Display Schemas and Their Objects 49

50 Privileges Tab Schema Size To display the privilege information for the schema: 1. Select a Schema in the navigation tree. 2. Click the Privileges tab in the right pane. The Privileges tab displays a table showing the access privileges: Grantee: The name of a user or role whose privilege is being described. Grantor: The name of the user or role who granted the privileges and the special SQL user names PUBLIC and SYSTEM. With Grant: Specifies an X to indicate if the user or role has grant privileges. Grant Level: The level at which the privileges are visible. The values displayed in this column are: Schema, Object, or Column. Schema indicates permissions have been applied to the schema. Object indicates permissions were applied directly to the object whose permissions are being displayed. Column indicates the permissions applied to the column. When an object level privilege applies to all columns, the individual column privileges are not displayed, otherwise the individual column level permissions are listed. Privileges: Describes the privilege of the user or role. The value is All Privileges or a list of granted privileges separated by a comma. DDL and DML privileges are grouped accordingly. For a complete list of privileges, see the GRANT SCHEMA statement information in the Neoview SQL Reference Manual. To display the size of the schema: 1. Select a Schema in the navigation tree. 2. Right-click the schema and select Show Schema Size. A separate window is displayed with the schema size. In the right pane, these attributes are displayed: Object Type: Name of the object (for example, table, table indexes, and so on). Current Size: The current size of the object. The schema size displayed is a snapshot of the schema at the timestamp shown on the top of the table display. [ Refresh ] refreshes the size information. Display Tables and Their Properties To display the table columns, primary key information, attributes, and usage information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema and click the table name in the right pane, or open the Tables folder. HPDM displays the tables in the schema. 50 Manage Database Objects

51 Columns Tab In the right pane, these tabs appear: Columns tab Primary Key tab Hash Key tab Unique Constraints tab Foreign Keys tab Attributes tab Partitions tab Usage tab DDL tab Statistics tab Privileges tab You can also expand Tables to display a table list in the left pane. Each table in the navigation tree contains a folder called Indexes and a folder called Triggers. The Indexes folder expands to show the indexes of a specified table. The Triggers folder expands to show the triggers of a specified table. To display the table columns: 1. Select a Schema and table and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Columns tab in the right pane. In the right pane, these attributes are displayed: Display Tables and Their Properties 51

52 Primary Key Tab Hash Key Tab Primary Key: Specifies the icon or special symbol to indicate column is part of the primary key. Column Name: Name of the column (string). Data Type: SQL datatype of the column. Nullable: If a column is NOT NULLABLE NOT DROPPABLE, the value displayed is Not Nullable. If the column is NOT NULL, the value displayed is Not Nullable. If the column is NULL, the value is blank. Default: For schema version 2300 or earlier, the default value displayed is GENERATED BY DEFAULT AS IDENTITY. For schema version 2400, the default value displayed is GENERATED {ALWAYS BY DEFAULT} AS IDENTITY. To display the primary key column information: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Primary Key tab in the right pane. In the right pane, these attributes are displayed: Position: The position of the column in the primary key order. Column Name: Name of the column (string). Data Type: SQL datatype of the column. Sort Order: Specifies the order as Ascending or Descending. Added By: Indicates if column was added by the System or User. To display the hash key column information: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Hash Key tab in the right pane. In the right pane, these attributes are displayed: Position: The position of the column in the hash key order. Column Name: Name of the column (string). Sort Order: Specifies the order as Ascending or Descending. Unique Constraints Tab To display the unique constraints for the table: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Unique Constraints tab in the right pane. Foreign Keys Tab In the right pane, these attributes are displayed: Constraint Name: Name of the unique constraint. Columns: The name of the columns that are constrained. To display the foreign keys information on the table: 52 Manage Database Objects

53 Attributes Tab Partitions Tab Usage Tab 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Foreign Key tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the foreign key constraint. Foreign Table: Name of the foreign table. Local Column: Name of the local column of the foreign key. Foreign Column: Name of the foreign column of the foreign key. Enforced: Indicates if referential integrity is enforced. To display the table attributes with the attribute name and value: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the table. Log Inserts Only: A string value of True or False. Reorganize Enabled: A string value of True or False. Update Statistics Enabled: A string value of True or False. Last Updated Statistics: The string value of Never or a timestamp of the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Maximum Size: Maximum size in megabytes to which a table can grow. If maximum size is 0, then the string Determined by system is displayed. Record Size: Row size in bytes in each logical record. Creation Time: Time and date when the table was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the table was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the table partition information: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Partitions tab in the right pane. In the right pane, these attributes are displayed: Partition Number: The index number of the partition. Percent Allocated: The percentage full of the partition. Row Count: The current total number of rows in the partition. Max Size: The maximum size in bytes of the partition. Current EOF: The current data size of the partition in bytes. To display usage information defined on the table: Display Tables and Their Properties 53

54 DDL Tab Statistics Tab Privileges Tab 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Usage tab in the right pane. The Usage tab displays the usage relationships of the table with other objects, if any. The attributes displayed are : Relationship: Specifies the relationship of the table with the object specified. The values are: Uses, Used By, Has. Related Object Type: Specifies the object type of the related object. The values are: Table, Materialized View, View or Synonym. Related Object Name: Specifies the 2-part ANSI object name with a hyperlink to the object. Creation Time: Time and date when the table was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the table was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for the table: 1. Select a Schema and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). To display the table profile or statistics information: 1. Select a Schema and click the table name in the right pane, or open the Tables folder and select a table name in the tree. 2. Click the Statistics tab in the right pane. The Statistics tab displays the histogram statistics for the table. For more information about displaying table statistics, see Display Table Statistics and Their Properties (page 75). To display the table privileges: 1. Select a Schema and click the table name in the right pane, or open the Tables folder and select a table in the tree. 2. Click the Privileges tab in the right pane. The Privileges tab displays a table showing the access privileges: Grantee: The name of the user or role whose privilege is being described. Grantor: The name of the user or role who granted the privileges and the special SQL user names PUBLIC and SYSTEM. With Grant: Specifies an X to indicate if the user or role has grant privileges. 54 Manage Database Objects

55 Grant Level: The level at which the permissions are visible. The values displayed in this column are: Schema, Object, or Column. Schema indicates permissions have been applied to the schema. Object indicates permissions were applied directly to the object whose permissions are being displayed. Column indicates the permissions applied to the column. When an Object level privilege applies to all columns, the individual column privileges are not displayed, otherwise the individual column level permissions are listed. Privileges: Describes the privilege of the user or role. The value is All Privileges or a list of granted privileges separated by a comma. DDL and DML privileges are grouped accordingly. For a complete list of privileges, see the GRANT SCHEMA statement information in the Neoview SQL Reference Manual. Tables Summary To display a detailed summary of the table: 1. Select a Schema and right-click the Tables folder and select Show Summary Details. A separate window is displayed with a summary of the table. The table summary displays: Name: The name of the table. Statistics Last Updated: The timestamp in which the table statistics was last updated. Total Current Row Count: The total number of rows in each table. Total Maximum Size: The total maximum size of the table (in bytes). Total Current Size: The total current size of the table (in bytes). Percent Allocated: The percent full of the table. The detailed summary is a snapshot of the tables in the schema at the timestamp shown at the top of the table display. If you select [ Refresh ] the summary is refreshed. Display Table Indexes and Their Properties To display the indexes for tables, columns, and attributes: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree. 5. Click the Tables folder and open the Indexes folder and select an index name. Display Table Indexes and Their Properties 55

56 Columns Tab Attributes Tab In the right pane, these tabs appear: Columns tab Attributes tab DDL tab Partitions tab To display the table index columns: 1. Select a Schema in the navigation tree. 2. Click the Tables folder and open the Indexes folder and select an index name. 3. Click the Columns tab in the right pane. In the right pane, these attributes are displayed: Column Name: Name of the column (string). Sort Order: Specifies the order as Ascending or Descending. Added By: Indicates if column was added by the System or User. To display the table index attributes: 1. Select a Schema in the navigation tree. 2. Click the Tables folder and open the Indexes folder and select an index name. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the index. Unique: Specifies if the index is unique, the value is Yes or No. 56 Manage Database Objects

57 DDL Tab Partitions Tab Populated: Specifies if the index has been populated, the value is Yes or No. Creation Time: Time and date when the table index was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the table index was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for table indexes: 1. Select a Schema in the navigation tree. 2. Click the Tables folder and open the Indexes folder and select an index name. 3. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). To display the table index partition information: 1. Select a Schema in the navigation tree. 2. Click the Tables folder and open the Indexes folder and select an index name. 3. Click the Partitions tab in the right pane. In the right pane, these attributes are displayed: Partition Number: The index number of the partition. Percent Allocated: The percentage full of the partition. Row Count: The current total number of rows in the partition. Max Size: The maximum size in bytes of the partition. Current EOF: The current data size of the partition in bytes. Table Indexes Summary To display a detailed summary of the table indexes: 1. Select a Schema in the navigation tree. 2. Right-click the Tables folder and select Show Summary Details. A separate window with a summary of the indexes is displayed The indexes summary displays: Name: The name of the index. Total Current Row Count: The total number of rows in each index. Total Maximum Size: The total maximum size of the index (in bytes). Total Current Size: The total current size of the index (in bytes). Percent Allocated: The percent full of the index. The detailed summary is a snapshot of the indexes (tables indexes and materialized view indexes) in the schema at the timestamp shown at the top of the table display. If you select [ Refresh ] the summary is refreshed. A row is highlighted in red if the partition is equal to or greater than 80%. Display Table Indexes and Their Properties 57

58 Display Views and Their Properties To display the view information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree. 5. Select the Views tab in the right pane, or open the Views folder and select a view. HPDM displays the views in this schema. Columns Tab In the right pane, these tabs appear: Columns tab Usage tab DDL tab Privileges tab To display the column information for a view: 1. Select a Schema in the navigation tree. 2. Click the Views tab, or open the Views folder and select a view. 3. Click the Columns tab in the right pane. The column information is displayed in each column. 58 Manage Database Objects In the right pane, these usages are displayed: Column Name: Name of the column (string). Source Object: The name of the source object. If it is a computed object, this is blank. The name is hyperlinked to show that clicking on the source object name navigates you to the location of the object.

59 Usage Tab DDL Tab Privileges Tab Data Type: SQL datatype of the column. Nullable: If column is NOT NULL NOT DROPPABLE, the value displayed is Not Nullable. If the column is NOT NULL, the displayed value is Not Nullable. If the column is NULL, the value is blank. Default: The default of the column. To display the usage information for a view: 1. Select a Schema in the navigation tree. 2. Click the Views tab, or open the Views folder and select a view. 3. Click the Usage tab in the right pane. The usage information is displayed in each column. The Usage tab displays the usage relationships of the view with other objects, if any. The attributes displayed are: Relationship: Specifies the relationship of the view with the object specified. The values are: Uses, Used By, and Has. Related Object Type: Specifies the object type of the related object. The values are: Table, Materialized View, View, or Synonym. Related Object Name: Specifies the 2-part ANSI object name with a hyperlink to the object. Creation Time: Time and date when the view was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local). Redefinition Time: Time and date when the view was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local). To display the DDL output for a view: 1. Navigate to the Schema in the navigation tree. 2. Click the Views tab, or open the Views folder and select a view. 3. Click the DDL tab in the right pane. In the right pane, DDL output is displayed in the text box. For HP services, the internal format of the SHOWDDL output is displayed. For more information on the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). To display view privileges: 1. Select a Schema in the navigation tree. 2. Click the Views tab, or open the Views folder and select a view. 3. Click the Privileges tab in the right pane. The Privileges tab displays a table showing the access privileges. Grantee: The name of a user or role whose privilege is being described. Grantor: The name of the user or role who granted the privileges and the special SQL user names PUBLIC and SYSTEM. With Grant: Specifies an X to indicate if the user or role has grant privileges. Grant Level: The level at which the permissions are visible. The values displayed in this column are: Schema, Object, or Column. Display Views and Their Properties 59

60 Schema indicates permissions have been applied to the schema. Object indicates permissions were applied directly to the object whose permissions are being displayed. Column indicates the permissions applied to the column. When an object level privilege applies to all columns, the individual column privileges are not displayed, otherwise the individual column level permissions are listed. Privileges: Describes the privilege of the user or role. The value is All Privileges or a list of granted privileges separated by a comma. DDL and DML privileges are grouped accordingly. For a complete list of privileges, see the GRANT SCHEMA statement information in the Neoview SQL Reference Manual. Display Materialized Views and Their Properties To display the materialized view information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree. 5. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. HPDM displays the materialized views in this schema. In the right pane, these tabs appear: Attributes tab Partitions tab Usage tab 60 Manage Database Objects

61 Attributes Tab DDL tab Privileges tab To display the materialized view attributes: 1. Navigate to the Schema in the navigation tree 2. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: External name of the materialized view. Refresh Type: Refresh policy displayed is (Recompute On Refresh On Statement). Recompute Derives the materialized view from scratch. This is used on the initial refresh of the materialized view and also to re-derive the materialized view if it is in an inconsistent state (for example, if the previous refresh was aborted abnormally). On Request Updates the materialized view at a time that you schedule. This allows for fast querying and a high update rate, but queries may read data that is not up-to-date with underlying tables. Select this if your application can tolerate "stale" data. On Statement Updates the materialized view immediately upon an update to the base tables. This slows the transaction speed because the materialized view refresh operation is coupled to the table update operation. Select this if your application relies on current data. Initialization Type: Initialization type displayed is (On Create On Refresh). On Create Initial entries to the materialized view are made when the view is created. A materialized view that is based on another materialized view can be initialized on create only if: The query expression does not include joins. The underlying materialized view is already initialized. On Refresh Initial entries to the materialized view are made on the first refresh after creation (default type). The materialized view is not available to select and rewrite until it has been refreshed. Refresh Commit Each: Specifies the number of rows that the refresh operation processes before committing a transaction and processing more rows. If an error occurs during the refresh, and the Refresh Commit Each attribute is set to a small number of rows, fewer rows will need to be rolled back as a result of the error. However, the smaller the value of this attribute, the greater the impact on the performance of the refresh. Refreshed At Timestamp: Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Display Materialized Views and Their Properties 61

62 Partitions Tab Usage Tab DDL Tab Creation Time: Time and date when the materialized view was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the materialized view partitions: 1. Select a Schema in the navigation tree 2. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. 3. Click the Partitions tab in the right pane. In the right pane, these attributes are displayed: Partition Number: The index number of the partition. Percent Allocated: The percentage full of the partition. Row Count: The current total number of rows in the partition. Max Size: The maximum size in bytes of the partition. Current EOF: The current data size of the partition in bytes. To display materialized view usage information: 1. Select a Schema in the navigation tree 2. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. 3. Click the Usage tab in the right pane. The Usage tab displays the usage relationships of the materialized view with other objects, if any. In the right pane, these attributes are displayed: Relationship: Specifies the materialized views relationship with the object specified. The values are: Uses, Used By, and Has. Related Object Type: Specifies the object type of the related object. The values are: Table, Materialized View, View, or Synonym. Related Object Name: Specifies the 2-part ANSI object name with a hyperlink to the object. Creation Time: Time and date when the materialized view was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for the materialized view: 1. Select a Schema in the navigation tree. 2. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. 3. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL SQL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. 62 Manage Database Objects

63 Privileges Tab For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). To display the privileges for the materialized view: 1. Select a Schema in the navigation tree. 2. Click the Materialized Views tab in the right pane and select a materialized view name, or open the Materialized Views folder and select a materialized view name in the tree. 3. Click the Privileges tab in the right pane. The Privileges tab displays a table showing the access privileges. Grantee: The name of a user or role whose privilege is being described. Grantor: The name of the user or role who granted the privileges and the special SQL user names PUBLIC and SYSTEM. With Grant: Specifies an X to indicate if the user or role has grant privileges. Grant Level: The level at which the permissions are visible. The values displayed in this column are: Schema, Object, or Column. Schema indicates permissions have been applied to the schema. Object indicates permissions were applied directly to the object whose permissions are being displayed. Column indicates the permissions applied to the column. When an object level privilege applies to all columns, the individual column privileges are not displayed, otherwise the individual column level permissions are listed. Privileges: Describes the privilege of the user or role. The value is All Privileges or a list of granted privileges separated by a comma. DDL and DML privileges are grouped accordingly. For a complete list of privileges, see the GRANT SCHEMA statement information in the Neoview SQL Reference Manual. Materialized Views Summary To display a detailed summary of the materialized views: 1. Select a Schema and right-click the Materialized View folder and select Show Summary Details. Clicking on Show Summary Details displays a separate window with a summary of the materialized views. The materialized views partition summary displays: Name: The name of the materialized view. Total Current Row Count: The total number of rows in each materialized view. Total Maximum Size: The total maximum size of the materialized view (in bytes). Total Current Size: The total current size of the materialized view (in bytes). Percent Allocated: The percent full of the materialized view. The detailed summary is a snapshot of the materialized view in the schema at the timestamp shown at the top of the table display. If you select [ Refresh ] the summary is refreshed. A row is highlighted in if the partition is equal to or greater than 80%. Display Materialized View Indexes and Their Properties To display the materialized view index information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. Display Materialized View Indexes and Their Properties 63

64 Columns Tab Attributes Tab DDL Tab 4. Select a Schema in the navigation tree. 5. Open the Materialized Views folder, select and open a Materialized View. 6. Open the Indexes folder and select a materialized view index in the tree. In the right pane, these tabs appear: Columns tab (user only) Attributes tab DDL tab Partitions tab To display the materialized view index columns: 1. Select a Schema in the navigation tree. 2. Open the Materialized Views folder, select and open a materialized view. 3. Open the Indexes folder and select a materialized view index in the tree. 4. Click the Columns tab in the right pane. In the right pane these attributes are displayed: Column Name: Name of the column (string). Sort Order: Specifies the order as Ascending or Descending. Added By: Indicates if column was added by the System or User. To display the materialized view attributes: 1. Select a Schema in the navigation tree. 2. Open the Materialized Views folder, select and open a materialized view. 3. Open the Indexes folder and select a materialized view index in the tree. 4. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the materialized view index. Unique: Specifies if the materialized view index is unique, the value is Yes or No. Populated: Specifies if the materialized view index has been populated, the value is Yes or No. Creation Time: Time and date when the materialized view index was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view index was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display DDL output for the materialized view: 1. Select a Schema in the navigation tree. 2. Open the Materialized Views folder, select and open a Materialized View. 3. Open the Indexes folder and select a materialized view index in the tree. 4. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. 64 Manage Database Objects

65 Partitions Tab For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). To display partition information for a materialized view index: 1. Select a Schema in the navigation tree 2. Open the Materialized Views folder, select and open a Materialized View. 3. Open the Indexes folder and select a materialized view index in the tree. 4. Click the Partitions tab in the right pane. In the right pane, these attributes are displayed: Partition Number: The index number of the partition. Percent Allocated: The percentage full of the partition. Row Count: The current total number of rows in the partition. Max Size: The maximum size in bytes of the partition. Current EOF: The current data size of the partition in bytes. Materialized View Indexes Summary To display a detailed summary of the materialized views: 1. Select a Schema and right-click the Materialized View folder and select Show Summary Details. Clicking on Show Summary Details displays a separate window with a summary of the materialized views. The materialized views partition summary displays: Name: The name of the materialized view. Total Current Row Count: The total number of rows in each materialized view. Total Maximum Size: The total maximum size of the materialized view (in bytes). Total Current Size: The total current size of the materialized view (in bytes). Percent Allocated: The percent full of the materialized view. The detailed summary is a snapshot of the materialized view in the schema at the timestamp shown at the top of the table display. If you select [ Refresh ] the summary is refreshed. A row is highlighted in red if the partition is equal to or greater than 80%. Display Materialized View Groups and Their Properties When you create a materialized view, a materialized view group is created automatically. It has the same name as the table that the materialized view references. To display the materialized view group information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree. 5. Click the Materialized View Groups tab in the right pane, or open the MV Groups folder and select a materialized view group name in the tree. Display Materialized View Groups and Their Properties 65

66 Attributes Tab Members Tab In the right pane, these tabs appear: Attributes tab Members tab DDL tab To display the materialized view groups attributes: 1. Select a Schema in the navigation tree. 2. Click the Materialized View Groups tab in the right pane, or open the Materialized View Groups folder and select a materialized view group name in the tree. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the materialized view group. Creation Time: Time and date when the materialized view group was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view group was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the names of the members of the materialized view group: 66 Manage Database Objects

67 DDL Tab 1. Select a Schema in the navigation tree. 2. Click the Materialized View Groups tab in the right pane, or open the Materialized View Groups folder and select a materialized view group name in the tree. 3. Click the Members tab in the right pane. In the right pane, the members are displayed in a table with the following attributes: Name: Name of the materialized view group member. The object names are 2 part ANSI names. Creation Time: Time and date when the materialized view group member was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the materialized view group member was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for materialized view groups: 1. Select a Schema in the navigation tree. 2. Click the Materialized View Groups tab in the right pane, or open the Materialized View Groups folder and select a materialized view group name in the tree. 3. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). Display Procedures and Their Properties To display the procedures names in the schema: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree. 5. Click the Procedures tab in the right pane and select a procedure name, or open the Procedures folder and select a procedure name in the tree. HPDM displays the procedures for this table. Display Procedures and Their Properties 67

68 Attributes Tab In the right pane, these tabs appear: Attributes tab Parameters tab Privileges tab To display the procedure names and attributes: 1. Select a Schema in the navigation tree. 2. Click the Procedures tab in the right pane and select a synonym name, or open the Procedures folder and select a procedure name in the tree. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: The name of the procedure. Dynamic Result Sets: The maximum number of result sets returned (integer). SQL Access: Specifies the way this procedure interacts with SQL Database. The values displayed are: CONTAINS SQL MODIFIES SQL DATA READS SQL DATA NO SQL. For more information, see the Neoview Guide to Stored Procedures in Java. Signature: The parameter signature. For information on data types, see the Neoview SQL Reference Manual. Creation Time: Time and date when the procedure was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the procedure was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). 68 Manage Database Objects

69 Parameters Tab Privileges Tab To display the procedure parameter information: 1. Select a Schema in the navigation tree. 2. Click the Procedures tab in the right pane and select a procedure name, or open the Procedures folder and select a procedure name in the tree. 3. Click the Parameters tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the parameter. Direction: The values displayed are: IN OUT INOUT. IN passes data to the procedure. OUT accepts data from the procedure. This is the default for array parameters. INOUT passes data to and accepts data from the procedure. SQL Data Type: Specifies an SQL data type that corresponds to the Java parameter of the procedure Java method. For information on SQL data types, see the Neoview SQL Reference Manual. Java Data Type: Specifies a mappable Java data type. For information on Java data types, see the Neoview Guide to Stored Procedures in Java. To display the privileges for the procedure: 1. Select a Schema in the navigation tree. 2. Click the Procedures tab in the right pane and select a procedure name, or open the Procedures folder and select a procedure name in the tree. 3. Click the Privileges tab in the right pane. The Privileges tab displays a table showing the access privileges. Grantee: The name of a user or role whose privilege is being described. Grantor: The name of the user or role who granted the privileges and the special SQL user names PUBLIC and SYSTEM. With Grant: Specifies an X to indicate if the user or role has grant privileges. Grant Level: The level at which the permissions are visible. The values displayed in this column are: Schema, Object, or Column. Schema indicates permissions have been applied to the schema. Object indicates permissions were applied directly to the object whose permissions are being displayed. Column indicates the permissions applied to the column. When an object level privilege applies to all columns, the individual column privileges are not displayed, otherwise the individual column level permissions are listed. Privileges: Describes the privilege of the user or role. The value is All Privileges or a list of granted privileges separated by a comma. DDL and DML privileges are grouped accordingly. For a complete list of privileges, see the GRANT SCHEMA statement information in the Neoview SQL Reference Manual. Display Synonyms and Their Properties To display the synonym names in the schema: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. Display Synonyms and Their Properties 69

70 4. Select a Schema in the navigation tree. 5. Click the Synonyms tab in the right pane and select a synonym name, or open the Synonyms folder and select a synonym name in the tree. Attributes Tab Usage Tab In the right pane, these tabs appear: Attributes tab Usage tab DDL tab To display the synonym names and attributes: 1. Select a Schema in the navigation tree. 2. Click the Synonyms tab in the right pane and select a synonym name, or open the Synonyms folder and select a synonym name in the tree. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the synonym. Creation Time: Time and date when the synonym was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the synonym was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the synonym usage information: 70 Manage Database Objects

71 DDL Tab 1. Select a Schema in the navigation tree. 2. Click the Synonyms tab in the right pane and select a synonym name, or open the Synonyms folder and select a synonym name in the tree. 3. Click the Usage tab in the right pane. The Usage tab displays the usage relationships of the synonym with other objects, if any. These attributes displayed are: Relationship: Specifies the relationship of the synonym with the object specified. The value is References. Related Object Type: Specifies the object type of the object that the synonym references. The values are: Table, Materialized View, or View. Related Object Name: Specifies the 2-part ANSI object name with a hyperlink to the object. Creation Time: Time and date when the synonym was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the synonym was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). To display the DDL output for the synonym: 1. Select a Schema in the navigation tree. 2. Click the Synonyms tab in the right pane and select a synonym name, or open the Synonyms folder and select a synonym name in the tree. 3. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). Display Triggers and Their Properties A trigger is a mechanism that resides in the database and specifies that when a particular action an insert, delete, or update occurs on a table, SQL should automatically perform one or more additional actions. To display the triggers: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a system in My Active Systems in the navigation tree. 4. Select a Schema in the navigation tree and click a table name in the right pane, or open the Tables folder and then open the Triggers folder. HPDM displays the triggers on this table. Display Triggers and Their Properties 71

72 Attributes Tab In the right pane, these tabs appear: Attributes tab Usage tab DDL tab To display the trigger attributes: 1. Select a Schema in the navigation tree. 2. Click the table name in the right pane, or open the Tables folder and then open the Triggers folder and select a trigger in the tree. 3. Click the Attributes tab in the right pane. In the right pane, these attributes are displayed: Name: Name of the trigger. Is Enabled: Specifies if the trigger is enabled. The value is 'Yes or 'No. Activation Time: Specifies when the trigger is activated. Used in combination with an operation. The value is Before or After. Operation: Specifies operation that causes the trigger to be activated. The values are (Insert Delete Update). Granularity: Specifies Row or Statement trigger. Row triggers are allowed for all Time/Event combinations. Statement triggers are allowed AFTER events. For more information, see the Neoview SQL Reference Manual. Creation Time: Time and date when the trigger was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time: Time and date when the trigger was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). 72 Manage Database Objects

73 Usage Tab DDL Tab To display the trigger usage information: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and then open the Triggers folder and select a trigger in the tree. 2. Click the Usage tab in the right pane. In the right pane, these attributes are displayed: Relationship: Specifies the relationship between this trigger and the object. Related Object Type: Specifies the object type of the object. Related Object Name: Specifies the object name with a hyperlink to the object. Creation Time: Time and date when the trigger was created. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Redefinition Time:Time and date when the trigger was last redefined. Timestamp is in the format (yyyy-mm-dd HH:mm:ss.FFFFFF local time). Operation: Specifies what types of the operation performed on this object to activate the trigger. The value is one of the (Delete/Insert/Select/Update/Call). Is Subject Table: Specifies whether the target is a subject table. The value is True or False. To display the DDL output for the trigger: 1. Select a Schema in the navigation tree and click the table name in the right pane, or open the Tables folder and then open the Triggers folder and select a trigger in the tree. 2. Click the DDL tab in the right pane. The DDL tab displays DDL output from the SHOWDDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. For more information about the format of the SHOWDDL command, see the Neoview SQL Reference Manual. For more information about displaying DDL, see Display Schema DDL and Their Properties (page 73). Display Schema DDL and Their Properties DDL Tab To display schema DDL information, a DDL tab appears in the right pane when these objects are selected in the navigation tree: Schema Table Table Index View Materialized View Materialized View Index Materialized View Group Procedure Synonym Trigger The DDL tab displays DDL output from the Show DDL command in the right pane. You can highlight and copy contents, but you cannot edit the contents. Display Schema DDL and Their Properties 73

74 Show DDL The external format of the Show DDL output is displayed. For more information on the format of the Show DDL command, see the Neoview SQL Reference Manual. Show DDL allows you to select objects for which you want DDL output fetched and displayed. NOTE: Opening up Show DDL to the system-level allowing you to select different catalogs and schemas and their objects may cause performance issues. To avoid performance issues, Show DDL limits the selection to a specific schema. Select a node in the navigation tree, right-click the Show DDL menu and the Show DDL dialog box appears. The Show DDL menu is available only for a schema node and its child nodes in the navigation tree. The Show DDL menu is not available for catalogs folder or the catalog and schemas folder. In the Show DDL dialog box, the Select Objects pane displays a Selection Tree that displays a navigation tree. The Selection Tree has check boxes in front of the node names and you can select or deselect specific objects. If the Show DDL dialog box is invoked on a folder node in the main navigation tree, the Select Objects pane displays (by default) the selection tree with the corresponding folder node and all its child nodes with check boxes selected. If the Show DDL dialog box is invoked on a leaf node in the main navigation tree, the Select Objects pane displays (by default) the selection tree with the corresponding leaf node s check box selected. The option to select more objects or uncheck selected objects is always available. Objects can be selected from only one schema. If objects are selected from a different schema, an error message is displayed. 74 Manage Database Objects

75 The DDL Output pane has a text box with scroll bars and the DDL output is displayed in the text box. The Show DDL dialog box options are: Button [ Load ] [ Append ] [ Clear All ] [ Save ] [ Clear ] [ Done ] Description Loads the Show DDL output of the selected objects (with check boxes selected) and replaces the contents in the DDL Output pane. Appends the selected objects to the existing contents in the DDL Output pane. Clears selected objects (with check boxes selected) in the Selected Objects pane. Saves the contents of the DDL Output text box using the File menu dialog box. Clears the DDL Output text box. Closes the Show DDL dialog box. Display Table Statistics and Their Properties HPDM allows you to display table profile or statistics information. The table profile or statistics information can be used to troubleshoot problem queries or to create additional indexes for help with query performance. Display Table Column Statistics To display table profile or statistics information: 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. Display Table Statistics and Their Properties 75

76 3. Select a Schema in the navigation tree. 4. Click the Statistics tab in the right pane. The Statistics tab displays the histogram statistics for the table. For each column in the table, the data is fetched from the HISTOGRAMS UMD table. The right pane displays these attributes: Name: Name of the column. Datatype: Specifies the column datatype. # Nulls: The number of null values for the column. An interval (bucket) with "(NULL) as the boundary value from the histogram_intervals table. Min Value: The Low_Value from histograms table for this column. Max Value: The High_Value the histograms table for this column. Skew: CV from histograms table for this column for schema version For older schema versions, the value is 0. UEC: Total_UECs from histograms table for this column. Column Cardinality: Rowcount from histograms table for this column. Last Stats Timestamp: The STATS_TIME from histogram table for this column. Viewing Sampled Statistics To display a sample view of the table column statistics, click on the hyperlink on the column name, or double-click any row in the right pane, or use the Sample Column Statistics button located at the top right pane. 1. Start the HP Database Manager and log on using any user ID. 2. Click the Database area. 3. Select a Schema in the navigation tree. 4. Click the Statistics tab in the right pane. 5. Click the hyperlink on the column name, or double-click on any row in the right pane, or use the View Sampled Statistics button located at the top of the right pane. The header displays the column name, the sampled percent, and the table name. The attributes displayed are: Column Name: Name of the column. Data Type: Displays the column datatype. # Nulls: The number of null values for the column. An interval (bucket) with "(NULL) as the boundary value from the histogram_intervals table. Skew: CV from histograms table for this column for schema version For older schema versions, the value is 0. The middle pane displays: Values: Displays the top 10 frequent values for the column. Cardinality: Rowcount from histograms table for this column. The bottom pane displays the histogram intervals for the column data boundaries. For each boundary it displays the data from the stats table and the result from the sample. The pane displays a side-by-side comparison of the histogram data to the sampled data. Interval Number: Name of the column. Min Boundary: The minimum value of the histograms table for this column. Max Boundary: The maximum value of the histograms table for this column. Stats UEC: The total UEC from histograms table of this column. Sampled UEC: The sampled_uec from histograms table for this column Stats Cardinality: The STATS_TIME from histogram table for this column. Sampled Cardinality: The sampled_uec from histograms table for this column. 76 Manage Database Objects

77 6 Use the System Monitor Display the System Monitor The system monitor is a tool within HPDM that displays status and performance data for the Neoview platform. The displayed status and performance data includes seven performance metrics and four system status icons. NOTE: The system monitor is visible for both connected and disconnected systems. The system monitor uses TCP/IP UDP datagrams to communicate with a server component on the Neoview platform. UDP communication allows the system monitor to display useful information even without an active ODBC connection to the system. To display the system monitor: 1. In the navigation tree pane, select the system that you want to monitor. 2. Select the Monitoring area. For more information about areas, see Select an Area (page 25). 3. In the right pane, click the Monitoring tab. Related Topics See the Parts of the System Monitor (page 77) Understand the Performance Metrics (page 78) See the Parts of the System Monitor The system monitor shows performance metrics and system status icons. You can display the performance metrics as a bar graph, a timeline, or a combination of both. In the bar graph (Bar Graph tab), each metric occupies a separate row with a footer. The footer shows the name of the metric. Each bar represents a processing node (CPU), and each column represents a segment. This figure shows a bar graph consisting of two segments (32 CPUs). Display the System Monitor 77

78 Related Topics Configure System Monitor Options (page 82) Understand the Performance Metrics (page 78) Understand the System Status Icons (page 80) Terms segment Understand the Performance Metrics The system monitor shows seven performance metrics: Metric CPU Busy Disk I/O Cache Hits Dispatch Swap Free Memory Queue Length Description The average busy value of the specified processing node (CPU) over the last refresh interval. The average number of disk I/O operations over the last refresh interval. The average number of cache accesses over the last refresh interval. The average number of process-context switches over the last refresh interval. The average number of page faults (swaps) over the last refresh interval. The amount of free memory currently available (in megabytes). The number of processes currently waiting to be dispatched (on the ready queue). The default refresh rate for all performance metrics is 2 seconds. However, the refresh rate is configurable. See Configure System Monitor Options (page 82). Related Topics Configure System Monitor Options (page 82) 78 Use the System Monitor

79 Use Tooltips to Show the Value of a Performance Metric (page 79) Use Tooltips to Show the Value of a Performance Metric When the system monitor bar graph (Bar Graph tab) is displayed, you can quickly obtain the current value of a metric for a given segment and CPU. To obtain the current value, hold the cursor over the bar for the CPU. A tooltip caption shows the segment number, the CPU number, and the approximate value of the bar at the instant the cursor moved over it: Terms segment About the Timeline Tab The Timeline tab shows a graph of each performance metric over time. The graph displays the aggregated (arithmetic mean) value for the entire system over time. Timelines enable you to see a trend for a given metric over a specified number of data points (the Max Range). A data point is a 2-second interval. The timeline graph has no units; a vertical scale is provided only for comparison. The trace lines use the same colors as the bar graph bars in the Bar Graph tab. You can configure the number of data points, the background color, and the trace line colors. Related Topics Configure System Monitor Options (page 82) Use Tooltips to Show the Value of a Performance Metric 79

80 About the Hybrid Tab The Hybrid tab shows a bar graph and a set of timelines side by side: Related Topics About the Timeline Tab (page 79) Configure System Monitor Options (page 82) Understand the System Status Icons The four system status icons (Connectivity, Disks, Transactions, and Alerts) provide an at-a-glance summary of the up or down state of various subsystems and tell you if any alerts are present: 80 Use the System Monitor

81 This table describes the icons: Icon Connectivity Disks Transactions Alerts Description Icon for the association servers. Indicates if $MXOAS and $MXAS2 are running. $MXOAS is the component of the Neoview Database Connectivity Service (NDCS) that receives client connection requests for database access and associates the requestor with a server to execute the requested access. $MXAS2 is the component of NDCS that receives connection requests from the Neoview Transporter and associates that requestor with a server to execute the requested database access. Icon for the disk subsystem. Indicates if the disk drives on all segments are accessible. If a disk volume (both the primary and the mirror) is down, the disk is reported as Down. Other errors are reported as a Warning, including the condition where status information cannot be obtained because of extremely high disk activity. Only disks with errors are reported. If all disks are operational, a message to that effect is displayed. Icon for the Transaction Management Facility (TMF), which provides transaction services. The icon shows if TMF is started or not (reported as a Down condition), if transactions can be created or not (reported as a Down condition), and if there are any hung transactions (reported as a Down condition). Errors, warnings, or informational messages that need your attention. See Get Information About Alerts (page 89). NOTE: The Alerts icon requires an ODBC connection and is gray until you connect to a system. The icon shape and color communicate the general health of each subsystem: Icon Color State Description Gray Connecting The client is waiting to establish a connection with the server. Green Up The subsystem is operating normally. Yellow Warning The subsystem has a minor problem. Red Down The platform has an alert. At least one component has failed or is down. Related Topics Get Details About System Status Icons (page 81) Get Information About Alerts (page 89) Get Details About System Status Icons To get more information about the Connectivity, Transactions, or Disks icons, click any of these icons. An information dialog box appears. For example: Get Details About System Status Icons 81

82 For more information about the Alerts icon, see Get Information About Alerts (page 89). Related Topics Understand the System Status Icons (page 80) Get Information About Alerts (page 89) Configure System Monitor Options The system monitor options pane allows you to control the display of performance metrics, including the bar colors, the refresh rate, and other parameters. To display the system monitor options pane: 1. Under My Active Systems or My Other Systems, select the system that you want to monitor. NOTE: You do not have to be connected to a system to use the system monitor. The system monitor communicates over UDP (not ODBC) with a server component on the Neoview platform. However, the Alerts icon and Alerts tab require an active ODBC connection. For Alerts, you must connect to the server. 2. Click the Monitoring area. For more information about areas, see Select an Area (page 25). 3. In the right pane, right-click anywhere in the Bar Graph, Timeline, or Hybrid tabs, and select Configure System Monitor Options. The system monitor options pane is displayed. To use the system monitor options pane, change a setting or select a new option and click [ Apply ]. To cancel any changes, click [ Cancel ]. Both the [ Apply ] and [ Cancel ] buttons return you to the system monitor tabs from which you started. 82 Use the System Monitor

83 This table describes the system monitor options and settings: Option or Setting Port Refresh Rate Options Active System Status Alerts System Status Location Metric and 100% Settings Description This option shows the Port Number for connecting to the Neoview platform. The default number is 4746, which should satisfy most installations. If the system monitor fails to return data and you suspect that a different port was assigned, contact your HP support representative. The Fixed Incoming option is provided for troubleshooting at sites where the client workstation is behind a firewall. Selecting this option activates a client port that you can specify. The default client port number is 0 (Windows reads 0 as a placeholder for the next available outgoing port). The Fixed Incoming option is useful because the System Monitor both receives and sends data to the Neoview platform. The System Monitor uses a dynamic port for incoming communications, which means it doesn't know the incoming port number until a connection is made. This requires opening a firewall to a large range of ports, which can be undesirable. To avoid opening up a large number of ports, you can specify a fixed incoming port using this option. The refresh rate is the amount of time that the client waits before requesting new data from the server. The default rate is 2 seconds. You can change the refresh rate to another value in the range 2 through 500 seconds. NOTE: The server does not always return the requested data immediately. For instance, if the refresh rate is set to 5 seconds, the client requests data from the server every 5 seconds. But the server can take an additional 2 to 4 seconds to respond with the data. In this sense, the refresh rate is closer to an update request interval. Options that allow you to show or hide these system status icons: Connectivity Transactions Disks Alerts To hide an icon, deselect the appropriate option. Controls where the system status icons appear. You can display the icons above or below the bar graph or timeline information. Control the bar/line color, show/hide option, and 100% setting for performance metrics. For example: The bar/line color is the color of the specified bar in the bar graph or the line in the timeline. See Change a Color Option (page 85). The show/hide option controls whether or not the metric is displayed. When a show/hide options is selected, the performance metric is displayed. When the option is deselected, the metric is hidden. The 100% setting is the highest non-error value that the system monitor is currently configured to display. A value higher than the 100% value causes the bar color to change. A value higher than the 100% setting is not reflected by the bar but is captured in the tooltip information. Chart Background Options Options that control the background colors for the timeline, bar graph, and the lost-connection condition. The Lost Connection Background Color is implemented only if the Timeout Color option is selected. See Change a Color Option (page 85). Configure System Monitor Options 83

84 Option or Setting Additional Color Options Aggregation Options Timeout Color Additional Settings Timeline Options Description Options that control the bar color for the mouse-over, threshold-exceeded, and CPU-down conditions. See Change a Color Option (page 85). Options that control the way data collected (aggregated) for each bar in the bar graph (Bar Graph tab): No Aggregation displays one bar per CPU (16 bars per segment). For example, the client shows 64 bars (16 CPUs per segment) for a four-segment platform. Segments displays one bar per segment. For example, the client shows four bars for a four-segment platform. Each bar represents the average value for a given metric for the segment. If a metric exceeds its 100% setting, the bar color changes to the Threshold Exceeded bar color. Special viewing features are available when segment aggregation is selected. See Use the System Monitor With Segment Aggregation (page 84). Controls the chart background color when the connection with the server is lost. If this option is selected, the Lost Connection Background Color is implemented when a connection is lost. The Lost Connection Background Color can help you recognize when the data provided by the client is no longer valid. The Neoview System Monitor retries the connection every couple of seconds for about 10 minutes. After 10 minutes, an error message is displayed. Controls the Show Separators option. Segment separators are the vertical lines on the system monitor screen that mark each segment in a Neoview platform. These lines appear by default, but you can hide them by deselecting this option. To specify the amount of time captured by a timeline, enter a number in the Max Range field. The default value is 50. This is the number of data points (intervals) that you want the timeline to display. Data points are collected approximately every 2 seconds. Therefore, specifying a Max Range of 50 intervals produces a timeline of about 100 seconds. Terms segment Use the System Monitor With Segment Aggregation If segment aggregation is selected in the system monitor options pane, the display changes to show only one bar per segment. For example, if your system has four segments, the system monitor shows four colored bars for each metric. Each bar represents the average (arithmetic mean) value for that segment. Clicking any of the segment bars in the bar graph area of the Bar Graph tab or Hybrid tab changes the display to drill down on that segment. The display shows one bar for every CPU in the selected segment. NOTE: When the display is focused on one segment, you can no longer view bar graph information for any other segments. To return to the full system aggregated view, click the Full System View link at the top of the system monitor pane: Related Topics 84 Use the System Monitor

85 Configure System Monitor Options (page 82) Terms segment Change a Color Option Color options appear as bar/line-color buttons in the system monitor options pane. To change a color option: 1. Display the system monitor options pane, as described in Configure System Monitor Options (page 82). 2. Click the bar/line-color button for the metric or background whose color you want to change. The color palette dialog box appears. 3. Select a color from the color palette. 4. Click [ OK ]. 5. Click [ Apply ]. Related Topics Configure System Monitor Options (page 82) Change a Color Option 85

86 86

87 7 Respond to Alerts Display the Alerts Tab NOTE: Diagnostic information displayed by the Alerts tab is intended for use by HP support. This information is not documented for customer use. If you have questions about an alert condition, contact your HP support representative. Special privileges are required to display the Alerts tab. See Understand Privileges for Viewing and Updating Alerts (page 88). To display the Alerts tab: 1. In the My Active Systems folder of the navigation tree pane, select the system for which you want to view alerts. 2. Select the Monitoring area. For more information about areas, see Select an Area (page 25). 3. Use either of these methods: In the right pane, click the Alerts tab. Double-click the Alerts system status icon. Related Topics Understand Alerts (page 88) See the Parts of the Alerts Tab (page 87) Understand Privileges for Viewing and Updating Alerts (page 88) Understand the System Status Icons (page 80) See the Parts of the Alerts Tab Related Topics Understand Alerts (page 88) Understand Privileges for Viewing and Updating Alerts (page 88) Display the Alerts Tab 87

88 Understand Alerts NOTE: Diagnostic information displayed by the Alerts tab is intended for use by HP support. This information is not documented for customer use. If you have questions about an alert condition, contact your HP support representative. Alerts are alarms or incident reports generated by internal subsystems. The system monitor provides a system status icon to summarize the alert condition, and the Alerts tab provides detailed information about specific alerts. Alerts information is displayed only if the Neoview platform is loaded with Release 2.4 Service Pack 1 (SP1) or later software and you have sufficient privileges to view the alerts. The Alerts tab fetches alert details from a Neoview Repository view: NEO.HP_METRICS.ALERTS_VW2 This view is a merge of the ALARMS and DIALOUTS tables in the repository. HPDM uses a query to fetch this information. The query results are displayed in the Alerts tab data grid with the most recent alerts at the top of the grid. The grid column names are the column names of the NEO.HP_METRICS.ALERTS_VW2 Repository view. By default, alert details are refreshed every 3 minutes, but the refresh rate is configurable. After 30 days (based on the alert creation date), alerts are no longer displayed, but you can change the display period by configuring the Time Range in the Alerts Options dialog box. Related Topics Control the Refresh of Alerts (page 93) Use the Alerts Options Dialog Box (page 92) Understand Privileges for Viewing and Updating Alerts (page 88) Terms alert Understand Privileges for Viewing and Updating Alerts By default, super.super, super.services, and ROLE.DBA can view and update alerts. Other users can view alerts if they are granted SELECT privileges on the NEO.HP_METRICS.ALERTS_VW2 view, or if they are granted administrator privileges by an administrator user. Users who have SELECT privileges on the NEO.HP_METRICS.ALERTS_VW2 view cannot necessarily update alerts. Users can update alerts if they are granted administrator privileges by an administrator user or if they are granted UPDATE privileges on these columns of the Alarms table: STATUS NOTES LAST_UPDATE_UTC_TS LAST_UPDATE_LCT_TS CLOSED_UTC_TS CLOSED_LCT_TS To view the alerts state and the details, a user must have SELECT privileges on the NEO.HP_METRICS.ALERTS_VW2 view. This view is created by the Neoview Repository and by default secured for super.super, super.services, and ROLE.DBA. The super.super user has implicit update privileges. For all other users, HPDM checks the SQL privileges to verify that the current logged on user or role has update privileges for the MANAGEABILITY.METRICS.ALARMS base table. This includes super.services, ROLE.DBA, and all other roles. HPDM checks for update privileges on the whole table first. If those privileges are not found, HPDM checks to see if the user has update privileges on the ALARM_STATUS column. 88 Respond to Alerts

89 If the current user has update privileges, the ALARM_STATUS column in the Alerts data grid displays a menu with selectable update states (ACKNOWLEDGED and USERCLOSED): In addition, the ALARM_NOTES column provides a [... ] button that opens the Alert Notes Editor dialog box: If the current user does not have update privileges, the menu and notes button are not displayed. Related Topics Update an Alert (page 95) Make Notes About an Alert (page 96)??? Terms administrator Get Information About Alerts The Alerts icon in the system monitor shows the alert status. When you position your pointer over the icon, a tooltip shows the number of open errors, warnings, and informational messages: Unlike the Connectivity, Disks, and Transactions icons, the Alerts icon requires an ODBC connection to fetch the alerts status. This table describes how to interpret the alert state based on the color of the Alerts icon: Alerts Icon Color Gray Red Description A gray icon signals one of these conditions: The system is not connected. The logged on user does not have the required privileges to view alerts. The repository view for alerts does not exist. At least one OPEN or ACKNOWLEDGED alert is present and has an ERROR alert level. Get Information About Alerts 89

90 Alerts Icon Color Yellow Green Description At least one OPEN or ACKNOWLEDGED alert is present and has a WARN alert level. No ERROR or WARN alerts are present, but informational (INFO) alerts might be present. Related Topics Understand Row Detail Information for Alerts (page 90) Understand the System Status Icons (page 80) Understand Row Detail Information for Alerts This table describes the row detail information for the Alerts data grid. For more information about displaying row details, see Get Row Details for a Data Grid (page 113). NOTE: Diagnostic information displayed by the Alerts tab is intended for use by HP support. If you have questions about an alert condition, contact your HP support representative. Field LEVEL ALARM_RESOURCE_NAME ALARM_SPECIFIC_PROBLEM ALARM_SEGMENT ALARM_SEVERITY ALARM_STATUS ALARM_CREATE_LCT_TS ALARM_TYPE ALARM_NOTES ALARM_PROBABLE_CAUSE ALARM_COUNTER IR_ID IR_SEVERITY Description A computed field with an icon that indicates the ERROR, WARN, or INFO status. The name of the resource that generated the alarm. Information to describe why the ALARM_PROBABLE_CAUSE occurred. For example, if the probable cause is an equipment malfunction, this field might say that the temperature exceeded normal limits. The segment number where the problem originated. CRITICAL, FATAL, INDETERMINATE, INFORMATION, MAJOR, MINOR, OTHER, or WARNING. The severity is determined by the underlying alarm. NOTE: The severity for Neoview Management Dashboard alarms is always INDETERMINATE. ACKNOWLEDGED: An operator acknowledged the alarm, but it is still open. AUTOCLOSED: Neoview software deleted the alarm, indicating that the problem no longer exists. OPCLOSED: An HP support person closed the alarm manually. OPEN: An alarm was created. USERCLOSED: An operator used HPDM to close the alarm. UNKNOWN: The status is unknown. The ANSI timestamp in local civil time (LCT) when the alarm was created. This is the local time for the Neoview platform. NVMD for Neoview Management Dashboard alarms. OSM for Open System Management alarms. Notes about the alarm that can only be added manually by an HPDM operator. The likely cause of the alarm. The number of internal events generated for the alarm. The segment-local identification number associated with the incident report (IR). The ID is incremented for every new incident report. CRITICAL, FATAL, INDETERMINATE, INFORMATION, MAJOR, MINOR, OTHER, or WARNING. The severity is determined by the underlying alarm. 90 Respond to Alerts

91 Field IR_STATUS ALARM_CREATE_UTC_TS* ALARM_CLOSED_UTC_TS* ALARM_CLOSED_LCT_TS* ALARM_EVENT_NUMBER* ALARM_SSID* ALARM_IR_CREATED* ALARM_LAST_UPDATE_UTC_TS* ALARM_LAST_UPDATE_LCT_TS* IR_SEGMENT* IR_DETECTED_UTC_TS* IR_DETECTED_LCT_TS* IR_DELIVERED_UTC_TS* IR_DELIVERED_LCT_TS* IR_LAST_UPDATE_UTC_TS* IR_LAST_UPDATE_LCT_TS* IR_NOTES* Description The delivery status of an incident report (IR). Possible values are: CREATED, DELIVERED, FAILED DELIVERY, and UNKNOWN. This column indicates that a dial-out was generated by the Neoview platform, but not necessarily that the dial-out was successfully received by HP support. The ANSI timestamp in universal coordinated time (UTC) when the alarm was created. The ANSI timestamp when the alarm was closed, using the generated timestamp in universal coordinated time (UTC). The ANSI timestamp when the alarm was closed in local civil time (LCT). The EMS event number associated with the alarm. The subsystem ID for the event that generated the alarm. An indication of whether or not an IR is expected to be created, with the values Y (yes) or N (no). The timestamp in universal coordinated time (UTC) when the alert row was last updated. An alarm can be updated because internal events are generated for the alarm or because someone updated the notes or status for the alert row in HPDM. The timestamp in local civil time (LCT) when the alert row was last updated. An alarm can be updated because internal events are generated for the alarm or because someone updated the notes or status for the alert row in HPDM. The segment where the incident report was originated. This is the same as the alarm segment. The timestamp in universal coordinated time (UTC) when the problem-management software detected the incident report. The timestamp in local civil time (LCT) when the problem-management software detected the incident report. The timestamp in universal coordinated time (UTC) when the incident report was successfully dialed out. NOTE: This column indicates that a dial-out was generated by the Neoview platform, but not necessarily that the dial-out was successfully received by HP support. The timestamp in local civil time (LCT) when the incident report was successfully dialed out. NOTE: This column indicates that a dial-out was generated by the Neoview platform, but not necessarily that the dial-out was successfully received by HP support. The timestamp in universal coordinated time (UTC) when the incident report was last updated. The timestamp in local civil time (LCT) when the incident report was last updated. Always blank (for future use). *This field is not displayed by default. Use the Show/Hide Grid Columns command to control the display of this field. See Customize the Data Grid (page 116). Related Topics Get Row Details for a Data Grid (page 113) Customize the Data Grid (page 116) Understand Row Detail Information for Alerts 91

92 Terms alert segment Use the Alerts Options Dialog Box To display the Alerts Options dialog box: 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 2. Click the [ Alter Alerts Configuration ] button: The Alerts Options dialog box appears. This table describes the alerts options and controls: Option or Control Open Alerts Only All Alerts Show Neoview Management Dashboard Alerts Description Causes the Alerts data grid to display only the open and acknowledged alerts. These are alerts for which the ALARM_STATUS value is OPEN or ACKNOWLEDGED. NOTE: Whether the system monitor is configured to display open alerts or open and closed alerts, the state of the OPEN/ACKNOWLEDGED alerts is used to compute the color of the Alert Status icon, and the closed alerts are purged by the problem-management backend software at periodical intervals. Causes the Alerts data grid to display open and closed alerts. The closed alerts include: Alarms that have been closed by an operator by using HPDM (USERCLOSED) Alarms that have been closed by using another tool (OPCLOSED) Alarms that have been automatically closed by the system (AUTOCLOSED) NOTE: Whether the system monitor is configured to display open alerts or open and closed alerts, the state of the OPEN/ACKNOWLEDGED alerts is used to compute the color of the Alert status icon, and the closed alerts are purged by the problem-management backend software at periodical intervals. Causes the alerts from the Neoview Management Dashboard (ALARM_TYPE NVMD) to be fetched. These alerts are not displayed by default. 92 Respond to Alerts

93 Option or Control Time Range (server side LCT) From Time To Time Day +/ and Hour +/ Buttons Severity/Alert Level Mappings Description Specifies the interval for which data is fetched in the server-side local civil time (LCT). By default, the Alerts data grid fetches alert details for the last 30 days. But you can select other time range options: Custom Range Last Hour Today Last 24 Hours Yesterday This Week Last 7 Days Last Week Last 14 Days Last 30 Days This Month Specifies the start time for fetching data when the Custom Range option is chosen for the Time Range. This is the server LCT time (local civil time). Specifies the end time for fetching data when the Custom Range option is chosen for the Time Range. This is the server LCT time (local civil time). Allow you to fine tune the From Time and To Time values by adding or subtracting days or hours when the Custom Range option is chosen for the Time Range. Allow you to map the Alert Level icons to different severities. The Alerts tab displays three different alert levels (Error, Warning, and Information). However, there are eight different severity levels: Fatal Critical Major Minor Warning Information Other Indeterminate You can map the Alert Level icons to different severities by pressing the down arrow next to an Alert Level column and selecting a different icon: Any mapping changes are persisted across future HPDM sessions. Control the Refresh of Alerts Alerts are refreshed automatically every 3 minutes. A refresh timer controls the refresh interval. When an update is in progress, the refresh timer is paused. If the update completes successfully, the refresh timer is restarted. If for any reason one or more updates fail, the refresh timer remains paused so that you can resolve the issue without losing any update information. You can control the refresh interval and other refresh attributes by using the toolbar buttons at the top of the Alerts tab. Control the Refresh of Alerts 93

94 Click this button... Stop Data Provider Refresh Data Pause Timer Resume Timer Set Refresh Time Alter Alerts Configuration To do this Stop the refresh. Refresh the Alerts data grid at any time. Pause the refresh. Restart the refresh after pausing. Change the refresh interval. See the steps for doing this later in this topic. Control the display of alerts. See Use the Alerts Options Dialog Box (page 92). To change the refresh interval: 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 2. Click the [ Set Refresh Time ] button: 3. Select a refresh interval. The timer status bar counts down the new refresh interval in seconds. Suppose the refresh timer is set to a low value (for example, 30 seconds). If you are investigating an alert, you might want to pause the timer so that a refresh doesn't change the data displayed in the data grid. To pause the refresh: 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 2. Click the [ Pause Timer ] button. The button changes to a [ Resume Timer ] button, and the timer status bar shows Refresh Paused. 3. To restart the timer click the [ Resume Timer ] button. Related Topics About the Console Tab (page 97) See the Parts of the Alerts Tab (page 87) Use the Update Alert Dialog Box To display the Update Alert dialog box: 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 94 Respond to Alerts

95 2. In the Alerts data grid, right-click any alert (or multiple alerts), and select Update Alert(s). The Update Alert dialog box appears. This table describes the options and fields in the Update Alert dialog box: Option or Field Status Select a predefined note or enter your own Update History Description Allows you to choose between the ACKNOWLEDGED and USERCLOSED statuses. Allows you to select from these options: Alert resolved flags the alert as resolved. False alert flags the alert as a false alarm. Duplicate alert flags the alert as a duplicate. Customer note allows you to type a note or message that relates to the alert(s). Shows information about previous updates, if any, for an alert. This field is present only if previous updates were made. The [ Apply ] button submits the update changes to the server. [ Cancel ] cancels any changes made in the Update Alert dialog box. Update an Alert Updating an alert means changing the status of the alert to a value other then OPEN. You can change the status to ACKNOWLEDGED or USERCLOSED. You can also add information about an alert, as described in Make Notes About an Alert (page 96). To update an individual alert, use either of these methods: NOTE: You must have the necessary privileges before you can update an alert. See Understand Privileges for Viewing and Updating Alerts (page 88). Update the alert directly in the ALARM_STATUS column: 1. Click the down arrow in the ALARM_STATUS column for the alert that you want to update, and select ACKNOWLEDGE or USERCLOSED. Use this value ACKNOWLEDGED USERCLOSED To indicate that... An operator has viewed the alert. You can make notes about the alert in the ALARM_NOTES field. When an alert is acknowledged, the status, notes, and last updated timestamp columns are updated in the MANAGEABILITY.METRICS.ALARMS base table. An operator has viewed and closed the alert. You can make notes about the alert in the ALARM_NOTES field. When an alert is closed, the status, notes, last update timestamp, and closed timestamp columns are updated in the MANAGEABILITY.METRICS.ALARMS base table. If the Alerts Options dialog box is set to display only open alerts, the closed alert will not be visible anymore. Update an Alert 95

96 2. Click the [ Apply ] button at the bottom of the Alerts tab: Use the steps for updating multiple alerts, but select only one row to update. Related Topics Update Multiple Alerts (page 96) Make Notes About an Alert (page 96) Update Multiple Alerts You can update multiple alerts in the same operation. NOTE: You must have the necessary privileges before you can update alerts. See Understand Privileges for Viewing and Updating Alerts (page 88). To multiple update alert(s): 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 2. Select cells in multiple rows corresponding to the alerts that you want to update. 3. Right-click and select Update Alert(s). The Update Alert dialog box appears. 4. Complete the Update Alert dialog box, as described in Use the Update Alert Dialog Box (page 94). 5. Click [ Apply ]. Make Notes About an Alert You can annotate an alert without changing the status of the alert. NOTE: You must have the necessary privileges before you can annotate an alert. See Understand Privileges for Viewing and Updating Alerts (page 88). To annotate an alert: 1. Display the Alerts tab, as described in Display the Alerts Tab (page 87). 2. In the ALARM_NOTES column, click the [... ] button for the alert that you want to annotate. The Alert Notes Editor dialog box appears. 3. Select a predefined note, or type a customer note, and click [ OK ]. 96 Respond to Alerts

97 4. Click the [ Apply ] button at the bottom of the Alerts tab to send the changes to the server. Related Topics Update an Alert (page 95) About the Console Tab When either the Alerts tab or the System Offender tab is selected in the right pane, the Console tab is visible underneath it (unless the Console tab is hidden). The Console tab shows the queries that are used to gather data-grid information from the server. You can select and copy this information directly from the tab. To clear the console history, click the Clear Console History icon. To show or hide the Console tab, click the Fetch Status Bar. About the Console Tab 97

98 98

99 8 Find Offending Processes and Queries About System Offender System Offender is a tool that allows you to monitor system resources and detect processes and queries that use excessive CPU resources or memory. These are referred to as offending processes and queries. System Offender is a tab within the Monitoring area of HPDM. System Offender shows real-time data about processes and queries. The data is presented in a data grid. System Offender updates or refreshes the data grid at intervals that you control, and you can pause a refresh at any time to gather more information. System Offender is integrated with the Monitoring tab and system monitor. From the system monitor, you can drill down to obtain a list of related processes and queries and then obtain process detail, Pstate, or children-process information about each process. If the selected process has a query ID associated with it, you can check the plan, the compiler statistics, the runtime statistics, and memory usage counters. If necessary, you can cancel a runaway query and release allocated system resources. NOTE: Diagnostic information displayed by some System Offender dialog boxes is intended for use by HP support. This information is not documented for customer use. If you have questions about diagnostic information, contact your HP support representative. Related Topics Display the System Offender Tab (page 99) See the Parts of the System Offender (page 100) Terms data grid offending process Display the System Offender Tab To display the System Offender tab: 1. In the My Active Systems folder of the navigation tree pane, select the system for which you want to find offending processes. 2. Select the Monitoring area. For more information about areas, see Select an Area (page 25). 3. In the right pane, click the Monitoring tab. 4. Click the System Offender tab. Related Topics About System Offender (page 99) See the Parts of the System Offender (page 100) Understand System Offender Privileges (page 100) Find Offending Processes and Queries (page 100) About System Offender 99

100 See the Parts of the System Offender Related Topics Understand System Offender Privileges (page 100) Find Offending Processes and Queries (page 100) Understand System Offender Privileges Administrator users (ROLE.DBA, super.services, and super.super by default) can use all System Offender features. Only administrator users can alter System Offender server parameters, use the Pstate command, and cancel queries. Non-administrative users can alter System Offender client parameters and use all other System Offender features, which include displaying this information about a selected process: Workload detail information Process detail and parent process detail information Children process summary and detail information Terms administrator Find Offending Processes and Queries To find offending processes and queries, start your search in the system monitor. Then gather more information by using the System Offender: 1. Display the system monitor, as described in Display the System Monitor (page 77). 2. In the system monitor bar graph (Bar Graph tab or Hybrid tab), click one of the following areas: 100 Find Offending Processes and Queries

101 NOTE: Click once; you do not need to double-click. Click any CPU bar or header for these performance metrics... For example CPU Busy Disk I/O Cache Hits Dispatch Queue Length or... Free Memory Swap or... The System Offender tab displays a list of processes for the specified CPU (or all CPUs). The area you click in the System Monitor determines the System Offender active command. For example: When you click... The System Offender shows the active command as A CPU for a CPU-related metric A header for a CPU-related metric A CPU for a memory-related metric A header for a memory-related metric Find Offending Processes and Queries 101

102 3. In the System Offender data grid, see a list of processes: 4. Right-click a process that you want to learn more about, and select a command from the context menu: Terms NOTE: The Workload Detail command is active only if a query is associated with the selected process. The context menu commands provide detailed process information. For more information, see these topics. Get Query Workload Information (page 107) Get Process Detail Information (page 103) Get Pstate Information (page 104) Get Children Process Information (page 104) Understand Row Details for System Offender (page 105) 102 Find Offending Processes and Queries

103 data grid offending process Get Process Detail Information NOTE: Diagnostic information displayed by the Process Detail and Parent Process Detail dialog boxes is intended for use by HP support. This information is not documented for customer use. If you have questions about process detail information, contact your HP support representative. The Process Detail and Parent Process Detail commands, which are available from the context menu of the System Offender data grid, provide process information for a running process or a process that spawned another process (a parent process). For example: To obtain process detail information: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. Right-click a process in the data grid, and select Process Detail or Parent Process Detail. Related Topics Find Offending Processes and Queries (page 100) Understand System Offender Privileges (page 100) Terms administrator Get Process Detail Information 103

104 Get Pstate Information NOTE: Diagnostic information displayed by the Pstate and Parent Pstate dialog boxes is intended for use by HP support. This information is not documented for customer use. If you have questions about Pstate information, contact your HP support representative. The Pstate and Parent Pstate commands, which are available from the context menu of the System Offender data grid, provide a snapshot of the status of a running process or a process that spawned another process (a parent process). These commands are available only to administrator users. To obtain Pstate information: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. Right-click a process in the data grid, and select Pstate or Parent Pstate. Related Topics Find Offending Processes and Queries (page 100) Terms administrator Get Children Process Information A children process is a process that is spawned by another process (a parent process). To obtain children process information: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. Right-click a process in the data grid, and select Children Processes. The Children Processes dialog box appears. 3. To use and understand the information provided by the Children Processes dialog box, see Use the Children Processes Dialog Box (page 105). Related Topics Use the Children Processes Dialog Box (page 105) 104 Find Offending Processes and Queries

105 Use the Children Processes Dialog Box To display the Children Processes dialog box, see Get Children Process Information (page 104). This table describes the dialog box fields: Field or Option Query ID Query Text Parent Process Filter CPU Value [ Refresh ] Summary Tab Description The query identification number. The text of the Neoview SQL statement. The process that spawned the children processes described in the Detailed tab. Controls which processes are displayed in the Detailed tab based on CPU utilization. Set this value to the lowest CPU utilization that you want the dialog box to display. For example, if you set the CPU Value to 0, the tabs display all children processes in all CPUs. If you set the CPU Value to 50, the tabs display all children processes running in CPUs that are utilized at 50% or greater. Updates the information in the Summary and Detailed tabs. Displays the number of children processes running in each CPU for a 16-segment Neoview platform. Gray cells indicate CPUs or segments that are not available. A blue number indicates that the CPU utilization is less than 90%. A red number indicates that the CPU utilization is greater than or equal to 90%. For example, this Summary tab shows segment 1 CPUs 0, 1, 2, and 3 running at 90% or above: Detailed Tab Displays detailed information about all children processes for the selected parent process. The information includes: SEGMENT CPU PIN PROCESS PRIORITY PROCESS TYPE CPU USAGE MEM USAGE PROGRAM NAME In the CPU USAGE column, a red number indicates CPU utilization of greater than or equal to 90%. A blue number indicates CPU utilization of less than 90%. Related Topics Get Children Process Information (page 104) Understand Row Details for System Offender This table describes row detail information for the System Offender data grid. For more information about displaying row details, see Get Row Details for a Data Grid (page 113). Use the Children Processes Dialog Box 105

106 NOTE: Diagnostic information displayed by the System Offender tab is intended for use by HP support. If you have questions about an offending process, contact your HP support representative. Field SEGMENT CPU PIN PROCESS PRIORITY PROCESS TYPE CPU USAGE PERCENT* MEMORY USAGE MB* PROCESS NAME PROGRAM NAME* PARENT SEGMENT PARENT CPU PARENT PIN PARENTPROCESSPRIORITY PARENT PROCESS TYPE PARENT PROCESS NAME PARENTPROGRAMNAME* TCP PORT* TCP STATE* ELAPSED TIME WAIT TIME* HOLD TIME* QUERY ID Description The segment number. A Neoview platform consists of up to 16 segments with each segment containing up to 16 processing nodes. The processing node. The process identification number (PIN). The PIN is an unsigned integer that identifies a process in a processing node. The execution priority of the process (an integer in the range from 1 through 199 (1 is lowest priority)). The type of process, the display of which is controlled by the Process Type parameter in the Alter Offender Parameters dialog box. For example, if the current Process Type is set to SQL, the process types can be MXUDR, MXESP, MXCI, and MXOSRVR. If the Process Type is set to ALL, any process type can be displayed. For information about setting the process type, see Use the Alter Offender Parameters Dialog Box (page 109). The current CPU utilization from 0 to 100%. The current memory usage in megabytes (MB). A name that is assigned to a process when the process is created. A process name uniquely identifies a process or process pair in a system. A process name consists of a dollar sign ($) followed by one to five alphanumeric characters, the first of which must be alphabetic. The name of the program. The number of the segment on which the parent process is running. The processing node in which the parent process is running. The process identification number (PIN) of the parent process. The PIN is an unsigned integer that identifies a process in a processing node. The execution priority of the parent process (an integer in the range from 1 through 199 (1 is lowest priority)). The type of parent process, the display of which is controlled by the Process Type parameter in the Alter Offender Parameters dialog box. For example, if the current Process Type is set to SQL, the process types can be MXUDR, MXESP, MXCI, and MXOSRVR. If the Process Type is set to ALL, any process type can be displayed. For information about setting the process type, see Use the Alter Offender Parameters Dialog Box (page 109). A name that is assigned to a parent process when the process is created. Includes the segment name. A process name uniquely identifies a process or process pair in a system. A process name consists of a dollar sign ($) followed by one to five alphanumeric characters, the first of which must be alphabetic. The name of the parent program. The port to which the client process is connected. The state of the client connection. How long the query has been executing. How long the query has been in a waiting state. How long the query has been on hold. The query ID number (up to 160 characters). 106 Find Offending Processes and Queries

107 Field QUERY NAME QUERY TEXT ROLE NAME* USER NAME* DATASOURCE Description The name of the client workstation and application that generated the query. A preview of the actual query text (up to 254 characters). The role of the user who initiated the query. The user who initiated the query. The data source. *This field is not displayed by default on the data grid. To display this field, use the Show/Hide Grid Columns command available from the System Offender context menu. See Customize the Data Grid (page 116). Related Topics Get Row Details for a Data Grid (page 113) Customize the Data Grid (page 116) Terms segment Get Query Workload Information The Workload Detail dialog box shows query workload information. This information includes: General query information Compiler statistics Runtime statistics Memory allocation and usage information Query text and automatic retry information NOTE: Diagnostic information displayed by the Workload Detail dialog box is intended for use by HP support. If you have questions about query diagnostic information, contact your HP support representative. Any user can view the workload detail information. To display the Workload Detail dialog box: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. In the data grid, right-click a process that has a query ID (as indicated in the QUERY ID column), and select Workload Detail. The Workload Detail dialog box appears. 3. To use and understand the information in the Workload Detail dialog box, see Use the Workload Detail Dialog Box (page 107). Related Topics Cancel a Query From System Offender (page 108) Use the Workload Detail Dialog Box (page 107) Use the Workload Detail Dialog Box To display the Workload Detail dialog box, see Get Query Workload Information (page 107). Get Query Workload Information 107

108 NOTE: Diagnostic information displayed by the Workload Detail dialog box is intended for use by HP support. If you have questions about query diagnostic information, contact your HP support representative. The Workload Detail dialog box is mostly informational. If a query has a rule or service level associated with it, the Warn Level indicator indicates if the rule has been violated. The warning levels are: NOWARN (green) LOW (yellow) MEDIUM (orange) HIGH (red) Descriptions for each field in the Workload Detail dialog box can be found in the Neoview Workload Management Services Guide. This table describes the Workload Detail buttons and options: Button [ View ] [ SQL Text ] [ SQL Plan ] [ Cancel Query ] [ Rules Assoc ] [ Repository Info ] [ Refresh ] Auto Refresh Description Displays the Warn Info dialog box, listing rules information for the query. This dialog box can show the status for multiple warning levels associated with the selected query. Displays the text for any query that belongs to a service that has text enabled in WMS or displays the text obtained from the repository if text is not available in WMS. Displays the query plan if SQL Plan is enabled in WMS. Cancels the query. See Cancel a Query From System Offender (page 108). Shows you the rules associated with a service. Select a rule or service and click [ Service Info ] or [ Rule Info ] to get more information about a rule or service. Shows the data that is currently registered in the Neoview Repository for the specified query. Use this button to validate information for long-running queries. Refreshes all workload information manually. When you refresh the display, some information appears in blue text. Blue text indicates a value that changed since the last refresh. To configure an automatic refresh, select the Auto Refresh option. Select this option, and move the slider below it to refresh the workload information automatically after an interval of seconds that you specify. Note that when the display refreshes, some information appears in blue text. Blue text indicates a value that changed since the last refresh. Related Topics Cancel a Query From System Offender (page 108) Cancel a Query From System Offender Only an administrator user can cancel a query. To cancel a query by using the System Offender: 1. Display the Workload Detail dialog box as described in Get Query Workload Information (page 107). 2. Click [ Cancel Query ]. A confirmation dialog box appears. 3. Click [ Yes ] or [ No ]. 108 Find Offending Processes and Queries

109 NOTE: You can also cancel a query from the SQL Whiteboard. See Cancel a Query From the SQL Whiteboard (page 119). Related Topics Get Query Workload Information (page 107) Use the Workload Detail Dialog Box (page 107) Terms administrator Alter System Offender Parameters To display the Alter Offender Parameters dialog box and alter the parameters: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. In the toolbar, click the [ Alter Offender Parameters ] button: The Alter Offender Parameters dialog box is displayed. 3. Configure the server and/or client parameters as described in Use the Alter Offender Parameters Dialog Box (page 109). 4. Click OK. Related Topics Use the Alter Offender Parameters Dialog Box (page 109) Use the Alter Offender Parameters Dialog Box To display this dialog box, see Alter System Offender Parameters (page 109). You must be an administrator user to alter the Server Parameters. Any user can alter the Client Parameters. Altered parameters are persisted by HPDM. Group Box Server Parameters Parameter Sample Interval (sec.) Sample CPUs (# CPUs/sample) Description How often in seconds WMS fetches the offender sample data. The default value is 10, and the range is from 10 to 60 seconds. The number of CPUs that WMS checks during one sample. The default value is 2, and the range is 2 to 16. Sample Cache (# processes/segment) The number of offending processes that WMS displays per segment. The default value is 10, and the range is 10 to 100. Client Parameter Process Type SQL displays SQL processes, such as MXUDR, MXESP, MXCI, and MXOSRVR. All (the default setting) displays all processes. This table describes the buttons: Button [ OK ] [ Reset ] [ Cancel ] Description Sends the dialog box changes to the server. Restores the default values for the parameters that the user has privileges to change. Closes the dialog box without making changes. Alter System Offender Parameters 109

110 Related Topics Alter System Offender Parameters (page 109) Control the Refresh of System Offender The System Offender data grid is refreshed automatically every 60 seconds. During a refresh, System Offender fetches new information from the server using the current active command. The active command appears under the System Offender tab. For example: A refresh timer controls the refresh interval. When an update is in progress, the refresh timer is paused. If the update completes successfully, the refresh timer is restarted. If, for any reason, one or more updates fail, the refresh timer remains paused so that you can resolve the issue without losing configured information. You control the refresh interval and other refresh attributes by using the toolbar buttons at the top of the System Offender tab: Click this button... Stop Data Provider Refresh Data Pause Timer Resume Timer Set Refresh Time Alter Offender Parameters History To do this Stop the refresh. Refresh the Alerts data grid at any time. Pause the refresh. Restart the refresh after pausing. Change the refresh interval. See the steps for doing this later in this topic. Control the information displayed by the System Offender. See Alter System Offender Parameters (page 109). Display all of the WMS commands sent to the server for the current session. See Use the System Offender History (page 111). To change the refresh interval: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 110 Find Offending Processes and Queries

111 2. Click the [ Set Refresh Time ] button: 3. Select a refresh interval. The timer status bar counts down the new refresh interval in seconds. Suppose the refresh timer is set to a low value (for example, 30 seconds). If you are investigating an offending process, you might want to pause the timer so that a refresh doesn't change the data displayed in the data grid. To pause the refresh: 1. Display the System Offender tab, as described in Display the System Offender Tab (page 99). 2. Click the [ Pause Timer ] button. The button changes to a [ Resume Timer ] button, and the timer status bar shows Refresh Paused. 3. To restart the timer click the [ Resume Timer ] button. Related Topics See the Parts of the System Offender (page 100) About the Console Tab (page 97) Use the System Offender History The System Offender History dialog box shows all of the WMS commands sent to the server for the current session. To display the History dialog box: 1. Display the System Offender tab as described in Display the System Offender Tab (page 99). 2. Click the [ History ] button: The History dialog box appears. For example: The command history is more than simply a reference listing. You can select any row in the history and re-execute the selected command by clicking [ OK ]. Use the System Offender History 111

112 To erase the history, click [ Clear ]. To update the history, click [ Refresh ]. 112 Find Offending Processes and Queries

113 9 Work With Data Grids About Data Grids The Alerts tab, System Offender tab, SQL Whiteboard Statement Details pane, and some Space Management panels, such as the Over Threshold Summary, display information in a data grid. The data grid is a simple table with columns and some special features for displaying and manipulating data. Data grids allow you to do some or all of these tasks: Get details about a specific cell or row. Issue commands by right-clicking to display a context menu Sort data within a column. Rearrange columns. Copy cell or row information. Customize the display of information. Search for information in the grid. Some HPDM tabs (the tabs in the Database area, for example) do not provide data-grid features. You can usually sort and export the data in these tabs, but you can't get row detail information, search for items, or display context menus. Related Topics See the Parts of the Alerts Tab (page 87) See the Parts of the System Offender (page 100) Get Row Details for a Data Grid (page 113) Copy Data-Grid Information (page 114) Customize the Data Grid (page 116) Search the Data Grid (page 116) Terms data grid Get Row Details for a Data Grid To get more information about any row in a data grid, use either of these methods: Right-click any cell in the row, and select Row Details. Double-click any cell in the data grid. The Row Details dialog box is displayed. For example, this is the Row Details dialog box for Alerts: About Data Grids 113

114 The Row Details dialog box displays all possible column information, whereas the data grid shows only the grid columns that are currently configured using the Show/Hide Grid Columns command. Arrows at the top of the dialog box allow you to display detail information for other rows in the data grid without leaving the Row Details dialog box: Related Topics About Data Grids (page 113) Customize the Data Grid (page 116) Copy Data-Grid Information To copy data-grid information, use the Copy command in the context menu. For example: NOTE: Only one cell at a time can be copied in the System Offender tab. To copy the data in contiguous cells, select the cells you want to copy by clicking and dragging, then right-click and select the Copy command: 114 Work With Data Grids

115 To copy the data in noncontiguous cells, hold down the Control key, and select the cells you want to copy. Then right-click, and select Copy: The cell values are loaded into the Windows clipboard, from which you can paste them into other Windows applications. Related Topics About Data Grids (page 113) Customize the Data Grid (page 116) Copy Data-Grid Information 115

116 Customize the Data Grid The columns in data grids are fully customizable: To Show or hide columns Change the order of displayed columns Do this 1. Right-click a column heading in any data grid, and select Show/Hide Grid Columns. The Show/Hide Grid Columns dialog box appears. 2. Select the columns that you want to display, and click [ OK ]. NOTE: Click [ Defaults ] at any time to restore the default column selections. Use either of these methods: In the Show/Hide Grid Columns dialog box, select a column, then click the up or down arrows to change the position of the column: Then click [ OK ]. In the data grid, click and drag the column to a new position. See Sort and Move Data Columns (page 35). Sort information in the columns See Sort and Move Data Columns (page 35). Changes you make are persisted across HPDM sessions. Related Topics About Data Grids (page 113) Search the Data Grid Select any cell in the data grid, then type the first few characters of a string that you want to search. HPDM jumps to the first occurrence of a cell within the same column that contains the search string. Use Alt + and Alt + to jump to the next or previous occurrence of the search string: Related Topics About Data Grids (page 113) 116 Work With Data Grids

117 10 Use the SQL Whiteboard About the SQL Whiteboard The SQL Whiteboard allows you to enter and execute SQL statements from within HPDM and provides execution information for each of the SQL statements. The list of SQL statements is persisted between HPDM sessions the same way that system configuration and favorites are persisted in HPDM. Currently, HPDM supports only one instance of the SQL Whiteboard. SQL statements can be parameterized by embedding parameter names surrounded by double dollar signs ($$). When the statement is executed, the SQL Whiteboard requests the values for the parameters in the statement and easily allows you to reuse recent values for those parameters. Related Topics Save and Import System Definitions (page 39) Display the SQL Whiteboard To display the SQL Whiteboard, select Tools > SQL Whiteboard. Learn About the SQL Whiteboard Panes The SQL Whiteboard contains several panes: Pane Statement List Statement Statement Details Description Displays a listing of the SQL statements that you added from the Statement pane. Allows you to enter any DML or DDL statement, including SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, GRANT, DROP, REVOKE, and so on. Displays detailed information about the execution results. About the SQL Whiteboard 117

118 Learn About the Statement List Pane The Statement List pane provides a list of SQL statements that you added in a current session or earlier sessions of the SQL Whiteboard tool. The list of SQL statements is persisted between HPDM sessions the same way that connection information and favorites are persisted. From the Statement List pane, you can: View the name and statement that was previously added in the Statement pane. Optionally, you can explicitly add a statement to the statement list without executing it, using [ Add ]. Update an existing statement in the list using [ Update ] in the Statement. Sort the statements based on the statement name or statement text. If you want to discard unwanted statements, select the check box and use [ Discard ]. You can check or uncheck statements using [ All ] or [ None ]. The buttons across the top of the Statement List pane allow you to select individual statements or select all statements to be executed: Button [ All ] [ None ] [ Discard ] Function Selects all statements in the Statement List. Deselects all statements in the Statement List. Discards selected statements (marked checked boxes). Learn About the Statement Pane The Statement pane allows you to enter any SQL command (DDL or DML) in the text box. The maximum number of characters you can enter in the text box is The maximum limit is enforced by the.net text box control. In the Statement pane, these fields define a statement: Field Name System Catalog Schema Max Rows How to use... Enter the name of the SQL statement. You can specify a name to uniquely identify the statement in the statement list. Use [ Add ] to add the statement to the statement list. Use [ Update ] to update an existing statement from the statement list. From the System drop-down box, select a system on which you want to execute the query. Select a catalog name from the Catalog drop-down box. If you do not explicitly qualify the query by specifying a 3-part ANSI name, the default catalog is the currently selected value in the drop-down box. Select a schema name from the Schema drop-down box. If you do not explicitly qualify the query by specifying a 3-part ANSI name, the default schema is the currently selected value in the drop-down box. Specifies the maximum rows that you want returned and displayed in the details. The default is 500 rows, and the maximum is Use [ Execute ] to execute the statement. The buttons across the bottom of the Statement pane allow you to test the statement and change it: Button [ Add ] [ Update ] [ Execute ] Function Allows you to add a new SQL statement or duplicate a statement to the Statement List. Allows you to update the statement. Make the required change, and then select [ Update ]. Causes the statement to be executed and shows the results in the Statement Details pane. 118 Use the SQL Whiteboard

119 Understand Parameter Prompts SQL statements can be parameterized by embedding parameter names surrounded by $$ (double dollar signs). When the statement is executed, the SQL Whiteboard prompts you for values for all parameters in that statement and easily allows you to re-use recent values for those parameters. The feature is compatible with Neoview Reports. Cut, Copy, Paste, Undo, and Redo In the Statement pane, if you right-click the text box, these options are displayed: cut, copy, paste, undo, redo, and select all. Execute Highlighted Text If you highlight text, you can execute part of a statement. Cancel a Query From the SQL Whiteboard There may be times when you want to cancel a running SQL query. It may be that you typed in the wrong query or the query is inefficient or the query is creating a performance bottle neck and needs to be killed. After a query starts executing, the SQL Whiteboard [ Execute ] button switches its state to [ Cancel ]. Pressing [ Cancel ] terminates the SQL query. NOTE: You can also cancel a query from the Workload Detail dialog box of the System Offender. See Cancel a Query From System Offender (page 108). Learn About the Statement Details Pane The Statement Details pane contains statistics and details propagated from the selected statement in the Statement List pane. This is informational and has no interactive functionality. Statistics are shown only for statements that are loaded from the Statement pane. The values in the Statement Details pane are: Tab Execution Results Execution Error Description Displays the completion of SELECT statements: Last Evaluated shows when the statement was last evaluated. Time Elapsed specifies the elapsed time in seconds. Status displays the executed statement status. The Execution Results indicate the progress of the statement execution and the number of rows fetched so far. Once the statement has completed execution, it displays the status of success or failure, processing time, and the timestamp when the query was executed. If the execution is canceled, the status reflects the same. For DML statements such as INSERT, DELETE, or UPDATE, the results show how many rows were affected if the execution is successful. For other SQL commands, the results are displayed in text form. For SELECT statements, you can use the Export options to export the results to a file, clipboard, or spreadsheet. The export options are: Data to Clipboard, Data to Browser, Data to Spreadsheet, and Data to File. The data is preserved only while the SQL Whiteboard remains open. The data is flushed when the SQL Whiteboard is closed. Shows the execution error that is displayed if a statement has an error. The exact error is returned from ODBC and SQL. Learn About the Statement Details Pane 119

120 Tab Execution Parameters Executed Statement Description Is present if the statement has parameters and shows the values chosen for the current or earlier execution. Displays the statement that was executed with the parameters (if any), replaced with their values. NOTE: The Execution Results tab employs a data grid that provides special features for displaying and manipulating tabular information. See Work With Data Grids (page 113). Related Topics Export Data (page 36) Reuse a Connection The reuse connection feature is enabled by default in the SQL Whiteboard. This means any query executed for the selected system, uses the same connection, unless explicitly closed. Use [ Close ] to explicitly close the connection. You may want to close the connection to free up system resources. The reuse connection feature allows you to execute a series of statements in a single session using the same connection. A good example is when you are using volatile tables. You create the volatile table first and then run queries on it. The volatile table is available only until the session ends. Load and Save SQL Statements to a File The SQL Whiteboard provides commands that allow you to import SQL statements from a text file into the Statement pane. You can also export SQL statements from the Statement pane into a specified text file. To import or export SQL statements, use these commands from the File menu: Command Load SQL Statement Save SQL Statement Description Reads the text of an SQL statement from an ASCII file into the Statement text box. Saves the current SQL statement text from the Statement text box to an ASCII file. Only the statement text is saved, not the statement results. To save the results, use the Data to Clipboard or Data To Spreadsheet options. Related Topics Export Data (page 36) Highlight SQL Syntax To highlight SQL syntax in the Statement pane, use the Format > Highlight Syntax menu. This highlights the SQL keywords in the SQL text. This feature can be used each time you need syntax to be highlighted. Manage the Layout of Panes The SQL Whiteboard allows you to move or resize individual panes. After you have done so, it might be necessary to reset the layout to the original default configuration. To reset the layout of the Statement, Statement List, and Statement Details panes, use the File > Reset Layout command. Once a layout suits you, you can lock the layout using the File > Lock command. To unlock, use the File > Reset Layout menu. 120 Use the SQL Whiteboard

121 To explicitly persist the layout, use the File > Save Persistence command. The layout is persisted automatically when the SQL Whiteboard exits. The next time the SQL Whiteboard is launched (either in the current instance of HPDM or in a restarted HPDM instance), the layout is restored. Related Topics Save and Import System Definitions (page 39) Manage the Layout of Panes 121

122 122

123 11 Launch the Neoview Command Interface (NCI) Learn About NCI The Neoview platform supports a client-based utility, Neoview Command Interface (NCI), which enables you to enter SQL statements interactively or from script files in its command-line interface. You can also pass an SQL statement to NCI from a Perl or Python command line or from a Perl or Python program. For more information about using NCI, see the Neoview Command Interface (NCI) Guide, or use the command-line help within NCI. The help describes the commands supported in the current operating mode of NCI. Locate the NCI Program Launch NCI The HPDM application locates the NCI program in the NCI default install location. If the NCI program is not found in the default install location, a window appears and allows you to browse for the NCI installation location. Once the NCI program is located, the location persists. If NCI becomes uninstalled for any reason, the same process is used until the NCI program is located again. You can change the location of the NCI program at any time by using the Tools > Options window. To launch NCI, select Tools > Neoview Command Interface from the HPDM main menu. The NCI interface is launched in a separate window. Upon launching NCI, the user credentials from the HPDM session are used to log on to NCI. The data source and schema name are also taken into consideration. NCI sets these values (if specified) during the auto logon process. To set auto logon properties, see Set Auto Logon Options (page 123). Log on to the Neoview system and select Tools > Neoview Command Interface, the NCI window appears with a prompt ready to execute NCI commands. If NCI is launched and you are not logged on to a system, NCI does not use auto logon. Instead, NCI launches and prompts for an IP address (which is the default behavior in NCI). Under the Tools menu, select Options. The Options window is available only from the HPDM main window. The Option window is not available for cloned windows. You can set the path for the NCI.exe and the auto logon options Set Auto Logon Options To set the NCI auto logon features, select Tools > Options from the HPDM menu. Select Neoview Command Interface in the left pane of the Options window. The Options window displays a dialog box where auto logon features can be set for NCI. Auto logon can be disabled or enabled. The NCI prompt can be set to prompt specific options. The NCI prompt can be customized: Option Auto Logon Prompt Options Custom Prompt Description Click the check box to enable NCI auto logon. Click User, Server, or Schema to include these items in the NCI prompt when auto logon is also checked. When this item is checked, you may enter a custom prompt into the text field. Learn About NCI 123

124 124

125 12 Manage Disk Space About Space Management Space Management is a new area within HPDM that enables the monitoring and display of SQL space-related data for the Neoview platform. The displayed space data includes six panels of detailed SQL-space usage statistics. Space Management allows you to display SQL space by user, by schema, by table, and by partition. It also helps you identify and react to fast-growing tables by looking at historical trends. NOTE: For this initial release, the Space Management area includes only SQL space reporting and does not provide an entire Neoview system space-management solution. Terms area Display the Space Management Area To display the Space Management area: 1. In the navigation tree pane, select a system for which you want to obtain SQL space usage information. If no system is configured, see Add a System (page 20). 2. Select the Space Management area. For more information about areas, see Select an Area (page 25). 3. Fill in the Connect / Edit System dialog box, and click Connect. For more information, see Use the Connect / Edit System Dialog Box (page 17). About Space Management 125

126 4. In the right pane, click the Monitoring tab. After successful logon to a Neoview system: Space references are verified. Last inventory information is retrieved. The Over Threshold Summary is fetched. The System Overall and System Detail panels are automatically populated. The SQL Objects and SQL Objects Detail panels are populated when you by double-click an area of the pie chart or select a row in the System Detail panel. The Partition Distribution Across Disks and Table Growth panels are populated by using either of these methods: Select and double-click a bar in the graph of the SQL Objects panel. Select and double-click a row in the SQL Objects Detail panel. NOTE: At any time, you can refresh other panels, change values in the drop-down box, or select a bar graph in the SQL Objects panel or select a row in the SQL Objects Detail panel. Related Topics See the Parts of Space Management (page 126) Understand Space Usage Statistics (page 127) See the Parts of Space Management Space Management shows SQL space usage statistics for a Neoview system, including SQL objects, partition distribution across disks, and table growth. You can monitor and display space usage as a pie chart, bar graph, data grid, timeline, or a combination. Space Management presents information in a graphic and row format. Space Management reports on a Neoview system and plots multiple metrics on different graphs. You choose which metrics 126 Manage Disk Space

127 are reported on, and then selectively view each in the graph. Space Management employs a color scheme to display each metric and its performance. Each panel in the Monitoring tab can be enlarged by clicking the box icon on the right of the heading. When the display is focused on one panel, you can no longer view information from the other panels. To return to the full system view, click the box icon again. At the top of the Monitoring tab, connection information and last inventory status are displayed. This figure shows the different parts of the Space Management interface: Related Topics About the Monitoring Tab (page 128) Understand Space Usage Statistics Space Management shows six panels of detailed SQL space usage statistics: Panel System Overall System Detail SQL Objects SQL Objects Detail Description Pie chart view of the amount of space used on the Neoview by Category, Schema, Table, or by User. Detailed grid view of the total SQL space size per schema. Bar graph view of the SQL objects within the schema (including base tables, materialized views, and indexes). Detailed grid view of the SQL objects within the schema. Understand Space Usage Statistics 127

128 Panel Partition Distribution Across Disks Table Growth Description Bar graph view of the partition distribution across all disks in the system in megabytes (MB). Timeline view of the object sizes by table and the top fastest growing tables in the system. Related Topics About the Monitoring Tab (page 128) Get Version and Build Information for Space Management Version and build information for Space Management appears in the About box. To access the About box, select the Help > About menu in HPDM. The About HP Database Manager dialog box displays the current build information about HPDM. The HPDM.exe version information and the version procedure (VPROC) information is displayed, for example: The About dialog box displays the installed components: Installed Components displays the components currently installed in this HPDM product version. Description describes the components. Click the installed component to view a brief description of the component. About the Monitoring Tab The Monitoring tab provides an SQL space snapshot of a selected Neoview system. A graphical view visually depicts the system overall, including SQL objects, partition distribution across disks, and table growth. The Monitoring tab is the first point of reference for displaying SQL space management information. The Monitoring tab shows multiple bar graphs, data grids, and a timeline that represents a total view of the SQL space usage information for a selected system: 128 Manage Disk Space

129 View the Over Threshold Summary The Over Threshold Summary bar instantly allows you to identify if any disks, tables, or partitions are reaching a specified threshold level. Only entries that meet threshold criteria are displayed. To display the Over Threshold Summary, display the Monitoring tab, and click the double arrows at the top of the Logical Space tab: The Over Threshold Summary bar allows you to configure these fields: Field or Option %Full Max Rows for Each Type Disk Category Description You can enter a percentage value and only those disks, tables, and partitions exceeding the value are displayed. Shows the maximum number of rows for disks, table, and partitions. The default value is 10 (displays a maximum of 30 rows). By default, data disks and $SYSTEM are considered. Selecting the Audit check box includes all audit disks ($MAT* and $AUD*). In the Over Threshold Summary, these fields are displayed for disks, tables, and partitions: Field Type Date Time Segment Description Specifies type as: DISK, PARTITION, or TABLE. A snapshot of the time when the space data was last collected. Displays the segment name. View the Over Threshold Summary 129

130 Field Object Name %Full %User Full Description Displays the disk name, table name, or partition name. Fetches details from a Neoview Repository view: NEO.HP_METRICS.DISK_STATS_V1.FULL_PCT. Displays the percentage of user full. Percent values are computed according to the total user space, which is always less than the total platform space. HP uses some space for swap files, scratch space, and other support functions. In the pie chart, % values are calculated using total user space as the 100% reference. This figure shows the Over Threshold Summary where you can view disks, tables, or partitions that have exceeded a specified threshold of 50%: Use [ Refresh ] to refresh the Over Threshold Summary data grid. To change the sort order of a displayed column: Click the title of the column that you want to sort in ascending or descending order. See Sort and Move Data Columns (page 35). For more information about customizing the data grid, see Customize the Data Grid (page 116). The buttons across the bottom of the notification window allow you to export data: Button [ Data to Clipboard ] [ Data to Browser ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). 130 Manage Disk Space

131 Button [ Data to Spreadsheet ] [ Data to File ] Function Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). View the System Overall The System Overall panel is a pie chart that is automatically populated and displays the amount of SQL space used on the Neoview by Category, by Schema, by Table, or by User. From the Space Management area: 1. Select a system you want to view details about. 2. Click the Monitoring tab. 3. View the System Overall panel. Click the box icon on the right of the heading to enlarge the view of the System Overall panel. When the display is focused on one panel, you can no longer view information from the other panels. To return to the full system view, click the box icon again. This figure shows a snapshot of the System Overall panel and the free space available: In the System Overall panel, you can: 1. Select a value for Type in the drop-down box. 2. Select a value for Count in the drop-down box. 3. Optionally, select the check boxes Others or Free. 4. Click [ Refresh ] to refresh the panel by re-fetching the space information for the specified type. View the System Overall 131

132 In the System Overall panel, these fields can be selected in the drop-down box: Field or Option Type Count Others Free Description Select the type of information to be retrieved. The type values are: CATEGORY, SCHEMA, TABLE, or USER. (User is a role and is not associated with an LDAP user). Select the maximum number of areas to be displayed. The maximum count value is Captures the categories that do not make the top 10 (if the count is set to 10). You can select or deselect this check box. This field is optional. Captures the overall free space on the system. Objects less than 1% are listed on the top left-side. You can select or deselect this check box. This field is optional. NOTE: Percent values are computed according to the total user space. When Neoview is sold, a customer is sold x% of total physical disk space; HP needs the remaining SQL infrastructure to work well (for example, scratch space, swap space, etc.). On a Neoview C model, total user space is 66% of total physical disk space. On a Neoview E model, total user space is 64%. In the pie chart, % values are calculated using total user space as the 100% reference View the System Detail The System Detail panel is a data grid that is automatically populated and summarizes the total SQL space used for each schema. If the schema contains both partitioned and non-partitioned tables, then two rows are found in the data grid. In the System Detail panel each schema occupies a separate row in the data grid. From the Space Management area: 1. Select a system you wish to view details about. 2. Click the Monitoring tab. 3. View the System Detail panel. Click the box icon on the right of the heading to enlarge the view of the System Detail panel. When the display is focused on one area, you can no longer view information from the other areas. To return to the full system view, click on the box icon again. This figure shows a snapshot of the System Detail panel: 132 Manage Disk Space

133 To activate the System Detail panel, you can either: 1. Select a row in the data grid and click [ Refresh ] to refresh the panel by re-fetching the space information for the specified schema. 2. Double-click a row in the data grid. If you click the Filter Settings bar, you can: Select the columns to be displayed in the data grid. Select the partition types to be displayed (partition and non-partitioned). Enter the maximum number of rows to be viewed. NOTE: In the filter options, the schema setting is required. This figure shows the filter settings that you can select (by clicking on the check boxes) to be displayed in the data grid: View the System Detail 133

134 To change the sort order of a displayed column: Click the title of the column that you want to sort in ascending or descending order. See Sort and Move Data Columns (page 35). For more information on customizing the data grid, see Customize the Data Grid (page 116). In the System Detail panel, these fields are displayed: Field or Option Date Time Catalog Schema Space Type Number of Objects Schema Size %Used Description The last time space data was captured. Displays the catalog name of the schema. Displays the SQL schema name. Specifies the space type as partitoned or non-partitioned. Specifies the number of objects in the schema (objects can be base tables, materialized views, or indexes). Specifies the total size of the individual objects in the schema in megabytes (MB). Indicates the percentage of schema size versus total user space. The buttons across the bottom of the System Detail panel allow you to export data: Button [ Data to Clipboard ] [ Data to Browser ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). 134 Manage Disk Space

135 Button [ Data to Spreadsheet ] [ Data to File ] Function Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). View SQL Objects The SQL Objects panel is a bar graph view of the SQL objects in the schema. The SQL objects are viewed largest to smallest. Objects limited in size are not represented in the bar graph. The title of the bar graph represents the name of the schema. From the Space Management area: 1. Select a system you wish to view details about. 2. Click the Monitoring tab. 3. To activate the SQL Objects panel, you can either: Double-click an area of the pie chart. Double-click a row in the System Detail panel or select a row and click [ Refresh ] to refresh the panel by re-fetching the SQL objects within the schema. 4. To enlarge the view of the SQL Objects panel, click the box icon on the right of the heading. When the display is focused on one area, you can no longer view information from the other areas. To return to the full system view, click on the box icon again. 5. In the SQL Objects panel, you can: Select a value for Type in the drop-down box. Select a value for Count in the drop-down box. Click [ Refresh ] to refresh the panel by re-fetching the SQL objects in the schema. This figure shows the SQL Objects panel which displays the objects/sizes within the schema named TPCDS1000: View SQL Objects 135

136 NOTE: The name and size of the object appears whenever you place your cursor on a bar in the graph. In the SQL Objects panel, these fields can be selected in the drop-down box: Field or Option Type Count Description Specifies type as: base table (BT), materialized view (MV), index (IX), or ALL. The ALL option displays all objects. Specifies the number of objects to be displayed. View the SQL Objects Detail The SQL Objects Detail panel is a data grid of the SQL objects within a schema. In the SQL Objects Detail panel each schema occupies a separate row in the data grid. From the Space Management area: 1. Select a system you wish to view details about. 2. Click the Monitoring tab. 3. To activate the SQL Objects Detail panel, you can either: Double-click an area of the pie chart. Double-click a row in the System Detail panel or select a row and click [ Refresh ] to refresh the panel by re-fetching the SQL objects within the schema. 4. To enlarge the view of the SQL Objects Detail panel. Click the box icon on the right of the heading to enlarge the view of the SQL Objects Detail panel. When the display is focused on one panel, you can no longer view information from the other panels. To return to the full system view, click on the box icon again. 136 Manage Disk Space

137 This figure shows a view of the SQL Objects Detail panel: If you click the Filter Settings bar, you can: Select the columns to be displayed in the data grid. Enter the maximum number of rows to be viewed, default is NOTE: In the filter options, the object name is required. This figure shows the filter settings that you can select (by clicking on the check boxes) to be displayed in the data grid: View the SQL Objects Detail 137

138 To change the sort order of a displayed column: Click the title of the column that you want to sort in ascending or descending order. See Sort and Move Data Columns (page 35). For more information on customizing the data grid, see Customize the Data Grid (page 116). In the SQL Objects Detail panel, these fields are displayed: Field or Option Date Time Catalog Schema Object Type Object Name Object Name Space Row Count Object Size Number of Partitions Last Update Stats: Description The last time space data was captured. Specifies the SQL catalog name. Displays the SQL schema name. Specifies the type of SQL object. The object type values are: base table (BT), materialized view (MV), or index (IX). Specifies the SQL object name. Specifies the object name space as: CN Constraint IX Index LK Lock TA Table value object (table, view, stored procedure, SQL/MP alias) TR Trigger TT Trigger temp table The actual number of rows. This value may not be collected by the Inventory process if the option is turned OFF. Obtaining this value increases total inventory time. Specifies the object size in megabytes (MB). Specifies the number of partitions for the SQL object. No partition is 0. Displays the time and date when statistics were last updated. 138 Manage Disk Space

139 Field or Option Stats Row Count: %Full Description Number of rows from the histogram (accuracy depends on when statistics was last updated). Indicates the full size of the object. The buttons across the bottom of the SQL Objects Detail panel allow you to export data. Button [ Data to Clipboard ] [ Data to Browser ] [ Data to Spreadsheet ] [ Data to File ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). View Partition Distribution Across Disks The Partition Distribution Across Disks panel is a bar graph view of the partition distribution across all disks in megabytes (MB). The title of the bar graph represents the name of the table. Partition distribution across disks identifies skew (partitions of different sizes) which may indicate a problem with table partitioning and slow down performance. From the Space Management area: 1. Select a system you wish to view details about. 2. Click the Monitoring tab. 3. To activate the Partition Distribution Across Disks panel, you can either: Double-click a bar in the graph of the SQL Objects panel Double-click a row in the SQL Objects Detail panel or select a row and click [ Refresh ] to refresh the panel by re-fetching the SQL objects within the schema. 4. To enlarge the view of the View Partition Distribution Across Disks panel, click the box icon on the right of the heading. When the display is focused on one panel, you can no longer view information from the other panels. To return to the full system view, click on the box icon again. NOTE: At any time, you can refresh other panels, change values in the drop-down box, or select a bar graph in the SQL Objects panel or select a row in the SQL Objects Detail panel. This figure shows the View Partition Distribution Across Disks panel and displays the partition sizes for the disks in the table named STORE_SALES: View Partition Distribution Across Disks 139

140 In the Partition Distribution Across Disks panel, you can: 1. Select a value for Count in the drop-down box. 2. Select a value for Delta from AVG in the drop-down box. 3. Click [ Refresh ] to refresh the panel by re-fetching the partition distribution. In the Partition Distribution Across Disks panel, these fields can be selected in the drop-down box: Field or Option Count Delta from AVG Description Specifies the maximum number of partitions displayed. Specifies the percent (%) difference compared to the average partitions size (delta can represent above or below the average size). The bar graph color communicates an acceptable range for partition size: Color Red Green Description Indicates the partition size is higher or lower than the average partition size (for more than the Delta % specified). Indicates the partition size is within an acceptable range (for the Delta % specified). View Table Growth The Table Growth panel shows a graphical view of the object sizes by table and the top fastest growing tables. The title of the bar graph represents the name of the table. You can select a date range for the graph. Data is retrieved from the space historical view. From the Space Management area: 1. Select a system you wish to view details about. 2. Click the Monitoring tab. 140 Manage Disk Space

141 3. To activate the Table Growth panel, you can either: Double-click a bar in the graph of the SQL Objects panel Double-click a row in the SQL Objects Detail panel 4. To enlarge the view of the Table Growth panel, click the box icon on the right of the heading. When the display is focused on one panel, you can no longer view information from the other panels. To return to the full system view, click on the box icon again. NOTE: At any time, you can refresh other panels, change values in the drop-down box, or select a row in the SQL Objects Detail panel. This figure shows a snapshot of the Table Growth panel which displays the object sizes for the table named QUERY_STATS, during the last quarter: By Table Tab In the Table Growth panel, you can view growth by table or show the top fastest growing tables in the schema: By Table Tab (page 141) Top Fastest Growing Tables Tab (page 143) The By Table tab allows you to view the object sizes by table and specify the interval for which data is fetched. This figure shows a snapshot of the By Table tab which displays the object sizes for the table named T100K, during the last quarter: View Table Growth 141

142 1. Select a date range for the graph using the drop-down boxes. By default, the By Table data grid fetches table details for the last quarter. You can also select other time range options: Custom Range Last day Last week Last month Last quarter Last year 2. Click [ Refresh ] to refresh the panel by re-fetching table growth information. The bar graph color communicates table growth: Color Red Yellow Blue Description Indicates the minimum and maximum table growth. Indicates average table growth. Indicates current table growth. The buttons across the bottom of the By Table tab allow you to export data. Button [ Data to Clipboard ] [ Data to Browser ] [ Data to Spreadsheet ] [ Data to File ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). 142 Manage Disk Space

143 Top Fastest Growing Tables Tab The Top Fastest Growing Tables tab allows you to view the top fastest growing tables (in bytes per second) and specify a date interval for which data is fetched. This figure shows a snapshot of the Top Fastest Growing Tables tab which displays the object sizes for a table named T100K during a custom selected time range: 1. Select a date range for the graph using the drop-down boxes. By default, the Top Fastest Growing Tables data grid fetches table details for the last quarter. You can also select other time range options: Custom Range Last day Last week Last month Last quarter Last year 2. Click [ Refresh ] to refresh the panel by re-fetching table growth information. In the Top Fastest Growing Tables tab, these fields are displayed: Field or Option Catalog Schema Description Specifies the SQL catalog. Specifies the SQL schema. View Table Growth 143

144 Field or Option Object Name Space Object Name Start Size End Size Description Specifies the object name space as: CN Constraint IX Index LK Lock TA Table value object (table, view, stored procedure, SQL/MP alias) TR Trigger TT Trigger temp table Specifies the SQL object name. The object size corresponds to the start time (or close to the start time), in megabytes (MB). The object size corresponds to the endme (or close to the end time), in megabytes (MB). The buttons across the bottom of the Top Fastest Growing Tables tab allow you to export data. Button [ Data to Clipboard ] [ Data to Browser ] [ Data to Spreadsheet ] [ Data to File ] Function Copies the table data to the Windows clipboard. See Export Data (page 36). Opens a browser to display the data in a tabular format. See Export Data (page 36). Opens the Excel application and displays the data. See Export Data (page 36). Exports the data to a file in CSV format. See Export Data (page 36). Understand Historical Space Data Historical tables contain aggregated rows. Historical space data is based on an In-Place Data Aging algorithm: History grows over time, but remains in the same table. Displays more granularity when the selected period is closer to present time and displays less granularity when the selected period is further away from present time. Displays less granularity for older tables. Aggregated records retain the average, maximum, minimum, and current. You can specify the period of time as follows: Hourly records are aggregated into a daily record Daily records are aggregated into a weekly record Month daily records are aggregated into a monthly record Month records are aggregated into a quarterly record Quarterly records are aggregated into a yearly record Yearly records are retained indefinitely About the Configuration Tab The Configuration tab allows you to select specific configuration criteria for a system. The Configuration tab includes the: General tab Advanced tab This figure shows the Configuration tab: 144 Manage Disk Space

145 About the General Tab The General tab includes group: Inventory Control (page 145) Inventory Process Detail Status (page 147) Inventory Control The Inventory Control group allows you to define the inventory criteria to be displayed: Field or Option EXCLUDE percent sign (%) Description Use the EXCLUDE check box to exclude full inventory of a catalog, schema, or object in the inventory criteria. Deselecting the EXCLUDE check box allows full inventory of that object to be displayed. If you specifiy a catalog name, schema name, or object name the inventory is limited to those objects. Specifies all objects are displayed. In the Inventory Commands group, these buttons can be selected: Field or Option [ Start ] [ Pause ] Description Starts an inventory. Pauses the inventory. About the Configuration Tab 145

146 Field or Option [ Resume ] [ Stop ] [ Status ] Description Resumes the inventory. Stops the inventory. Obtains status and displays the progress at the bottom of the screen. In the Others area, you can configure these settings: Field or Option Space Reference Settings Inventory Stats Refresh If objects are reaching the specified threshold, automatically show the notification window Description Displays a window that specifies the locations of the space references. These references are verified at startup after log on. If any reference settings are not valid, a dialog box displays a warning message, but the Space client continues to execute. If any reference is incorrect, multiple SQL errors could be generated upon refresh. See Space Reference Settings (page 146). NOTE: Space reference settings can change the location for space tables or views, but these settings should not be changed by customers. Controls the refresh interval for the Last Inventory information displayed at the top of the screen. You can select or deselect this option. Displays the Over Threshold dialog automatically if thresholds are reached. You can select or deselect this option. See View the Over Threshold Summary (page 129). Space Reference Settings Space reference settings specifies the location of the space references and allows you to point to alternate space table and views. This figure shows the Space Reference Settings dialog box: 146 Manage Disk Space

147 The references are verified upon startup after initial logon and also verified each time you switch to another already connected system. If any of the references specified cannot be found, a dialog box displays a warning, but the Space Management client continues to run. If tables are missing, you run into multiple SQL errors upon refresh of the schema. In the Space Reference Settings dialog box, these fields are displayed: Category Table View SPJ Field or Option SQL System Registry SQL Snapshot Period SQL Class Rule SQL Status SQL Space SQL Space History Disk Status SPJ Name Description Defines space parameters in terms of user space and disk capacity. Controls data aging and aggregation (historical data). Defines categories of space data. Contains inventory status. Last inventory space data. Historical space data. Repository Disk View (used for %full). SPJ controls inventory (Start, Status, and so on). Inventory Process Detail Status The Inventory Process Detail Status area displays detailed status of the inventory process. About the Advanced Tab The Advanced tab includes these groups: Inventory Options (page 148) Update Space Reference Tables (page 148) This figure shows the Advanced tab: About the Configuration Tab 147

148 Inventory Options In the Inventory Options group, these options can be selected in the drop-down box: Field or Option Process Count Config Rate Description Number of parallel processes used for inventory. An internal pacing value keeping inventory from using too many system resources. Update Space Reference Tables In the Update Space Reference Tables group, these tabs can be selected: Tab Snapshot Periods Table Classification Rule Description Exposes the table that controls space data aging and aggregation. If you change the values, you need to restart the space aging component on a Neoview platform for the changes to be in effect. NOTE: Unless specifically recommended by HP support, these values should not be changed. Exposes the table that controls categorization of space information. If you change the values, you need to restart the space provider component on a Neoview platform for the changes to be in effect. Snapshot Periods Table Tab This figure displays the Snapshot Periods Table tab: Classification Rule Table Tab This figure displays the Classification Rule Table tab: 148 Manage Disk Space

149 About Space Management Tracing Options The Space Management Options dialog box shows tracing controls for Space Management. These tracing controls are for HP support use only. About Space Management Tracing Options 149