Tivoli Decision Support for OS/390. Administration Guide. Version 1.6, December 2003 SH

Transcription

1 Tioli Decision Support for OS/390 Administration Guide Version 1.6, December 2003 SH

2

3 Tioli Decision Support for OS/390 Administration Guide Version 1.6, December 2003 SH

4 Note Before using this information and the product it supports, read the information in Notices on page 421. Ninth Edition (June 2003) This edition applies to ersion 1, release 6 of Tioli 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 1993, All rights resered. Note to U.S. Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.

5 Contents Figures ix Preface xi Who should read this book xi What this book contains xi Publications xiii Tioli Decision Support for OS/390 library.. xiii Using LookAt to look up message explanations xi Accessing publications online xi Ordering publications x Accessibility x Contacting software support x Conentions used in this book xi Typeface conentions xi Changes in this edition xi Part 1. Getting started Chapter 1. Understanding Tioli Decision Support for OS/ Introduction to Tioli Decision Support for OS/390.3 Introduction to Tioli Decision Support for OS/390 performance features Introduction to the log collector Log definitions Record definitions Update definitions Table definitions Log and record procedures Collect process Introduction to the Tioli Decision Support for OS/390 database Introduction to the administration dialog Introduction to the reporting dialog Chapter 2. Installing Tioli Decision Support for OS/ Installation prerequisites Hardware prerequisites Software prerequisites Considerations when migrating from an earlier release or modification leel of Tioli Decision Support for OS/ Migrating the Tioli Decision Support for OS/390 base to the latest leel Step 1: Reiew the results of the SMP/E installation 16 Tioli Decision Support for OS/390 data sets..16 Local data sets Language-dependent Tioli Decision Support for OS/390 data sets Step 2: Set up security Tioli Decision Support for OS/390 security using secondary authorization IDs What to do Tioli Decision Support for OS/390 security without secondary authorization IDs Installation steps when secondary user IDs are not used Step 3: Initialize the DB2 database Initializing DB2 database when installing Tioli Decision Support for OS/390 for first time...21 DRLJDBIN job Customization considerations for the CICS Partitioning feature DRLJDBIP job Step 4: Prepare the dialog and update the dialog profile Step 5: Set personal dialog parameters Step 6: Create or update system tables Step 7: Set up QMF Step 8: Set up BookManager Step 9: Customize JCL Step 10: Test the installation of the Tioli Decision Support for OS/390 base Step 11: Reiew DB2 parameters Step 12: Install components Installing other Tioli Decision Support for OS/390 systems Installing Tioli Decision Support for OS/390 features separately Enabling the Tioli Data Warehouse Chapter 3. Oeriew of defining Tioli Decision Support for OS/390 objects.. 51 How Tioli Decision Support for OS/390 component installation works Defining definition library members with SQL..51 How Tioli Decision Support for OS/390 controls object replacement How Tioli Decision Support for OS/390 determines installation order Defining logs with log collector language...54 Defining records with log collector language..54 Defining tablespaces Defining tables and updates Defining updates and iews Defining reports Collecting data Collecting data through the administration dialog 60 Using log collector language to collect data...61 Adding a field to a record definition Using the administration dialog to add a field definition Using log collector language to add the field definition Part 2. Administering Tioli Decision Support for OS/ iii

