User sguidefortheviewer

Transcription

1 Tivoli Decision Support for OS/390 User sguidefortheviewer Version 1.6 SH

2

3 Tivoli Decision Support for OS/390 User sguidefortheviewer Version 1.6 SH

4 Note Before using this information and the product it supports, read the information in Notices on page 71. Fourth Edition (June 2003) This edition applies to version 1, release 6 of Tivoli Decision Support for OS/390 (product number ) and to all subsequent releases and modifications until otherwise indicated in new editions. This edition replaces SH Copyright International Business Machines Corporation 1999, All rights reserved. Note to U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.

5 Contents Figures v Preface vii Who should read this book vii What this book contains vii Publications viii Tivoli Decision Support for OS/390 Library.. viii Using LookAt to look up message explanations.. x Accessing publications online xi Ordering publications xi Accessibility xi Contacting software support xi Conventions used in this book xii Typeface conventions xii Chapter 1. Introduction Intuitive Graphical Navigation Last Generation Graphical Report Capability... 1 Graphical Query Editor Multiple Connection Management Chapter 2. Installing and Configuring the Viewer Hardware Requirements Software Requirements Downloading Install Scripts to a Workstation... 4 Downloading the Scripts to a Windows Workstation Downloading the Scripts to an AIX Workstation. 5 Downloading the Scripts to a Solaris Workstation 6 Installing the Product Installing JRE Installing the Viewer Setting Up the Environments Setting Up the Workstation Environment Setting Up the Host Environment Configuring Databases for the Viewer Uninstalling the Viewer Chapter 3. Getting Started Starting the Viewer Opening a Library Running a Report Refreshing Data Closing the Viewer Chapter 4. Tasks Adding a Library to the Viewer Adding Reports to a Library Viewing the Properties of a Library Viewing and Modifying the Properties of a Report 24 Sorting the Order in Which Reports Are Listed in a Library Specifying the Maximum Rows in a Report Modifying the Report QMF Settings Setting the Report Preferences Copying a Report Deleting a Report or Library Configuring a New Database for the Viewer Deleting a Database from the Viewer Connecting to Additional Databases Disconnecting from a Database Chapter 5. Working with DataViews.. 35 DataView Components DataView in Chart Format DataView in Table Format Customizing the DataView Setting Your Preferences Customizing the Chart View Customizing the Chart Area Customizing the Text View Using the Statistics Area on Reports Saving Preferences Loading Preferences Removing Preferences Viewing a DataView as a Mixed Graph Saving a DataView as a GIF File Exporting Report Data Printing a Report Chapter 6. SQL Query Editor Editing the Query for a Report Defining the SELECT Clause Defining the FROM Clause Defining the WHERE Clause Defining the GROUP BY Clause Defining the ORDER BY Clause Adding and Viewing a Union Saving a Query within the Database Saving a Query as a File Loading a Query File Chapter 7. Creating and Running Batch Reports Compatibility with Version Creating a Batch Report Running Batch Reports Using a Command File.. 59 Viewing Results of Running Batch Reports Viewing Batch Reports Saved as DataViews.. 60 Viewing Batch Reports Saved as CSV or GIF Files 60 Chapter 8. Message View Window Identifying the Viewer Messages Opening the Message View Showing Message Details Saving Messages in a File iii

6 Appendix A. Running Reports Created with the Reporting Dialog Using a Report Created with the Reporting Dialog 65 Appendix B. Problem Solving Invalid Page Fault on Windows Installation Does Not Start on Solaris Connection Cannot Be Established on Solaris Connection Cannot Be Established on AIX The Viewer Cannot Be Started on UNIX Operating Systems Notices Trademarks Index iv Tivoli Decision Support for OS/390 : User s Guide for the Viewer

7 Figures 1. DataView for a Report in Chart Format DataView for a Report in Table Format 37 v

8 vi Tivoli Decision Support for OS/390 : User s Guide for the Viewer

9 Preface Who should read this book What this book contains The User s Guide for the Viewer describes how to use the Java -based graphical interface for Tivoli Decision Support for OS/390. It tells you how to display the data retrieved from the DB2 database of the host to which you connect and how to work with the libraries and reports of Tivoli Decision Support for OS/390. This book also describes how to view more details on information and error messages produced by the Tivoli Decision Support for OS/390 Viewer (hereafter also referred to as Viewer). Tivoli Decision Support for OS/390 was previously known as Tivoli Performance Reporter for OS/390. The terms MVS and Performance Reporter for OS/390 are used interchangeably throughout this book. The terms OPC and Tivoli Workload Scheduler for z/os are used interchangeably throughout this book. The terms IBM Tivoli Decision Support for OS/390 and Tivoli Decision Support for OS/390 are used interchangeably throughout this book. The User s Guide for the Viewer is for anyone who uses the administrative and reporting functions of Tivoli Decision Support for OS/390. The guide comprises the following sections: v Chapter 1, Introduction, on page 1 Provides a short introduction that describes the product in general terms. v Chapter 2, Installing and Configuring the Viewer, on page 3 Explains how to install and set up the environment to work with the Viewer. It also tells you how to use the uninstallation procedure that is provided with the product. v Chapter 3, Getting Started, on page 15 Explains how to start the Viewer and the fundamentals of getting started with the product. v Chapter 4, Tasks, on page 21 Explains the main tasks you can perform with the libraries and reports of Tivoli Decision Support for OS/390. v Chapter 5, Working with DataViews, on page 35 Introduces you the concept of a DataView and how you use DataViews to work with reports. v Chapter 6, SQL Query Editor, on page 47 Explains how to define or modify the SQL query statement for a report. v Chapter 7, Creating and Running Batch Reports, on page 57 vii

10 What This Book Contains Publications Explains how to create and run reports that are run independently of the product. v Chapter 8, Message View Window, on page 61 Provides information about how to view and save the messages issued by the Viewer. v Appendix A, Running Reports Created with the Reporting Dialog, on page 65 Describes how to use the reports that you create with the Reporting Dialog. v Appendix B, Problem Solving, on page 69 Explains how to solve problems that you may encounter while using the Viewer. This section lists publications in the Tivoli Decision Support for OS/390 library and any other related documents. It also describes how to access Tivoli publications online, how to order Tivoli publications, and how to submit comments on Tivoli publications. Tivoli Decision Support for OS/390 Library The following documents are available in the Tivoli Decision Support for OS/390 library: v Administration Guide, SH Provides information about initializing the Tivoli Decision Support for OS/390 database and customizing and administering Tivoli Decision Support for OS/390. v Guide to the Reporting Dialog, SH Provides information for users who display existing reports, for users who create and modify reports, and for administrators who control reporting dialog default functions and capabilities. v Language Guide and Reference, SH Provides information for adminstrators, performance analysts, and programmers who are responsible for maintaining system log data and reports. v User s Guide for the Viewer, SH Provides information about how use the graphical interface for Tivoli Decision Support for OS/390. v Messages and Problem Determination, SH Provides information to help operators and system programmers understand, interpret, and respond to Tivoli Decision Support for OS/390 messages and codes. v Accounting Feature for the Host, SH Provides information for users who want to use Tivoli Decision Support for OS/390 to collect and report performance data generated by the Accounting feature. v Accounting Feature for the Workstation, SH Provides information for users who want to use the Accounting Workstation Option to manage, process, and analyze financial data on a workstation. v AS/400 System Performance Feature Guide and Reference, SH Provides information for administrators and users about collecting and reporting performance data generated by AS/400 systems. v CICS Performance Feature Guide and Reference, SH viii Tivoli Decision Support for OS/390 : User s Guide for the Viewer

11 Publications v Provides information for administrators and users about collecting and reporting performance data generated by Customer Information and Control System (CICS ). Distributed Systems Performance Feature Guide and Reference, SH Provides information for administrators and users about collecting and reporting performance data generated byoperating systems and applications running on a workstation. Preface ix

12 Publications v IMS Performance Feature Guide and Reference, SH Provides information for administrators and users about collecting and reporting performance data generated byinformation Management System (IMS ). v Network Performance Feature Installation and Administration, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reference, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. v Network Performance Feature Reports, SH Provides information for network analysts or programmers who use the Network Performance feature reports. v System Performance Feature Guide, SH Provides information for performance analysts and system programmers who are responsible for meeting the service-level objectives established in your organization. v System Performance Feature Reference Vol. I, SH Provides information for administrators and users with a variety of backgrounds who want to use Tivoli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS), Virtual Machine (VM) performance data. v System Performance Feature Reference Vol. II, SH Provides information for administrators and users with a variety of backgrounds who want to use Tivoli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS), Virtual Machine (VM) performance data. v IBM Online Library Omnibus Edition OS/390 Collection Kit, SK3T-4270 CD containing all OS/390 documentation. v IBM Online Library z/os Software Products Collection Kit, SK2T-6012 CD containing all z/os documentation. The Tivoli Software Glossary includes definitions for many of the technical terms related to Tivoli software. The Tivoli Software Glossary is available, in English only, at the following Web site: Using LookAt to look up message explanations LookAt is an online facility that lets you look up explanations for most messages you encounter, as well as for some system abends and codes. Using LookAt to find information is faster than a conventional search because in most cases LookAt goes directly to the message explanation. You can access LookAt from the Internet at: or from anywhere in z/os or z/os.e where you can access a TSO/E command line (for example, TSO/E prompt, ISPF, z/os UNIX System Services running OMVS). The LookAt Web site also features a mobile edition of LookAt for devices such as Pocket PCs, Palm OS, or Linux-based handhelds. So, if you have a handheld device with wireless access and an Internet browser, you can now access LookAt message information from almost anywhere. x Tivoli Decision Support for OS/390 : User s Guide for the Viewer

