HP Neoview Performance Analysis Tools

Transcription

1 HP Neoview Performance Analysis Tools HP Part Number: Published: September 2009 Edition: HP Neoview Release 2.4 Service Pack 1

2 Copyright 2009 Hewlett-Packard Development Company, L.P.

3 Table of Contents Learn About This Document...7 Publishing History...7 New and Changed Information in This Edition...7 Intended Audience...8 Related Documentation...8 Neoview Customer Library...8 Resources on the Web...9 Send Feedback to HP Install and Start the HP Neoview Performance Analysis Tools...11 What are the HP Neoview Performance Analysis Tools?...11 Install the Neoview Performance Analysis Tools...13 Uninstall the Neoview Performance Analysis Tools...13 Start the Neoview Performance Analyzer...13 Start the Neoview Query Viewer...14 Start the Neoview Query Workbench...14 Execute Queries in Neoview Command Interface...14 Exit Any Neoview Performance Analysis Tool Use the Workspace...17 Neoview Performance Analyzer Workspace...17 What is a Workspace?...17 Content Area of the Neoview Performance Analyzer Workspace...17 The Neoview Pane...18 The Workspace Toolbox...18 The Live View Pane...18 The Triage Space Pane...18 The Query Workbench Pane...18 Create a New Workspace...18 Start a Workspace...18 Define the Layout for the Workspace...19 Save a Workspace Layout...19 Close a Workspace...19 Open a Workspace...19 The Workspace At a Glance...19 Workspace Title...19 Menu Bar Commands...19 Task Toolbar...20 Workspace Toolbox...20 Rename a Workspace...20 Lock a Workspace...20 Set Workspace Options...20 Add Another Workspace...21 Connect to the Neoview Platform...21 Disconnect/Reconnect to the Neoview Platform Use the Workspace Toolbox...23 The Workspace Toolbox At a Glance...23 Table of Contents 3

4 Add Tools...23 Aggregate Functions...23 System Metrics...24 Processing Node Utilization...24 Processing Node Queue Length...24 Memory Usage...24 Cache Hits...24 System I/O Activity...24 Workload Metrics...24 Timeline Controller...25 Select Time Periods From the Timeline Controller Use the Neoview Pane...27 Neoview and Customized Views...27 The Neoview Pane At a Glance...27 Select Content to Analyze...27 Adjust Time Settings...28 Delete Tools and Graphs...28 Add a Customized View...28 Rename a Customized View...28 Delete a View...28 Other Tasks on Graphs Use the Live View Pane...31 Live View Pane in NPA = Neoview Query Viewer...31 The Live View Pane At a Glance...31 Configure Live View Options...32 Customize the Live View...32 Kill Queries...32 Actions on Live View Queries...33 Notification Bubbles...33 Pause the Display...33 Load Queries from Live View to the Triage Space...33 Thresholds and Alerts...33 Client Thresholds Rule Manager...33 Threshold Rule Creation Wizard...34 Workspaces Tab...35 Conditions Tab...35 Actions Tab...36 Running Threshold Rules...36 Configuring Neoview WMS Services and Rules With Live View...36 Monitoring Queries...37 Time-Based Metrics...39 Rate-Based Metrics...40 Compile-Time Metrics...40 Run-Time Metrics...41 Miscellanous Facts...43 Rule Warnings...43 Per-Table Statistics...43 Get Query Text...44 At-A-Glance System Summary Information...44 Statement Counter Summary Information...44 Service Counters Summary Information Table of Contents

5 Platform Status Counters Information...45 Statement and Service Counter Details...46 Neoview WMS Services Configuration...46 Services Details Log File...47 Neoview WMS Configuration...48 WMS Configuration Dialog...48 View or Alter the WMS System Configuration...48 Managing Services...49 View Summary of All Services...49 Services User Interface...49 Add a New WMS Service...50 Alter an Existing WMS Service...52 Delete a WMS Service...53 Start a WMS Service...53 Stop a WMS Service...54 Hold a WMS Service...54 Release a WMS Service...54 Managing Rules...54 View Summary of All Rules...54 Rules Summary Interface...55 Add a New Rule...56 Managing Admin Roles...62 View Summary of All Admin Roles...62 Save/Export WMS Configuration...63 Character Set Support Use the Triage Space Pane...65 The Triage Space Pane At a Glance...65 Triage Space Settings...66 Switching Repositories...66 Query Candlestick Graph...67 Query Candlestick Graph Right-Click Menu...67 Triage Space Button Panel...68 Filter the Queries...68 Triage Space Data Grid...70 Triage Space Data Grid Right-Click Menu...70 Triage Space Query Details...70 Triage Space Statement Counters...73 Load Queries from the Triage Space to Query Workbench Use the Query Workbench...75 Query Workbench Pane in NPA = Neoview Query Workbench...75 The Query Workbench At a Glance...75 Query Workbench Settings...75 Query List...76 Difference Between Checked or Selected Queries...76 SQL Text...77 Execute or Explain the Selected Query...77 Enter a New Query...77 Schema Drop Down...77 Maximum Rows Fetched...77 Rename the Query...78 Statistics...78 Table of Contents 5

6 Query Workbench Query Details...78 Explain Plan...78 Operator Groups...79 Analyze the Explain Plan Through the Grid...80 About the ESP_EXCHANGE and HYBRID_HASH_JOIN Operators...80 Process Boundaries...80 Process Architecture For a Query...80 Plan Summary and Operator Details...81 Execute Output Tips for Query Plan Performance Improvements...83 Determine the Base Table Access Strategy...83 When to Change the Default Aggregate Function...83 Improve File Scan Performance...83 Improve Index Scan Performance...84 Significance of Hash Key Columns...84 Significance of Primary Key Columns Keyboard Shortcuts...87 General Shortcuts...87 Menu Shortcuts...87 Workspace Shortcuts...87 View Shortcuts...87 Triage Space Shortcuts...87 Glossary...89 Index Table of Contents

7 Learn About This Document This guide describes how to use the Neoview Performance Analysis Tools to monitor and analyze queries. Publishing History This guide supports HP Neoview Release 2.4 Service Pack 1 (SP1). The publication date and part number indicate this document s current edition: Part Number Product Version HP Neoview Release 2.4 SP1 HP Neoview Release 2.3 Publication Date September 2009 April 2008 Online Help Build Date: August 28, 2009 New and Changed Information in This Edition These are the principal changes for this edition: Added new chapter for Live View/Neoview Query Viewer and all topics within the chapter, including: Thresholds and Alerts WMS Services and Rules Added these topics: What Are the HP Neoview Performance Analysis Tools? Start the Neoview Query Viewer Start the Neoview Query Workbench Exit Any Neoview Performance Analysis Tools Execute Queries in Neoview Command Interface What is a Workspace? Start a Workspace Menu Bar Commands Content Area of the NPA Workspace Switching Repositories Adjust Time Settings Triage Space Settings Query Candlestick Right-Click Menu Triage Space Data Grid Right-Click Menu Triage Space Query Details Statement Counters Query Workbench Pane in NPA=Neoview Query Workbench Updated these topics: Install the Neoview Performance Analysis Tools Uninstall the Neoview Performance Analysis Tools Neoview Performance Analyzer Workspace Create a New Workspace Workspace Title Workload Metrics Publishing History 7

8 Added these glossary terms: Data source Menu bar Neoview platform SQL statement Intended Audience This guide is intended for users who perform database administrator tasks and have a need to monitor and analyze query activity. Related Documentation This manual is part of the HP Neoview customer library. Neoview Customer Library The manuals in the Neoview customer library are listed here for your convenience. Administration Neoview Character Sets Administrator's Guide Neoview Database Administrator s Guide Neoview Guide to Stored Procedures in Java Neoview Query Guide Neoview Security Administration Guide Neoview Transporter User Guide README files for installing Administration products 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 for Neoview security administrators, including instructions and background for user and role management, password encryption, database security, and integration with Lightweight Directory Access Protocol (LDAP) servers. Information about processes and commands for loading data into your Neoview platform or extracting data from it. 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 Performance Analyzer Online Help Help topics that describe how to use the HP Database Manager Client to connect and manage a Neoview data warehousing platform. Information about how to connect and manage the HP Database Manager for database administrators. 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 Neoview Performance Analyzer to analyze and troubleshoot query-related issues on the Neoview data warehousing platform. 8

9 Neoview Reports Online Help Neoview Repository User Guide Neoview System Monitor Quick Start Neoview Workload Management Services Guide README files for installing Management products 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. Instructions for starting, using, customizing, and troubleshooting the Neoview System Monitor. Information about using Neoview Workload Management Services (WMS) to manage workload and resources on a Neoview data warehousing platform. README for the HP Database Manager (HPDM) README for HP Neoview Command Interface (NCI) README for 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 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 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 Messages Manual Neoview SQL Reference Manual README for HP Neoview Release 2.4 SP1 A hyperlinked collection of East Asian characters supported by Neoview character set functionality. Cause, effect, and recovery information for error messages. Reference information about the syntax of SQL statements, functions, and other SQL language elements supported by the Neoview database software. Information about new features and considerations for using 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. We are committed to providing documentation that meets your needs. Send any errors found, suggestions for improvement, or compliments to docsfeedback@hp.com. Resources on the Web 9

10 10 Include the document title, part number, and any comment, error found, or suggestion for improvement you have concerning this document.

11 1 Install and Start the HP Neoview Performance Analysis Tools What are the HP Neoview Performance Analysis Tools? The Neoview Performance Analysis Tools provide insight into queries running on the Neoview data warehousing platform. Prior to Neoview Release 2.3 SP3, this product was known as Neoview Performance Analyzer. In Neoview Release 2.3 SP3 and following releases, Neoview Performance Analyzer is one of three components of the Neoview Performance Analysis Tools (NPA Tools). NPA Tools contains these components: Neoview Performance Analyzer Provides graphical representation of system metrics and query metrics. Neoview Performance Analyzer enables DBAs to troubleshoot query-related issues by its use of reactive and/or retrospective analysis. The Neoview Performance Analyzer offers charting with drill-down capabilities as well as query analytics. Queries can be isolated within the graphs and reworked to improve performance. Information presented in graph and grid form can be exported into a Windows clipboard or application, such as PowerPoint, Word, or Excel. Neoview Performance Analyzer is composed of these tools: Neoview Pane Allows you to define which system metrics and workload metrics you want to display in the workspace content area. Through the use of views, you can switch between different layout types and make performance decisions on the resource usage of the system and the areas and workload that need to be investigated and optimized. For a sample screen, see The Neoview Pane At a Glance (page 27). Live View Provides live operational view of queries running on the Neoview platform same as standalone tool Neoview Query Viewer. For a sample screen, see The Live View Pane At a Glance (page 31). Triage Space Provides historical data that has been fetched from the repository. For a sample screen, see The Triage Space Pane At a Glance (page 65). Query Workbench Provides query analysis and execution capabilities same as standalone tool Neoview Query Workbench. For a sample screen, see The Query Workbench At a Glance (page 75). What are the HP Neoview Performance Analysis Tools? 11

12 Neoview Query Viewer Live operational view of queries running on the Neoview platform. Standalone product. Same as Live View in Neoview Performance Analyzer. Neoview Query Workbench Query plan analysis and execution tool. Standalone product. Same as Query Workbench in Neoview Performance Analyzer. Because the functionality for the Live View pane in the Neoview Performance Analyzer product is the mostly the same (with minor differences) as the standalone tool Neoview Query Viewer, all functionality for both tools is described in this document as Live View and differences are noted. Similarly, the Query Workbench pane in NPA is mostly the same as the standalone tool Neoview Query Workbench. Functionality for both tools is described in this document as Query Workbench. 12 Install and Start the HP Neoview Performance Analysis Tools

13 Install the Neoview Performance Analysis Tools The HP Neoview Performance Analysis Tools are installed with a Windows installer. You can find the installer by searching for HP Neoview Performance Analysis Tools on the HP Software Depot web site. See Resources on the Web. NPA Tools has these installation requirements: Requirement Computer Display resolution Memory Disk space Operating system HP Neoview release ODBC Additional 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 or higher Neoview Release 2.4 SP1 Neoview Client version 2.3 or higher Microsoft.NET Framework 2.0 HP recommends that you install all NPA Tools. Uninstall the Neoview Performance Analysis Tools After NPA Tools are installed, uninstall them by using the Uninstall feature in the Start>Programs>Neoview Performance Analysis Tools folder or use the Control Panel, Add and Remove Programs feature. Note these considerations for uninstalling: You do not need to uninstall the client before installing a new client application. The client is uninstalled automatically as part of a new client installation. Uninstalling does not remove customized files, DSN information, or log files. If you uninstall from the Start menu, the NPA Tools are removed automatically. Start the Neoview Performance Analyzer To start the Neoview Performance Analyzer, double-click the Neoview Performance Analyzer icon on your desktop or choose Start>All Programs>HP Neoview Performance Analysis Tools>Neoview Performance Analyzer. Install the Neoview Performance Analysis Tools 13

14 NOTE: You must connect to the Neoview data warehousing platform through the client driver to use the full capabilities and features of the Neoview Performance Analyzer. See Connect to the Neoview Platform. Start the Neoview Query Viewer To start the Neoview Query Viewer, double-click the Neoview Query Viewer icon on your desktop or choose Start>All Programs>HP Neoview Performance Analysis Tools>Neoview Query Viewer. NOTE: You must connect to the Neoview data warehousing platform through the client driver to use the full capabilities and features of the Neoview Query Viewer. See Connect to the Neoview Platform. Start the Neoview Query Workbench To start the Neoview Query Workbench, double-click the Neoview Query Workbench icon on your desktop or choose Start>All Programs>HP Neoview Performance Analysis Tools>Neoview Query Workbench. NOTE: You must connect to the Neoview data warehousing platform through the client driver to use the full capabilities and features of the Neoview Query Workbench. See Connect to the Neoview Platform. Execute Queries in Neoview Command Interface You use the HP Neoview Command Interface (NCI) product to execute SQL statements in the Neoview platform. You use NPA Tools to monitor and analyze the same statements. For information about downloading and using NCI, see HP Neoview Command Interface Guide. 14 Install and Start the HP Neoview Performance Analysis Tools