6 Chapter 4. Setting up operating routines Collecting log data Collecting data from IMS Collecting data from Tioli Serice Desk Collecting network configuration data Performing routine data collection Monitoring collect actiity Sample collect messages Using collect messages Reiewing log statistics Using the DRLLOGDATASETS table Improing collect performance Administering the Tioli Decision Support for OS/390 database Understanding DB2 concepts Understanding how Tioli Decision Support for OS/390 uses DB Understanding tablespaces Calculating and monitoring tablespace requirements Parameters for tablespace reporting Considerations when running DRLJTBSR..82 Reorganizing the database Reorg/Discard Utility Purging Utility Backing up the Tioli Decision Support for OS/390 database Determining when to back up the Tioli Decision Support for OS/390 database...88 Determining a leel of backup Determining which tablespaces to back up..88 Recoering from database errors Correcting an out-of-space condition in a Tioli Decision Support for OS/390 tablespace or indexspace Correcting corrupted data in the Tioli Decision Support for OS/390 database...89 Monitoring the size of the Tioli Decision Support for OS/390 database Understanding how Tioli Decision Support for OS/390 uses DB2 locking and concurrency...91 Maintaining database security Monitoring database access Using aailable tools to work with the Tioli Decision Support for OS/390 database Administering lookup and control tables Administering reports Running reports in batch Specifying batch settings Understanding output options for batch reports Defining report queries and forms for batch execution Using job DRLJBATR to run reports in batch 95 Using the reporting dialog to run reports in batch Parameters for batch reporting Saing reports for reporting dialog users Including saed charts in BookMaster documents QMF batch reporting Creating report groups Administering problem records Reiewing exceptions and generating problem records Generating problem records in batch Chapter 5. Working with components 105 Installing, deinstalling, or migrating a component 106 Migrating a component Installing a component Installing the component online Installing the component in batch mode..113 Test the component to erify its proper installation Deinstalling a component Working with a component definition Controlling objects that you hae modified..117 Creating alter statements for user-modified objects How to use modification flags Update processor Record processor Log processor Record procedure processor How to create customized alter statements 131 Summary of object change flags Listing the modified objects Viewing objects in a component Viewing or editing an object definition Adding an object to a component Deleting an object from a component Excluding an object from a component installation Including an object in a component installation 139 Deleting a component Creating a component Chapter 6. Working with log and record definitions Working with the contents of logs Viewing a list of log data sets collected Deleting a log data set Collecting data from a log into DB2 tables Displaying log statistics Displaying the contents of a log Creating a report on a record Working with log definitions Viewing and modifying a log definition Working with header fields Creating a log definition Deleting a log definition Working with record definitions in a log Viewing and modifying a record definition Working with fields in a record definition Working with sections in a record definition Creating a record definition Displaying update definitions associated with a record Deleting a record definition i Tioli Decision Support for OS/390: Administration Guide

7 Viewing and modifying a record procedure definition Creating a record procedure definition Deleting a record procedure definition Chapter 7. Working with tables and update definitions Working with data in tables Displaying the contents of a table Editing the contents of a table Showing the size of a table Recalculating the contents of a table Importing the contents of an IXF file to a table 172 Exporting table data to an IXF file Purging a table Unloading and loading tables Integration with DB2 High Performance Unload 176 Running DB2 High Performance Unload utility Sample control statement for DB2 High Performance Unload utility Working with tables and update definitions Opening a table to display columns Displaying and modifying a column definition Adding a column to a table Displaying and adding a table index Deleting a table index Displaying and modifying update definitions of a table Working with abbreiations Modifying a distribution clause Modifying an apply schedule clause Displaying and editing the purge condition of a table Displaying and modifying a table or indexspace 192 Displaying a iew definition Printing a list of Tioli Decision Support for OS/390 tables Saing a table definition in a data set Listing a subset of tables in the Tables window 198 Creating a table Deleting a table or iew Creating a tablespace Creating an update definition Deleting an update definition Administering user access to tables Documenting a table Chapter 8. Working with the log data manager option Summary of how the log data manager is used Inoking the log data manager Job step for recording a log data set for collection 208 Using the DRLJLDML job step DRLJLDML sample job Setting the parameters for job DRLJLDML Modifying log collector statements Listing the data sets containing collect statements Editing the collect statements Modifying Tioli Decision Support for OS/390-supplied collect statements Adding a log ID and collect statements data set 213 Changing the collect statements data set name 214 Listing and modifying the list of log data sets to be collected Listing the log data sets to be collected Modifying the log ID for a log data set Deleting information about a log data set Recording a log data set to be collected again 216 Adding a log data set to be collected The collect job and the parameters it uses Deciding which log data sets to collect Concatenation of log data sets Running collect jobs in parallel DRLELDMC sample job Setting the parameters for job DRLJLDMC Modifying the list of successfully collected log data sets Viewing the information about successfully collected log data sets Viewing the dump data set Changing the retention period of information about a log data set Deleting the information about a log data set 222 Modifying the list of unsuccessfully collected log data sets Viewing the unsuccessfully collected log data set Viewing the dump data set Recording a log data set to be collected again 223 Deleting the information about a log data set 224 Part 3. Appendixes Appendix A. System tables and iews 227 Log collector system tables DRLEXPRESSIONS DRLFIELDS DRLLDM_COLLECTSTMT DRLLDM_LOGDATASETS DRLLOGDATASETS DRLLOGS DRLPURGECOND DRLRECORDPROCS DRLRECORDS DRLRPROCINPUT DRLSECTIONS DRLUPDATECOLS DRLUPDATEDISTR DRLUPDATELETS DRLUPDATES Dialog system tables DRLCHARTS DRLCOMPONENTS DRLCOMP_OBJECTS DRLCOMP_PARTS DRLGROUPS DRLGROUP_REPORTS Contents

