Installation Guide Version 2 Release 3
Total Page:16
File Type:pdf, Size:1020Kb
IBM Tivoli Operations Planning and Control Installation Guide Version 2 Release 3 SH19-4379-02 IBM Tivoli Operations Planning and Control Installation Guide Version 2 Release 3 SH19-4379-02 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page xv. ISO 9001 Certification This product was developed using an ISO 9001 certified quality system. Certification has been awarded by the Italian quality system certification group, CSQ (Certification No. CISQ/CSQ 9150.IBM7). CSQ is a member of the mutually recognized organization of European assessors, ITQS, which assesses and certifies quality systems in the field of information technology enterprises. Third Edition (December 1999) This is a major revision of, and obsoletes, SH19-4379-01. This edition applies to Version 2 Release 3 Modification Level 0 of Tivoli Operations Planning and Control, Program Number 5697-OPC, and to all subsequent releases and modifications until otherwise indicated in new editions or technical newsletters. See the “Summary of Tivoli OPC Version 2 Release 3 Enhancements” on page xxvii for the changes made to this manual. Technical changes or additions to the text to describe the Tivoli Job Scheduling Console Support are indicated by a vertical line to the left of the change. Make sure you are using the correct edition for the level of the product. Order publications through your IBM representative or the IBM branch office serving your locality. Publications are not stocked at the address below. IBM welcomes your comments. A form for readers' comments appears at the back of this publication. If the form has been removed, address your comments to: Tivoli OPC Information Development Rome Tivoli Laboratory IBM Italy S.p.A. Via Sciangai, 53 00144 Rome Italy Fax Number (+39) 06 5966 2077 Internet ID: ROMERCF at VNET.IBM.COM When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. Copyright International Business Machines Corporation 1991, 1999. All rights reserved. Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp. Contents Notices . xv Programming Interface Information ......................... xv Trademarks . xvi Preface . xix Who Should Read This Guide ............................ xix Required Product Knowledge ............................. xix How to Use This Guide ............................... xx How This Guide Is Organized ............................ xx Tivoli OPC Publications ................................ xxi Tivoli OPC Online Books .............................. xxii Online Message Facility .............................. xxii Required Publications . xxii Books about Related Products ........................... xxiii Summary of Tivoli OPC Version 2 Release 3 Enhancements ....... xxvii Job Scheduling Console ............................... xxvii Catalog Management — Data Availability ..................... xxvii OS/390 Workload Manager Support ........................ xxvii OS/390 Automatic Restart Manager Support ................... xxviii Program Interface (PIF) Enhancements ...................... xxviii Enhancements for Non-OS/390 Tracker Agents ................. xxviii Usability Enhancements . xxix New and Changed Installation Exits ........................ xxix New and Changed Initialization Statements ................... xxix Version 2 Release 2 Summary ........................... xxxi Version 2 Release 1 Summary ........................... xxxiv Part 1. Planning ................................................ 1 Chapter 1. Overview . 3 Tivoli OPC Parts and Their Relationships ....................... 3 Tracker . 4 Controller . 4 | Server for Dialogs, PIFs, and Tivoli Job Scheduling Console .......... 4 | Data Store . 5 Tivoli OPC Configurations .............................. 5 Controlling System . 5 Controlled Systems . 5 Tivoli OPC Subtasks ................................... 6 Relationship between Tivoli OPC and MVS ...................... 7 Using the Tivoli OPC Program Directory ....................... 8 Sample Library . 8 The Installation Process ................................. 9 Chapter 2. Planning Your Tivoli OPC Configuration ............. 11 Planning Considerations . 11 Trackers . 11 Initialization Statements . 11 Copyright IBM Corp. 1991, 1999 iii Communication . 12 Ways to Connect Tivoli OPC Systems ....................... 12 Shared DASD . 12 MVS Cross-System Coupling Facility ....................... 13 VTAM (Network Communication Function) ................... 13 Workstation Destination . 13 Workload Restart . 14 JES Considerations . 14 Tivoli OPC Basic Configuration Examples ..................... 15 DASD Connected . 16 VTAM Connected . 17 XCF Connected . 18 Tracker and Controller in a Single Address Space ............... 20 | Tivoli OPC Data Store Basic Configuration Examples ............... 21 | SNA Connected . 21 | XCF Connected . 23 Chapter 3. Planning Your Installation of Tivoli OPC ............. 25 Installation Considerations . 25 Configuring for Availability ............................. 25 Hot Standby . 25 Starting an Event Writer with an Event Reader Function ........... 25 Checklist for Installing Tivoli OPC .......................... 26 Part 2. Installing Tivoli OPC ....................................... 33 Chapter 4. Installing Tivoli OPC .......................... 35 Loading Tracker Software ............................... 36 Loading Controller Software .............................. 36 Loading National Language Support Software for the Controller ......... 37 Loading Workload Monitor/2 Software to MVS ................... 37 Loading Workload Monitor/2 NLS Software to MVS ................ 38 Using the EQQJOBS Installation Aid ........................ 38 Setting Up the EQQJOBS Installation Aid .................... 39 Creating the Sample Job JCL ........................... 40 | Generating Tivoli OPC Data Store Samples ................... 43 Generating Tivoli OPC Batch-Job Skeletons .................. 45 Adding SMF and JES Exits for Event Tracking ................... 49 Updating SYS1.PARMLIB . 51 Defining Tivoli OPC Subsystems ......................... 51 Calculating MAXECSA Values ......................... 52 Authorizing the Tivoli OPC Load-Module Library ................ 54 Updating SMF Parameters ............................. 54 Updating MVS Dump Options ........................... 56 Updating the MVS Link-Library Definition .................... 56 Updating XCF Initialization Options ........................ 57 Modifying TSO Parameters ............................ 57 Performance Considerations . 59 Defining the DLF Exit for Hiperbatch Support .................. 59 Starting Tivoli OPC Automatically ......................... 59 Updating APPC/MVS Options ........................... 59 Implementing Support for Data Set Triggering ................. 59 Setting Up the Tivoli OPC RACF Environment ................... 60 iv Tivoli OPC Installation Guide Controlling the User ID of the Tivoli OPC Address Space ........... 61 Controlling the User ID of Tivoli OPC-Submitted Jobs ............. 61 Normal Batch Jobs ................................ 61 Tivoli OPC Batch Jobs ............................. 62 Protecting Tivoli OPC Data Sets ......................... 62 Controlling Access to Tivoli OPC Resources .................. 62 | Permitting Access to the Controller through the API ............ 64 | Controlling Access to Tivoli OPC Resources when Using Tivoli Job | Scheduling Console . 64 | Permitting Access to the Controller through the Tivoli Job Scheduling | Console . 65 Authorizing Tivoli OPC as a Job Submitter ................... 65 Authorizing Tivoli OPC to Issue JES Commands ................ 66 Allocating Tivoli OPC Data Sets ........................... 67 Allocating the VSAM Data Sets .......................... 68 Application Description Dataset (EQQADDS) ................ 71 Current Plan Datasets (EQQCPnDS) ..................... 71 JCL Repository Datasets (EQQJSnDS) .................... 72 Allocating Tivoli OPC Non-VSAM Data Sets ................... 72 Internal Reader Dataset (EQQBRDS) ..................... 75 Checkpoint Dataset (EQQCKPT) ....................... 75 Diagnostic Datasets (EQQDMSG, EQQDUMP, and SYSMDUMP) .... 75 Event Dataset (EQQEVDS and EQQEVDnn) ................ 76 Job Library Dataset (EQQJBLIB) ....................... 78 Job-Completion-Checker Datasets . 78 Job-Tracking Datasets (EQQJTARC, EQQJTnn, EQQDLnn) ....... 79 Message Log Dataset (EQQMLOG) ...................... 80 Parameter Library (EQQPARM) ........................ 80 PIF Parameter Dataset (EQQYPARM) .................... 80 Automatic-Recovery-Procedure Library (EQQPRLIB) ............ 80 Started-Task-Submit Dataset (EQQSTC) ................... 81 Submit/Release Dataset (EQQSUDS) ..................... 81 | Allocating Tivoli OPC Data Store Data Sets .................... 81 | Creating JCL Procedures for Tivoli OPC Address Spaces ............ 82 Implementing Support for Started-Task Operations ............... 82 Required Data Sets ................................. 83 Optional Data Sets ................................. 85 Defining the Initialization Statements ........................ 86 Creating the DB2 Database .............................. 87 Setting Up the ISPF Environment .......................... 87 Setting Up the