13 Publications To use LookAt as a TSO/E command, you must have LookAt installed on your host system. Accessing publications online IBM posts publications for this and all other Tivoli products, as they become available and whenever they are updated, to the Tivoli Software Information Center Web site. The Tivoli Software Information Center is located at the following Web address: Click the Tivoli Decision Support for OS/390 link to access the product library. These publications are available in PDF or HTML format, or both. Translated documents are also available for some products. Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog. This option is available when you click File Print. Fit to page ensures that the full dimensions of a letter-sized page print on the paper that you are using. Ordering publications You can order many Tivoli publications online at the following Web site: cgibin/pbi.cgi Accessibility Contacting software support You can also order by telephone by calling one of these numbers: v In the United States: v In Canada: In other countries, see the following Web site for a list of telephone numbers: Accessibility features help users with a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface.you can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For additional information, see the Accessibility Appendix in Administration Guide. If you have a problem with any Tivoli product, refer to the following IBM Software Support Web site: If you want to contact software support, see the IBM Software: Support Guide at the following Web site: Preface xi

14 Contacting Customer Support The guide provides information about how to contact IBM Software Support, depending on the severity of your problem, and the following information: v Registration and eligibility v v Telephone numbers and addresses, depending on the country in which you are located Information you must have before contacting IBM Software Support Note: For Tivoli NetView for OS/390 customers only, additional support is available on the NETVIEW CFORUM (Customer Forum) through the IBMLink system. This forum is monitored by NetView developers who answer questions and provide guidance. When a problem with the code is found, you are asked to open an official problem management record (PMR) to obtain resolution. Conventions used in this book Typeface conventions This guide uses several conventions for special terms and actions, operating system-dependent commands and paths, and margin graphics. The term z/os is used in this book to mean z/os and OS/390 operating systems. Where the term OS/390 does appear, the related information applies only to OS/390 operating systems. This guide uses the following typeface conventions: Bold v Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text v Interface controls (check boxes, push buttons, radio buttons, spin buttons, fields, folders, icons, list boxes, items inside list boxes, multicolumn lists, containers, menu choices, menu names, tabs, property sheets), labels (such as Tip:, and Operating system considerations:) v Column headings in a table v Keywords and parameters in text Italic v Citations (titles of books, diskettes, and CDs) v Words defined in text v Emphasis of words (words as words) v Letters as letters v New terms in text (except in a definition list) v Variables and values you must provide Monospace v Examples and code examples v File names, programming keywords, and other elements that are difficult to distinguish from surrounding text v Message text and prompts addressed to the user v Text that the user must type xii Tivoli Decision Support for OS/390 : User s Guide for the Viewer

15 Conventions Used v Values for arguments or command options Preface xiii

16 Conventions Used xiv Tivoli Decision Support for OS/390 : User s Guide for the Viewer

17 Chapter 1. Introduction Intuitive Graphical Navigation The Viewer is the new Java-based graphical interface for Tivoli Decision Support for OS/390. With the Viewer you can easily and intuitively manage Tivoli Decision Support for OS/390 reports and libraries from any Windows NT, 98, Windows 2000, AIX, or SUN workstation. There is no need to use 3270 emulators. You can use the Tivoli Decision Support for OS/390 Viewer to customize and run reports and to perform all the administrative operations such as adding report libraries, creating and deleting reports, and creating and modifying SQL queries. The Viewer runs on the workstation and connects to the Tivoli Decision Support for OS/390 database on the host. All the report libraries, reports, and report data are dynamically retrieved from the host without having to save any data on the workstation. The data that the Viewer displays is always current and up to date, because the Viewer is always synchronized with the host. This manual explains all the features of the Viewer in detail. The following features are among the most important. You can navigate among report libraries and reports in the same way as you would using Windows File Manager. All the actions you can perform on graphical objects are described in the context menu for each object. Last Generation Graphical Report Capability Graphical Query Editor The Viewer provides a complete set of fully customizable graphical and tabular presentation types, including plot, pie, area, stack, and bar graphs. This powerful Viewer tool enables you to easily create and modify queries without having to manually edit the queries. Multiple Connection Management The Viewer can manage connections to multiple Tivoli Decision Support for OS/390 databases on the host and can display the data from these multiple connections in the same workstation interface. 1

18 2 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

19 Chapter 2. Installing and Configuring the Viewer Hardware Requirements Software Requirements This chapter describes how to install and configure the Tivoli Decision Support for OS/390 Viewer. Before you install the product, ensure that you review the following sections: v Hardware Requirements v Software Requirements In addition, a section describing the automated uninstall utility to remove the product is included at the end of the chapter. If you use a Windows operating system, the minimum hardware requirements for the Viewer are a Pentium processor 266 MHz and 64 MB of RAM. If you use UNIX operating systems, the minimum hardware requirements for the Viewer are the same as the ones for the operating system you are using. The following operating systems are supported: v AIX Version or later, with patches for JDK v Sun Solaris Version 2.7 or later, with patches for JDK v Windows 98, Windows NT Version 4.0, or Windows 2000 Ensure you have installed the following: For all operating systems Java Runtime Environment (JRE) For the Windows operating systems DB2 Connect Personal Edition Version 6.1, or later 3

20 Software Requirements For the UNIX operating systems DB2 Connect Enterprise Edition Version 6.2, or later Downloading Install Scripts to a Workstation This section supplements the procedure to install JRE and the Viewer (described in Installing the Product on page 7), with information relevant to Tivoli Decision Support for OS/390. The following sections describe how to download the scripts that contain the files to install JRE and the Viewer, from an OS/390 or z/os host to a workstation running on a Windows or UNIX operating system. The files are located on the host in Tivoli Decision Support for OS/390 members, as follows: Member DRLVIENT DRLVIAIX DRLVISOL DRLVISET Contains the file to install: JRE for Windows operating systems JRE for AIX JRE for Sun Solaris The Viewer PTF, for any operating system Downloading the Scripts to a Windows Workstation On the Windows workstation where you want to install JRE and the Viewer, download the Tivoli Decision Support for OS/390 members DRLVIENT and DRLVISET from the host. You can use any directory you want on the workstation; /tmp is used in this example. Download the members and assign them the following names: Member DRLVIENT Renamed as: ibm-jre-n130p-win32-x86.zip DRLVISET setup.class 1. To download the members, from a command prompt enter: ftp hostname where hostname specifies the name of the host. 2. When prompted, enter your user ID and password. 3. To perform the transfer in binary format, enter bin 4. To change the current directory on the Windows operating system, enter: lcd /tmp 5. To get the script from the partitioned dataset, assign it the appropriate name, and store it in the /tmp directory, then enter: get xxxxxxxx.sdrlvyyy(membername) newname where: xxxxxxxx yyy membername newname Specifies the high-level identifier Specifies the language version (ENU for English or JPN for Japanese) Specifies the name of the member you are downloading Specifies the new name you assign to the member you are downloading, as described at the beginning of this section 4 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

21 Downloading Install Scripts to a Workstation 6. To exit, enter quit The following files are stored on your workstation: v setup.class v ibm-jre-n130p-win32-x86.zip To start the procedure to install JRE and the Viewer, see Installing the Product on page 7. Downloading the Scripts to an AIX Workstation On the AIX workstation where you want to install JRE and the Viewer, download the Tivoli Decision Support for OS/390 members DRLVIAIX and DRLVISET from the host. Use any directory you want on the workstation; /tmp is used in this example. Download the members and assign them the following names: Member DRLVIAIX Rename as: jre130.tar DRLVISET setup.class 1. To download the members, from a command prompt enter: ftp hostname where hostname specifies the name of the host. 2. When prompted, enter your user ID and password. 3. To perform the transfer in binary format, enter bin 4. To change the current directory on the AIX operating system, enter: lcd /tmp 5. To get the script from the partitioned dataset, assign it the appropriate name, and store it in the /tmp directory, then enter: get xxxxxxxx.sdrlvyyy(membername) newname where: xxxxxxxx yyy membername Specifies the high-level identifier Specifies the language version (ENU for English or JPN for Japanese) Specifies the name of the member you are downloading newname Specifies the new name you assign to the member you are downloading, as described at the beginning of this section 6. To exit, enter quit The following files are stored on your workstation: v setup.class v jre130.tar To start the procedure to install JRE and the Viewer, see Installing the Product on page 7. Chapter 2. Installing and Configuring 5