8 DRLMIGRATION DRLREPORTS DRLREPORT_ATTR DRLREPORT_COLUMNS DRLREPORT_QUERIES DRLREPORT_TEXT DRLREPORT_VARS DRLSEARCH_ATTR DRLSEARCHES Views on DB2 and QMF tables Views on Tioli Decision Support for OS/390 system tables Appendix B. Control tables and common tables Control tables DAY_OF_WEEK Example of table contents: PERIOD_PLAN Example of table contents: SCHEDULE Example of table contents: SPECIAL_DAY Example of table contents: CICS control tables CICS_DICTIONARY CICS_FIELD Common data tables Naming standard for common data tables 249 AVAILABILITY_D, _W, _M AVAILABILITY_T EXCEPTION_T Common lookup tables AVAILABILITY_PARM Example of table contents: USER_GROUP Example of table contents: Appendix C. Sample components Sample Component SAMPLE_H, _M data tables SAMPLE_USER lookup table Example of table contents Sample Interal Job/Step Accounting Component 255 SMF30_JOBADDR_T,_H,_D,_M Data Tables SMF30_JOBSTEP_T, Data Table SMF30_STEP_SLA_LK Lookup Table SMF30_SYSID_LK Lookup Table SMF30_JOBSTEP_TV View Sample Components reports Sample Component reports Sample Report Sample Report Sample Report Sample Interal Job/Step Accounting Component reports Report 1: Job Daily Resource Consumption 271 Report 2: Job Step Duration and CPU Consumption Appendix D. Record definitions supplied with Tioli Decision Support for OS/ SMF records DFSHS/RMM records IMS SLDS records DCOLLECT records EREP records OPC records VM accounting records VMPRF records Appendix E. Naming conention for Tioli Decision Support for OS/390 definition members Naming conention for members of DRL160.SDRLDEFS Naming conention for members of DRL160.SDRLRENU Appendix F. Migrating from SLR ersion Considerations when migrating from SLR to Tioli Decision Support for OS/ Setting migration parameters Setting migration parameters for tables Setting migration parameters for reports Migrating SLR V3 data to Tioli Decision Support for OS/390 predefined tables Migrating SLR V3 tables to Tioli Decision Support for OS/390 user-defined tables Editing the migration job for Tioli Decision Support for OS/390 user-defined tables Job step Job steps 3 and Migrating SLR record build exits Migrating reports Checking the output Running the report definition statements Report migration reference information Graphic reports Views Appendix G. Using the REXX-SQL interface Calling the DRL1SQLX module Input REXX ariables Output REXX ariables Resered REXX ariable REXX example of calling DRL1SQLX Appendix H. Administration dialog options and commands Tioli Decision Support for OS/390 dialog options 315 Tioli Decision Support for OS/390 commands Appendix I. Installation reference DRLFPROF user-modifiable area i Tioli Decision Support for OS/390: Administration Guide

