Tivoli Decision Support for OS/390 Administration Guide. Version SH

Transcription

1 Tivoli Decision Support for OS/390 Administration Guide Version SH

2

3 Tivoli Decision Support for OS/390 Administration Guide Version SH

4 Tivoli Decision Support for OS/390 Administration Guide, Version Copyright Notice Copyright IBM Corporation 1993, 2001 All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Right Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Trademarks IBM, Tivoli, the Tivoli logo, ACF/VTAM, AIX, AS/400, BookManager, BookMaster, CICS, CICS/ESA, CICS/MVS, Common User Access, CUA, DATABASE 2, DB2, DFSMS/MVS, GDDM, IBMLink, IMS, MQSeries, MVS, MVS/ESA, MVS/XA, NetView, OpenEdition, Operating System/2, OS/2, OS/390, OS/400, QMF, RACF, RMF, S/390, SP, VM/ESA, VTAM, and z/os are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both. Windows and Windows NT are registered trademarks of Microsoft Corporation. UNIX is a registered trademark of the Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. Notices References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to valid intellectual property or other legally protectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York , U.S.A. ISO 9001 Certification This product was developed using an ISO 9001 certified quality system. Certification has been awarded by Bureau Veritas Quality International (BVQI) (Certification No. BVQI / A). BVQI is a world leader in quality certification and is currently recognized by more than 20 accreditation bodies.

5 Contents Figures... xvii Preface... xxi Who Should Read This Book... xxi What This Book Contains.... xxi Publications... xxiii Tivoli Decision Support for OS/390 Library... xxiii Accessing Publications Online... xxiv Ordering Publications... xxiv Providing Feedback about Publications... xxv Contacting Customer Support.... xxv Using LookAt to Look Up Message Explanations... xxv Conventions Used in This Book... xxvi Changes in This Edition... xxvi Changes in the Previous Edition... xxvi Part I. Getting started... 1 Chapter 1. Understanding Tivoli Decision Support for OS/ Introduction to Tivoli Decision Support for OS/ Introduction to Tivoli Decision Support for OS/390 performance features Introduction to the log collector Log definitions... 5 Record definitions... 5 Update definitions... 6 Table definitions... 6 Log and record procedures... 6 Collect process... 6 Introduction to the Tivoli Decision Support for OS/390 database... 9 Introduction to the administration dialog Introduction to the reporting dialog Chapter 2. Installing Tivoli Decision Support for OS/ Installation prerequisites Hardware prerequisites Software prerequisites Administration Guide iii

6 Considerations when migrating from an earlier release or modification level of Tivoli Decision Support for OS/ Migrating the Tivoli Decision Support for OS/390 base to the latest level Step 1: Review the results of the SMP/E installation Tivoli Decision Support for OS/390 data sets Local data sets Language-dependent Tivoli Decision Support for OS/390 data sets Step 2: Set up security Tivoli Decision Support for OS/390 security using secondary authorization IDs Whattodo Tivoli 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 Tivoli Decision Support for OS/390 for first time 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 Tivoli Decision Support for OS/390 base Step 11: Review DB2 parameters Step 12: Install components Installing other Tivoli Decision Support for OS/390 systems Installing Tivoli Decision Support for OS/390 features separately Chapter 3. Overview of defining Tivoli Decision Support for OS/390 objects How Tivoli Decision Support for OS/390 component installation works Defining definition library members with SQL How Tivoli Decision Support for OS/390 controls object replacement How Tivoli Decision Support for OS/390 determines installation order Defining logs with log collector language Defining records with log collector language Defining tablespaces iv Version 1.5.1

7 Defining tables and updates Defining updates and views Defining reports Collecting data Collecting data through the administration dialog Using log collector language to collect data 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 II. Administering Tivoli Decision Support for OS/ Chapter 4. Setting up operating routines Collecting log data Collecting data from IMS Collecting data from Tivoli Service Desk Collecting network configuration data Performing routine data collection Monitoring collect activity Sample collect messages Using collect messages Reviewing log statistics Using the DRLLOGDATASETS table Improving collect performance Administering the Tivoli Decision Support for OS/390 database Understanding DB2 concepts Understanding how Tivoli Decision Support for OS/390 uses DB Understanding tablespaces Calculating and monitoring tablespace requirements Parameters for tablespace reporting Considerations when running DRLJTBSR Purging and reorganizing the database Backing up the Tivoli Decision Support for OS/390 database Determining when to back up the Tivoli Decision Support for OS/390 database Determining a level of backup Determining which tablespaces to back up Recovering from database errors Correcting an out-of-space condition in a Tivoli Decision Support for OS/390 tablespace or indexspace Correcting corrupted data in the Tivoli Decision Support for OS/390 database Administration Guide v