22 Downloading Install Scripts to a Workstation Downloading the Scripts to a Solaris Workstation On the Solaris workstation where you want to install JRE and the Viewer, download the Tivoli Decision Support for OS/390 members DRLVISOL and DRLVISET from the host. Use any directory you want on the workstation; /tmp is used in this example. Download the members and assign them the following names: Member DRLVISOL Rename as: jre130.tar DRLVISET setup.class 1. To download the members, from a command prompt enter: ftp hostname where hostname specifies the name of the host. 2. When prompted, enter your user ID and password. 3. To perform the transfer in binary format, enter bin 4. To change the current directory on the Solaris operating system, enter: lcd /tmp 5. To get the script from the partitioned dataset, assign it the appropriate name, and store it in the /tmp directory, then enter: get xxxxxxxx.sdrlvyyy(membername) newname where: xxxxxxxx yyy membername Specifies the high-level identifier Specifies the language version (ENU for English or JPN for Japanese) Specifies the name of the member you are downloading newname Specifies the new name you assign to the member you are downloading, as described at the beginning of this section 6. To exit, enter quit The following files are stored on your workstation: v setup.class v jre130.tar To start the procedure to install JRE and the Viewer, see Installing the Product on page 7. 6 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

23 Installing the Product Installing the Product The following sections describe how to install JRE and the Viewer. Installing JRE To install JRE 1.3.0, perform the following steps depending on the operating systems you are running: v v v On Windows: 1. Unzip the ibm-jre-n130p-win32-x86.zip file downloaded from the host to a temporary directory. 2. Enter the command install and follow the wizard that is displayed to lead you through installation. On AIX: 1. Copy the jre130.tar file from the temporary directory where you downloaded the install scripts to the JREdir directory (the directory where you want to install JRE). 2. From the JREdir directory untar the jre130.tar file. JRE is now installed. On Solaris: 1. Copy the jre130.tar file from the temporary directory where you downloaded the install scripts to the JREdir directory (the directory where you want to install JRE). 2. From the JREdir directory untar the jre130.tar file. JRE is now installed. Installing the Viewer To install the Viewer, you must have Administrator privileges (on Windows) or be connected as root (on UNIX). Perform the following steps: 1. Insert the product CD into the CD-ROM drive and switch to the Viewer directory. (If you downloaded the install scripts from the host, switch to the directory where you downloaded the files). 2. Enter one of the following commands, depending on the operating systems you are running. v On Windows: v JREdir\jre\bin\java -cp "." setup On AIX: JREdir/jre/sh/java -cp "." setup Chapter 2. Installing and Configuring 7

24 Installing the Viewer v On Solaris: JREdir/jre/bin/java -cp "." setup 3. The Welcome window is displayed to lead you through the installation process. Select Next to display the README Information dialog that contains the latest information about the product. 4. After having read the readme information, select Next to display the Software License Agreement dialog. 5. After having read the terms of license, select the Accept all terms of the license check box to accept all the conditions stated in the dialog. 6. Select Next to display the Specify DB2 Path dialog. In the DB2 primary directory field, specify, with its complete path, the directory where DB2 is installed. 7. Select Next to display the Choose Destination Directory dialog. 8. In the Primary destination directory field specify, with its complete path, the destination directory where to install the Viewer. We recommend the following path: 8 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

25 Installing the Viewer C:\PRViewer /PRViewer On Windows On UNIX Select Install to begin the product installation. 9. If the destination location you specified does not exist on your system, a message dialog prompting you to create the destination location is displayed. Select Yes to continue. The Installing dialog, showing you the status of the installation, is displayed. Setting Up the Environments 10. At the end of the installation process, the Installation Complete dialog is displayed. Select Finish to close the dialog. The Viewer is now installed. Before using it, see Setting Up the Workstation Environment to configure the environment. To work with the Viewer, refer to the following sections to set up the environment at the workstation where the Viewer is installed and on the host where Tivoli Decision Support for OS/390 is installed. Note: For UNIX operating systems, to establish the connection between the Viewer and the Tivoli Decision Support for OS/390 DB2, ensure that you are logged in as: v A DB2 instance owner -ORv Any user whose profile is included in the DB2 administrators group After setting up the environment, you can start the Viewer and configure the databases that the Viewer will use. For details about starting the Viewer and configuring the databases, see Configuring Databases for the Viewer on page 11. Setting Up the Workstation Environment To run the Viewer, set up the environment at the workstation where you installed the Viewer as follows: Chapter 2. Installing and Configuring 9

26 Setting Up the Environments 1. Ensure that the workstation s settings are configured for the English language. (Refer to the manual of the operating system you are using to see how to set the support for the English language.) 2. Ensure that the name of the database (database alias) to which you are going to connect with the Viewer is defined to the DB2 Client. 3. If you are running on Windows 98, edit the config.sys file and add the following statement: SHELL= C:\ COMMAND.COM C:\ / P / E:1024 Setting Up the Host Environment To enable the Viewer to work with Tivoli Decision Support for OS/390, at the host where Tivoli Decision Support for OS/390 is installed set the following parameter in the DRLFPROF file (a member of DRL160.SDRLCNTL): VIEWER=YES For more information about the DRLFPROF file, refer to the Tivoli Decision Support for OS/390 Administration Guide. 10 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

27 Configuring Databases Configuring Databases for the Viewer To connect to one or more databases, you must configure the databases for the Viewer. For UNIX operating systems: v To establish the connection between the Viewer and the Tivoli Decision Support for OS/390 DB2, ensure that you are logged in as a DB2 instance owner or any user whose profile is included in the DB2 administrators group. v Only one user can work with the Viewer, that is, the first user who operates the Viewer is assigned the required permissions, which cannot ordinarily be transferred. To configure the databases for the Viewer, perform the following steps: 1. Start the Viewer from the directory where you installed the product, by entering one of the following commands, depending on the operating systems you are running. v On Windows: v run_viewer On AIX and Solaris: run_viewer.sh The main window of the Viewer, called Tivoli Decision Support for OS/390 Viewer window, is displayed. The first time you open this window, the Batch Reports and Stored Reports libraries, provided with the Viewer, are shown in the right frame. For more information about these libraries, see Chapter 7, Creating and Running Batch Reports, on page From the Configuration menu of the action bar, select Configure Database. Chapter 2. Installing and Configuring 11

28 Configuring Databases The Configure Database for the Viewer dialog is displayed. 3. The first time you open this dialog, it is empty. To configure a database for the Viewer, select the add row button (the button with a plus sign) at the top of the dialog. An empty row is added for you to edit. 4. Specify the following, by clicking each field you want to edit: Database Alias Specify the DB2 alias of the database. This field is required. Table Prefix Specify the table prefix you want to work with. This field is required. System Table Prefix Specify the system table prefix you want to work with. This field is required. Description Enter a description of the database. This field is optional. Use as Default Select this check box to define the database as the default database used by the Viewer. 5. Add as many rows as many databases you want to configure. 6. Select Update to close the dialog and return to the Tivoli Decision Support for OS/390 Viewer window. The databases you specified are now available to the Viewer. For more information about connecting to multiple databases, see Connecting to Additional Databases on page Tivoli Decision Support for OS/390 : User s Guide for the Viewer

29 Uninstalling the Viewer Uninstalling the Viewer To uninstall the Viewer: 1. From the directory where you installed the product, enter one of the following commands depending on the operating system you are running. v On Windows: v v JREdir\jre\bin\java -cp "." uninstall On AIX: JREdir/jre/sh/java -cp "." uninstall On Solaris: JREdir/jre/bin/java -cp "." uninstall where JREdir specifies the complete path where you installed JRE The Confirm Uninstallation dialog is displayed. 2. Select Yes to start the uninstallation. The Uninstalling dialog, showing you the status of the uninstallation, is displayed. 3. At the end of the uninstallation process, the Uninstallation Complete dialog is displayed indicating that the uninstallation is complete. Select Finish to close the dialog. The Viewer and all of its components are removed and are no longer listed on your system. Chapter 2. Installing and Configuring 13

30 Uninstalling the Viewer 14 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

31 Chapter 3. Getting Started Starting the Viewer This chapter explains how to start the Viewer and use it to perform basic operations. Once you get started with the basics, read Chapter 4, Tasks, on page 21 to learn how to perform more advanced operations. The following tasks are described in detail: v Starting the Viewer v Opening a library v Running a report v Refreshing data v Closing the Viewer To start the Viewer: 1. On a command line, from the directory where you installed the product, enter: v On Windows: v run_viewer On AIX and Solaris: run_viewer.sh The main window of the Viewer, called Tivoli Decision Support for OS/390 Viewer window, is displayed. 2. To connect to the database you want to use, from the action bar select Connections and select Connect. The Connect dialog is displayed. 3. Set the following fields: Database This field is initialized with the database you configured as the default at installation time. To connect to another database, display the list and select one. If the database you want to connect to is not listed, see Configuring a New Database for the Viewer on page 31 to define the database to the Viewer. The Description field is updated with the description of the database. 15