9 Oeriew of the Dialog Parameters window Dialog Parameters when QMF is used Dialog Parameters when QMF is not used Dialog parameters and descriptions Allocation oeriew Appendix J. Migrating Components from Earlier Releases Jobs you must run before migrating from CICS Performance feature statistics component migration jobs CICS Performance feature unit-of-work component migration jobs CICS Partitioning feature statistics component migration jobs CICS Partitioning feature unit-of-work component migration job DB2 component migration job Distributed Monitor component (Sentry) migration job MVS component migration jobs MVS Performance Management component migration jobs RAFBATCH and RAFJOBLOG tables migration job Resource Accounting component migration job 349 TWS for z/os-opc component migration job 349 IMS component migration job Migrate MVS aailability from MVS component into MVS aailability component job DFSMS component migration job Jobs you must run to restructure and migrate the OS/400 component OS/400 component restructuring job OS/400 component migration job Jobs you must run to restructure tablespaces for CICS, IMS and MVS components MVS Performance Management component migration job MVS component migration job CICS component migration jobs IMS Collect component migration jobs Job you must run to change the bufferpool Jobs you must run before migrating from IXFP_SUBSYSTEM_H, _D, _M tables migration job MVS component migration job RAFBATCH and RAFJOBLOG tables migration job MVS performance Management component migration job Migrate NPM/IP from NPM Transit Time component into NPM/IP component job RACF component migration job TWS for z/os-opc component migration job 355 IMS component migration job Migrate MVS aailability from MVS component into MVS aailability component job DFSMS component migration job Jobs you must run before migrating from RACF component migration job MVS performance Management component migration job TWS for z/os-opc component migration job 356 IMS component migration job Migrate MVS aailability from MVS component into MVS aailability component job Migrate NPM/IP from NPM Transit Time component into NPM/IP component job DFSMS component migration job Component objects modified for migration from to Accounting feature objects modified by migration from CICS Partitioning feature objects modified by migration from CICS Performance feature objects modified by migration from Distributed Monitoring component (Sentry) objects modified by migration from IMS feature objects modified by migration from Network Performance feature objects modified by migration from System Performance feature objects modified by migration from Workstation Performance feature objects modified by migration from Component objects modified for migration from to CICS Partitioning feature objects modified by migration from CICS Performance feature objects modified by migration from IMS feature objects modified by migration from Network Performance feature objects modified by migration from System Performance feature objects modified by migration from Component objects modified for migration from to Network Performance feature objects modified by migration from System Performance feature objects modified by migration from Objects deleted by OS/400 component restructuring Tioli Decision Support for OS/390 objects modified by the migration to the restructured tablespace design CICS Performance feature objects IMS Collect component System Performance feature objects Actions required to migrate modified objects Process Tioli Decision Support for OS/390 Statements window Appendix K. Administration reports 407 PRA001 - Indexspace cross-reference PRA002 - Actual tablespace allocation PRA003 - Table purge condition Contents ii

10 PRA004 - List columns for a requested table with comments PRA005 - List all tables with comments PRA006 - List User Modified Objects Appendix L. Accessibility Appendix M. List of abbreiations Notices Trademarks Glossary Index iii Tioli Decision Support for OS/390: Administration Guide

11 Figures 1. Tioli Decision Support for OS/390 oeriew 4 2. Oeriew of Tioli Decision Support for OS/390 data flow Introducing the Administration dialog DRLJDBIN job (member of DRL161.SDRLCNTL) (Part 1 of 3) DRLJDBIN job (member of DRL161.SDRLCNTL) (Part 2 of 3) DRLJDBIN job (member of DRL161.SDRLCNTL) (Part 3 of 3) DRLJDBIP job (member of DRL160.SDRLCNTL) (Part 1 of 2) DRLJDBIP job (member of DRL160.SDRLCNTL) (Part 2 of 2) Tioli Decision Support for OS/390 Primary Menu Administration window System window Dialog Parameters window System Tables window System window Logs window Collect window Reports window Data Selection window System Tables window Tioli Decision Support for OS/390 definition member DRLISAMP defining component definitions Tioli Decision Support for OS/390 definition member DRLLSAMP defining a log type Tioli Decision Support for OS/390 definition member DRLRSAMP defining a record type Tioli Decision Support for OS/390 definition member DRLSSAMP defining a tablespace Tioli Decision Support for OS/390 definition member DRLTSAMP defining tables and updates (Part 1 of 2) Tioli Decision Support for OS/390 definition member DRLTSAMP defining tables and updates (Part 2 of 2) Tioli Decision Support for OS/390 definition member DRLOSAMP defining reports and report groups Tioli Decision Support for OS/390 definition member DRLQSA01 report query Inoking the log collector in batch to collect data Field Definition window Record Definition window Process Tioli Decision Support for OS/390 Statements window Result of processing log collector language statements DRLJCOLL job for collecting data from an SMF data set (Part 1 of 2) DRLJCOLL job for collecting data from an SMF data set (Part 2 of 2) Sample collect messages Collect Statistics window DB2 enironment for the Tioli Decision Support for OS/390 database Tablespace list window DRLJTBSR job that reports tablespace requirements Sample output for DRLJTBSR Tables window Tablespace list window DRLJPURG job that uses all purge conditions Tables window DRLJCOPY job for backing up Tioli Decision Support for OS/390 tablespaces DRLJRUNS job for generating DB2 statistics DB2I Primary Option Menu DRLJBATR job for printing or saing reports in batch (Part 1 of 2) DRLJBATR job for printing or saing reports in batch (Part 2 of 2) Conerting saed graphic report data to a page segment Using reports in BookMaster documents Using QMF to report in batch DRLJEXCE job for generating problem records Components window Space pull-down Installation Options window Sample log collector messages Lookup Tables window Editing an installation job Select Table window Tables window Components window User Modified Members window User Modified Members window User Modified Members window Component window Logs window Data Sets window Collect Statistics window Collect window Sample log statistics output Record Data window List Record window Output from List record function Log Definition window Record Definitions window Record Definition window Field Definition window Section Definition window Record Procedure Definition window Tables window ix