8 Monitoring the size of the Tivoli Decision Support for OS/390 database Understanding how Tivoli Decision Support for OS/390 uses DB2 locking and concurrency 90 Maintaining database security Monitoring database access Using available tools to work with the Tivoli 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 Using the reporting dialog to run reports in batch Parameters for batch reporting Saving reports for reporting dialog users Including saved charts in BookMaster documents QMF batch reporting Creating report groups Administering problem records Reviewing exceptions and generating problem records Generating problem records in batch Chapter 5. Working with components Installing, deinstalling, or migrating a component Migrating a component Installing a component Installing the component online Installing the component in batch mode Test the component to verify its proper installation Deinstalling a component Working with a component definition Controlling objects that you have modified 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 Deleting a component vi Version 1.5.1

9 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 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 Exporting table data to an IXF file Purging a table Unloading and loading tables Working with tables and update definitions Opening a table to display columns Displaying and modifying a column definition Adding a column to a table Administration Guide vii

10 Displaying and adding a table index Deleting a table index Displaying and modifying update definitions of a table Working with abbreviations 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 Displaying a view definition Printing a list of Tivoli Decision Support for OS/390 tables Saving a table definition in a data set Listing a subset of tables in the Tables window Creating a table Deleting a table or view 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 Invoking the log data manager Job step for recording a log data set for collection 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 Tivoli Decision Support for OS/390-supplied collect statements Adding a log ID and collect statements data set Changing the collect statements data set name 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 Adding a log data set to be collected viii Version 1.5.1

11 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 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 Deleting the information about a log data set Part III. Appendixes Appendix A. System tables and views 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 Administration Guide ix

12 DRLCOMP_PARTS DRLGROUPS DRLGROUP_REPORTS DRLMIGRATION DRLREPORTS DRLREPORT_ATTR DRLREPORT_COLUMNS DRLREPORT_QUERIES DRLREPORT_TEXT DRLREPORT_VARS DRLSEARCH_ATTR DRLSEARCHES Views on DB2 and QMF tables Views on Tivoli 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 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 component x Version 1.5.1

13 SAMPLE_H, _M data tables SAMPLE_USER lookup table Example of table contents Sample component reports Sample Report Sample Report Sample Report Appendix D. Record definitions supplied with Tivoli 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 convention for Tivoli Decision Support for OS/390 definition members Naming convention for members of DRL151.SDRLDEFS Naming convention for members of DRL151.SDRLRENU Appendix F. Migrating from SLR version Considerations when migrating from SLR to Tivoli Decision Support for OS/ Setting migration parameters Setting migration parameters for tables Setting migration parameters for reports Migrating SLR V3 data to Tivoli Decision Support for OS/390 predefined tables Migrating SLR V3 tables to Tivoli Decision Support for OS/390 user-defined tables Editing the migration job for Tivoli 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 Administration Guide xi

14 Graphic reports Views Appendix G. Using the REXX-SQL interface Calling the DRL1SQLX module Input REXX variables Output REXX variables Reserved REXX variable REXX example of calling DRL1SQLX Appendix H. Installation reference DRLEINI1 listing user-modifiable area DRLEINIT listing user-modifiable area Overview of the Dialog Parameters window Dialog Parameters when QMF is used Dialog Parameters when QMF is not used Dialog parameters and descriptions Allocation overview Appendix I. Administration dialog options and commands Tivoli Decision Support for OS/390 dialog options Tivoli Decision Support for OS/390 commands Appendix J. Migrating Components from Earlier Releases Jobs you must run before migrating from Capacity Planner feature migration job CICS Performance feature monitoring component migration jobs Running the insert statements Jobs CICS Performance feature statistics component migration jobs CICS Performance feature unit-of-work component migration jobs DB2 component migration job Distributed Monitor component migration job MVS component migration jobs MVS Performance Management component migration jobs Network Performance feature migration job Resource Accounting component migration job System Table DRLREPORTS UNIX Accounting component migration job Jobs you must run before migrating from xii Version 1.5.1