32 Starting the Viewer User ID To connect to the database, specify the identifier of the user. Ensure that the user ID you specify has been granted the privileges required to use Tivoli Decision Support for OS/390 and that the user is defined as administrator to Tivoli Decision Support. Note: If the user is not defined as administrator to Tivoli Decision Support, some viewer tasks will not be performed. For more information about granting authorizations to Tivoli Decision Support for OS/390 users, see the Tivoli Decision Support for OS/390 Administration Guide. Password Specify the password associated with the user ID you entered. Asterisks are displayed instead of the password, when you type it. 4. Select the Connect button. 5. A dialog with the message The connection was successfully established is displayed. Select the OK button. 16 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

33 Starting the Viewer The dialog with the information message is closed and you return to the Tivoli Decision Support for OS/390 Viewer window, which is automatically updated with the libraries contained in the DB2 database of the host to which you are connected. Opening a Library Each library is identified by the description that was defined in the database. Next to this information, the database ID to which the library belongs is shown between brackets. This database ID information prevents ambiguity when connections to multiple databases are established. For more information about connecting to multiple databases, see Connecting to Additional Databases on page 32. The database ID is shown in the format DBalias-tableprefix-systemtableprefix. Note: When you start the Viewer, the libraries contained in the database to which you are connected are listed in both frames of the Tivoli Decision Support for OS/390 Viewer window. When you open a library, a list of the reports contained in the library is shown in the right frame of the Tivoli Decision Support for OS/390 Viewer window. The list of libraries is shown in the left frame of the window only. See Opening a Library to learn how to open a library. To open a library and list the reports that it contains, from the Tivoli Decision Support for OS/390 Viewer window, click the icon of the library you want to work with. The right frame of the Tivoli Decision Support for OS/390 Viewer window is updated with the reports contained in the library. (Note that the library icon Chapter 3. Getting Started 17

34 Opening a Library changes to an open folder to indicate you are working with that library.) Running a Report Each report is identified by the description that was defined in the database. Next to this information, the report ID is shown. A report is your view into a database. The report contains an SQL query that is used to extract data from the database. You generate a report by running it. To run a report, from the Tivoli Decision Support for OS/390 Viewer window: 1. Click the library to which the report you want to run belongs. A list of the reports contained in the library is displayed. 2. Right-click the report to display the context menu and select Run. 18 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

35 Running a Report OR Double-click the report. 3. If the query of the report contains variables, the Specify Query Variables dialog is displayed. Refreshing Data This dialog may show variables with some values already set from the last time you used this dialog. The optional variables are identified by (Optional) before the name. All of the other variables are required. 4. In the Value field for each variable you want to set, specify a value or click the Values button to display a list of values and select one. For multiple selection (where allowed), hold the Ctrl key pressed and select the values you want. To specify multiple values manually, separate each value with a comma. 5. When you have completed your settings, select OK to generate the report. The dialog is closed and a DataView with your report is displayed. For details about DataViews, see Chapter 5, Working with DataViews, on page 35. The first time you open the Viewer or a library, you access the data that is retrieved from the database at that time. The data is not subsequently updated, unless you specifically request it. When you switch from one library to another and then return to the first library, the data displayed in the first library is not automatically updated, unless you specifically request it. To update the data, from the Tivoli Decision Support for OS/390 Viewer window: 1. From the action bar, select View. 2. Select Refresh Now. The contents of the library that is currently open is updated with the new data retrieved from the database. To update the list of libraries shown in the Tivoli Decision Support for OS/390 Viewer window, select the Tivoli Decision Support for OS/390 icon and from the View menu of the action bar select Refresh Now. Chapter 3. Getting Started 19

36 Closing the Viewer Closing the Viewer To close the Viewer: 1. From the action bar, select File. 2. Select Quit. The connection to the database and the Tivoli Decision Support for OS/390 Viewer window are closed. 20 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

37 Chapter 4. Tasks This chapter describes the operations you can perform on the libraries and reports of Tivoli Decision Support for OS/390, how to configure a new database for the Viewer, and how to connect and disconnect from a database. The following tasks are described in detail: v Adding a library to the Viewer v Adding reports to a library v Viewing the properties of a library v Viewing and modifying the properties of a report v Sorting the order in which reports are listed in a library v Specifying the maximum number of rows in a report v Modifying the report QMF settings v Setting the report preferences v Copying a report v Deleting a report or library v Configuring a new database for the Viewer v Connecting to additional databases v Disconnecting from a database 21

38 Adding a Library Adding a Library to the Viewer To add a new library, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the Tivoli Decision Support for OS/390 icon to display the context menu and select New Library. The New Library dialog is displayed. 2. Fill in the fields as follows: Library Identifier Specify an identifier for the new library. You can use a maximum of 18 characters. Description Specify a description of the library. This information is displayed as the library name in the Tivoli Decision Support for OS/390 Viewer window. Database Identifier Display the list of available databases and select one. (Database identifiers are shown in the format DBalias-tableprefixsystemtableprefix.) 22 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

39 Adding a Library Adding Reports to a Library 3. When you complete your settings, select OK to return to the Tivoli Decision Support for OS/390 Viewer window. The new library is added to the Viewer. To add a report to a library, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the library to display the context menu and select New Report. The New Report dialog is displayed. 2. Fill in the fields as follows: Report Identifier Specify an identifier for the report. You can use a maximum of 18 characters. Description Specify a description of the report. This information is displayed as the report name in the Tivoli Decision Support for OS/390 Viewer window and as the title when the report is generated. Database Identifier This field is initialized with the database used by the library you selected when opening this dialog. To specify another database, display the list of available databases and select one. Library This field is initialized with the library you selected when opening this dialog. To specify another library, display the list of library descriptions and select one. 3. When you complete your settings, click OK to return to the Tivoli Decision Support for OS/390 Viewer window. The new report is added to the library you specified. Viewing the Properties of a Library To view the properties of a library, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the library to display the context menu and select Properties. Chapter 4. Tasks 23

40 Properties of a Library The Properties dialog is displayed. The values currently set for the library are displayed: Library Identifier The identifier of the library. Description The description of the library. This information is displayed as the library name in the Tivoli Decision Support for OS/390 Viewer window. Database Identifier The identifier of the database to which the report refers, shown in the format DBalias-tableprefix-systemtableprefix. The Last Update and Created by fields show the date when the library was last modified and the user who created the library, respectively. These fields are automatically set by the Viewer. 2. To close the dialog and return to the Tivoli Decision Support for OS/390 Viewer window, select OK. Viewing and Modifying the Properties of a Report To view or modify the properties of a report, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report to display the context menu and select Properties. The Properties dialog is displayed. 24 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

41 Properties of a Report The values currently set for the report are displayed as follows: Report Identifier The identifier of the report. Description The description of the report. This is the only value you can change. This information is displayed as the report name in the Tivoli Decision Support for OS/390 Viewer window and as the title when the report is generated. Library The description of the library to which the report belongs. Database Identifier The identifier of the database to which the report refers. The Last Update and Created by fields show the date when the report was last modified and the user who created the report, respectively. These fields are automatically set by the Viewer. 2. To close the dialog and return to the Tivoli Decision Support for OS/390 Viewer window, select OK. Sorting the Order in Which Reports Are Listed in a Library To alphabetically sort the order in which the reports are listed in a library, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the library whose reports you want to sort and from the context menu, select Sort. 2. Choose one of the following criteria for ordering the reports: v By Description of the report v By ID of the report The default is By Description. The order of the reports within the library is updated according to the criteria you set. Specifying the Maximum Rows in a Report You can specify the maximum number of rows that will be retrieved from the Tivoli Decision Support for OS/390 table when a report is generated. In the Tivoli Decision Support for OS/390 Viewer window: 1. From the Settings menu of the action bar, select Specify Max Rows. The Specify Max Rows in Report dialog is displayed. 2. In the Max rows field, specify the maximum number of rows that you want to retrieve from the table when the report is run. The default is Select OK to save your setting and close the dialog. Each time you run a report, the number of rows you have specified in this dialog will be applied. Chapter 4. Tasks 25

42 Modifying Report QMF Settings Modifying the Report QMF Settings You can change the layout of a report, for example by changing the column headings or aggregating the data in a different way, by modifying the report Query Management Facility (QMF) settings. From the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report to display the context menu and select QMF Settings. The QMF Settings dialog is displayed. 2. Set the following fields (when applicable): Sequence No. Specifies the sequence in which the columns are displayed in the report. Type a value from 1 to 999. Blank values are not valid. If two or more columns have the same sequence number, they are displayed next to each other, following the order you specified in the query statement. This is a required field. Heading Specifies the text for the column heading in the report. Enter the new heading over the existing one. QMF Usage Defines how column data is used to produce reports. 26 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