12 82. Using QMF to display a Tioli Decision Support for OS/390 table Editing a table in ISPF Table Size window Recalculate window Condition window Column Values window Selecting tables to unload Unload Utility window Utilities pull-down DB2 High Performance Unload utility Table window Column Definition window Add Column window Indexes window Index window Add Index window Update Definitions window Update Definition window Abbreiations window Distribution window Apply Schedule window Retention Period window Purge Condition window Tablespaces window Tablespace window Indexes window Index window Tablespace window View window New Table window New Tablespace window New Update Definition window Grant Priilege window Reoke Priilege window Log Data Manager Main Selection window DRLJLDML job (Part 1 of 2) DRLJLDML job (Part 2 of 2) Collect Statements window Edit collect statements window Add Collect Statements Definition window Modify Collect Statements Definition window SMF Log Data Sets To Be Collected window Modify Log ID For a Log Data Set window Add a Data Set To Be Collected window DRLJLDMC (Part 1 of 2) DRLJLDMC (Part 2 of 2) Log Data Sets Collected Successfully window Retention Period window Log Data Sets Collected with Failure window Sample data flow Sample Interal Job/Step Accounting Data Flow Sample Report Sample Report Sample Report Sample Interal Job/Steo Accounting sample Report JOBAS Sample Interal Job/Step Accounting sample Report JOBST Migration window Migration Parameters for Table Migration window Migration Parameters for Reports window Predefined Tables window SLR V3 Table Conersion window Conert SLR V3 reports to Tioli Decision Support for OS/390 reports window Statements for the cross-reference list The original SLR report commands SLR commands conerted to Tioli Decision Support for OS/390 SQL Generated Tioli Decision Support for OS/390 with cross-reference listing applied The form generated The form in QMF Process Tioli Decision Support for OS/390 Statements window Tioli Decision Support for OS/390 report creation Example of REXX-SQL interface call DRLFPROF the dialog initialization data set (Part 1 of 8) DRLFPROF the dialog initialization dat set (PART 2 of 8) DRLFPROF the dialog initialization data set (PART 3 of 8) DRLFPROF the dialog initialization data set (PART 4 of 8) DRLFPROF the dialog initialization data set (PART 5 of 8) DRLFPROF the dialog initialization data set (PART 6 of 8) DRLFPROF (PART 7 of 8) the dialog initialization data set DRLFPROF the dialog initialization data set (PART 8 of 8) Dialog Parameters window when QMF is used Dialog Parameters window when QMF is not used Process Tioli Decision Support for OS/390 Statements window Part of an Indexspace Cross-reference Report Part of an Actual Tablespace Allocation Report Part of a Table Purge Condition Report Example of List columns for a requested table with comment Example of List all tables with comment 412 x Tioli Decision Support for OS/390: Administration Guide