15 NOTE: You are not required to use the same user name for connecting to NCI and NPA, however, you should log on to the same Neoview platform. Exit Any Neoview Performance Analysis Tool To exit any of the NPA Tools, close the window. NPA Tools will confirm that you want to exit. Exiting the application securely disconnects all active sessions. Exit Any Neoview Performance Analysis Tool 15

16 16

17 2 Use the Workspace Neoview Performance Analyzer Workspace The workspace is the heart of the Neoview Performance Analyzer and all activity occurs within this space. The workspace is a content area where you can design the layout of the performance tools and views. You can customize a view of the Neoview platform that you want to see. A new workspace can be created through the Workspace menu bar command. See Start a Workspace. When a new workspace is created, it is unlocked and you have the option of customizing the performance tools and metrics to display. The performance tools are described in Use the Workspace Toolbox. What is a Workspace? A workspace consists of a title bar showing the workspace name and a content area. The workspace name is composed of the Neoview platform name, the data source name, and the user name that you used to log in. The information show in the content area depends on the pane or tool selected. Content Area of the Neoview Performance Analyzer Workspace The Neoview Performance Analyzer Workspace provides the content area or work area for any graphs or tools you want to use. The content area is composed of four panes: Neoview, Live View, Triage Space, and Query Workbench: Use the Neoview pane to customize the system metrics and workload metrics you want to display. To add a tool, simply drag and drop the tool to the workspace. NOTE: To view graph information, you must turn on Fetch Timeline Information in the Tools>Options settings. See Adjust Time Settings. You can select areas of interest in the tools to drill down for information. See Use the Neoview Pane. NOTE: To select areas of a performance tool or graph, click the left mouse button in the area of the graph you want to review and drag the box around the content. Monitor queries currently running on the Neoview platform (or recently completed) with information from the Live View pane. Live View gives you a point-in-time display and provides settings that allow you to set WMS services and rules. See Use the Live View Pane. After you select queries in the performance tools in the Neoview pane, review the query information in the Triage Space pane. The Triage Space allows you to focus on certain characteristics of the queries and hide queries. You select a query or multiple queries in the Triage Space that you want to review in the Query Workbench. See Use the Triage Space Pane. View the SQL, work on one or more queries, generate explain plans, and check for potential improvements to performance for single and multiple queries in the Query Workbench Pane. See Use the Query Workbench. NOTE: You cannot rename the Neoview, Live View, Triage Space, or Query Workbench panes. Using the Workspace describes the features available for use from the Workspace. Neoview Performance Analyzer Workspace 17

18 The Neoview Pane The Neoview pane allows you to define which system metrics and workload metrics you want to display in the workspace content area. Through the use of views, you can switch between different layout types and make performance decisions on the resource usage of the system and the areas and workload that need to be investigated and optimized. Use the Neoview Pane describes the features available for use. The Workspace Toolbox The Workspace Toolbox provides the tools (most are metric graphs) for the Neoview pane views. See The Workspace Toolbox At a Glance. Current tools available: System Metrics Processing Node Utilization (Busy Percentage) Processing Node Queue Length Memory Usage Cache Hits System I/O Activity Workload Metrics Timeline Controller The Live View Pane The Live View gives you a point-in-time display. It displays queries that are currently running on the Neoview platform (or completed in the last 1 minute) with information from the Neoview Workload Management Services (WMS). Use the Live View Pane describes the features available for use. The Triage Space Pane The areas you select in the Neoview pane are the time periods in which you want to drill down (a time dimension). The Triage Space will be loaded from the Repository with all the queries running on the Neoview platform in that time period. The Triage Space isolates the queries for analysis in the query workbench. Use the Triage Space Pane describes the features available for use. The Query Workbench Pane Review and rework queries that you isolated in the Triage Space pane in the Query Workbench pane. Any rework you perform to a query is for test purposes only, so that you can analyze performance. Use the Query Workbench describes the features available for use. Create a New Workspace Neoview Performance Analyzer opens with a new workspace, called Default Workspace. You can rename this by choosing the menu bar command Workspace>Rename. To create a new workspace, choose the New icon from the toolbar or choose the menu bar command Workspace>New. To open an existing workspace, choose the Open icon from the toolbar or choose the menu bar command Workspace>Open. Start a Workspace Neoview Performance Analyzer opens with a new workspace. To create another new workspace, choose the New icon from the toolbar or choose the menu bar command Workspace>New to open a new workspace. 18 Use the Workspace