43 Modifying Report QMF Settings To add or change a usage code, click the field you want to set in the QMF Usage list and, from the list of usage codes that is displayed, select one of the following: (none) If no usage code is given, the column is displayed without any aggregation or summary. This usage code cannot be used with the GROUP usage code. ACROSS Displays data horizontally for one of the columns in the report. When you use ACROSS for one column, you must use GROUP for one or more of the other columns. For the remaining columns, you can use OMIT. In that case, the summary line for each group value can contain several sets of results from the columns that use aggregations. There is one set for each group of values in the column that uses ACROSS. A report can have only one column with the ACROSS usage code. BREAKn Divides the information in the report into smaller sections, to make the report easier to read and understand. There are six levels of break codes (n=1 6) that provide columns for different levels of breaks. Any change in the value of the column causes a break; subtotals are displayed for columns whose usage is one of the aggregation usages. To be able to show breaks in a meaningful way in a report, the SQL query must contain an ORDER BY clause for the column or columns for which you specify BREAKn. This usage code does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. GROUP Displays one line of summary data for each set of values in the column. The summary line can display only values that are the same for each member of the group, such as the value in a control column or the results of columns whose usage is an aggregation code. To present reports with GROUP usage codes in a meaningful way, the SQL query must use an ORDER BY clause for the columns for which you specify GROUP. OMIT Excludes a column and its values from the report. This usage code cannot be used with the GROUP usage code. AVERAGE Computes the average of the values in the column. The data in the column must be numeric. COUNT Computes the number of values in the column. FIRST Computes the first value in the column. LAST Computes the last value in the column. Chapter 4. Tasks 27

44 Modifying Report QMF Settings MAXIMUM Computes the greatest value in the column. MINIMUM Computes the smallest value in the column. SUM TCPT Computes the sum of the values in the column. The data in the column must be numeric. Computes the percentage of the column total that each value in the column represents. It replaces the data value with a calculation. The data in the column must be numeric. This usage code does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. Indent Specifies the number of spaces between a column and the column to its left. For the left-most column, this value corresponds to the number of spaces between the column and the left margin. You cannot modify this field. This field does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. Width Specifies the number of characters used for the column. Type a value from 1 to 99. This field is required. This field does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. Edit Code Determines the formatting of character, graphic, numeric, and time data for each column. This field is required. Possible values are: v C v E v In v Jn v Kn v Ln v Pn where n represents an integer number, if any. For a complete description of the edit codes, refer to Query Management Facility: Reference. This field does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. Definition This field does not affect the display of the report in a DataView; it is significant only to Tivoli Decision Support for OS/390. You cannot change the value of this field. 3. To delete a row, select the row you want to erase and select the delete row button (the button with an X mark) at the top of the dialog. The row is deleted without prompting you for confirmation. 4. To add a row, select the line above which you want to add the new row and select the add row button (the button with a plus sign) at the top of the dialog. A new empty row is added for you to edit. 28 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

45 Modifying Report QMF Settings 5. When you complete your settings, select OK to return to the Tivoli Decision Support for OS/390 Viewer window. Setting the Report Preferences You can customize the representation of the data in your report by setting the preferences of your DataView. For more information about DataViews, see Chapter 5, Working with DataViews, on page 35. From the Tivoli Decision Support for OS/390 Viewer window: 1. Select Report Preferences from the Settings menu of the action bar. The DataView dialog is displayed with a sample DataView that you can to customize. Copying a Report 2. Modify the sample DataView as you prefer. For more information about customizing a DataView, see Setting Your Preferences on page To save your preferences, do one of the following: v From the File menu, select Save Preferences to save the graphical setting that you have modified. (This is the graphical setting shown in the preferences area.) -ORv From the File menu, select Save Preferences As to save the graphical setting that you have modified with a different name. (For more information about saving your preferences, see Viewing a DataView as a Mixed Graph on page 45.) 4. You are returned to the DataView dialog, where the graphical setting you have created is shown in the preferences area. Close the dialog to return to the Tivoli Decision Support for OS/390 Viewer window. For detailed information about how to apply the graphical setting you have created, see Loading Preferences on page 44. You can copy a report to a different library, within the same database, or to the same library with a different identifier. Chapter 4. Tasks 29

46 Copying a Report From the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report you want to copy and, from the context menu, select Copy. 2. Right-click the library to which you want to copy the report and, from the context menu, select Paste. 3. The Rename dialog is displayed. Specify a New Report ID and select OK. The new report is added to the library with the identifier that you specified. Note that the name of the report shown in the Tivoli Decision Support for OS/390 Viewer window does not change. To change it, modify the description of the report as explained in Viewing and Modifying the Properties of a Report on page 24. The report is copied to the library with the same SQL query it had at the source library and the QMF settings are copied to it. To define or modify the QMF settings for the report, see Modifying the Report QMF Settings on page Tivoli Decision Support for OS/390 : User s Guide for the Viewer

47 Deleting a Report or Library Deleting a Report or Library To delete a report or a library from the Viewer, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report or library you want to delete and, from the context menu, select Delete. 2. A warning message prompting you to confirm the deletion is displayed. Select Yes to delete the library or report. When you erase a report, the report is no longer listed in the library. When you erase a library, the library is no longer listed in the Tivoli Decision Support for OS/390 Viewer window, though all its reports are moved to the Ungrouped Reports library. (To see the reports, open the Ungrouped Reports library and refresh the data.) Configuring a New Database for the Viewer To configure another database to which you can connect from the Viewer, in the Tivoli Decision Support for OS/390 Viewer window: 1. From the Configuration menu of the action bar, select Configure Database. The Configure Database for the Viewer dialog is displayed, showing a list of the databases that you configured for the Viewer at installation time. 2. To add a new database to the list, select the add row button (the button with a plus sign) at the top of the dialog. A new empty line is added for you to edit. 3. Specify the following information, by clicking each field you want to edit: Database Alias Specify the DB2 alias of the database. This field is required. Table Prefix Specify the table prefix you want to work with. This field is required. System Table Prefix Specify the system table prefix you want to work with. This field is required. Description Enter a description of the database. This field is optional. Use as Default Select this check box to define the database as the default database used by the Viewer. If another database was previously set as the default, the new setting will take effect the next time you start the product. Chapter 4. Tasks 31

48 Configuring a New Database 4. Select Update to close the dialog and return to the Tivoli Decision Support for OS/390 Viewer window. The database you specified is now available to the Viewer. Deleting a Database from the Viewer From the Configure Database for the Viewer dialog, you can also delete a database that was configured for the Viewer: 1. Select the row where the database whose configuration you want to remove is specified. 2. Select the delete row button (the button with an X mark) at the top of the dialog. The configuration of the database is deleted. 3. Select Update to close the dialog and return to the Tivoli Decision Support for OS/390 Viewer window. Connecting to Additional Databases You can connect to as many databases as you want, provided that you defined the databases to the Viewer (see Configuring Databases for the Viewer on page 11 and Configuring a New Database for the Viewer on page 31). To connect to another database, from the Tivoli Decision Support for OS/390 Viewer window: 1. From the Connections menu of the action bar, select Connect. The Connect dialog is displayed. 32 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

49 Connecting to Additional Databases 2. Set the following fields: Database Display the list of available databases and select the database to which you want to connect. The Description field is updated with the description of the database. User ID To connect to the database, specify the identifier of the user. Ensure that the user ID you specify has been granted the privileges required to use Tivoli Decision Support for OS/390. For more information about defining authorizations to Tivoli Decision Support for OS/390 users, see the Tivoli Decision Support for OS/390 Administration Guide. Password Specify the password associated with the user ID you chose. Asterisks are displayed instead of the password, when you type it. 3. Select the Connect button. 4. A dialog with the message The connection was successfully established is displayed. Select the OK button. The dialog with the information message is closed and the libraries belonging to the new database are added to the Tivoli Decision Support for OS/390 Viewer window. Disconnecting from a Database To disconnect from a database, from the Tivoli Decision Support for OS/390 Viewer window: 1. From the Connections menu of the action bar, select Disconnect. The Disconnect dialog is displayed. 2. Select the Database from which you want to disconnect and select the Disconnect button. 3. A dialog with the message The disconnection was successfully executed is displayed. Select the OK button. The dialog with the information message is closed and the list of libraries in the Tivoli Decision Support for OS/390 is updated. Chapter 4. Tasks 33

50 Disconnecting from a Database 34 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

51 Chapter 5. Working with DataViews DataView Components A DataView is a window that contains the tabular or graphical representation of the data you are reporting. You use a DataView to customize, save the settings, print reports, and export the data contained in the report. This chapter describes: v DataView components v How to customize a DataView v How to save, load, and remove your preferences v How to view a DataView as a mixed graph v How to save a DataView as a GIF file v How to export the report data v How to print the report A report is your view into a database. The report contains an SQL query that is used to extract data from the database. A DataView is your view of the extracted data, which can be displayed as a chart or a table. This section describes the parts that compose a DataView for reports in chart format and table format. 35