13 Preface Who should read this book This book proides an introduction to IBM Tioli Decision Support for OS/390 (hereafter referred to as Tioli Decision Support for OS/390), the administration dialog, and the reporting dialog. It describes procedures for installing the base product and its features and for administering Tioli Decision Support for OS/390 through routine batch jobs and the administration dialog. Tioli Decision Support for OS/390 was preiously known as Tioli Performance Reporter for OS/390. The terms MVS and OS/390 are used interchangeably throughout this book. The Administration Guide is for the Tioli Decision Support for OS/390 administrator, the person who initializes the Tioli Decision Support for OS/390 database and customizes and administers Tioli Decision Support for OS/390. Readers should be familiar with: DB2 and its utilities What this book contains Query Management Facility (QMF ), if QMF is used with Tioli Decision Support for OS/390 Time Sharing Option Extensions (TSO/E) Restructured Extended Executor (REXX) language Job control language (JCL) Interactie System Productiity Facility/Program Deelopment Facility (ISPF/PDF) and its dialog manager functions Use this book as a guide by reading Part I and Part II. Use the remaining sections of the book as a reference. The book contains these parts, chapters and appendixes: Part I. Getting started Chapter 1, Understanding Tioli Decision Support for OS/390 proides an oeriew of Tioli Decision Support for OS/390 and its features. Chapter 2, Installing Tioli Decision Support for OS/390 describes how to complete the installation of Tioli Decision Support for OS/390, including information about how to migrate from an earlier release or modification leel of Tioli Decision Support for OS/390 and a summary of installation prerequisites for hardware and software. Chapter 3, Oeriew of defining Tioli Decision Support for OS/390 objects describes how to create Tioli Decision Support for OS/390 definitions using Tioli Decision Support for OS/390 dialogs or languages. Part II. Administering Tioli Decision Support for OS/390 Chapter 4, Setting up operating routines describes running routine batch jobs for such tasks as collecting data, administering the Tioli Decision Support for OS/390 database, and producing reports. xi

14 Preface Chapter 5, Working with components describes how to work with parts of a Tioli Decision Support for OS/390 feature, including installing and changing them. It also contains information about how to migrate from an earlier release or modification leel of Tioli Decision Support for OS/390. Chapter 6, Working with log and record definitions describes how to work with definitions for log data sets and the records within those data sets. Chapter 7, Working with tables and update definitions describes how to work with data tables, lookup tables, and the flow of data from log data sets to data tables. It also explains how to purge unneeded data from data tables. Chapter 8, Working with the log data manager option describes how to use the log data manager option to automate the collection of data. Part III. Appendixes Appendix A, System tables and iews describes system tables, which contain definitions for logs, records, updates, and other Tioli Decision Support for OS/390 objects, and iews of DB2 and QMF tables. Appendix B, Control tables and common tables describes data tables and lookup tables used by most components of Tioli Decision Support for OS/390. It also describes tables that define holidays, shifts, and operating objecties to Tioli Decision Support for OS/390. Appendix C, Sample components describes a simplified component that is shipped with the base and can be used to erify Tioli Decision Support for OS/390 installation. You can use the Sample component to demonstrate the collection and reporting process. Appendix D, Record definitions supplied with Tioli Decision Support for OS/390 lists predefined Tioli Decision Support for OS/390 definitions for record types in log data sets. Appendix E, Naming conention for Tioli Decision Support for OS/390 definition members describes the naming standard of members in the Tioli Decision Support for OS/390 definitions library. Appendix F, Migrating from SLR ersion 3.3 describes how to migrate Serice Leel Reporter (SLR) Version 3.3 tables and reports to Tioli Decision Support for OS/390. Appendix G, Using the REXX-SQL interface describes how to code REXX programs that call a Tioli Decision Support for OS/390 module to retriee DB2 data. Appendix H, Administration dialog options and commands describes Tioli Decision Support for OS/390 administration dialog primary window pull-down options and Tioli Decision Support for OS/390 commands you can use from windows with a command line. Appendix I, Installation reference describes Tioli Decision Support for OS/390 data sets and initialization parameters used during installation. Appendix J, Migrating Components from Earlier Releases describes how to migrate component objects for Tioli Decision Support for OS/390 from to 1.6.0, from to and from to Appendix K, Administration reports describes the administration reports that map indexspaces to indexes, check tablespace allocation and list current purge criteria. Appendix L, Accessibility features help a user who has a physical disability, such as restricted mobility or limited ision, to use software products successfully. xii Tioli Decision Support for OS/390: Administration Guide