15 CICS Performance feature monitoring component migration jobs Running the insert statements Jobs CICS Performance feature statistics component migration jobs CICS Performance feature unit-of-work component migration jobs DB2 component migration job Distributed Monitor component migration job MVS component migration job MVS Performance Management component migration jobs RAFBATCH and RAFJOBLOG tables migration job Resource Accounting component migration job UNIX Accounting component migration job Jobs you must run before migrating from CICS Performance feature monitoring component migration jobs Running the insert statements Jobs CICS Performance feature statistics component migration jobs CICS Performance feature unit-of-work component migration jobs CICS Partitioning feature monitoring component migration jobs Running the insert statements 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 Jobs you must run to restructure and migrate the OS/400 component OS/400 component restructuring job OS/400 component migration job Job you must run to restructure tables for the Resource Accounting component 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 Administration Guide xiii

16 Jobs you must run before migrating from CICS_DICTIONARY table migration job IXFP_SUBSYSTEM_H, _D, _M tables migration job MVS component migration job RAFBATCH and RAFJOBLOG tables migration job Component objects modified for migration from to Accounting 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 (new name for UNIX feature) Component objects modified for migration from to Accounting 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 (new name for UNIX feature) 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 Objects deleted by OS/400 component restructuring xiv Version 1.5.1

17 Tivoli 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 Tivoli Decision Support for OS/390 Statements window Appendix K. Administration reports PRA001 - Indexspace cross-reference PRA002 - Actual tablespace allocation PRA003 - Table purge condition Appendix L. List of abbreviations Glossary Index Administration Guide xv

18 xvi Version 1.5.1

19 Figures 1. Tivoli Decision Support for OS/390 overview Overview of Tivoli Decision Support for OS/390 data flow Introducing the Administration dialog DRLJDBIN job (member of DRL151.SDRLCNTL) (Part 1 of 2) DRLJDBIN job (member of DRL151.SDRLCNTL) (Part 2 of 2) DRLJDBIP job (member of DRL151.SDRLCNTL) (Part 1 of 2) DRLJDBIP job (member of DRL151.SDRLCNTL) (Part 2 of 2) Tivoli 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 Tivoli Decision Support for OS/390 definition member DRLISAMP defining component definitions Tivoli Decision Support for OS/390 definition member DRLLSAMP defining a log type Tivoli Decision Support for OS/390 definition member DRLRSAMP defining a record type Tivoli Decision Support for OS/390 definition member DRLSSAMP defining a tablespace Tivoli Decision Support for OS/390 definition member DRLTSAMP defining tables and updates (Part 1 of 2) Tivoli Decision Support for OS/390 definition member DRLTSAMP defining tables and updates (Part 2 of 2) Tivoli Decision Support for OS/390 definition member DRLOSAMP defining reports and report groups Tivoli Decision Support for OS/390 definition member DRLQSA01 report query Invoking the log collector in batch to collect data Field Definition window Record Definition window Process Tivoli 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 environment for the Tivoli Decision Support for OS/390 database Tablespace list window DRLJTBSR job that reports tablespace requirements Sample output for DRLJTBSR DRLJPURG job that uses all purge conditions Table list window DRLJCOPY job for backing up Tivoli Decision Support for OS/390 tablespaces DRLJRUNS job for generating DB2 statistics DB2I Primary Option Menu DRLJBATR job for printing or saving reports in batch (Part 1 of 2) Administration Guide xvii

20 46. DRLJBATR job for printing or saving reports in batch (Part 2 of 2) Converting saved 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 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 Using QMF to display a Tivoli 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 Table window Column Definition window Add Column window Indexes window Index window Add Index window Update Definitions window Update Definition window Abbreviations window Distribution window Apply Schedule window Retention Period window Purge Condition window Tablespaces window Tablespace window Indexes window xviii Version 1.5.1