19 Define the Layout for the Workspace To define the layout of your workspace, drag in the tools you want to use from the Workspace Toolbox. The Timeline Controller appears as soon as you add any tool. For more information about the tools and workspace toolbox, see The Workspace Toolbox At a Glance. Save a Workspace Layout To save a workspace layout, choose Save from the Workspace menu bar command or click the disk icon on the toolbar. You can also choose the Save As option from the Workspace menu bar command. Workspaces are saved in workspace file format (.wks). The save function saves the layout of the workspace only; it does not retain the content of the graphs. Close a Workspace To close (or delete) a workspace, choose Close from the Workspace menu bar command or click the X in the right corner of the workspace. Neoview Performance Analyzer will verify that you want to close the workspace. Open a Workspace To open an existing, previously saved workspace, choose the Open icon from the toolbar or Open from the Workspace menu bar command to open a workspace. You can open only workspace files saved in the workspace file format (.wks). The Workspace At a Glance The workspace consists of the workspace content area with the four panes (Neoview, Live View, Triage Space, and Query Workbench). Additionally, the Neoview Performance Analyzer application elements are important for use with the workspace. These elements include: Title of the program and the name of the workspace Menu bar commands Task toolbar Workspace toolbox The right-click context menu (within a workspace) provides options for Add View, Lock Workspace, Refresh Frequency, and Copy to Clipboard. Workspace Title The workspace title displays the current connection information and appears at the top of the application in this format: WorkspaceName (SystemConnection: DataSource) User: Username (Usertype) WorkspaceName is the name assigned to the workspace. The first workspace is called Default Workspace. Subsequent workspaces that you add are numbered (New Workspace #2, New Workspace #3, and so on). You can change the name by choosing the menu bar command Workspace>Rename. SystemConnection refers to the Neoview platform to which you are connected. DataSource refers to the data source you used to connect NPA to the Neoview platform. Username is the client ID you use to connect. Usertype refers to the type of user: services or DBA. Menu Bar Commands The menu bar is the list of commands at the top of the NPA Tools windows. For Neoview Performance Analyzer, the commands are Workspace, Edit, Tools, Display, Windows, and Define the Layout for the Workspace 19

20 Task Toolbar Help. For Neoview Query Viewer and Neoview Query Workbench, the commands are Workspace, Edit, Tools, Display, and Help. The task toolbar provides quick access to standard features as well as NPA-specific tasks: Workspace Toolbox The workspace toolbox appears at the bottom of the application. Rename a Workspace By default, workspaces are numerically named (Default Workspace, New Workspace #2, and so on). You can rename the workspace to a different name by choosing the Rename option from the Workspace menu bar command. You can also rename the workspace by using the Save or Save As menu option from the Workspace menu bar command. Lock a Workspace After you have designed your workspace and added the necessary views, you can lock the workspace so that the view and the workspace design layout cannot be edited or deleted. On the task toolbar, the padlock icon is a toggle feature. Click the padlock icon to lock the workspace. You can also lock the workspace by using the Workspace menu bar command Lock option or right-click menu option for Lock Workspace. When the workspace is locked, the padlock is locked and the workspace wallpaper of dots is changed to solid white. Additionally, the workspace toolbox at the bottom of the screen is hidden. To unlock the workspace, click the padlock icon or choose Unlock Workspace from the right-click menu, or Unlock from the Workspace menu bar command. Set Workspace Options Each workspace can be set up with different options. Access the available options through the Tools>Options menu bar command. The Options dialog can be configured for an individual workspace or can be set up as default for all workspaces. To set up default options for all workspaces, set the options values before workspaces are created or opened. These values will 20 Use the Workspace

21 then be used as defaults for all subsequently created workspaces. To set up default values for individual workspaces, set the options values on an active workspace. The available options: Option Connection Settings Triage Space Settings Time Settings Query Workbench Settings Description Allow you to set the connection and command timeout settings. The values you enter should be numeric and represent the time in seconds. Described in Triage Space Settings, allow you to specify Triage Space settings such as the fetch limit. For the Triage Space and Live View, you can set the live range and hide transaction bounds and completed queries. Described in Adjust Time Settings, allow you to change time-related values for NPA. Described in Query Workbench Settings, allow you to control the Query Workbench behavior. Add Another Workspace You can add another workspace by choosing the New option. Each workspace must connect through a data source to the Neoview platform, however, you can access different data sources. To access a different data source, when you connect to ODBC, configure a new data source using the ODBC Administrator. Any new data sources that are added through the ODBC Administrator show up when you connect to the Neoview platform. Multiple workspaces can access the same data source. You can also connect to the same Neoview platform to use side-by-side views. NOTE: Only one workspace can be active at any given time. As you switch between multiple workspaces, their states may be different. The toolbar icons, menu items, options, and toolbox enabling and disabling is done automatically based on the state and options of the currently active workspace. Connect to the Neoview Platform You must connect to the Neoview platform through ODBC to use the Neoview Performance Analysis Tools. To connect to the Neoview platform, click the Connect icon on the toolbar: You can also connect to ODBC by selecting the Connect option from the Workspace menu bar command. A connection dialog allows you to select one of the client-side configured data sources or allows you to enter your connection specific properties, including name of the data source, the user id you want to use, password, host name, and port number. In the case of preconfigured client-side data sources, the default schema is set and the schema name is displayed as a read-only field. In order to run NPA, you require permissions to access the data in the Repository. The default administrative users are SERVICES and DBA roles. NPA will not allow any other users to connect to the Neoview platform. If you are not one of these roles, you will get this error: Add Another Workspace 21

22 However, you can run the Neoview Query Viewer and Neoview Query Workbench tools as those tools do not require access to the Neoview Repository. The Connect dialog provides a Test option that allows you to check your connection to the Neoview platform. After you select OK, NPA connects to the Neoview platform and the workload filter dimensions in the Triage Space. If the Fetch Timeline is enabled, NPA starts downloading information to populate and build up the Timeline Controller and the individual system and workload graphs. Additionally, when a successful connection is established to the Neoview platform, the toolbar icons for Connect, Disconnect, and Reconnect functions are enabled and change their icons according to the state. In the disconnected state, the Connect button shows a plug/connect icon. When connected, NPA shows a connected power plug: You can adjust the timeout settings for ODBC sessions through the Tools menu bar command Options selection. For information about the Triage Space settings, see Use the Triage Space Pane. For information about the Time Settings, see Neoview Performance Analyzer Workspace. The Cancel button discards changes and closes the Connect dialog. Disconnect/Reconnect to the Neoview Platform To go offline from the Neoview platform, choose the Disconnect (red X ) icon. To reconnect to the Neoview platform, choose the Reconnect icon.you might need to reconnect in cases of error or connection timeouts or failures. If you disconnect a workspace from the Neoview platform, all tools will stop updating and any queries that you executed or explain plans generated in the Query Workbench pane will complete immediately with errors. 22 Use the Workspace

23 3 Use the Workspace Toolbox The Workspace Toolbox At a Glance The workspace toolbox is a panel of tools that you can use to graphically map the state of the Neoview platform. These tools map various performance metrics either at the system or workload level. Add Tools The workspace toolbox appears at the bottom of all NPA views, including Neoview and customized views, Live View, Triage Space, and the Query Workbench. However, you use the metrics only in the Neoview and customized views. If you mouse over one of the metrics, a short tool tip appears that describes the type of tool. From left to right, these tools are available in the toolbox: System Metrics Processing Node Utilization Processing Node Queue Length Memory Usage Cache Hits System I/O Activity Workload Metrics Timeline Controller Simply drag and drop a tool from the workspace toolbox to the workspace content area. You can use as many different tools from the toolbox or the same tool multiple times per view in a workspace. Aggregate Functions Each tool dragged into the workspace from the workspace toolbox displays a graph associated with an aggregate function metric. The default aggregate function varies by the type of metric being graphed. For example, the default aggregate function for the Processing Node Utilization tool is an average function. This value is an average of the Processing Node Utilization values across all the processors (across all segments) that make up a single Neoview platform. The aggregate functions include: Average Total Minimum Maximum Standard deviation By default, each graph displays or is configured with the default aggregate function for the tool. You can change an aggregate function for a tool. Right click to pull up the right-click menu and select the aggregate function you want to apply. You may need to change the default aggregate function. For tips on improving query plan performance, see When to Change the Default Aggregate Function. The Workspace Toolbox At a Glance 23

24 System Metrics The System Metrics tool is a shortcut to select the default system metric tools in a single view. Clicking on this icon will add these tools to the workspace: Processing Node Utilization, Processing Node Queue Length, Cache Hits, and System I/O Activity. The default aggregate function for Processing Node Utilization and Processing Node Queue Length is an average function. The other metrics use a total (or sum) aggregate function by default. Processing Node Utilization The Processing Node Utilization tool provides details about the processor node busy time on the Neoview platform. The default aggregate function is an average percentage value of each individual node over 5 minute time intervals and indicates the Neoview platform utilization rate. This percentage value is an average across all the nodes (on all the segments) that make up the Neoview platform. A high percentage value indicates a high Neoview platform utilization rate and a lower percentage value indicates a lower Neoview platform utilization rate. Processing Node Queue Length The Processing Node Queue Length tool displays the number of processes that were on the ready list at particular points in time. The default aggregation function is an average function of the queue lengths of each individual node on the Neoview platform over 5 minute intervals. A higher queue length value points to more processes waiting on the query list. This might indicate Some queries (processes) are waiting for resources that are in use by another process. The load on the system is really high. While this might not be indicative of node processing busy time, it could point to a resource consumption problem on the Neoview platform. Memory Usage Cache Hits The Memory Usage tool graphs the total memory utilization across all individual processing nodes on the Neoview platform. This metric value is the sum of all the nodes over a 5-minute interval across the Neoview platform and is an indicator of the memory pressure on the system. The Cache-Hits tool graphs the total number of times a required data block was found in the disk cache for disk I/O operations. This indicator is a sum of all the cache hits that occurred on all the individual nodes of the Neoview platform over a 5-minute interval. A higher number of cache hits will result in better query performance. System I/O Activity The System I/O Activity tool graphs the total number of disk transfers (I/O operations) that occurred on the Neoview platform over 5-minute intervals. This indicator is a sum of all the disk I/O operations initiated on the Neoview platform. Workload Metrics The Workload Metrics allow you to specify a workload filter to graph metrics specific to workloads. This enables you to view the performance of a workload over a period of time and make improvements to the workload distribution as well as provide for whether a user may need to tune or optimize a particular workload. You can create as many workload graphs as you need. To graph the Workload Metrics, follow these steps: 24 Use the Workspace Toolbox

25 1. In the Triage Space, create a workload filter for the information you want to capture in the Workload Metric. The items you define in the filter determine the graphed information in the Workload Metric. For more information about filter definition, see Filter the Queries. 2. Save the filter by selecting the Save button at the top of the Workload Filters. The filter is saved in XML file format (*.xml). 3. In the Neoview pane, add a Workload Metric tool from the workspace toolbox. 4. Enter the name of the previously saved filter. 5. In the Workload Graph Configuration box, choose the information you want to graph. You can graph any of the following options: Total Number of Sessions Total Number of Unique Users Total Number of Unique Clients Total Number of Unique Applications Total Number of In-Use DataSources Total Number of Statements Total Number of SELECT Statements Total Number of UPDATE Statements Total Number of DELETE Statements Total Number of INSERT Statements Total Number of OTHER Statements Total Number of Errors Estimated Cost Disk Read Operations Lock Escalations Lock Waits Messages to Disk Message Bytes to Disk Number of Rows Accessed Number of Rows Retrieved Number of Executes Number of Rows IUD Total Number of Control Statements Timeline Controller The Timeline Controller is automatically included across the bottom of the workspace when you add any tool to the workspace. The controller shows the elapsed time for the graph (the past 24 hour time period). If you have only one tool in the workspace and delete it, you also delete the Timeline Controller. You can add the controller again by dragging it into the workspace. Select Time Periods From the Timeline Controller The Timeline Controller allows you to analyze data from a specific time interval. The default display shows the past 24 hour time period. You can drill down within that time period to specific times by clicking, holding, and moving the left mouse button within the controller. You can change the time interval displayed on the Timeline Controller by selecting Time Interval from the Tools>Options menu. Timeline Controller 25

26 26

27 4 Use the Neoview Pane Neoview and Customized Views The Neoview and customized views allow you to define which system and workload metrics you want to display in the workspace content area. Through the use of views, you can switch between different layout types and make performance decisions on the resource usage of the system and the areas and workload that need to be investigated and optimized. NOTE: To view graph information, you must turn on Fetch Timeline Information in the Tools>Options settings. See Adjust Time Settings. The Neoview Pane At a Glance Use the Neoview pane to select the information you want to analyze by adding tools to the workspace. To add a tool, drag and drop the tool to the workspace content area. The available tools: System Metrics Processing Node Utilization Processing Node Queue Length Memory Usage Cache Hits System I/O Activity Workload Metrics Timeline Controller For details about the tools, see Use the Workspace Toolbox. Select Content to Analyze In the Neoview or customized views, you have full control over the performance metrics to be displayed. You can use the workspace toolbox to drag and drop as many tools as you want onto the content area and rearrange and resize the graphs. The type of tool and the performance metric Neoview and Customized Views 27

28 that is graphed varies depending to the type of tool that you drag and drop onto the workspace content area (that is, in the Neoview pane or customized view). To rubber band or select areas of a graph, click the left mouse button in the area of the graph you want to review and drag the box around the content. Adjust Time Settings You adjust time settings through the Tools>Options>Time Settings menu bar command. These options can be changed: Time Setting Options Timeline Interval and Metric Graph Interval Fetch Timeline Information Show Times in Local Timezone Description The default timeline interval is 1 day and the metric graph interval is 1 hour. A prepopulated set of values may be selected from the drop-down box for these two time values or you can enter a time value number followed by days, hours, minutes, or seconds. NPA automatically converts this value into an internally stored form (in seconds). Both options are grayed out unless Fetch Timeline Information is selected. Toggle switch to turn on graph information in the Neoview pane of NPA. Default is off. Toggle switch to show time in local timezone. Default is on. Delete Tools and Graphs Simply click the X in the corner of the graph to delete it. If more than one graph is contained in the workspace, the timeline remains at the bottom. However, if the workspace contains one graph only, the timeline will also be deleted if you delete the graph. You can easily grab the graphs and timeline again from the workspace toolbox. Add a Customized View To add a customized view, right-click in the Neoview pane and choose the Add a View option. You can add views from the Neoview pane. Adding a view is like adding another Neoview pane, but you can name it as you like. The added views use the shared persistent query information as well as the workspace's ODBC connection to the Neoview platform. You can add as many views as you like. Drag tools from the workspace toolbox into the new view. You might choose to group certain tools in a view and name them accordingly. Rename a Customized View To rename a customized view, select the view and choose the Workspace>Rename menu bar command option. NOTE: You cannot rename the Neoview pane. Delete a View To delete a customized view, select the customized view, click the X in the upper-right corner of the view. Deleting a view is an operation that cannot be undone. 28 Use the Neoview Pane

29 NOTE: You cannot delete the Neoview pane. Other Tasks on Graphs Place the cursor in a graph and right-click. The right-click menu provides these tasks: Task Copy Save Image As Page Setup Print Show Point Values Aggregate Function Configure Workload Graph Description Copies a graph to the clipboard. Saves the current graph based on a selected format to a file. Available formats include png, jpg, gif, tif, and bmp. Sets up the graph's page layout for printing, allows you to select the paper size and source, page orientation, and margins. Provides the Print dialog so you can print the graph. Toggle switch that shows tooltips/point values when the mouse hovers over a graph data point. Provides the choice of Average, Minimum, Maximum, and Standard Deviation. Not available for Workload Metrics. For more information, see Aggregate Functions and When to Change the Default Aggregate Function. Provides options for Workload Metrics. For more information, see (page 24). Other Tasks on Graphs 29

30 30

31 5 Use the Live View Pane The Live View pane gives you a point-in-time display. It displays queries that are currently running on the system (or completed in the last 1 minute) with information from the Neoview Workload Management Services (WMS). In the Neoview Performance Analyzer, Live View is one of the four panes. The Live View pane in the Neoview Performance Analyzer provides the same information as the Neoview Query Viewer, which is a standalone tool for operational support. Live View Pane in NPA = Neoview Query Viewer The Live View pane gives you a point-in-time display. It displays queries that are currently running on the system (or completed in the last 1 minute) with information from the Neoview Workload Management Services (WMS). In the Neoview Performance Analyzer, Live View is one of the tabbed tools. The Live View pane in the Neoview Performance Analyzer provides the same information as the Neoview Query Viewer, which is a standalone tool for operational support. The Triage Space, which is another tab in the Neoview Performance Analyzer, provides historical data that has been fetched from the repository. For information about the Tools>Options settings for Live View, see Triage Space Settings. The Live View Pane At a Glance Connect to the previously configured client-side ODBC data source either by pressing the F5 key or selecting the Workspace>Connect menu bar command option. On Release 2.3 platforms, make sure that you connect to the data source that was previously configured by HP Support to use the service HP_MANAGEABILITY. Release 2.4 has a rule to automatically associate the Live View to HP_MANAGEABILITY if the user is role.dba or services (super (services, super)). When you are connected to the Neoview platform, Live View automatically downloads a list of currently running queries and refreshes itself on a pre-configured interval basis (the default is every 30 seconds for Release 2.3 platforms and higher, and five minutes for Release 2.2 platforms). Live View Pane in NPA = Neoview Query Viewer 31

32 NOTE: Neoview Query Viewer does not show the Get Session or Load Triage buttons. Configure Live View Options To configure the Live View options, use the Tools>Options menu to adjust the settings. From the Options menu, you can set the following options: This Option... Connection Timeout Command Timeout Live Range Show times in local time zone Hide Transaction Bounds Hide Completed Queries Controls Displays the number of seconds to wait for establishing a connection. Displays the number of seconds to wait when executing any command. The default value is 600 (seconds). To ensure that query management actions execute correctly, do not set this value to a value lower than 600. Controls the maximum number of data points to graph for trending statement counters and platform performance indicators. This is the amount of historical information the client keeps in memory. Controls whether times are displayed in the local client time zone or in the time zone where the Neoview platform resides. Controls whether SQL statements that are transaction boundaries (such as BEGIN/COMMIT WORK or BEGIN TRANSACTION/END TRANSACTION) are retrieved and displayed. Filters transaction boundaries. This option can also be controlled from the Live View Options right-click menu. Controls whether recently executed SQL statements (in the last minute) are also downloaded and displayed along with currently running queries as per the repository. This option can also be controlled from the Live View Options right-click menu. Customize the Live View Kill Queries To customize the list of columns you want to display, right click on the grid or on the tabular listing of queries and select the Customize Grid Columns menu item. When you select the Customize Grid Columns option, a dialog box appears that allows you to individually select or deselect the list of columns of the list of running queries that you wish to display in tabular form. Save your customized layout with the Workspace menu Save option. The layout is stored in the Neoview Performance Analysis Tools installation directory. The layout is called default.wks and is stored in this directory: C:\Program Files\Hewlett-Packard\Neoview Performance Analysis Tools. You can customize and set the refresh frequency on the right-click menu on the grid. The default refresh frequency is 5 minutes for a Release 2.2 platform and 30 seconds for a Release 2.3 or later platform (WMS-enabled). The right-click menu also shows the query view options shortcuts. This controls whether completed SQL statements or SQL statements that are transaction boundaries are downloaded and displayed in the Live View. The right-click menu allows you to select all the queries in the display (grid or tabular) and copy the details to the clipboard. You and the DBA role can kill the queries that you own. The Kill Selected Queries option allows you to kill the selected queries in the Live View. You must own the selected queries. Select one or more queries, and select the Kill Selected Queries option from the right-click menu. A dialog appears that asks you to confirm the operation. This operation is performed asynchronously, and after it completes, a notification bubble appears which provides the status of the background operation (query kill). After the operation completes, the query row changes color and the query state changes to Abnormally Terminated. Queries with the Abnormally Terminated state will age out and be removed from the display. 32 Use the Live View Pane

33 Actions on Live View Queries The Live View displays its own SQL statements in the query list. Queries, SPJ calls, and other SQL statements initiated by Live View are identified by the text Neoview Performance Analyzer or Neoview Query Viewer in the APPLICATION_ID field. Query management actions against such queries are discouraged. For example, killing a query initiated by the Live View will cause Live View to lose its ODBC connection to the Neoview platform. Notification Bubbles Notification bubbles are message indicators that display the status of any asynchronous operation in Live View, such as connect, load/refresh query list, kill a query, and so on. Most operations in the viewer of queries are queued and asynchronous (run in the background), which means the client is not locked while an operation is in progress. After a background operation completes, a notification bubble appears that indicates the status of the background operation that you initiated. This is similar to how Microsoft Outlook or instant messaging clients show you new messages or status updates. The notification bubble automatically disappears after about one minute, slowly fading out. Click on the notification bubble to restore the bubble to 100% opacity. No user interaction is required to dismiss the notification, although you can dismiss the notification immediately by clicking on the x in the top right corner of the bubble. Pause the Display The Live View display refreshes at the interval specified by the Refresh Frequency setting. To pause the display so that you can examine a list of running queries for a longer time than the refresh interval allows, pause from the Neoview platform by selecting the Pause icon on the Live View toolbar. The display will show the same list of queries that was visible before you paused. Load Queries from Live View to the Triage Space To load queries from the Live View to the Triage Space for further analysis, choose the Load Triage button on the Live View toolbar. Thresholds and Alerts Live View allows you to create rules that will cause an alert to be triggered when a query exceeds a specific threshold. The rules and alerts system operates in a manner similar to the Workload Filter in the Triage Space, but provides additional filtering, highlighting, and logging capabilities. To open the Client Threshold Rule Manager, click on the pencil icon on the task toolbar. Client Thresholds Rule Manager The Client Thresholds Rule Manager lists all thresholds that have been created or loaded since NPA was launched. The Rule Manager also allows you to create, modify, or delete thresholds from the various workspaces that are open in NPA. Actions on Live View Queries 33

34 Threshold Rule Creation Wizard To open the Threshold Rule Creation Wizard, which provides various menu items to help with the creation or modification of thresholds, click on the New Rule or Edit Rule button in the Client Threshold Rule Manager. In order for a threshold to be completed, it must be applied to one or more workspaces and it must have a name. Notice the tabbed areas directly below the screen title: Workspaces, Conditions, and Actions. 34 Use the Live View Pane

35 Workspaces Tab The Workspaces tab is the first tab displayed when the Threshold Rule Creation Wizard is opened. The Workspaces tab lists the workspaces that are open in NPA and allows you to enable this threshold for specific workspaces by checking the box to the left of the workspace name. 'All Workspaces this session' means all currently open workspaces (for NPA only as this tool only allows multiple workspaces) and any future workspaces that may be opened for this client instance. 'All Currently Open Workspaces' means workspaces that are open now in NPA and does not refer to future workspaces. Conditions Tab The Conditions tab lists the properties of a query that can be monitored for threshold violations. Add a condition to the rule by checking the box to the left of the condition s name. By default, the conditions list is populated with hard-coded values representing the conditions that are most frequently used and most likely to be published by the Neoview system. After you have connected to a system and performed a fetch or Live View operation, the columns headings in the Triage Thresholds and Alerts 35

36 Space Fetched Queries will appear under the Conditions tab. These column headings can be used as conditions in a rule. When you select properties in the Conditions tab, the Rule description (right-pane) adds the condition. You edit the Rule description by clicking on the blue link. NOTE: Checked Conditions will not operate correctly until you configure the condition s threshold value by clicking on the blue underlined text in the Rule description pane. Actions Tab The Actions tab provides a list of actions that can be taken when a condition has been violated. Selected alerts will appear under the Then: keyword in the Rule description pane. Most alerts must also be configured (also by clicking on the blue underlined text in the Rule description pane) in order to operate correctly. Running Threshold Rules After a threshold rule has been created and has been enabled for one or more workspaces, the rule will perform the indicated action when a violating query is loaded into the Triage Space from a fetch or Live View operation. Configuring Neoview WMS Services and Rules With Live View Neoview Performance Analysis Tools now include a point-and-click interface for configuring Workload Management Services (WMS) services and rules through the Live View pane. You can now use the NPA tools to: Add, alter, and delete services. See Managing Services (page 49). Add, alter, and delete rules. See Managing Rules (page 54). Associate rules with service. See Associate Rules to Services (page 61). Manage admin (administrator) roles. See Managing Admin Roles (page 62). Display all rules associated with a given service. See Alter an Existing WMS Service (page 52). Display all services associated with a given rule. See Managing Rules (page 54). Export server-side rules. See Save/Export WMS Configuration (page 63). Highlight queries that triggered a rule, and view rules that were triggered for running queries. See Rules Summary Interface (page 55). For detailed information about Neoview WMS, see the Neoview Workload Management Services Guide. 36 Use the Live View Pane

37 Monitoring Queries The right pane of the Live View provides a pop-in screen that allows each individual query's details to be viewed in a more user-friendly manner. To activate the query details pop-in screen, select a query, then click on the Query Details label on the right side of the screen. The Query Details tab is a toggle tab used to display or hide information. This screen shows the high-level Query Details information: When you click on the Monitor Query button, Live View brings up the full Query Details for the query that allows you to watch query executions. You can watch multiple running queries simultaneously. The same watch or monitoring functionality can also be achieved by double-clicking on a query in the Live View (grid containing the list of running queries). This information is only available for queries that are currently running or that completed recently (that is, queries for which Neoview WMS has information). Configuring Neoview WMS Services and Rules With Live View 37

38 The Query Details window provides a detailed view of the query and shows the query text and the metrics related to the query split into these categories: Category Time-Based Metrics (page 39) Rate-Based Metrics (page 40) Compile-Time Metrics (page 40) Run-Time Metrics (page 41) Miscellanous Facts (page 43) Rule Warnings (page 43) Per-Table Statistics (page 43) Get Query Text (page 44) Description Indicates metrics relating to the time dimension. Depending on the version of the platform you are connected to, the set of information displayed will vary. See Time-Based Metrics. Indicates the rate of consumption of resources or rate of counters since the previous time interval. This is the difference between the samples of the last 2 intervals (current previous). See Rate-Based Metrics. Provides a view of the estimates of resources required by a query. This information is static for a query (meaning it does not change while a query executes). See Compile-Time Metrics. Provides actual resources that have been currently consumed by the query or metrics that relate to the current state of the query. This information varies and changes over time (when this information is sampled or aggregated). See Run-Time Metrics. Catch-all bucket that contains other facts about this query, including user information, process information, warning levels, query type, state of the query, and so on. See Miscellanous Facts. Represents any Neoview WMS rules that were violated on the platform and contains details about the specific violations. This is indicated by the query s WARN_LEVEL (Warning Level) state going into a Low, Medium or High state. This information is only available for platforms enabled with Neoview WMS support for rules (that is, R2.4 and higher). See Rule Warnings. Statistics on a per-table basis. These are the individual statistics for each table (per-table) involved in the query. See Per-Table Statistics. Provides the ability to retrieve the query text associated with the monitored query. See Get Query Text. You can click on any of the columns in the metrics to order the layout as you prefer. Additionally, you can save a layout so that all future views are ordered in the same way. To save a layout: View the Query Details for a query. Change the layout of the Query Details screen by selecting columns (ascending or descending). Do NOT close the Query Details window. Select Workspace>Save from the menu bar command to save the layout (*.wks). You can now close the Query Details window. The next query for which you view Query Details or when you restart NPA/NQV, you will see the saved Query Details layout. The Query Details panel: 38 Use the Live View Pane

39 The title corresponds to the unique query ID for the query, as well as the username and connection information, including the data source used to connect to the Neoview platform. Time-Based Metrics Time-based metrics provide information relating to the time dimension associated with the query. Depending on the version of the platform to which you are connected, the information displayed will vary. This list provides a short description for the metrics: Metric Entry Id Start Time End Time Elapsed Time Wait Time Compilation Start Time Compilation End Time Execution Start Time Execution End Time Description Unique identifier to indicate when the query entered the Neoview platform. Indicates the time when the query was submitted into the Neoview system. Indicates the time when the query completed execution. The amount of time for which a query ran (or is running). This is the time since the start of the query until the current time for running queries or a difference of the start and end times for completed queries. Display format is hh:mm:ss (hour, minute, and seconds). Indicates how long a query waited before it started execution (time from entry into the system until the time the query actually started its execution). Time when the query compilation started (or when PREPARE for this query). Time when the query compilation ended (or when PREPARE for this query). Time when the query started running (or executing). Time when the query completed executing. Configuring Neoview WMS Services and Rules With Live View 39

40 Metric Query Elapsed Time Total Processor Time Last Interval Processor Time Total Processor Time Microseconds Last Updated Hold Time Description The amount of time used by Neoview SQL to execute the query. Total amount of processor (CPU) time utilized by the query. Display format is hh:mm:ss (hour, minute, and seconds). Total amount of processor (CPU) time utilized by the query in the last interval. Display format is hh:mm:ss (hour, minute, and seconds). This is the value from the previous refresh interval. Total amount of processor (CPU) time in microseconds utilized by the query. This information is the same as the total processor time but uses a different display format. Time when the query information was last updated in WMS queues. Indicates how long a query was in a hold state. Rate-Based Metrics Rate-based metrics indicate the rate of consumption of resources or rate of counters since the previous time interval, which is the difference between the samples of the last 2 intervals (current previous). Depending on the version of the platform to which you are connected, the information displayed will vary. This list provides a short description for the metrics: Metric Rows/Second Processor Usage/Second Delta Processor Time Delta Space Alloc MB Delta Space Used MB Delta Disk Reads Delta IUD IUD/Second Description Indicates the rate of rows being retrieved from the system. Because Neoview SQL uses data-flow architecture, this counter depends on the time and processing it requires to flow up a single row of results back to the ROOT level operator. Indicates the amount of processor (CPU) cycles the query is consuming (rate of the processor usage). Indicates the difference between the current and previous sample of the processor (CPU) utilization. Indicates the difference (current previous interval samples) in the amount of megabytes (MB) of memory allocated by all the processes involved with the query. Indicates the difference (current previous interval samples) in the amount of megabytes (MB) of memory used by all the processes involved with the query. Indicates the difference (current previous interval samples) in the number of disk reads performed by all the processes involved with the query. Indicates the difference (current previous interval samples) in the number of rows inserted, updated, or deleted. Provides the rate of the number of rows inserted, updated, or deleted per second. Compile-Time Metrics Compile-time metrics are used by Neoview SQL to generate query plans and provides a view of the estimates of resources required by a query. This information is static for the life of a query (meaning it does not change while a query executes). Depending on the version of the platform 40 Use the Live View Pane

41 to which you are connected, the information displayed will vary. This document provides a short description for the metrics: Metric Estimated Cost Cardinality Estimate CPU Time Estimate IO Time Estimate Msg Time Estimate Idle Time Estimate Estimated Total Time Rows Access Estimate Rows Usage Estimate Total Memory Estimate Resource Usage Estimate CMP Affinity Num Compilation Degree Of Parallellism CMP TXN Needed Compilation Mandatory Cross Product CMP Missing Stats CMP Num Joins CMP Full Scan On Table Compilation_High_ESAM_Max_Buffer_Usage CMP Rows Accessed Full Scan Compilation Disk Process Rows Accessed Compilation Disk Process Rows Used Description Indicates estimated cost of the query. Indicates estimated number of rows returned back from the query. Indicates estimated total amount of processor (CPU) time. Indicates estimated total amount of IO time. Indicates estimated total amount of messaging time. Indicates estimated idle time. Total time estimate. Indicates estimated total number of rows that will be accessed from the disk process by the Executor in the disk process (EID). Indicates estimated total number of rows that will be used. This is the compiler estimate of the number of rows that the Executor returns in the disk process (EID) after applying the predicates. Indicates estimated total amount of memory. Indicates estimated total resource usage. Compiler Affinity Number (indicates processors used). Degree of parallelism. Indicates whether a transaction is needed to run this query. Indicates whether there is a cross product. Indicates whether statistics are missing. Indicates the number of join operators required. Indicates whether a full scan of the table is required. This is indicative of the predicate not using a key-field to restrict the number of records you need to search. Indicates high disk processor buffer usage. Indicates the estimated number rows accessed for a full scan. Indicates an estimate of the number of rows accessed in the disk process. Indicates an estimate of the number of rows used in the disk process. Run-Time Metrics Run-time metrics indicate the actual resources that have been currently used by the query or metrics that relate to the current state of the query. This information varies and will change over time when this information is sampled or aggregated. Depending on the version of the platform to which you are connected, the information displayed will vary. This document provides a short description of the metrics: Metric Exec State Error Code Description Indicates the query s execution state. Error code value. Configuring Neoview WMS Services and Rules With Live View 41

42 Metric SQL Error Code Rows Accessed Used Rows Space Allocation GB Space Usage GB Total Space Alloc KB Total Space Used KB Stats Bytes Disk Reads Lock Waits Lock Escalations Opens Messages To Disk Message Bytes To Disk Num Rows IUD Stats Error Code Processes Created Disk Process BusyTime SQL CPU Time Process Create Time Open Time SQL Space Alloc SQL Space Used SQL Heap Alloc SQL Heap Used EID Space Alloc EID Space Used EID Heap Alloc Description Top level error code returned by the query. This is also an indicator that shows whether the query completed with warnings, errors or successfully. A positive number indicates a warning. A negative number indicates an error. Number of rows accessed by the Executor in the disk process (EID). Number of rows used. This is the number of rows returned by the Executor in the disk process (EID) after applying the predicates. In a push down plan, EID may not return all the user rows. Number of gigabytes (GB) of memory allocated. Number of gigabytes (GB) of memory used. Number of kilobytes (KB) of memory allocated. Same as the GB value but in KB units. Number of kilobytes (KB) of memory used. Same as the GB value but in KB units. Internal counter of the run-time statistics infrastructure. Indicates the number of bytes returned for statistics counts. Number of disk-read operations for accessing all the tables referenced by the query. Number of lock waits. This counter indicates the number of times this query had to wait on a conflicting lock. A value of 0 indicates no locks were encountered while executing the query. Number of lock escalations. This counter indicates the number of times row locks escalated into a file lock during the execution of the query. A value of 0 indicates no locks were escalated while executing the query. Number of opens (one per partition). This is the number of OPEN calls performed by Neoview SQL on behalf of the query. Number of messages sent to execute operations on the tables used by the query. Number of messages bytes sent to access the tables used by the query. Number of rows inserted, updated, or deleted. Internal error code returned to the stats collector from the run-time statistics (RMS) infrastructure. Number of Executor server processes created. Processor (CPU) utilization by the disk process. Processor (CPU) utilization by Neoview SQL. Amount of time to create Executor Server Processes (ESPs). Amount of time spent on opens. Total space allocation by Neoview SQL. Total space used by Neoview SQL. Total heap allocation by Neoview SQL. Total heap used by Neoview SQL. Total space allocation by the Executor in the disk process. Total space used by the Executor in the disk process. Total heap allocation by the Executor in the disk process. 42 Use the Live View Pane

43 Metric EID Heap Used Total Memory Allocated Description Total heap used by the Executor in the disk process. Total memory allocated for the query. Miscellanous Facts This catch-all bucket contains other facts about the query. Depending on the version of the platform to which you are connected, the information displayed will vary. This document provides a short description about the metrics: Metric Query ID State Role Name Application ID Client ID Service Process Info SQL Type Statement ID Statement Type Substate Warning Level Query Name Description Query identifier. State of the query. Role name associated with the query (role of the user running the query). Name of the application that initiated this query. Client machine name. The Neoview WMS service under which the query is running. Name of the master process of the query. Type of SQL statement. Statement ID of the query (part of the Query ID). Type of DML statement. The substate of the query. Warning levels triggered by this query (rules violations). Neoview WMS internal field containing the concatenated client and application information. Rule Warnings Rule warnings display any warnings of Neoview WMS rule violations. The query s WARN_LEVEL (Warning Level) state is an indicator of rule warnings that were generated. The warning levels currently supported and generated are Low, Medium, and High. This information is only available for platforms enabled with Neoview WMS support for rules (that is, R2.4 and higher). Per-Table Statistics Per-table statistics displays the runtime view of individual statistics for all tables involved in the query. This document provides a short description about the columns in the Per-Table Statistics table: Metric TableName EstAccessedRows EstUsedRows AccessedRows Description Name of the table. Compiler's estimated number of rows accessed. Compiler's estimated number of rows returned after applying the predicates. Actual number of rows accessed. Configuring Neoview WMS Services and Rules With Live View 43

44 Metric UsedRows MessageCount MessageBytes DiskIOs LockWaits LockEscalations DiskProcessBusyTime Opens OpenTime LastUpdated Description Number of rows returned after applying the predicates. In a push down plan, all the used rows may not be returned. Count of the messages. Count of the message bytes sent to access the tables in this statement. Number of disk reads for accessing the tables referenced in this statement. Displays the number of times this statement had to wait on a conflicting lock. If this field is 0, no locks were encountered during the processing of this statement. The number of times row locks escalated to a file lock during the execution of this statement. If this field is 0, no locks were escalated during this statement execution. An approximation of the total CPU time spent for executing the given query. Number of OPEN calls performed by the SQL executor on behalf of this statement. Time this process spent doing OPENs on behalf of this statement. An internal counter indicating the last time (internal form) when the per-table statistics were updated. Get Query Text Get Query Text provides the ability to retrieve the query text associated with the query being monitored (watched). This tool contains a text box which hosts the query text, a control to turn on/off the formatting of the query text and the Get Query Text button. Get Query Text retrieves the query text from the repository. At-A-Glance System Summary Information The top pane of the Live View application contains a grid that shows a live listing of the queries running on the Neoview platform. Just below this pane is a system summary information pane, which provides an at-a-glance view of statement counters, services, and platform status counters. Statement Counter Summary Information Statement Counters provide summary information about the queries that are currently displayed in Live View. These counters are indicator values of queries that are running, completed, in waiting, and in hold states in the Neoview WMS queues. This information provides a summary view of the current state of queries running and managed by Neoview WMS. The recently completed query counter information is aged out based on the default Neoview WMS settings (1 minute) that is, queries that completed within the last minute or 60 seconds will be shown in the Live View and the Completed counter value will be the corresponding value (or count of the completed queries). 44 Use the Live View Pane

45 On the upper right corner of the summary box is a magnifying glass icon, which allows you to drill down and display details about historical information of Neoview WMS queues. Clicking on this icon will bring up a detailed screen. See Statement and Service Counter Details. Service Counters Summary Information Service Counters provide summary information about the services configured on the Neoview platform (through Neoview WMS). These counters are indicator values of the total number of configured and active services and the number of services that have exceeded their threshold settings. On the upper right corner of the summary box is a magnifying glass icon, which allows you to drill down and display details about historical information of Neoview WMS services. Clicking on this icon will bring up a detailed screen. See Statement and Service Counter Details. Platform Status Counters Information Platform Status Counters provide summary information about Neoview platform performance information. The counters provide summary information about the entire Neoview platform as viewed by Neoview WMS. These counters are indicator values of the average node busy percentage, the memory usage percentage, and the total number of disk I/Os and cache hits. On the upper right corner of the summary box is a log graph icon, which allows you to drill down and display details about historical information of Neoview platform performance metrics. Clicking on this icon will bring up a detailed window that provides current Neoview platform performance metrics and historical details of four specific Neoview platform counters (Average Node Busy %, Average Memory Usage %, Average Disk IOs, and Average Cache Hits). The graphical information is also displayed in a tabular form at the bottom of the screen and can be easily copied and exported to a spreadsheet using keyboard shortcuts (Control+A to select all rows and Control+C to copy the data). Configuring Neoview WMS Services and Rules With Live View 45

46 Statement and Service Counter Details To bring up a detailed window that provides current service configuration on the Neoview platform and historical details of statement counters retrieved by this Live View instance, click on the magnifying glass icon from either the Statement Counters summary (see Statement Counter Summary Information) or the Services summary (see Service Counters Summary Information). This window also provides administrative users (described in Neoview WMS Services Configuration) the ability to configure and manage Neoview WMS and services within the Neoview WMS infrastructure. Four panes are displayed on this screen the top pane, Services Summary, has the same summary information for services along with the Node Busy and Memory Usage values from the last interval that the Live View client retrieved summary information back from the Neoview WMS infrastructure. The Service Details area is described in Neoview WMS Services Configuration. The Total Statement Counters show trends of the status of statements on the Neoview platform and is displayed in a tabular form. The Statement Counters Detail shows the tabular details of the same information and can be easily copied and exported to a spreadsheet. Neoview WMS Services Configuration To bring up a detailed window that provides current service configuration on the Neoview platform, click on the magnifying glass icon from either the Statement Counters summary or the Services summary panes (described in Statement Counter Summary Information and Service Counters Summary Information). This window also provides administrative users (described in the At-A-Glance System Summary Information) the ability to configure and manage the Neoview WMS and services within the Neoview WMS infrastructure. 46 Use the Live View Pane

47 The Service Details grid lists all the services configured in the current system. The Service Details also provides a view of the current state of all Neoview WMS services. Any service that exceeds the threshold set in the Add Service dialog is shown in red and the row containing the service is shaded. Below the grid are two buttons: Configure and Log to File. Configure enables administrative users to configure the Neoview WMS system. Log to File allows the service and WMS platform performance metrics information to be logged to a client-side file on disk. This function allows service threshold violations and service information to be logged to a file automatically. The log file is automatically rolled over every night. Services Details Log File The log file contains summary and detail information about the services. At each refresh interval (default is 30 seconds), a new block of information is logged to the log file separated by dashed lines as a separator. The first line in every block of the log file (separated by dashed lines) contains a summary. The rows following the summary contain details for each WMS service. If the service level is over the threshold, the fifth field in the row contains [*]. In the example, the service SALTEST is over the threshold set for maximum memory usage. The current memory usage is 82%, but the configured value (setting) for that service level is 70%. RFC1123 DateTime, Monitor DateTime, CPU Busy %, Memory Usage %, Threshold Violations, SERVICE_NAME, STATE, SERVICE_PRIORITY, MAX_CPU_BUSY, MAX_MEM_USAGE, MAX_ROWS_FETCHED, ACTIVE_TIME, SQL_PLAN, SQL_TEXT, EXEC_TIMEOUT, WAIT_TIMEOUT, HOLD_TIMEOUT "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , , 3 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, PRIOR5, ACTIVE, HIGH, 95, 95, 0, FROM 01:00 TO 23:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, WMA_TEST_SERVICE, ACTIVE, HIGH, 0, 0, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, PRIOR3, ACTIVE, HIGH, 0, 0, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, QS-SERVICE4, ACTIVE, HIGH, 100, 90, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, QS-SERVICE5, STOPPED, MEDIUM, 50, 0, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, A, ACTIVE, MEDIUM, 0, 0, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 5, 5, 5 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, S1, ACTIVE, MEDIUM, 0, 0, 0, FROM 00:00 TO 24:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, PRIOR4, ACTIVE, MEDIUM, 0, 0, 0, FROM 00:00 TO 24:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, PRIOR1, ACTIVE, MEDIUM, 0, 0, 0, FROM 00:00 TO 23:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , , [*], QS-SERVICE2, ACTIVE, MEDIUM, 85, 5, 0, FROM 00:00 TO 20:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, PRIOR2, ACTIVE, MEDIUM, 0, 0, 0, FROM 00:00 TO 23:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , , [*], QS-SERVICE1, HOLD, LOW, 80, 75, 0, FROM 19:00 TO 20:00, NO_PLAN, NO_TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , , [*], SALTEST, ACTIVE, LOW, 10, 10, 0, FROM 00:00 TO 24:00, PLAN, TEXT, 0, 0, 0 "Thu, 27 Aug :37:11 GMT", 8/27/2009 9:37:11 AM, , ,, QS-SERVICE3, ACTIVE, LOW, 0, 0, 0, FROM 00:00 TO 23:00, NO_PLAN, NO_TEXT, 0, 0, 0 Neoview WMS Services Configuration 47

48 Neoview WMS Configuration To make it easy to navigate to the WMS configuration user interface, a menu item and a corresponding toolbar called Configure Workload Management System is provided. This menu launches the Neoview WMS Configuration user interface: Corresponding toolbar icon: WMS Configuration Dialog This screen shows the Configure Workload Management System dialog: The left pane displays all available WMS configuration entities in a hierarchical tree structure. The entities include the WMS system configuration, WMS service configuration, rules configuration, and admin role configuration. The right pane displays the configuration details for the configuration entity that is currently selected in the tree. View or Alter the WMS System Configuration To view or alter the WMS system configuration, in the configuration tree, select the System node. The right pane displays the current WMS system configuration. 48 Use the Live View Pane

49 Click Apply to alter the system configuration. Refresh refreshes the screen by re-fetching the system configuration. Hold is enabled only if the system is in an ACTIVE state. Clicking on the Hold button places the system on HOLD. Release is enabled only if the system is in an HOLD state. Clicking on the Release button releases the system from hold and makes it ACTIVE. When you right click on the System node in the configuration tree, it displays these menus. Refresh Refreshes the WMS system configuration and the updates the right pane. Hold Places the system on Hold. Menu is enabled only if the system is ACTIVE. Release Releases the system from Hold. Menu is enabled only if the system is in a HOLD state. Stop Stops the system. Enabled only if Neoview WMS is running (active or hold state). Start Starts the system. Enabled only when Neoview WMS is stopped. Export configuration Exports the entire WMS configuration into a script as WMS commands which can be executed using a command interface. Managing Services View Summary of All Services To view the summary of all services, select the Services node in the configuration tree. The right pane displays a summary of all existing services in the system. Services User Interface You can perform actions on the services with these interface options: The Alter button and the alter service toolbar (pencil icon) are enabled if only one row is selected in the data grid. When you click on these controls, the selection on the configuration tree will move to the service selected in the summary grid. The right pane will display the Neoview WMS Services Configuration 49

50 service details and you can alter the service details. You can also double-click on a data grid row to navigate to the specific service. The Delete button and the delete service toolbar (X icon) are enabled if one or more rows are selected in the data grid and allow you to delete the selected services. In R2.4, only services that are in a stopped state are deleted. System-created services HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER cannot be deleted. If one of these system-created services is in the selected list, it will be ignored and an informational message will be displayed. The Start button and start service toolbar (right arrow icon) are enabled if one or more rows are selected in the data grid. If enabled, you can start the selected services. Only services in a stopped state are started. (R2.4 feature). For R2.3 the Start button and the start toolbar are hidden. The Stop button and the stop service toolbar (red square icon) are enabled if one or more rows are selected in the data grid. If enabled, you can stop the selected services. Only active services can be stopped. (R2.4 feature) For R2.3, the Stop button and the stop toolbar are hidden. System-created services HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER cannot be stopped. If one of these system-created services is in the selected list, it will be ignored and informational message will be displayed. The Hold button and hold service toolbar (two parallel bars icon) are enabled if one or more rows are selected in the data grid. If enabled, you can place the selected services on hold. Only services that are in an active state can be placed on hold. Services that are not in an active state are ignored and an informational message is displayed. The Release button and Release service toolbar (checkered box icon) are enabled if one or more rows are selected in the data grid. If enabled, you can release the selected services from hold. Only services that are in a hold state will be released. The Export configuration toolbar (save disk icon) exports the entire WMS configuration into a script as WMS commands which can then be executed using a command interface. Context menu (right-click menu) for Services tree node: Refresh Refreshes the tree and the services summary right pane with latest service information from the system. Add Service Launches the Add Service dialog. Hold All Services Places all services on hold (skips system-created services). Release All Services Releases all services that are on hold. Add a New WMS Service To add a new WMS service, on the Service Summary screen, click Add or the plus sign icon on the toolbar to launch the Add Service dialog. You can also right click on the Services tree node and right click and select the Add Service menu item. 50 Use the Live View Pane

51 This table describes the interface attributes: Attribute Service Name (max. 24 characters) Service Priority (URGENT, HIGH, MEDIUM-HIGH, MEDIUM, LOW-MEDIUM, LOW) Override Datasource Priority Max Processor Utilization (0-100) % Max Memory Usage (0-100) % Max Rows Fetched Active Time Execution Timeout (minutes) (0-1440) Wait Timeout (minutes) (0-1440) Hold Timeout (minutes) (0-1440) SQL Plan (True/False) Description Name of the service. Service names support Neoview character sets. Priority of the service. Overrides the service data source priority (R2.4+ feature). Hidden for older versions. Percentage of CPU utilized. Default from WMS system configuration. Percentage of memory used. Default from WMS system configuration. Maximum rows that can be returned by a query. Affects the size of the result set of queries that are workload managed. Default from WMS system configuration R2.4 feature. Hidden for R2.3 systems. Time from hh:mm to hh:mm (00:00 24:00) Maximum time interval a query can be in the executing state before the query automatically times out. Default from WMS system configuration. Hidden for R2.3 systems. Maximum time interval a query can be in the waiting state before the query automatically times out. Default from WMS system configuration. Hidden for R2.3 systems. Maximum time interval a query can be in the holding state before the query automatically times out. Default from WMS system configuration. R2.4 feature. Hidden for R2.3 systems. Indicates if the WMS server processes should temporarily store the SQL Plan. Neoview WMS Services Configuration 51

52 Attribute SQL Text (True/False) Comments (max. 256 characters) Description Indicates if the WMS server processes should temporarily store the SQL Text. Optional, free-form text you can enter to describe the service. Click Add to add the service or Cancel to cancel the operation and exit the dialog. Alter an Existing WMS Service To alter an existing WMS service, in the Service Details summary screen, click Alter or double-click on a row in the services data grid. This changes the selection on the configuration tree to the service selected in the summary grid. The right pane displays the service details that you can alter. You can expand the Services node in the tree and select the service that you want to alter. The following attributes are displayed: Attibute Service Name (max. 24 characters) Service Priority (URGENT, HIGH, MEDIUM-HIGH, MEDIUM, LOW-MEDIUM, LOW) State Override Datasource Priority Description Name of the service. This is a read-only field. Priority of the service. You cannot alter the priority of the system-created services HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER. Service priority is disabled for system-created services. Displays the current state of the system. This is a read-only field. Overrides the service data source priority (R2.4+ feature). Hidden for older versions. 52 Use the Live View Pane

53 Attibute Max Processor Utilization (0-100) % Max Memory Usage (0-100) % Max Rows Fetched Active Time Execution Timeout (minutes) (0-1440) Wait Timeout (minutes) (0-1440) Hold Timeout (minutes) (0-1440) SQL Plan (True/False) SQL Text (True/False) Comments (max. 256 characters) Associated Rules Description Percentage of CPU utilized. Default from WMS system configuration. Percentage of memory used. Default from WMS system configuration. Maximum rows that can be returned by a query. Affects the size of the result set of queries that are workload managed. Default from WMS system configuration R2.4 feature. Hidden for R2.3 systems. Time from hh:mm to hh:mm (00:00 24:00) Maximum time interval a query can be in the executing state before the query automatically times out. Default from WMS system configuration. Maximum time interval a query can be in the waiting state before the query automatically times out. Default from WMS system configuration. Maximum time interval a query can be in the holding state before the query automatically times out. Default from WMS system configuration. R2.4 feature. Hidden for R2.3 systems. Indicates if the WMS server processes should temporarily store the SQL Plan. Indicates if the WMS server processes should temporarily store the SQL Text. Optional, free-form text you can enter to describe the service. List of all available rules per rule type (connection, compilation, or execution) with the current set of associated rules indicated by the checkboxes. These checkboxes also allow you to change (add or remove) rule associations to a server. See Associate Rules to Services. After you have adjusted the attributes, click Alter to alter the service. Delete a WMS Service To delete a WMS service, on the Service Summary screen, you can delete a service using one of these methods: Select the services to delete in the data grid and click on Delete or the X icon on the toolbar. Select the services to delete in the configuration tree and right click and select the Delete menu. The Delete menu is disabled for system-created services, because they cannot be deleted. For R2.4 and beyond, the service can be deleted only if the service is in a stopped state. When you select multiple services from the grid and select the Delete option, a dialog box will popup to confirm the delete request: Choose Yes to continue with delete or No to cancel. Start a WMS Service To start a WMS service, on the Service Summary screen, select the services in the data grid and click on the Start button or the right arrow icon on the toolbar. This will start the service. Only services that are in a stopped state are started. You can also right click on a specific service in the configuration tree and select the Start menu to start the service. The Start menu is enabled only if the service is in a stopped state. Neoview WMS Services Configuration 53

54 Stop a WMS Service To stop a WMS service, on the Service Summary screen, select one or more services in the data grid and click on the Stop button or the red square icon on the toolbar. System-created services HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER cannot be stopped. A dialog box will popup to confirm the stop request: Choose Yes to continue with stop or No to cancel. You can also right click on a specific service in the configuration tree and select the Stop menu to stop the service. The Stop menu is enabled only if the service is in an active state and is not one of the system-created services HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER. Hold a WMS Service To hold a WMS service, on the Service Summary screen, select the service in the data grid and click on Hold or the blue parallel bars icon on the toolbar. This will place the service on hold. Only active services can be placed on hold. A dialog box will popup to confirm the hold request: Choose Yes to continue with the hold or No to cancel. You can also right click on a specific service in the configuration tree and select the Hold menu to place the service on hold. The Hold menu is enabled only if the service is in an active state. Release a WMS Service To release a WMS service, on the Service Summary screen, select the service in the data grid and click on Release or the red/white checkered square icon on the toolbar. This will release the service from hold. Only those services that are in a hold state are released. You can also right click on a specific service in the configuration tree and select the Release menu to release the service from hold. The Release menu is enabled only if the service is in a hold state. Managing Rules View Summary of All Rules To view the summary of all rules, select the Rules node in the configuration tree. The right pane displays a summary of all existing rules in the system. 54 Use the Live View Pane

55 Note this information about the Rules Summary: When you select the Connection Rules tree node, only the connection rules are displayed in the right summary pane. When you select the Compilation Rules tree node, only the compilation rules are displayed in the right summary pane. When you select the Execution Rules tree node, only the execution rules are displayed in the right summary pane. Rules Summary Interface You can perform these actions in the Rules Summary interface: The Add button and the add rules icon (plus sign) are always enabled and launch the Add Rule dialog that lets you add a new rule. See Add a New Rule. The Alter button and the alter rule icon (pencil) are enabled if ONLY ONE row is selected in the data grid. When you click on these controls, the selection on the configuration tree moves to the rule selected in the summary grid. The right pane displays the rule details and you can alter the rule details. You can also double click on a data grid row to navigate to the specific rule. See Alter Existing Rule. The Delete button and the delete rule icon (X) are enabled if one or more rows are selected in the data grid and let you delete the selected rules. The system-created rules cannot be deleted and if any one of these system-created rules is in the selected list, they are ignored and an informational message is displayed. See Delete a Rule. NOTE: System-generated rule names start with an HPS_ prefix. You cannot create a rule with the HPS_ prefix. It is reserved for system rules. The Associate button and the Associate icon (paper clip) are used to launch the Associate Rule dialog that lets you associate rules to services. See Associate Rules to Services. Neoview WMS Services Configuration 55

56 The Export configuration icon (save disk) exports the entire WMS configuration into a script as WMS commands which can then be executed using a command interface. See Save/Export WMS Configuration. Context menu (right click) for the Rules folder nodes. This applies to the Rules, Connection Rules, Execution Rules and Compilation Rules tree nodes. Refresh Refreshes the rules list in the tree and in the right summary pane. Add Rule Launches the Add Rule dialog. Associate Rule Launches the Associate Rule dialog Add a New Rule To add a new rule, in the Rules Summary screen, click the Add button or the plus sign icon on the toolbar. This launches the Add Rule Dialog. You can also right click on the Rules, Connection Rules, Compilation Rules, or Execution Rules tree node and right click and select the Add Rule menu item. Add a New Connection Rule To add a connection rule, on the Add Rule dialog, set the Rule Type radio button to Connection. Warn Level and Rule Action attributes are optional. You can specify them as needed. If you select the SQL_CMD action, you can specify a valid SQL statement that shall be executed when the rule is triggered. If NO-ACTION is specified for Rule Action, no action is taken. In the expression group box, select a predefined property from the drop down box and enter a value in the Value field. You can optionally select the Ignore case check box to ignore case checking on the value. Add Expr adds the expression to the expressions list. Add other expressions as needed. The expression list specifies the rule trigger conditions. To clear the expressions and start over, click Clear. The Command Preview control displays the WMS command that will be issued when Apply is clicked. On apply, the rule is added and a confirmation message is displayed. To cancel the dialog without creating the rule, click Cancel. This screen shows adding a connection rule called RCONN2: 56 Use the Live View Pane

57 When adding a rule, you can provide information in the following fields: Field Name Rule Name Warn Level Rule Action Expression: Logical Expression: Property Expression: Operator Expression: Percentage Expression: Value Expression Description Name of the rule. Up to 24 characters (can be multi-bytes). Rule names support Neoview character sets. WARN-LOW, NO-WARN (Default) SQL_CMD (SQL String can be multi-bytes), NO-ACTION AND SESSION, APPL, LOGIN, DSN Empty (disabled) Empty (disabled) SESSION-Value (Up to 24 chars) APPL-Value (Up to 30 chars and can be multi-bytes) LOGIN-Value (Up to 17 chars) DSN-Value (Up to 32 chars and can be multi-bytes) Can contain up 4 expressions Example: ADD RULE CONN RCONN2 (SESSION abc, LOGIN role.dba, DSN ICASE(mYDsN), APPL ICASE( "Neoview Performance Analyzer"), WARN-LOW, SQL_CMD "set schema "NEO.MYSCHEMA""); After a rule is added, you can view the Rule Details by clicking on the rule in the left pane: Neoview WMS Services Configuration 57

58 Add a New Compilation Rule To add a compilation rule, on the Add Rule dialog, set the Rule Type radio button to Compilation. Warn Level and Rule Action are optional attributes. You can specify as needed. If you select the EXEC action, you can specify a valid SQL statement that is or shall be executed when the rule is triggered. If NO-ACTION is specified for Rule Action, no action is taken. In the expression group box, select a predefined property from the drop-down box and then enter a value in the Value field. You can optionally select the Ignore case check box to ignore case checking on the value. The Add Expr button adds the expression to the expressions list. You can choose AND/OR logical operators for the expression. For certain predefined properties, you need to specify an operator like the = sign and then specify a value. In the screen shown next, notice that EST_TOTAL_MEMORY is the property, > is the operator, and the value is 100. If you select a % operator, you can specify a percentage value in the Percentage field. Add other expressions as needed. The expression list specifies the rule trigger conditions. To clear the expressions and start over, click the Clear button. The Command Preview control displays the WMS command that will be issued when the Apply button is clicked. On Apply, the rule is added and a confirmation message is displayed. To cancel the dialog without creating the rule, click on the Cancel button. This screen show adding a compilation rule called RCOMP3: 58 Use the Live View Pane

59 When adding a rule, you can provide information in the following fields: Field Name Rule Name Warn Level Rule Action Expression: Logical Expression: Property Expression: Operator Expression: Percentage Expression: Value Expression Description Name of the rule. Up to 24 characters (can be multi-bytes). Rule names support Neoview character sets. WARN-HIGH, WARN-MEDIUM, WARN-LOW (Default), NO-WARN REJECT, HOLD, SQL_CMD (SQL string) (SQL string can be multi-bytes), NO-ACTION AND, OR EST_TOTAL_MEMORY, EST_TOTAL_TIME, EST_CARDINALITY, EST_ACCESSED_ROWS, EST_USED_ROWS, NUM_JOINS, SCAN_SIZE, UPDATE_STATS_WARNING (Boolean Operator/Value are empty) Empty (for UPDATE_STATS_WARNING), =. >=, >, <, <=, <> Empty (disabled) Numeric Values (for UPDATE_STATS_WARNING) 1 or more expressions from the property list Example: ADD RULE COMP RCOMP3 (AND, EST_TOTAL_MEMORY > 100, UPDATE_STATS_WARNING, WARN-MEDIUM, HOLD ); Add a New Execution Rule To add an execution rule, on the Add Rule dialog, set the Rule Type radio button to Execution. Warn Level and Rule Action attributes are optional. You can specify as needed. NO-ACTION resets the CANCEL action on a execution rule. In the expression group box, select a predefined property from the drop down box and then enter a value in the Value field. You can optionally select the Ignore case checkbox to ignore Neoview WMS Services Configuration 59

60 case checking on the value. The Add Expr button adds the expression to the expressions list. You can choose AND/OR logical operators for the expression. For certain predefined properties, you need to specify an operator like the = sign and then specify a value. If you select a % operator, you can specify a percentage value in the Percentage field. In the next screen, you can see that the expression checking for the current CPU_TIME is 200% of EST_CPU_TIME. Add other expressions as needed. The expression list specifies the rule trigger conditions. To clear the expressions and start over, use the Clear button. The Command Preview control displays the WMS command that will be issued when the Apply button is clicked. On Apply, the rule is added and a confirmation message is displayed. To cancel the dialog without creating the rule, click on the Cancel button. This screen shows adding an execution rule called REXEC3: When adding a rule, you can provide information in the following fields: Field Name Rule Name Warn Level Rule Action Expression: Logical Expression: Property Expression: Operator Description Name of the rule. Up to 24 characters (can be multi-bytes). Rule names support Neoview character sets. WARN-HIGH, WARN-MEDIUM, WARN-LOW (Default), NO-WARN Empty, CANCEL, NO-ACTION AND, OR USED_ROWS, ACCESSED_ROWS, TOTAL_MEM_ALLOC, ELAPSED_TIME, CPU_TIME =. >=, >, <, <=, <>, % 60 Use the Live View Pane

61 Field Name Expression: Percentage Expression: Value Expression Description Numeric Value EST_USED_ROWS, EST_ACCESSED_ROWS, EST_TOTAL_MEMORY, EST_CPU_TIME, Numeric values 1 or more expressions from the property list Example: ADD RULE EXEC REXEC3 (AND, USED_ROWS >= EST_USED_ROWS, ELAPSED_TIME > 100, CPU_TIME 200 % EST_CPU_TIME, WARN-HIGH, CANCEL ); Alter Existing Rule To alter an existing rule, on the Rules Summary screen, select a rule in the grid and then click the Alter button or the pencil icon on the toolbar or double-click on the row in the rules grid. This changes the selection on the configuration tree to the rule selected in the summary grid. The right pane will display the rule details and you can alter the rule details. You can also expand the Connection Rules, Compilation Rules or the Execution Rules tree node in the tree and then select the rule that you want to alter. Make changes as needed and click on the Apply button. The rule name and rule type cannot be modified. Delete a Rule To delete a rule, on the Rules Summary screen, you can delete a rule by using one of these methods: Select the rules to delete in the data grid and click on the Delete button or the X icon on the toolbar. Select the rule to delete in the configuration tree and right click and select the Delete menu. The Delete menu is disabled for system-created rules, because they cannot be deleted. A confirmation message will pop up asking you to confirm the delete. Associate Rules to Services To associate a rule to a service, on the Rules group box, select the rule type Connection, Compilation, or Execution. Launch the Associated Rules dialog by right-clicking on the Rules, Connection Rules, Execution Rules, or Compilation Rules folder and choosing the Associate menu or by clicking on the Associate button or the toolbar icon in the Rules Summary Screen. The Associated Rules list box displays existing rule associations, if any, for the specific rule type. Select a rule from the list. Next, select a service from the Services list and click on the Associate button. The association should appear in the Associated Rules grid. To see a list of services associated to a specific rule, select the rule from the Rules list box and click on the Associated Services button. To view the rule information, select the rule and click on the Show Rule Info button. To see a list of rules associated to a specific service, select the service from the Services list box and click on the Associated Rules button. To view the service information, select the service and click on the Show Service button. Use the Move Up/Move Down buttons to change the order of the rule associations in the association list box. To un-associate rules, select one or more rule associations in the list box and click on the Un-Associate or Un-Associate All buttons. Neoview WMS Services Configuration 61

62 The Command Preview displays the WMS command that will be executed to apply rule associations to the system. Click on the Refresh button to reload the existing associations list from the system. Managing Admin Roles View Summary of All Admin Roles To view a summary of all admin roles, select the Admin Roles node in the configuration tree. The right pane displays a summary of all existing admin roles in the system. Admin Role Summary Interface You can perform these actions in the Admin Role Summary interface: The Add button at the bottom and the plus sign icon on the toolbar are always enabled and launch the Add Admin Role dialog that lets you add a new admin role. The Delete button at the bottom and the delete icon on the toolbar are enabled if one or more rows are selected in the data grid and allow you to delete the selected admin roles. The system-created admin roles (ROLE.DBA, SUPER.SUPER and SUPER.SERVICES) cannot be deleted and if one of these roles is in the selected list, they will be ignored and an informational message will be displayed. The Save Neoview WMS Configuration (save icon) exports the entire WMS configuration into a script as WMS commands which can be executed using a command interface. Context menu (right click) for the Admin Roles folder node: Refresh Refreshes the admin role list in the tree and in the right summary pane. Add Admin Role Launches the Add Admin Role dialog Add Admin Role To add an admin role, on the Admin Roles Summary screen, click on the Add button or plus sign icon on the toolbar. You can also right click on the Admin Roles tree node and choose the Add Admin Role menu. This launches the Add Admin Role dialog. Enter a valid role name and click the Add button to add the role name to the Admin Roles list. Delete Admin Role On the Admin Roles Summary screen, you can delete an admin role by one of these methods: 62 Use the Live View Pane

63 Select the Admin Role to delete in the data grid and click on the Delete button or the delete icon on the toolbar. Select the Admin Role to delete in the configuration tree and right click and select the Delete menu. The Delete menu is disabled for system-created admin roles, because they cannot be deleted. A confirmation dialog is displayed requesting you to confirm the delete operation. Save/Export WMS Configuration You can export the current WMS configuration and save it to a file as a series of WMS commands. This command file can then be executed using Neoview Command Interface on a different system, if you want to replicate the same WMS configuration on this new system. You can launch the Export WMS Configuration dialog by: Right click on the System tree node and select the Export Configuration menu. In the Services Summary screen, click on the save disk icon. In the Rules Summary screen, click on the save disk icon. This list describes the Export WMS Configuration actions: For the WMS system, an ALTER WMS command is generated. For each of the user-added services, an ADD SERVICE command is generated. For the system-added services (HP_DEFAULT_SERVICE, HPS_MANAGEABILITY, HPS_TRANSPORTER) an ALTER SERVICE command is generated. For each of the user-added rules, an ADD RULE command is generated. For the system-added rules (rules with HPS_ prefix) an ALTER RULE command is generated For connection-rule associations, an ALTER WMS CONN command is generated. For the compilation-rule associations for each service, an ALTER SERVICE COMP WMS command is generated. For the execution-rule associations for each service, an ALTER SERVICE EXEC WMS command is generated. Save/Export WMS Configuration 63

64 For each of the user-added admin roles, an ADD ADMIN command is generated. The system-created admin roles (SUPER.SUPER, SUPER.SERVICES, ROLE.DBA) are skipped. The Save button opens a file save dialog and allows you to save the generated command script to a file. The Done button closes the dialog. The exported configuration can now be propagated to another system by executing the exported script file using NCI. Character Set Support Both Rule and Service names support Neoview character sets. 64 Use the Live View Pane

65 6 Use the Triage Space Pane The Triage Space isolates queries you select in the Neoview view and customized views for analysis in the Query Workbench. Triage Space information comes from the Repository. The Triage Space Pane At a Glance The Triage Space pane contains several parts: Triage Space Pane Part Query Candlestick Graph Triage Space button panel Workload Filter Triage Space data grid Query Details Statement Counters Description Shows a graphical step graph view of the queries represented in the table grid. If you click on one of the bars in the top grid, the query associated with the bar is highlighted in the table grid. If you mouse over a bar, NPA shows you when the query started and how long it took. See Query Candlestick Graph. The checkboxes and buttons on the Triage Space button panel let you control certain characteristics of your display. The commands are Preview SQL, Hide, Show Hidden, Get Session, Load Workbench, Clear, and Default Size/Maximize. See the Triage Space Button Panel. Shows the properties filters. Click on the Workload Filter bar to the left side of the table grid to show the filters. See Filter the Queries. A table area that shows the queries you selected in the Neoview Pane. You can resize the table grid. Additionally, the fetch limit setting for the Triage Space is You can change the fetch limit (Triage Space Settings Fetch Limit) by choosing the Tools>Options selection. See Triage Space Data Grid. A bar on the right side of the screen that pops up a list of query details. See Triage Space Query Details. On the bottom of the screen, provides summary information about the queries that are shown in the Triage Space. See Triage Space Statement Counters (page 73). The Triage Space Pane At a Glance 65

66 Triage Space Pane Part Timeline Grid Description A timeline controller that shows the elapsed time for the graphs (the past 24 hour time period). The controller the same timeline displayed on the Neoview view and customized views. Triage Space Settings The Tools>Options>Triage Space Settings allow you to control the Triage Space and Live View behavior. The settings include: Setting Fetch Limit (Triage Space only) Live Range(Live View only) Hide Transaction Bounds (Live View only) Hide Completed Queries (Live View only) Description Allows you to specify an upper limit on the number of rows to fetch when doing any operation to load the triage space. The default fetch limit is rows. Sets the maximum number of data points to graph for trending statement counters and platform performance indicators. This value is the amount of historical information that the client keeps in memory. This option is used for Live View. Controls whether SQL statements that are transaction boundaries (BEGIN WORK/COMMIT WORK or BEGIN TRANSACTION/END TRANSACTION) are retrieved and displayed. Filters transaction boundaries. This option can also be controlled from the Live View right-click menu. Controls whether recently executed SQL statements (in the last minute) are also downloaded and displayed along with currently running queries as per the repository. This option can also be controlled from the Live View right-click menu. This screen shows the Triage Space Settings portion of the Tools>Options dialog, which allows you to adjust Triage Space and Live View settings. Switching Repositories The Neoview Performance Analyzer tool provides the ability to switch repositories on the fly through the Tools>Options screen. This allows you to view both current system repository information as well as archived information. You can also enter a custom (archived) repository schema name in the text box. The Triage Space uses the Repository. This screen shows the Repository View Settings portion of the Tools>Options dialog, which allows you to change repositories on the fly. 66 Use the Triage Space Pane

67 Query Candlestick Graph The query candlestick graph is a graphical representation of the way workloads and queries ran over a specific period of time. The list of queries in the query candlestick graph is the same that the queries in the Triage Space data grid. The candlestick graph is a visual representation of those workloads or queries. On the graph, the X-axis (horizontal) is the list of queries than ran or were running on the Neoview platform. The Y-axis (vertical) represents the start to end time. This is the time the first query was started until the time the last query was run or until the current time (if any queries show as running in the Triage Space data grid). A tall candlestick represents a long running query and side-by-side candlesticks represent concurrently running queries. The bottom line of candlesticks on the queries on the X-axis indicate the rate at which queries ran on the system. If the bottom line of candlesticks is steep, it indicates that the Neoview platform did not have a lot of workload running. A clustered set of queries indicates a lot of parallel queries running at the same time. A shorter step interleaved with candlesticks shows a well-behaved parallel workload. The candlestick graph allows you to zoom into a set of workloads, so that in a clustered set of queries, you can choose to view a zoomed-in view of that particular section of the candlestick graph. Scrollbars automatically appear when you zoom in to an image as NPA expands the graph off the screen. You can reset to the default view by clicking on the Reset button in the workload filter. If you move your mouse over the candlestick associated with a query, a tool tip gives you more information about the running query. Additionally, this action selects and positions the grid to the particular query. The corresponding row in the Triage Space data grid is highlighted in yellow. Query Candlestick Graph Right-Click Menu The right-click menu for the Query Candlestick Graph shows these options: Option Copy Save Image As Page Setup Print Show Point Values Un-Zoom Description Copy query candlestick graph to the clipboard. This is useful for copying the graph into a report. Save picture of query candlestick graph to file (*.png, *.jpeg, and so on). Set up margins and so on. Print query candlestick graph. Toggle switch that shows or hides point values on the query candlestick graph. Toggle switch that zooms or un-zooms the query candlestick graph. Query Candlestick Graph 67

68 Triage Space Button Panel The Triage Space button panel commands: Commands Preview SQL Show Hidden Hide Get Session Load Workbench Clear Default Size/Maximize Description Shows a preview (three lines) of the SQL statement for each query. Shows previously hidden queries. Hides queries that you highlight in the Triage Space data grid. You can hide multiple queries in the Triage Space data grid. If you hide queries in the Triage Space data grid, they are also hidden in the candlestick graph. Retrieves all queries that are part of the session to which the selected queries belong. When a query is selected in the Triage Space data grid and you choose Show Session, all queries associated with the session ID are loaded into the Triage Space. Loads selected queries from the Triage Space data grid to the Query Workbench. Clears the Triage Space of all queries. Maximizes the Triage Space data grid and removes the candlestick graph and timeline grid across the bottom of the screen. You can sort on multiple columns in the table grid by holding down the Ctrl key and clicking on the column name on which to sort. Filter the Queries On the left side of the table grid, notice the Workload Filter bar (this area has two arrows pointing to the table grid). Click on this area to display the Workload Filter Properties. The Workload Filter Properties contain these buttons at the top of the filter: Button Open Save Filter Fetch Reset Description Loads a saved filter (XML file format). Saves the current filter to a disk file. Filters are saved in XML format (*.xml). Filters only on current content of Triage Space data grid and updates the candlestick graph to be consistent with the queries that are filtered and showing in the data grid. Fetches data from the Neoview platform applying as many filtering criteria as possible. Applies the local filter to the data retrieved back from the Neoview platform. Resets all filters to unfiltered content (from start to end). The candlestick graph is updated to match the Triage Space data grid. You can control how the query attributes display with the icons immediately following the Workload Filter properties. The icons represent Categorized or A-Z order. Categorized order groups the filter attributes by function. A-Z order provides an alphabetical listing of the filter attributes. A description pane appears at the bottom of the Workload Filter. The description pane provides additional information on the selected filter item. The Workload Filter properties grid provides three areas for which you can filter queries: Dimensions, Facts, and Identifiers: 68 Use the Triage Space Pane

69 Dimensions: Filter Applications Clients DataSources TimePeriod Users Description Select application IDs from the list. Click on the icon at the right side of the blank field for a list of IDs. Select client IDs from the list. Click on the icon at the right side of the blank field for a list of IDs. Select data sources from the list. Click on the icon at the right side of the blank field for a list of data sources. Custom date and time field. Click the icon at the right side of the blank field for a list of options. Select user name from the list. Click on the icon at the right side of the blank field for a list of IDs. Facts: Filter Custom_Filter Elapsed_Time Error Estimated_Cost IUD_Count Row_Count Rows_Accessed State Text Type Description Custom Neoview qualifier (Neoview platform filter). The elapsed time equal to or more in the format hh:mm:ss (client-side filter). You can either filter on the elapsed time or you can filter on queries that ran with periods of time. The period of time can be specified as a relative time value or an absolute value. Indicates whether to filter statements with errors (client-side filter). Choices are Yes, No, or Any. Lower limit for estimated query cost. Filter on number of insert, update, and delete operations. Minimum number of rows retrieved. Minimum number of rows accessed. Filter based on the query state (client-side filter). Choices are Any, Completed, Error, Running, or Abnormally Terminated. A free format text box that allows you to filter on query text containing some value. You can use a wildcard character on one or more characters using the % or * symbols. For a single character wildcard, use the? or _ symbols. Indicates the SQL statement type (client-side filter). Choices are: Any, Select, Insert, Delete, Update, Call, DDL, Management, Control, or Other. Identifiers: Filter Query_ID Session_ID Description Filter based on query ID. Filter based on session ID. If you enter more than one filter criteria, the operation is translated to an AND operation. Filter the Queries 69

70 Triage Space Data Grid The Triage Space data grid is a tabular representation of the queries shown in the candlestick graph. The list of queries control how the candlestick graph is displayed. You can perform preliminary what-if analysis by using the Hide and Show buttons on the Triage Space button panel. The rows in the Triage Space data grid are color coded according to their state. Queries with errors are displayed in red, running queries are displayed in green, and completed queries are displayed in blue. The Triage Space data grid allows you to sort on the various columns in the grid. Click on the column header to sort by that column. You can also sort by multiple columns by holding down the Ctrl key as you select the columns with the left mouse button. Triage Space Data Grid Right-Click Menu The options available from the Triage Space data grid right-click menu include: Options Add View Lock Workspace Select All Copy to Clipboard Generate SQL Scripts Clear Triage Space Delete Selected Rows Hide Selected Queries Release Selected Queries Kill Selected Queries Grid Layout Customize Grid Columns Description Adds a new view to the workspace. Locks the workspace so that it cannot be edited. Select all objects in the view. Copy object to clipboard. Create SQL script from the SQL text. Clear all rows in the Triage Space. Delete selected rows. Hide selected queries. Release selected queries. Kill selected queries that you own. Controls the Triage Space data grid and query candlestick graph layout, maximizing the grid (or showing both the grid and the query candlestick graph, which is the default). Allows you to individually select or deselect the list of columns of the list of queries that you wish to display in tabular form Triage Space Query Details The right pane of the Triage Space provides a pop-in screen that allows each individual query's details to be viewed in a more user-friendly manner. To activate the Query Details pop-in screen, select a query, then click on the Query Details label on the right side of the screen. The Query Details tab is a toggle tab used to display or hide information. This screen shows the Query Details information: 70 Use the Triage Space Pane

71 The Query Details provides this information: Type: Metrics Field Estimated Cost Start Priority Disk Reads Lock Escalations Lock Waits Message Bytes to Disk Messages to Disk Rows Accessed Description Estimated cost of the query. Query's starting priority. The priority of the NDCS connectivity server process when this query started execution. Number of disk reads performed by the Data Access Manager to access all the tables associated with this query. Number of times row locks escalated to file lock on any tables associated with this query during the execution of the query. Number of times access to tables associated with this query was delayed due to conflicting lock mode. Number of bytes exchanged between the file system and the Data Access Manager in accessing all tables associated with this query. Number of messages sent to the Data Access Manager to access the table. Number of rows accessed by the query. Triage Space Query Details 71

72 Field Rows Retrieved Num Rows Iud Total Executes Segment Id Node Id Pin Entry Id Sequence Num Statement Order Description Number of rows retrieved. Total number of rows inserted, updated, or deleted in all tables accessed by the query. Total number of rows executed. Segment Id for the query. Node Id for the query. Pin for the query. Entry Id for the query. Sequence num for the query. Begin/End based on query's execution state. Type: Miscellaneous Field Session Id Query Id State User Name Application Id Client Id Datasource Sql Type Error Code Process Info Process Name Statement Status Description Session identifier. Query identifier. State of the query. Name of the user. Name of application that initiated the query. Client machine name. Name of the data source. Type of SQL statement. If an error, error code. 0 if no error. Name of master process of the query. Name of master process of the query. Status of the statement. Type: Time Field Start Time End Time Elapsed Time Query Elapsed Time Master Executor Time Entry Time Total Elapsed Time Description Indicates the time when the query was submitted into the Neoview system. Indicates the time when the query completed execution. Amount of time for which a query ran. Difference between start and end times for the query. Amount of time used by Neoview SQL to execute the query. Time spent in the master executor process of this query. Time when query entered the Neoview system. Total time it took for the query to run. 72 Use the Triage Space Pane

73 Field Total Execution Time Current System Time Description Time it took for the Neoview platform to execute the query. Current system time. Triage Space Statement Counters Statement counters appear at the bottom of the Triage Space pane and provide summary information about the queries that are shown in the Triage Space. These counters are indicator values of queries that are running, completed, or contained errors. Load Queries from the Triage Space to Query Workbench After you have selected the queries you want to analyze and they are highlighted, click on the Load Workbench button to load the queries into the Query Workbench. Triage Space Statement Counters 73

74 74

75 7 Use the Query Workbench Query Workbench Pane in NPA = Neoview Query Workbench Use the Query Workbench pane to analyze queries. Query Workbench is mostly the same as the standalone tool Neoview Query Workbench, except as noted in this document. The Query Workbench At a Glance The Query Workbench pane contains several frames: Query List shows a listing of queries you selected and loaded to the Query Workbench from the Triage Space. SQL Text shows the SQL statement for the query selected in the Query List. Statistics shows the statistics and details associated with the query selected in the Query List. Query Details shows an organized layout of an Explain plan for the current query in the SQL text frame. It contains two tabs: Explain Plan and Execute Output. All frames in the Query Workbench can be moved by selecting the frame to move it, or resize by clicking the box in the upper right corner of the frame. Query Workbench Settings The Tools>Options>Query Workbench Settings allow you to control the Query Workbench behavior. The available options include: Option Max Rows Auto Version Queries Enable Query Execution Description Indicates the maximum number of rows to fetch for an execute operation. Adds a new query to the SQL Text frame in the Query Workbench if an existing query is changed and then executed or explained. Enables or disables the Execute button in the Query Workbench. Query Workbench Pane in NPA = Neoview Query Workbench 75

76 Option Color Process Boundaries Sort Plan Grid by Levels Description Enables or disables colored process boundaries for explain plans in the Query Workbench Query Details. When not checked, removes color from process boundaries. Enables or disables the ability to sort explain plan grid rows by operator level. When not checked, sorts according to grid values. Query List The Query List frame helps you manage a set of queries. The combined items in the Query List are called a query set. The Query List contains the queries you selected in the Triage Space and loaded into the Query Workbench or queries that you loaded from any saved workbench data files. Individual queries can be selected using the associated check box for each query item and multiple query set (batch) operations can be performed on the selected query set. You can perform several actions based on these queries. Note that checked and selected queries are handled differently. See Difference Between Checked or Selected Queries. Notice the icons at the top of the Query List frame: Open (file folder icon) loads a previously saved checked query into the Query Workbench. You can only load files in WBD file format (*.wbd). Save (disk icon) saves checked queries into a file. Files are saved in WBD file format (*.wbd). Set Schema (eye dropper icon) sets the same schema for checked queries. Rename (pencil icon) lets you provide a new statement label for a selected query. Rename works only on the highlighted query. You can also select the Rename option by double-clicking on the query row in the Query List frame. The statement label is used as the name in the Query List frame. Delete ( X ) deletes checked queries. Notice the two check boxes along the bottom of the Query List frame. The behavior of Explain and Execute in the Query List differs from the SQL Text frame. In the Query List frame, these operations are performed on many queries at once (batch mode). In the SQL Text frame, these operations are performed only on the current query in the SQL Text area. When Explain is checked and Batch Run is selected, NPA provides the explain plans for multiple checked queries. The Explain plan is stored internally for fast retrieval. You can also save the stored plan to a file. When Execute is checked and Batch Run is selected, NPA executes the checked queries. The executed queries are stored internally for fast retrieval. You can also save the executed output to a file. Batch Run runs the requested operation (Explain, Execute, or both). If both Explain and Execute are checked and Batch Run is selected, NPA treats the queries as an entire session and recreates and replays the queries in the Query List sequentially from top to bottom to gather the explain plans. Treating the queries as a session is useful for subsequent queries that may depend on transient SQL objects created as part of a session. Because millions of rows might be involved, the results are discarded. Difference Between Checked or Selected Queries You select a query by clicking on the query in the Query List frame. The SQL statement for the query appears in the SQL Text frame and the statistics for the query are shown in the Statistics frame. You can get Explain output or Execute the query by choosing those tasks from the SQL Text frame. You cannot select multiple queries. Selected queries cannot be saved. You check a query or queries by clicking the check box next to the query. You can check multiple queries. When you check a query or queries, you can perform a number of tasks shown by the 76 Use the Query Workbench

77 SQL Text buttons below the Query List as described in Query List. Checked queries are stored internally for fast retrieval. You can saved checked queries. For example, if you check three queries in the Query List, the SQL statement for the first query will show in the SQL Text frame. You can view the SQL for each query by clicking on the query in the Query List. The SQL Text frame contains the SQL statement for the query selected in the Query List. In the SQL Text frame, you can: Execute or Explain the Selected Query. Enter a New Query or paste in a query from somewhere else, then execute or explain the selected query. Change the schema name with the Schema Drop Down box. Change the Maximum Rows Fetched. Rename the Query. Move to another selected query by using the up and down arrow keys. The buttons across the bottom of the SQL Text frame allow you to test the query and change it. Execute causes the query to be executed and shows the results in the Execute Output tab of the Query Details frame. Take note that the plan is not stored; if you want to save the executed output, you must check and execute it from the Query List. Update allows you to make changes to the query. Make the change, then select Update. You can save the query by checking it in the Query List and choosing Save. Add New allows you to duplicate a query or add a new query to the Query List. When you select Add New, NPA duplicates the current query in the SQL Text frame. To create a new query, either amend the query or paste in a new query. The added query shows as an entry at the bottom of the Query List. Note that the new query has the same Statement Label as the query from which it was duplicated. You can change this by double-clicking the name and typing in a new name. Explain immediately presents the query execution plan in the Explain Plan tab of the Query Details frame. Take note that the plan is not stored; if you want to save the plan, you must check the query and explain it from the Query List. Execute or Explain the Selected Query When queries are loaded into the Query Workbench from the Triage Space, the first selected query is shown in the SQL Text frame. To simply execute or explain the selected query, choose the appropriate button at the bottom of the SQL Text frame. Enter a New Query You can enter a new query or paste in a query from somewhere else in the SQL Text frame. After you enter the query, you can give it a name in the Name box above the query field. Schema Drop Down If you have unqualified queries (that is, queries without a schema name), you can select the schema associated with the query by using the drop-down Schema dialog box. Fully qualified names override the schema drop-down setting. Maximum Rows Fetched The Max Rows field provides the amount of rows allowed in the workbench. The value -1 returns all rows. SQL Text 77

78 Rename the Query Statistics You can rename the selected query in the Name box above the query field. The Statistics frame contains query statistics and details propagated from the query in the Triage Space. This frame is purely informational and has no interactive functionality. Statistics are shown only for queries that are loaded from the Triage Space. If a query is changed in the SQL Text frame and executed again, the statistics will be invalid. The fields in the Statistics frame include: Field Data Source Client ID Error Code Start Time End Time Elapsed Time Execution Time Estimated Cost Rows Accessed Rows Retrieved Rows IUD Disk Reads Messages to Disk Msg Bytes to Disk Lock Escalations Lock Waits Description Data source though which the data was collected. Client name that ran the query. SQL error code. 0 means no error. Start time for the query. End time for the query. Total time it took for the query to run. Time it took for the Neoview platform to execute the query. Estimated cost of the query. Number of rows accessed by the query. Number of rows retrieved. Total number of rows inserted, updated, or deleted in all tables accessed by the query. Number of disk reads performed by the Data Access Manager to access all the tables associated with this query. Number of messages sent to the Data Access Manager to access the table. Number of bytes exchanged between the file system and the Data Access Manager in accessing all tables associated with this query. Number of times row locks escalated to file lock on any tables associated with this query during the execution of the query. Number of times access to tables associated with this query was delayed due to conflicting lock mode. Query Workbench Query Details Explain Plan The Query Details frame contains the Explain Plan and Execute Output tabs. The Explain Plan area shows the query plan output in a tabular tree format. The Explain Plan area is divided into three sections. The left section shows the query plan in tree format. The middle section shows details about the plan in grid form. See Analyze the Explain Plan Through the Grid. The right section shows the Plan Summary and Operator Details, which includes the Cost Details and Description columns of the Explain output. Tool tips provide information throughout the query plan output. Additionally, you can get in-depth information about each operator in the query plan by right clicking on the operator and choosing Help. This points 78 Use the Query Workbench

79 you to in-depth information about the operators in the Neoview Query Guide. For information about the EXPLAIN statement, see the Neoview SQL Reference Manual. For information about improving query plans, see Tips for Query Plan Performance Improvements. Operator Groups Each operator is identified in the query tree by an icon that identifies the group type. These are the operator groups: File Scan Root Exchange Insert Split Top Partition Access Tuple ESAM Subset Group By Merge Union Default ESAM Unique Join Sort Data Mining Query Workbench Query Details 79

80 The default icon (question mark) is used for operators not represented by a group. Analyze the Explain Plan Through the Grid You can sort on the fields in the explain plan grid (middle section). Note that when you click on an operator in the query plan, the row is highlighted in the grid section. You can sort on the fields in the grid, so if you are interested in the total cost of an operator, you can sort them in ascending or descending cost. While you may find it useful to analyze information through the grid, keep in mind that after your analysis, you need to re-explain the plan again to align the operator tree and the grid contents. You can sort the query plan by the grid level or by the tree level by using the Tools>Options>Query Workbench Settings. When enabled, sorting is done through the grid level. When disabled, sorting is done through the operator tree. About the ESP_EXCHANGE and HYBRID_HASH_JOIN Operators In the Explain output, NPA provides additional information about the ESP_EXCHANGE and HYBRID_HASH_JOIN operators. The abbreviations describe the type of operation performed. ESP_EXCHANGE can show these abbreviations: BR for Broadcast partition HP for Hash partition RN for Hash partition with Random numbering HYBRID_HASH_JOIN can show these abbreviations: MP for Matching Partition NMP for Nonmatching Partition Process Boundaries Process boundaries are differentiated in query plans by color. Process boundaries are captured in the query plan in the fragment_type and fragment_id fields of the query plan. You can turn off process boundary coloring by unchecking the Color Process Boundaries setting in the Tools>Options>Query Workbench Settings. The colors are defined as follows: Master process (or root): white ESP process: varying shades of blue (up to 40 shades) Disk process (ESAM): yellow Process Architecture For a Query Several processes are required to execute a query plan. You will find it helpful to understand the processes where operators execute when you need to identify problems in queries. MXOSRVR is the database server through which NPA connects. This process is also called the master executor or root and controls the overall execution of the query. Each NPA user connection is made through a separate MXOSRVR process. MXCMP is the Neoview compiler and compiles the query and generates the query execution plan. A separate MXCMP process is dedicated to each database server process. ESP (Executor Server Process) is a helper process used for parallel execution of a query. Each query can have many ESPs with the maximum of 1 ESP per CPU per plan step. ESPs are dedicated to an active server connection and then available for reuse. If the connection is broken and another user connects to the server, the ESPs are available to the new user. Disk process Encapsulated SQL Access Manager (ESAM) is a disk process manager that manages access to data for the volume. ESAM processes are shared among all active queries and are never dedicated processes. One logical disk process is allocated per disk volume (implemented as a set of processes per disk volume). Each operator executes within a process, and some operators might execute in different processes. For example, the join operators can execute in either the master executor or ESP process. Sorts 80 Use the Query Workbench

81 can execute in the master executor or ESP processes, and groupbys can execute in the master executor, ESP, or ESAM processes. Certain scan operators always execute in the same process. For example, the scan operators, including FILE_SCAN and FILE_SCAN_UNIQUE, always execute in the ESAM process. The ROOT operator always executes in the master executor process. NPA plans only show the operators that represent the process boundaries and indicate the number of processes used or accessed. They do not show each individual process involved in executing the query. Although the NPA plan appears to show only two processes, a root process and a ESAM process, many other processes are used to execute the query plan. The plan shows the ROOT process and 15 ESAM processes. The notation 15 >1 indicates that 15 ESAM processes are used to perform the file scan operation. The first number, 15, refers to the bottom partitioning information (in this case, the file scan operation across 15 ESAM processes), and 1 refers to the root, or master executor process where the information is rolled up. Plan Summary and Operator Details When you choose Explain from either the SQL Text or Query List frames, the initial display in the right section of the Query Details is a summary of the plan. To see details about an operator, select an operator in the tree. The Operator Details, which includes Cost Details and the Description fields from the Explain output, is shown. To see the Plan Summary again, either use the shortcut (Ctrl + click) or select the query from the SQL Text or Query List frames and choose Explain again. The summary items shown in the Plan Summary are total counts of several operations. The fields in the Plan Summary: Field ESP EXCHANGES ESP PROCESSES HASH JOINS MERGE JOINS NESTED JOINS TOTAL JOINS SCANS SORTS IUDs Description Total number of ESP_EXCHANGE operators in this plan. Total number of child processes counted for this plan. Total number of hash joins in this plan. Total number of merge joins in this plan. Total number of nested joins in this plan. Total joins in this plan. Total scans in this join (includes file and index scans). Total number of sorts in this plan. Total number of inserts, updates, and deletes in this plan. Query Workbench Query Details 81