15 Preface A list of abbreiations, glossary, and index follow the appendixes. Publications This section lists publications in the Tioli Decision Support for OS/390 library and any other related documents. It also describes how to access Tioli publications online and how to order Tioli publications. Tioli Decision Support for OS/390 library The following documents are aailable in the Tioli Decision Support for OS/390 library: Administration Guide, SH Proides information about initializing the Tioli Decision Support for OS/390 database and customizing and administering Tioli Decision Support for OS/390. Guide to the Reporting Dialog, SH Proides 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. Language Guide and Reference, SH Proides information for administrators, performance analysts, and programmers who are responsible for maintaining system log data and reports. User s Guide for the Viewer, SH Proides information about how use the graphical interface for Tioli Decision Support for OS/390. Messages and Problem Determination, SH Proides information to help operators and system programmers understand, interpret, and respond to Tioli Decision Support for OS/390 messages and codes. Accounting Feature for the Host, SH Proides information for users who want to use Tioli Decision Support for OS/390 to collect and report performance data generated by the Accounting feature. Accounting Feature for the Workstation, SH Proides information for users who want to use the Accounting Workstation Option to manage, process, and analyze financial data on a workstation. AS/400 System Performance Feature Guide and Reference, SH Proides information for administrators and users about collecting and reporting performance data generated by AS/400 systems. CICS Performance Feature Guide and Reference, SH Proides 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 Proides information for administrators and users about collecting and reporting performance data generated by operating systems and applications running on a workstation. IMS Performance Feature Guide and Reference, SH Proides information for administrators and users about collecting and reporting performance data generated by Information Management System (IMS). Preface xiii

16 Preface Network Performance Feature Installation and Administration, SH Proides information for network analysts or programmers who are responsible for setting up the network reporting enironment. Network Performance Feature Reference, SH Proides information for network analysts or programmers who are responsible for setting up the network reporting enironment. Network Performance Feature Reports, SH Proides information for network analysts or programmers who use the Network Performance feature reports. System Performance Feature Guide, SH Proides information for performance analysts and system programmers who are responsible for meeting the serice-leel objecties established in your organization. System Performance Feature Reference Volume I, SH Proides information for administrators and users with a ariety of backgrounds who want to use Tioli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS) or Virtual Machine (VM) performance data. System Performance Feature Reference Volume II, SH Proides information for administrators and users with a ariety of backgrounds who want to use Tioli Decision Support for OS/390 to analyze Multiple Virtual Storage (MVS) or Virtual Machine (VM) performance data. IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T-6700 CD containing all OS/390 documentation. IBM Online Library z/os Software Products Collection Kit, SK3T-4270 CD containing all z/os documentation. 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 conentional 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 Serices running OMVS). The LookAt Web site also features a mobile edition of LookAt for deices such as Pocket PCs, Palm OS, or Linux-based handhelds. So, if you hae a handheld deice with wireless access and an Internet browser, you can now access LookAt message information from almost anywhere. Accessing publications online IBM posts publications for this and all other Tioli products, as they become aailable and wheneer they are updated, to the Tioli Software Information Center Web site. The Tioli Software Information Center is located at the following Web address: xi Tioli Decision Support for OS/390: Administration Guide

17 Preface Accessibility Click the Tioli Decision Support for OS/390 link to access the product library. These publications are aailable in PDF or HTML format, or both. Translated documents are also aailable 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 aailable 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 Tioli publications online at the following Web site: cgibin/pbi.cgi You can also order by telephone by calling one of these numbers: In the United States: In Canada: Contacting software support 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 ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate 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 Appendix L, Accessibility, on page 417 of this Tioli Decision Support for OS/390 guide. If you hae a problem with any Tioli 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: The guide proides information about how to contact IBM Software Support, depending on the seerity of your problem, and the following information: Registration and eligibility Telephone numbers and addresses, depending on the country in which you are located Information you must hae before contacting IBM Software Support Preface x