21 98. Index window Tablespace window View window New Table window New Tablespace window New Update Definition window Grant Privilege window Revoke Privilege 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 Report Sample Report Sample Report Migration window Migration Parameters for Table Migration window Migration Parameters for Reports window Predefined Tables window SLR V3 Table Conversion window Convert SLR V3 reports to Tivoli Decision Support for OS/390 reports window Statements for the cross-reference list The original SLR report commands SLR commands converted to Tivoli Decision Support for OS/390 SQL Generated Tivoli Decision Support for OS/390 with cross-reference listing applied The form generated The form in QMF Process Tivoli Decision Support for OS/390 Statements window Tivoli Decision Support for OS/390 report creation Example of REXX-SQL interface call DRLEINI1 the dialog initialization exec (Part 1 of 7) DRLEINI1 the dialog initialization exec (Part 2 of 7) DRLEINI1 the dialog initialization exec (Part 3 of 7) DRLEINI1 the dialog initialization exec (Part 4 of 7) DRLEINI1 the dialog initialization exec (Part 5 of 7) DRLEINI1 the dialog initialization exec (Part 6 of 7) DRLEINI1 the dialog initialization exec (Part 7 of 7) DRLEINIT the dialog exec Dialog Parameters window when QMF is used Dialog Parameters window when QMF is not used Administration Guide xix

22 150. Options in the Tivoli Decision Support for OS/390 Administration window Options in the Components window Options in the Logs window Options in the Record Definitions window Options in the Tables window (Part 1 of 2) Options in the Tables window (Part 2 of 2) Process Tivoli 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 xx Version 1.5.1

23 Preface This book provides an introduction to Tivoli 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 Tivoli Decision Support for OS/390 through routine batch jobs and the administration dialog. Tivoli Decision Support for OS/390 was previously known as Tivoli Performance Reporter for OS/390. The terms MVS and OS/390 are used interchangeably throughout this book. Who Should Read This Book The Administration Guide is for the Tivoli Decision Support for OS/390 administrator, the person who initializes the Tivoli Decision Support for OS/390 database and customizes and administers Tivoli Decision Support for OS/390. You should have a working knowledge of: DATABASE 2 (DB2 ) and its utilities Query Management Facility (QMF ) (if QMF is used with Tivoli Decision Support for OS/390) Time Sharing Option Extensions (TSO/E) Restructured Extended Executor (REXX) language Job control language (JCL) Interactive System Productivity Facility/Program Development Facility (ISPF/PDF) and its dialog manager functions What This Book Contains 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 Tivoli Decision Support for OS/390 provides an overview of Tivoli Decision Support for OS/390 and its features. Chapter 2, Installing Tivoli Decision Support for OS/390 describes how to complete the installation of Tivoli Decision Support for OS/390, including information about how to migrate from an earlier release or modification level of Tivoli Decision Support for OS/390 and a summary of installation prerequisites for hardware and software. Chapter 3, Overview of defining Tivoli Decision Support for OS/390 objects describes how to create Tivoli Decision Support for OS/390 definitions using Tivoli Decision Support for OS/390 dialogs or languages. Part II. Administering Tivoli Decision Support for OS/390 Administration Guide xxi

24 Preface Chapter 4, Setting up operating routines describes running routine batch jobs for such tasks as collecting data, administering the Tivoli Decision Support for OS/390 database, and producing reports. Chapter 5, Working with components describes how to work with parts of an Tivoli 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 level of Tivoli 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 views describes system tables, which contain definitions for logs, records, updates, and other Tivoli Decision Support for OS/390 objects, and views of DB2 and QMF tables. Appendix B, Control tables and common tables describes data tables and lookup tables used by most components of Tivoli Decision Support for OS/390. It also describes tables that define holidays, shifts, and operating objectives to Tivoli Decision Support for OS/390. Appendix C, Sample component describes a simplified component that is shipped with the base and can be used to verify Tivoli 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 Tivoli Decision Support for OS/390 lists predefined Tivoli Decision Support for OS/390 definitions for record types in log data sets. Appendix E, Naming convention for Tivoli Decision Support for OS/390 definition members describes the naming standard of members in the Tivoli Decision Support for OS/390 definitions library. Appendix F, Migrating from SLR version 3.3 describes how to migrate Service Level Reporter (SLR) Version 3.3 tables and reports to Tivoli Decision Support for OS/390. Appendix G, Using the REXX-SQL interface describes how to code REXX programs that call a Tivoli Decision Support for OS/390 module to retrieve DB2 data. Appendix H, Installation reference describes Tivoli Decision Support for OS/390 data sets and initialization parameters used during installation. Appendix I, Administration dialog options and commands describes Tivoli Decision Support for OS/390 administration dialog primary window pull-down options and Tivoli Decision Support for OS/390 commands you can use from windows with a command line. Appendix J, Migrating Components from Earlier Releases describes how to migrate component objects for Tivoli Decision Support for OS/390 from 1.2.0, and to 1.5.0, and from to xxii Version 1.5.1