52 DataView Components DataView in Chart Format Figure 1 shows the components of a DataView in chart format. Action bar Preferences area Tool bar area Chart view Status area Header Y title Chart area Legend X title Footer Figure 1. DataView for a Report in Chart Format You can customize the chart view. For more information, see Setting Your Preferences on page 38. From the Options menu of the action bar, you can choose whether to display: v The preferences area v The tool bar area v The status area v The DataView as a mixed graph (for more information, see Viewing a DataView as a Mixed Graph on page 45) From the tool bar area, you can switch among the different views of the report (unless the data cannot be represented in that particular format): v Bar v Pie v Line v Stack v Area v Table From the preferences area, you can select the graphical setting you want to use for the report. For more information about graphical settings, see Setting Your Preferences on page Tivoli Decision Support for OS/390 : User s Guide for the Viewer

53 DataView components DataView in Table Format Figure 2 shows the components of a DataView for a report in table format. Action bar Preferences area Tool bar area Text view Status area Customizing the DataView Figure 2. DataView for a Report in Table Format You can customize the text view. For more information, see Setting Your Preferences on page 38. From the Options menu of the action bar, you can choose whether to display: v The preferences area v The tool bar area v The status area v The DataView as a mixed graph (for more information, see Viewing a DataView as a Mixed Graph on page 45) From the tool bar area, you can switch to the chart format, choosing among the different views of the report (unless the data cannot be represented in that particular format): v Bar v Pie v Line v Stack v Area From the preferences area, you can select the graphical setting you want to use to view the report. For more information about graphical settings, see Setting Your Preferences on page 38. You can customize the DataView components with your preferred settings. Refer to the following sections for an explanation on how to set and save your preferences. Note: The settings you specify are immediately applied, but they are not saved when you close the DataView. To save the values as a graphical setting for future use, see Saving Preferences on page 44. Chapter 5. Working with DataViews 37

54 Setting Your Preferences Setting Your Preferences To customize a DataView, you can: 1. Double-click the chart view, text view, or any customizable item within them, whose properties you want to modify. Depending on your choice, a Properties dialog in which you can set your preferences is displayed. OR 1. In the preferences area, display the list of graphical settings and select the one you want to modify. 2. From the Options menu of the action bar, select Preferences. The Preferences dialog related to the graphical setting you selected is displayed. 3. In the left frame of the Preferences dialog, select the item whose properties you want to modify. The right frame of the dialog is updated with the fields that apply to that item. 4. Set the following fields: View Type Select the type of view for the report. Buffer Size Specify the maximum number of points that the view can collect. (Note that this is not the same as the maximum number of points that the view can display. You set this value in the Visible points field of the Chart View item.) The maximum value of the buffer size that you can specify is 500. Text Specify a text for the company name. This name is shown above the report header in the DataView window. Visible Select this check box to show the company name in the DataView window. Foreground Color Click this field to set the color for the background of the company name. 38 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

55 Setting Your Preferences Font Select the Change button to specify the type and size of the font to use for the company name. 5. Select Frame to set the properties of the DataView window. Set the following fields: Title Specify a title for the DataView window. Width Specify a number for the width of the DataView window. Height Specify a number for the height of the DataView window. Tool Bar Visible Select this check box to show the tool bar in the DataView window. Preferences Area Visible Select this check box to show the preferences area in the DataView window. Status Area Visible Select this check box to show the status area in the DataView window. 6. Select OK to close the dialog and return to the DataView. The settings you specify are immediately applied, but they are not saved when you close the DataView. To save the values as a graphical setting for future use, see Saving Preferences on page 44. To customize the chart view and text view, select the corresponding icon in the Preferences dialog. For more details, see Customizing the Chart View, Customizing the Chart Area on page 40, and Customizing the Text View on page 42. Customizing the Chart View To customize the chart view: 1. From the left frame of the Preferences dialog, select the Chart View icon. Chapter 5. Working with DataViews 39

56 Customizing the Chart View (This is equivalent to double-clicking the chart view itself, within the DataView.) 2. Set the following fields: Visible Points Specify the number of points to display in the chart area at one time. Background Color Click this field to select the color for the background. Series Colors Click the button corresponding to the color to use for the series. Labeling Mode Display the list of values and select how to display the labels. Label Anchor Display the list of values and select where to position the labels. Label Font Select the Change button to specify the type and size of the font to use for the labels. Symbol Styles Click the button corresponding to the symbol and color to use for the Line view of the report. 3. Select OK to close the dialog and return to the DataView. The settings you specify are immediately applied, but they are not saved when you close the DataView. To save the values as a graphical setting for future use, see Saving Preferences on page 44. Customizing the Chart Area To customize the chart area: 1. From the left frame of the Preferences dialog, select the plus sign (+) next to the Chart View icon and select Chart Area. 40 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

57 Customizing the Chart Area (This is equivalent to double-clicking the chart area itself, within the DataView.) 2. Set the following fields: Visible Select this check box to show the chart area in the DataView. Depth Specify a number greater than zero to make the chart three-dimensional. Axis Inversion Select this check box to show the X axis on the vertical axis and the Y axis on the horizontal axis. X Axis Grid Select this check box to show a grid on the X axis. Y Axis Grid Select this check box to show a grid on the Y axis. Background Color Click this field to set the color for the background. Foreground Color Click this field to set the color for the chart text. Plot Area Color Click this field to set the color for the plot area. X Labels Rotation Select a radio button to specify the degree of rotation of the labels on the X axis. Y Labels Rotation Select a radio button to specify the degree of rotation of the labels on the Y axis. Border Type Display the list of types and select the type of border for the chart area. Border Width Specify the width for the border of the chart area. Chapter 5. Working with DataViews 41

58 Customizing the Chart Area Font Select Change to set the type and size of font used in the chart area. 3. Select OK to close the dialog and return to the DataView. The settings you specify are immediately applied, but they are not saved when you close the DataView. To save the values as a graphical setting for future use, see Saving Preferences on page 44. Customizing the Text View To customize the text view: 1. From the left frame of the Preferences dialog, select Text View. (This is equivalent to double-clicking the text view itself, within the DataView.) 2. Set the following fields: Title Text Specify a title for the text view. Title Visible Select this check box to show the title in the text view. Statistics Area Visible Select this check box to show the statistics area within the text view. For more details about the statistics area, see Using the Statistics Area on Reports on page 43. Background Color Click this field to set the color for the text view background. Foreground Color Click this field to set the color for the text. Show Grid Select this check box to show a grid in the text view. Grid Color Click this field to set the color for the grid. 3. Select OK to close the dialog and return to the DataView. 42 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

59 Customizing the Text View The settings you specify are immediately applied, but they are not saved when you close the DataView. To save the values as a graphical setting for future use, see Saving Preferences on page 44. Using the Statistics Area on Reports Within a report in table format, you can optionally show the statistics area to perform statistical operations. For details on how to show the statistics area, see Customizing the Text View on page 42. A DataView that resembles the following one is displayed. To use the statistics area: 1. Depending on the operations you want to perform, select the Average, Sum, Maximum, and Minimum check boxes. 2. In the report, select the lines that contain the values on which you want to perform the statistical operations. (To select more than one line, hold the Ctrl key pressed and click the lines you want.) The results of the operation are shown immediately. Chapter 5. Working with DataViews 43

60 Saving Preferences Saving Preferences Loading Preferences After setting your preferences to customize the DataView, save them as a graphical setting for future use. To save your preferences, from the action bar in the DataView: 1. From the File menu, select Save Preferences to save the graphical setting you have modified. OR 1. From the File menu, select Save Preferences As to save the graphical setting you have modified with a different name. The Save Preferences As dialog is displayed. 2. Specify a Name for the graphical setting and select OK. You are returned to the DataView, where the graphical setting you have created is shown in the preferences area. To load the graphical setting that contains your preferences, from the DataView: 1. In the preferences area, display the list of available graphical settings and select one. OR 1. If you customized the DataView so that the preferences area is not shown, from the File menu of the action bar select Load Preferences. The Load Preferences dialog is displayed. Removing Preferences 2. Display the list of available graphical settings and select one. 3. Select OK to close the dialog and return to the DataView. The graphical setting you chose is used to customize the DataView. To remove a graphical setting, from the DataView window: 1. In the preferences area, ensure that the graphical setting you want to remove is not currently in use. 2. From the File menu of the action bar, select Remove Preferences. 44 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

61 Removing Preferences The Remove Preferences dialog is displayed. 3. Select the graphical setting you want to remove and select the Remove button. 4. The graphical setting is removed from the list. Select Close to close the dialog. You are returned to the DataView. The graphical setting you removed is no longer existing. Viewing a DataView as a Mixed Graph You can display the data shown in a DataView by using mixed graphical views. The data is represented as Bar and Line formats, according to the metrics you choose. To get a list of the metrics, you must have run the report at least once. Note: You can set mixed graphs only for a DataView shown as Bar format. From the DataView window: 1. From the Options menu, select Mixed Graph to display the Mixed Graph Preferences dialog. 2. Select one or more metrics and click OK. 3. You are returned to the DataView dialog, where the DataView is updated to the selection you made. Saving a DataView as a GIF File You can save a DataView as a GIF file on your local disks. From the DataView window: 1. From the File menu, select Save As GIF. The Save As GIF - DataView dialog is displayed. 2. Choose the path and specify a File name. Chapter 5. Working with DataViews 45