18 Preface Note: For Tioli NetView for OS/390 customers only, additional support is aailable on the NETVIEW CFORUM (Customer Forum) through the IBMLink system. This forum is monitored by NetView deelopers who answer questions and proide guidance. When a problem with the code is found, you are asked to open an official problem management record (PMR) to obtain resolution. Conentions used in this book This guide uses seeral conentions 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. Typeface conentions This guide uses the following typeface conentions: Bold Italic Changes in this edition Lowercase commands and mixed case commands that are otherwise difficult to distinguish from surrounding text 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:) Column headings in a table Keywords and parameters in text Citations (titles of books, diskettes, and CDs) Words defined in text Emphasis of words (words as words) Letters as letters New terms in text (except in a definition list) Variables and alues you must proide Monospace Examples and code examples File names, programming keywords, and other elements that are difficult to distinguish from surrounding text Message text and prompts addressed to the user Text that the user must type Values for arguments or command options This edition is an updated ersion that replaces the preious edition of the same book. The changes are: Information about database reorganization has been added in Chapter 4, Setting up operating routines and Chapter 7, Working with tables and update definitions. A new utility, REORG/DISCARD, has been added and described in the same chapters. xi Tioli Decision Support for OS/390: Administration Guide

19 Preface Information has been added about creating alter statements for user-modified objects in Chapter 5, Working with components. Information has been added about loading and unloading functions, in Chapter 7, Working with tables and update definitions. New tables and reports hae been added in Appendix C, Sample components, on page 253 about the new Sample Interal Job/Step Accounting Component. Appendix J, Migrating Components from Earlier Releases has been updated with new information. A new report has been added in Appendix K, Administration reports, on page 407. Appendix L, Accessibility has been added. Except for editorial changes, updates to this edition are marked with a ertical bar to the left of the change. Preface xii

20 xiii Tioli Decision Support for OS/390: Administration Guide

21 Part 1. Getting started Chapter 1. Understanding Tioli Decision Support for OS/ Introduction to Tioli Decision Support for OS/390.3 Introduction to Tioli Decision Support for OS/390 performance features Introduction to the log collector Log definitions Record definitions Update definitions Table definitions Log and record procedures Collect process Introduction to the Tioli Decision Support for OS/390 database Introduction to the administration dialog Introduction to the reporting dialog Chapter 2. Installing Tioli Decision Support for OS/ Installation prerequisites Hardware prerequisites Software prerequisites Considerations when migrating from an earlier release or modification leel of Tioli Decision Support for OS/ Migrating the Tioli Decision Support for OS/390 base to the latest leel Step 1: Reiew the results of the SMP/E installation 16 Tioli Decision Support for OS/390 data sets..16 Local data sets Language-dependent Tioli Decision Support for OS/390 data sets Step 2: Set up security Tioli Decision Support for OS/390 security using secondary authorization IDs What to do Tioli Decision Support for OS/390 security without secondary authorization IDs Installation steps when secondary user IDs are not used Step 3: Initialize the DB2 database Initializing DB2 database when installing Tioli Decision Support for OS/390 for first time...21 DRLJDBIN job Customization considerations for the CICS Partitioning feature DRLJDBIP job Step 4: Prepare the dialog and update the dialog profile Step 5: Set personal dialog parameters Step 6: Create or update system tables Step 7: Set up QMF Step 8: Set up BookManager Step 9: Customize JCL Step 10: Test the installation of the Tioli Decision Support for OS/390 base Step 11: Reiew DB2 parameters Step 12: Install components Installing other Tioli Decision Support for OS/390 systems Installing Tioli Decision Support for OS/390 features separately Enabling the Tioli Data Warehouse Chapter 3. Oeriew of defining Tioli Decision Support for OS/390 objects How Tioli Decision Support for OS/390 component installation works Defining definition library members with SQL..51 How Tioli Decision Support for OS/390 controls object replacement How Tioli Decision Support for OS/390 determines installation order Defining logs with log collector language...54 Defining records with log collector language..54 Defining tablespaces Defining tables and updates Defining updates and iews Defining reports Collecting data Collecting data through the administration dialog 60 Using log collector language to collect data...61 Adding a field to a record definition Using the administration dialog to add a field definition Using log collector language to add the field definition