25 Preface Publications Appendix K, Administration reports describes the administration reports that map indexspaces to indexes, check tablespace allocation and list current purge criteria. A list of abbreviations, glossary, and index follow the appendixes. 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 make 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: 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. 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. Language Guide and Reference, SH Provides information for adminstrators, performance analysts, and programmers who are responsible for maintaining system log data and reports. User s Guide for the Viewer, SH Provides information about how use the graphical interface for Tivoli Decision Support for OS/390. 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. 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. 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. 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. Capacity Planner Feature Guide and Reference, SH Provides information about capacity planning and how to install and implement the Capacity Planner. CICS Performance Feature Guide and Reference, SH Provides information for administrators and users about collecting and reporting performance data generated by Customer Information and Control System (CICS ). Distributed Systems Feature Guide and Reference, SH Administration Guide xxiii

26 Preface Provides information for administrators and users about collecting and reporting performance data generated by operating systems and applications running on a workstation. IMS Performamce Feature Guide and Reference, SH Provides information for administrators and users about collecting and reporting performance data generated by Information Management System (IMS). Network Performance Feature Installation and Administration, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. Network Performance Feature Reference, SH Provides information for network analysts or programmers who are responsible for setting up the network reporting environment. Network Performance Feature Reports, SH Provides information for network analysts or programmers who use the Network Performance feature reports. 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. System Performance Feature Reference Volume 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), or OS/2 performance data. System Performance Feature Reference Volume 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), or OS/2 performance data. IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T-6700 (available March 2002) CD containing all OS/390 documentation. IBM Online Library z/os Software Products Collection Kit, SK3T-4270 (available March 2002) CD containing all z/os documentation. Accessing Publications Online You can access many Tivoli publications online at the Tivoli Customer Support Web site: These publications are available in PDF or HTML format, or both. Translated documents are also available for some products. Ordering Publications You can order many Tivoli publications online at the following Web site: You can also order by telephone by calling one of these numbers: xxiv Version 1.5.1

27 In the United States: In Canada: In other countries, for a list of telephone numbers, see the following Web site: Providing Feedback about Publications We are very interested in hearing about your experience with Tivoli products and documentation, and we welcome your suggestions for improvements. If you have comments or suggestions about our products and documentation, contact us in one of the following ways: Send an to pubs@tivoli.com. Complete our customer feedback survey at the following Web site: Contacting Customer Support If you have a problem with any Tivoli product, you can contact Tivoli Customer Support. See the Tivoli Customer Support Handbook at the following Web site: The handbook provides information about how to contact Tivoli Customer Support, depending on the severity of your problem, and the following information: Registration and eligibility Telephone numbers and addresses, depending on the country you are in What information you should gather before contacting support Preface 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 get resolution. Using LookAt to Look Up Message Explanations LookAt is an online facility that allows you to look up explanations for z/os messages, system abends, and some codes. Using LookAt to find information is faster than a conventional search because in most cases LookAt goes directly to the explanation. You can access LookAt from the Internet at: or from anywhere in z/os where you can access a TSO command line (for example, TSO prompt, ISPF, z/os UNIX System Services running OMVS). To find a message explanation on the Internet, go to the LookAt Web site and simply enter the message identifier (for example, IAT1836 or IAT*). Administration Guide xxv