62 Saving a DataView Exporting Report Data Printing a Report 3. Select the Save button. The GIF file is created and you are returned to the DataView. You can export all of the report data as a Comma Separated Variables (CSV) file. You can then display the file in a spreadsheet and use the functions of the spreadsheet program to continue to work on the information. From the DataView window: 1. From the File menu, select Export As CSV. The Export As CSV - DataView dialog is displayed. 2. Choose the path and specify a File name. 3. Select the Save button. The CSV file is created and you are returned to the DataView. To print a report, from the DataView window: 1. From the File menu, select Print. The Print dialog is displayed. 2. Change the print options you want to modify. 3. Select the OK button. The report is sent to the printer you chose and you are returned to the DataView. 46 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

63 Chapter 6. SQL Query Editor In Tivoli Decision Support for OS/390, when you request a report (DataView), the Viewer creates the SQL query to retrieve the data from the relevant database. The Viewer provides an SQL Query Editor window that enables you to view and edit the SQL query. In the SQL Query Editor window, the header, if any, of the SQL query and each clause of the SELECT statement are displayed one at a time to enable you to redefine your expressions. No syntax checking is performed on the expressions you define. You can use the SQL Query Editor to modify an existing query within a database or create a new query based on the one you are modifying. New queries can be saved as files that you store locally and can be used to replace the queries of other reports. This chapter describes how to: v Edit the query for a report v Save a query or a query file v Load a query file Editing the Query for a Report To edit the query for a report, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report to display the context menu and select Modify Query. 47

64 Editing a Query The SQL Query Editor window is displayed. The window is divided into left, right, and bottom frames. 2. The left frame shows the alias of the database that the report addresses and the table prefixes contained in the database. From this frame you display the tables and columns you want to work with (see Defining the SELECT Clause ). 3. The first time you open the SQL Query Editor, the right frame shows the Header, if any, of the query. Double-click the line of the header you want to edit (the line is highlighted in blue) and modify the information. To delete, add, or move a line in this frame, click the line to select it (the line is highlighted in yellow) and use the buttons at the bottom of the frame: Button with an X mark Deletes the selected line Button with a plus sign (+) Adds a line Button with an ascending arrow Moves the selected line up one position Button with a descending arrow Moves the selected line down one position From this frame, you also define each clause of the query (see the following sections). 4. The Resulting Query frame at the bottom of the window shows the query as it is currently defined for the report you selected. As you change the query, the results are automatically shown in this frame. Note: Any comments that the user has added at the end of a query line, are not shown in this frame. Defining the SELECT Clause The SELECT clause is required. 48 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

65 Defining the SELECT Clause To define the SELECT clause, in the SQL Query Editor: Chapter 6. SQL Query Editor 49

66 Defining the SELECT Clause 1. From the action bar: v If you want to modify an existing query, select View and select the UNION you want to work with. OR v If you are adding a new query, select Actions and select Add UNION. The right frame of the window is updated with tabs that enable you to define the clauses of the query. The SELECT tab is already chosen for you. Any expressions that are defined for the SELECT clause are also shown. 2. To modify an expression, click the line you want to change and modify the information. (As soon as you switch to another line or press Enter, the Resulting Query is updated.) 3. To add a column to the SELECT clause, from the left frame select the icon to expand the table prefix you want to use. A list of the available tables is displayed. 50 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

67 Defining the SELECT Clause 4. Select the icon to expand the table you want to use. A list of the columns contained in the table is displayed. 5. Right-click the column you want and select Add Column to Query. The column is added to the right frame. Each column you add is identified in the format: tableprefix.tablename.column 6. Define the expression you want to add. You can add as many columns and expressions as you need. Defining the FROM Clause The FROM clause is required. To define the FROM clause of the query: 1. Select the FROM tab. Chapter 6. SQL Query Editor 51

68 Defining the FROM Clause The right frame of the window is updated with any table defined for the FROM clause in the query. 2. To add a table to the FROM clause, from the left frame right-click the table you want and select Add Table to Query. The table is added to the right frame and the Resulting Query is updated. Each table you add is identified in the format: tableprefix.tablename Defining the WHERE Clause The WHERE clause is optional. To define the WHERE clause of the query: 1. Select the WHERE tab. The right frame of the window is updated with any conditions defined for the WHERE clause. 2. To modify a condition, click the line you want to change and modify the information. (As soon as you switch to another line or press Enter, the Resulting Query is updated.) 3. To add a column to the WHERE clause, from the left frame right-click the column you want and select Add Column to Query. The column is added to the right frame. Each column you add is identified in the format: tableprefix.tablename.column 4. Define the expression you want to add. You can add as many expressions as you need. 52 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

69 Defining the GROUP BY Clause Defining the GROUP BY Clause The GROUP BY clause is optional. To define the GROUP BY clause of the query, in the SQL Query Editor: 1. Select the GROUP BY tab. The right frame of the window is updated with any column defined for the GROUP BY clause. 2. To add a column, from the left frame right-click the column you want and select Add Column to Query. The column is added to the right frame and the Resulting Query is updated. Each column you add is identified in the format: tableprefix.tablename.column Defining the ORDER BY Clause The ORDER BY clause is optional. To define the ORDER BY clause of the query, in the SQL Query Editor: 1. Select the ORDER BY tab. The right frame of the window is updated with any columns and expressions specified for the ORDER BY clause. 2. To add a column, from the left frame right-click the column you want and select Add Column to Query. The column is added to the right frame and the Resulting Query is updated. Each column you add is identified in the format: tableprefix.tablename.column 3. To specify the order in which the values of a column or expression will be shown, type DESC (for descending) or ASC (for ascending) next to the column or expression. The default is ascending. 4. Press Enter to update the Resulting Query. Chapter 6. SQL Query Editor 53

70 Adding and Viewing a Union Adding and Viewing a Union You can add as many unions as you want to your SQL statement (for more information about unions, see the DB2 SQL Reference). To add a union, in the Tivoli Decision Support for OS/390 Viewer window: 1. From the action bar, select Actions. 2. Select Add UNION. The right frame of the window is updated with the tabs that enable you to define the clauses of the new query. The SELECT tab is already chosen for you. 3. Define the clauses of your query. (For more information about defining clauses, see Editing the Query for a Report on page 47). To view the unions in your SQL statement: 1. From the action bar, select View. 2. Select the UNION you want to view. The currently selected union, if any, is shown with an asterisk (*) next to the name. Saving a Query within the Database Saving a Query as a File To save in the database a query that you edited, from the SQL Query Editor window: 1. From the Query menu of the action bar, select Update. 2. Select Close. The query is updated within the database with the changes you made. The SQL Query Editor window is closed and you return to the Tivoli Decision Support for OS/390 Viewer window. To save a query you edited as a query file, from the SQL Query Editor window: 1. From the Query menu of action bar, select Save File. The Save As dialog, which enables you to save the query in a file stored locally, is displayed. 2. Select a path in the Save in field and specify a File name for the query. 3. Select the Save button to close the dialog and return to the SQL Query Editor. 4. Select the Close button to return to the Tivoli Decision Support for OS/390 Viewer window. The query file is stored locally with the name you assigned. The old query still exists without any changes made. 54 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

71 Loading a Query File Loading a Query File You can use a query that you stored locally in a file to replace the query of a report within the database. To load a query file, from the SQL Query Editor window: 1. From the action bar, select Query. 2. Select Load File. The Open dialog is displayed. 3. Select a path in the Look in field and specify the File name you want to work with. 4. Select the Open button. The dialog is closed and you are returned to the SQL Query Editor window. The SQL Query Editor window is updated with the query you chose. 5. From the Query menu of the action bar, select Update to replace the query in the database with the query retrieved from the query file. 6. Select Close. The SQL Query Editor window is closed and you return to the Tivoli Decision Support for OS/390 Viewer window. Chapter 6. SQL Query Editor 55

72 Loading a Query File 56 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

73 Chapter 7. Creating and Running Batch Reports A batch report is an SQL query that is run without user intervention. Using batch reports enables you to schedule the running of the reports during off-peak times, saving valuable system resources during peak working hours. Batch reports can be run from the Batch Reports library, which is automatically created when you install the Viewer, or by using the command file that is provided with the product. You can run batch reports (that is, run the SQL queries contained in the reports) individually or you can run them all together. This chapter explains you how to: v Create a batch report v Run batch reports v View results of batch reports v Delete a batch report Compatibility with Version Creating a Batch Report Batch reports that were created with the Viewer Version 1.4 are not removed when you uninstall the Viewer or install Version You can still work with them. To create a batch report, from the Tivoli Decision Support for OS/390 Viewer window: 1. Right-click the report you want to run in batch and, from the context menu, select Copy. 2. Right-click the Batch Reports library and, from the context menu, select Paste to copy the report in the library. 3. If you are copying a report whose ID and database alias are the same as an existing report in the Batch Reports library, the Specify New Description dialog is displayed. Specify a New Description for the report and select OK. 57

