IBM TME 10 Operations Planning and Control Customization and Tuning Version 2 Release 2 SH19-4380-01 IBM TME 10 Operations Planning and Control Customization and Tuning Version 2 Release 2 SH19-4380-01 Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page xiii. 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. Second Edition (June 1998) This is a major revision of, and obsoletes, SH19-4380-00. This edition applies to Version 2 Release 2 Modification Level 0 of TME 10 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 TME 10 OPC Version 2 Release 2 Enhancements” on page xxv for the changes made to this manual. Technical changes or additions to the text and illustrations 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: TME 10 OPC Information Development Rome Tivoli Laboratory IBM Italy S.p.A. Via Sciangai, 53 00144 Rome Italy Fax Number (+39) 6 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, 1998. 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 . xiii Programming Interface Information ......................... xiii Trademarks . xiv Preface . xv Required Product Knowledge ............................. xv How to Use this Book ................................. xv How this Book is Organized .............................. xv TME 10 OPC Publications .............................. xvii TME 10 OPC Online Books ........................... xviii Online Message Facility ............................. xviii Books about Related Products ........................... xviii How to Read the Syntax Diagrams ......................... xxi Summary of TME 10 OPC Version 2 Release 2 Enhancements ....... xxv Version 2 Release 1.0 Summary .......................... xxviii Part 1. Customizing TME 10 OPC . 1 Chapter 1. TME 10 OPC Initialization Statements—Reference ........ 3 Specifying the Statements ................................ 3 Creating the Statements ............................... 3 Storing the Statements ................................ 4 Overriding the EQQPARM Statements ....................... 4 Selecting Statements for the Tracker and Controller ............... 4 Other Initialization Statements ............................ 6 ALERTS . 6 Error Conditions . 7 APPCROUT . 9 AROPTS . 10 AUDIT . 12 AUTHDEF . 15 BATCHOPT . 17 DBCSOPTS . 24 ERDROPTS . 25 EWTROPTS . 26 EXITS . 30 INCLUDE . 31 INIT . 31 INTFOPTS . 34 JCCOPTS . 35 JOBOPTS . 38 JTOPTS . 42 NOERROR . 59 OPCOPTS . 61 RESOPTS . 69 RESOURCE . 72 RODMOPTS . 73 ROUTOPTS . 76 Copyright IBM Corp. 1991, 1998 iii SERVOPTS . 81 TRROPTS . 82 XCFOPTS . 83 Chapter 2. Identifying Related Initialization-Statement Parameters .... 85 Configuration . 86 Security . 87 Generating Audit Information (JT Log Data) .................... 88 Determining the Success or Failure of a Job .................... 88 Recovery . 89 Catalog Management . 89 Automatic Job Recovery .............................. 90 Workload Restart . 90 Performance . 91 Reporting . 92 RODM Monitoring . 92 Output Processing . 93 Chapter 3. Implementing Security in TME 10 OPC .............. 95 Planning Security Implementation .......................... 95 How TME 10 OPC Verifies Access Authority .................. 96 Identifying Users . 97 Establishing Naming Conventions for TME 10 OPC Resources ....... 97 Grouping RACF Users and Resources ...................... 98 General Security Considerations ......................... 98 Controlling Access to TME 10 OPC ......................... 99 Controlling Access to the TME 10 OPC Subsystem .............. 99 Controlling Access to TME 10 OPC Fixed Resources ............ 100 Controlling Access to TME 10 OPC Subresources .............. 100 TME 10 OPC Subresources and RACF Resources ............ 101 Controlling Access to TME 10 OPC from APPC ............... 102 APPC/MVS and RACF ............................ 103 TME 10 OPC API and RACF ........................ 103 Controlling Access through TSO Commands ................. 104 Functions and Data that You Can Protect .................... 105 Access Requirements to Fixed Resources for Dialog Users .......... 108 Examples of Security Strategies .......................... 112 A Centralized Security Strategy ......................... 112 External Access to TME 10 OPC ...................... 112 Access through the TME 10 OPC Subsystem ............... 112 A Decentralized Security Strategy ....................... 114 External Access to TME 10 OPC ...................... 114 Access through the TME 10 OPC Subsystem ............... 114 Chapter 4. TME 10 OPC Exits .......................... 117 TME 10 OPC Start/Stop Exit (EQQUX000) .................... 118 Installing the Exit ................................. 118 Interface to the Exit ................................ 118 Job-Submit Exit (EQQUX001) ........................... 119 Installing the Exit ................................. 119 Interface to the Exit ................................ 119 Job-Library-Read Exit (EQQUX002) ........................ 121 Installing the Exit ................................. 121 Interface to the Exit ................................ 122 iv TME 10 OPC Customization and Tuning Application-Description-Feedback Exit (EQQUX003) .............. 125 Installing the Exit ................................. 125 Interface to the Exit ................................ 125 Event-Filtering Exit (EQQUX004) .......................... 126 Installing the Exit ................................. 126 Interface to the Exit ................................ 126 SYSOUT Archiving Exit (EQQUX005) ....................... 128 Installing the Exit ................................. 128 Interface to the Exit ................................ 128 Incident-Record-Create Exit (EQQUX006) .................... 130 Installing the Exit ................................. 131 Interface to the Exit ................................ 131 Operation-Status-Change Exit (EQQUX007) ................... 133 Installing the Exit ................................. 133 Interface to the Exit ................................ 134 Pre-Catalog-Management Exit (EQQUX008) ................... 136 Installing the Exit ................................. 136 Interface to the Exit ................................ 137 Operation-Initiation Exit (EQQUX009) ....................... 139 Installing the Exit ................................. 140 Interface to the Exit ................................ 140 Job-Log-Retrieval Exit (EQQUX010) ........................ 141 Installing the Exit ................................. 142 Interface to the Exit ................................ 142 Job-Tracking Log Write Exit (EQQUX011) .................... 145 Installing the Exit ................................. 145 Interface to the Exit ................................ 145 JCL-Imbed Exit . 147 Installing the Exit ................................. 147 Interface to the Exit ................................ 147 JCL-Variable-Substitution Exit . 149 Installing the Exit ................................. 149 Interface to the Exit ................................ 149 Automatic-Job-Recovery Exit . 151 Installing the Exit ................................. 151 Interface to the Exit ................................ 151 Daily-Planning-Report Exit (EQQDPUE1) ..................... 153 Installing the Exit ................................. 153 Interface to the Exit ................................ 153 Chapter 5. Reporting Events to TME 10 OPC ................ 155 Supplying Event Information to TME 10 OPC .................. 155 General Information about TME 10 OPC Subroutines ............ 156 Using the General TME 10 OPC Subroutine (EQQUSIN) ........... 157 Invocation Requirements . 157 EQQUSIN Parameters . 157 APP—Fixed Section . 158 APPOBJ—Object Section . 159 APPSEL—Selection Section . 161 APPVAL—Selection Value Section ..................... 162 APPFLD—Field Section . 162 APPDAT—Data Section . 163 Specifying Selection Criteria ........................... 163 Selecting an Operation to Change the Status (CP_OPER_EVENT) .. 163 Contents v Selecting a Special Resource (CP_SR_EVENT) ............. 164 Selecting an Operation to Supply User Data (CP_OPINFO_EVENT) .. 165 Selecting a TME 10 OPC Dataset (BACKUP_EVENT) .......... 166 Selecting a Workstation (CP_WS_EVENT)