28 Preface To use LookAt as a TSO command, LookAt must be installed on your host system. You can obtain the LookAt code for TSO from a disk on your z/os Collection Kit, SK3T-4269 or from the LookAt Web site. To obtain the code from the LookAt Web site, do the following: 1. Go to 2. Click the News button. 3. Scroll to Download LookAt Code for TSO and VM. 4. Click the ftp link, which will take you to a list of operating systems. Select the appropriate operating system. Then select the appropriate release. 5. Find the lookat.me file and follow its detailed instructions. To find a message explanation from a TSO command line, simply enter: lookat message-id. LookAt will display the message explanation for the message requested. Note: Some messages have information in more than one book. For example, IEC192I has routing and descriptor codes listed in z/os MVS Routing and Descriptor Codes, SA For such messages, LookAt prompts you to choose which book to open. Conventions Used in This Book 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. Changes in This Edition This edition is an updated version that replaces the previous edition of the same book. The changes are: The name of the base product has been changed to Tivoli Decision Support for OS/390. Information for migration from Tivoli Decision Support for OS/390 V1.5.0 to V1.5.1 has been added to Appendix J, Migrating Components from Earlier Releases. Except for editorial changes, updates to this edition are marked with a vertical bar to the left of the change. Changes in the Previous Edition The major changes were: Administration reports Tablespace reorganization Managing tablespaces Bufferpool enhancement Managing bufferpools Three new administration reports were introduced for mapping indexspaces to indexes, checking tablespace allocation and listing current purge criteria. A new, optional table design for CICS, IMS and MVS components enabled you to better manage DASD allocation in large environments. This design stored each table in its own tablespace. A new job, DRLJTBSR, enabled you to calculate and monitor Tivoli Decision Support for OS/390 tablespaces. A new, optional, job DRLJBMIG enabled you to specify which bufferpools to use for index and tablespaces of one or more Tivoli Decision Support for OS/390 components. All Tivoli Decision Support for OS/390 tablespaces and xxvi Version 1.5.1

29 Preface Buffer size extension OS/400 components index definitions were given a BUFFERPOOL clause. For each one, you could specify the bufferpool in the Dialog Parameters window. An extension was been added to the BUFFERSIZE parameter. You could now specify the size of the buffer in KB or MB in the Collect window. The structure of Tivoli Decision Support for OS/390 OS/400 components was simplified. Two new jobs, DRLJ4MIG and DRLJ4CON, restructured and migrated OS/400 components. There were also changes to: Software prerequisites The software prerequisites for installing and using in Installing Tivoli Decision Support for OS/390 on page 13 were updated. Migration information Migrating Components from Earlier Releases on page 313 was updated with information on migrating from previous releases of Tivoli Decision Support for OS/390 to Tivoli Decision Support for OS/ Component installation Component deinstallation Sometimes installing a component ends with an error or a warning. Information was provided about when these can be ignored. Sometimes deinstalling of a component ends with a warning message. Information was provided about when this can be ignored. Administration Guide xxvii

30 Preface xxviii Version 1.5.1

31 Part I. Getting started Chapter 1. Understanding Tivoli Decision Support for OS/ Introduction to Tivoli Decision Support for OS/ Introduction to Tivoli Decision Support for OS/390 performance features Introduction to the log collector Log definitions... 5 Record definitions... 5 Update definitions... 6 Table definitions... 6 Log and record procedures... 6 Collect process... 6 Introduction to the Tivoli Decision Support for OS/390 database... 9 Introduction to the administration dialog Introduction to the reporting dialog Chapter 2. Installing Tivoli Decision Support for OS/ Installation prerequisites Hardware prerequisites Software prerequisites Considerations when migrating from an earlier release or modification level of Tivoli Decision Support for OS/ Migrating the Tivoli Decision Support for OS/390 base to the latest level Step 1: Review the results of the SMP/E installation Tivoli Decision Support for OS/390 data sets Local data sets Language-dependent Tivoli Decision Support for OS/390 data sets Step 2: Set up security Tivoli Decision Support for OS/390 security using secondary authorization IDs Whattodo Tivoli 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 Tivoli Decision Support for OS/390 for first time 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 Tivoli Decision Support for OS/390 base Step 11: Review DB2 parameters Step 12: Install components Installing other Tivoli Decision Support for OS/390 systems Installing Tivoli Decision Support for OS/390 features separately Administration Guide 1