74 Creating a Batch Report 4. The report is copied to the Batch Reports library for your use. Right-click the report and from the context menu select one of the following: Specify Variables Displays the Specify Query Variables dialog. Use this dialog to set the values of the variables in the query statement. This operation is required, because you are not prompted for the variables when the report is run (even if you run it at run-time). For more information about specifying query variables, see Running a Report on page 18. Properties Displays the Properties dialog. 58 Tivoli Decision Support for OS/390 : User s Guide for the Viewer You can modify: v The Description of the report, which is displayed as the report name in the Tivoli Decision Support for OS/390 Viewer window. v The Additional Description of the report. You can use a maximum of 8 characters. This field is optional. v The format in which to save the report. For more information about report formats, see Viewing Results of Running Batch Reports on page 60.

75 Creating a Batch Report v The type of graphical view (only for GIF format). Run Runs the report immediately, even though it is a batch report. To run all batch reports at the same time, right-click the Batch Reports library and from the context menu select Run. Delete Deletes the report from the Batch Reports library. A warning message prompting you to confirm the deletion is displayed. Select OK to delete the report. To delete all batch reports at the same time, right-click the Batch Reports library and from the context menu select Delete. A warning message will prompt you to confirm the deletion. 5. Add to the Batch Reports library as many reports as you want. If you are connected to multiple databases, you can add reports that belong to different databases. Running Batch Reports Using a Command File All of the reports within the Batch Reports library are invoked together. To run the batch reports use the run_batchreport command file that is provided with the product. This file invokes the Viewer in batch mode. On Windows use run_batchreport.bat; on UNIX use run_batchreport.sh. 1. From the directory where you installed the Viewer, edit the run_batchreport file and replace the appropriate values in following line: java -classpath %CLASSPATH% com.tivoli.reporter.main.batchstartup /u userid /p pwd /h DBalias where: userid pwd DBalias The identifier of the user connected to the database The password associated with the user ID The name of the database If the batch reports you run belong to different databases, you must repeat this line for each database you use. 2. Invoke the command file from a command line or, to schedule the execution of the command file at a time that is more convenient for you, use a scheduling program. The reports are run in batch independently of whether the Viewer is running. Chapter 7. Creating and Running Batch Reports 59

76 Viewing Results of Batch Reports Viewing Results of Running Batch Reports The location of the batch reports depends on the format used to save them. Viewing Batch Reports Saved as DataViews Batch reports saved as DataViews are stored in the Stored Reports library. To view these reports: 1. In the Tivoli Decision Support for OS/390 Viewer window, open the Stored Reports library. (You may need to refresh the data, to see the reports.) A list of all the batch reports that were run is displayed. Each report is identified in the format reportdesc(dbalias)-adddesc-date, where: reportdesc The report description (DBalias) The name of the database, included between brackets adddesc The additional description you specified for the report, if any date The date when the report was run, shown in the local format If you run the batch reports more than once in the same day, the last reports generated overwrite the previous ones. 2. Right-click the report you want to view and select Run. The batch report that was generated is displayed for you in a DataView window. (To save the DataView as a GIF file, see Saving a DataView as a GIF File on page 45.) Viewing Batch Reports Saved as CSV or GIF Files Batch reports saved as CSV or GIF files are stored in the /BatchReports directory located in the path where you installed the product. The following files are stored in this directory:.btc files.csv files.gif files.ser files Contain the information used by the program to run the report (binary format) Reports saved in CSV format Reports saved in GIF format Reports saved in DataView format, if any To view the batch reports saved as CSV, use a spreadsheet program. To view the batch reports saved as GIF, use a graphics tool. Each batch report saved either as CSV or GIF, is identified in the format reportid-dbalias-n-adddesc-date, where: reportid The report identifier DBalias The name of the database n A number assigned by the product, starting from 0 adddesc The additional description you specified for the report, if any date The date when the report was run, shown in the local format If you run the batch reports more than once in the same day, the most recent reports overwrite the previous ones. 60 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

77 Chapter 8. Message View Window You can look at the messages issued by the Viewer through the Message View window. You can view the message text, a more detailed description of the message, and save the messages in a file for your convenience. This chapter explains how to: v Identify a Viewer message v Open the Message View window v View the message details v Save the messages in a file Identifying the Viewer Messages Viewer messages have an identifier in the following format: DRLnnnnY Opening the Message View Where: DRL Is the message prefix. nnnn Specifies the serial number of the message, starting from Y Identifies the type of the message as follows: I Information messages provide feedback about something happening in the product or system that might be important. These messages also guide you while you are requesting specific actions from Tivoli Decision Support for OS/390 Viewer. W Warning messages call your attention to an exception condition that is not necessarily an error and does not require immediate action. E Error messages indicate that an action cannot be completed because of a user or system error. Error messages always require a user response. H Help messages give you hints or suggestions for how to use the product more efficiently. To open the Message View window, from the Tivoli Decision Support for OS/390 Viewer window: 1. From the action bar, select View. 61

78 Opening the Message View 2. Select Message View to display the Message View window. For each message, you are shown the following information: Type Message ID Date Message Text Whether the message is an information, warning, error, or help message. The identifier of the message. The day, date, and time when the message was issued. The text that the Viewer shows in the message. You can filter the messages that are displayed in the Message View window: 1. From the action bar, select View and select Filter Options. The Filter Options window is displayed. 2. In the Show Messages of Type field, select the type of message you want to display. The default value is <none>, meaning that all messages regardless of their types are displayed. 3. Select OK to close the dialog and return to the Message View. The contents of the Message View window is updated with the type of message you set. You can also sort the order in which messages are listed in the Message View window: 1. From the action bar, select View and select Sort. 62 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

79 Opening the Message View 2. Choose the criteria by which you want to order the messages, among the following: v Message ID v Type v Date The order of the Message View window is updated according to the criteria you set. Showing Message Details To view a more detailed description of a message, from the Message View window: 1. Select the message whose detailed description you want to view. 2. Select the message. With the mouse right button display the context menu and select Show Details. (This is equivalent to double-clicking the message.) The Show Details dialog is displayed. You are shown the message identifier, message type, and a detailed description of the event that caused the message. 3. Select OK to close the dialog and return to the Message View window. Saving Messages in a File To save the contents of the Message View window: 1. From the action bar, select File and select Save as. The Save As dialog is displayed. 2. Select a path in the Save in field and specify a File name. 3. Select the Save button to close the dialog and return to the Message View window. All of the messages contained in the Message View are saved in the file you specified. Chapter 8. Message View Window 63

80 Saving Messages in a File 64 Tivoli Decision Support for OS/390 : User s Guide for the Viewer

81 Appendix A. Running Reports Created with the Reporting Dialog Reports that you create with the Tivoli Decision Support for OS/390 Reporting Dialog (hereafter also referred to as Reporting Dialog) can be used and run with the Viewer, provided that you set the following parameter in the DRLFPROF file: QMFUSE=NO However, if you set QMFUSE=YES the following rules apply: v Reports that were created with the Reporting Dialog cannot be used with the Viewer. v Reports that were created with Tivoli Decision Support for OS/390 and then modified with the Reporting Dialog, can be used with the Viewer but the changes you made are not seen. v Reports that were created with Tivoli Decision Support for OS/390 and then modified with the Viewer, can be used with the Reporting Dialog but the changes you made are not seen. This appendix describes the operations to perform to work with a report that you created with the Reporting Dialog: v Create a new report v Modify the old report s SQL query statement v Save the SQL query statement in the database for the new report Using a Report Created with the Reporting Dialog To use with the Viewer a report that you created with the Reporting Dialog: 1. From the Tivoli Decision Support for OS/390 Viewer window, right-click the library where you want to create a new report that is based on the old report you have. Select New Report. The New Report dialog is displayed. 2. Specify a Report Identifier and Description for the new report you are creating. For more information about these fields, see Adding Reports to a Library on page Select OK to save the settings and close the dialog. The new report is added to the library. 4. Right-click the report you created and select Modify Query. The SQL Query Editor window is displayed. 5. From the Query menu of the action bar, select Load File to display the Open dialog. For more information about the SQL Query Editor, see Chapter 6, SQL Query Editor, on page Specify the directory and the name of the file where your old report is stored in the Look in and File name fields, respectively. 7. Select Open to close the dialog and return to the SQL Query Editor, where the query is displayed in the Resulting Query frame. 65

82 Using a Report Created with Reporting Dialog 8. Scroll to the last line of the list, as shown in the following figure: You see the last clause defined for the query statement (ORDER BY, in this example), followed by some text that is not required by Viewer. 66 Tivoli Decision Support for OS/390 : User s Guide for the Viewer