IBM Tivoli Workload Scheduler for z/OS IBM Customization and Tuning Version 9.2 (Revised September 2017) SC32-1265-09 IBM Tivoli Workload Scheduler for z/OS IBM Customization and Tuning Version 9.2 (Revised September 2017) SC32-1265-09 Note Before using this information and the product it supports, read the information in “Notices” on page 401. This edition applies to version 9, release 2, modification level 0 SPE of Tivoli Workload Scheduler for z/OS (program number 5698-T08) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 1999, 2016. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. © Copyright 2017 HCL Technologies Limited. Contents Figures .............. vii RCLDDP ............... 127 RCLDSNP .............. 128 Tables ............... ix RCLOPTS .............. 128 RCLSKIP ............... 135 RESOPTS............... 136 About this publication ........ xi RESOURCE .............. 141 What is new in this release ......... xi RODMOPTS.............. 141 Who should read this publication ....... xi ROUTOPTS .............. 145 Publications .............. xi SERVOPTS .............. 149 Using LookAt to look up message explanations .. xii TCPOPTS .............. 155 Accessibility .............. xii TOPOLOGY .............. 159 Tivoli technical training .......... xii TRGOPT ............... 159 Support information ........... xiii TRROPTS .............. 161 Conventions used in this publication ..... xiii USRREC ............... 164 How to read syntax diagrams ........ xiii XCFOPTS .............. 164 Part 1. Customizing Tivoli Workload Chapter 2. Identifying related Scheduler for z/OS ......... 1 initialization-statement parameters .. 167 Configuration ............. 168 Chapter 1. Defining initialization Security ............... 169 statements ............. 3 Generating audit information (JT log data) ... 170 Determining the success or failure of a job ... 170 Specifying the statements .......... 3 Recovery ............... 171 Creating the statements .......... 3 Restart and cleanup .......... 172 Storing the statements .......... 4 Job log retrieval ........... 172 Overriding the EQQPARM statements ..... 4 Automatic job recovery ......... 173 Choosing the appropriate statements ..... 4 Workload restart ........... 173 ALERTS ................ 7 Performance.............. 174 AROPTS ............... 11 Reporting .............. 175 AUDIT ................ 14 RODM monitoring ........... 175 AUDITCP ............... 16 Output processing............ 176 AUTHDEF .............. 17 End-to-end scheduling with fault tolerance BATCHOPT .............. 20 capabilities .............. 176 | BKPTOPTS .............. 33 Network configuration ......... 177 CPUREC ............... 36 Job definitions ............ 178 DBCSOPTS .............. 37 Regional settings ........... 179 DBOPT ................ 38 WLM integration ............ 180 DOMREC ............... 41 External monitoring ........... 180 DSTOPTS ............... 42 DSTUTIL ............... 47 ERDROPTS .............. 50 Chapter 3. Implementing security ... 183 EWTROPTS .............. 51 Planning security implementation ...... 183 EXITS ................ 56 How Tivoli Workload Scheduler for z/OS FLOPTS ............... 57 verifies access authority ......... 184 HTTPOPTS .............. 60 Identifying users ........... 185 INCLUDE ............... 65 Establishing naming conventions for IBM Tivoli INIT ................. 66 Workload Scheduler for z/OS resources ... 186 INTFOPTS............... 70 Grouping RACF users and resources .... 186 JCCOPTS ............... 72 General security considerations ...... 187 JTOPTS................ 75 Controlling access to Tivoli Workload Scheduler for MONOPTS .............. 101 z/OS ................ 188 MONPOL .............. 102 Controlling access to the Tivoli Workload NOERROR .............. 104 Scheduler for z/OS subsystem ...... 188 OPCOPTS .............. 108 Controlling access to Tivoli Workload Scheduler | OSLCOPTS .............. 124 for z/OS fixed resources......... 188 OUCOPTS .............. 126 © Copyright IBM Corp. 1999, 2016 iii Controlling access to Tivoli Workload Scheduler Installing the exit ........... 229 for z/OS subresources ......... 189 Interface to the exit .......... 230 Controlling access to Tivoli Workload Scheduler Incident-record-create exit (EQQUX006) .... 232 for z/OS from APPC .......... 191 Installing the exit ........... 232 Controlling access to Tivoli Workload Scheduler Interface to the exit .......... 232 for z/OS using Dynamic Workload Console .. 193 Operation-status-change exit (EQQUX007).... 234 Controlling access through TSO commands .. 196 Installing the exit ........... 234 Functions and data that you can protect .... 197 Interface to the exit .......... 235 Access requirements to fixed resources for dialog Operation-initiation exit (EQQUX009) ..... 238 users ................ 202 Installing the exit ........... 238 Examples of security strategies ....... 206 Interface to the exit .......... 238 A centralized security strategy....... 207 Job-tracking log write exit (EQQUX011) .... 240 A decentralized security strategy ...... 208 Installing the exit ........... 240 Interface to the exit .......... 240 Chapter 4. Tivoli Workload Scheduler Job-tailoring event exit (EQQUX013)...... 242 for z/OS exits ........... 211 Installing the exit ........... 242 Interface to the exit .......... 242 Tivoli Workload Scheduler for z/OS user exits Time-dependent-operation exit (EQQUX014) ... 244 invocation .............. 212 Installing the exit ........... 245 Start/stop exit (EQQUX000) ....... 212 Interface to the exit .......... 246 Job-submit exit (EQQUX001) ....... 212 EQQDELDS/EQQCLEAN Catalog exit Job-library-read exit (EQQUX002) ..... 213 (EQQUXCAT) ............. 247 Application-description-feedback exit Installing the exit ........... 248 (EQQUX003) ............ 213 Interface to the exit .......... 248 Event-filtering exit (EQQUX004) ...... 213 EQQCLEAN GDG Resolution exit (EQQUXGDG) 248 SYSOUT archiving exit (EQQUX005) .... 213 DDPROT/DSNPROT interactions ..... 249 Incident-record-create exit (EQQUX006) ... 213 Installing the exit ........... 249 Operation-status-change exit (EQQUX007)... 213 Interface to the exit .......... 249 Operation-initiation exit (EQQUX009) .... 213 JCL-imbed exit ............. 250 Job-tracking log write exit (EQQUX011) ... 213 Installing the exit ........... 250 Job-tailoring prevention exit (EQQUX013) ... 214 Interface to the exit .......... 250 Time-dependent-operation exit (EQQUX014) .. 214 Variable-substitution exit (on JCL or job definition JCL-imbed exit (on FETCH directive) .... 214 variable) ............... 252 Variable-substitution exit (on JCL or job Installing the exit ........... 253 definition variable) .......... 214 Interface to the exit .......... 253 Automatic-job-recovery exit (on RECOVER Automatic-job-recovery exit ........ 255 statement) ............. 214 Installing the exit ........... 255 Daily-planning-report exit (EQQDPUE1) ... 214 Interface to the exit .......... 255 EQQDELDS/EQQCLEAN catalog exit Daily-planning-report exit (EQQDPUE1) .... 257 (EQQUXCAT) ............ 214 Installing the exit ........... 257 EQQCLEAN GDG resolution exit Interface to the exit .......... 257 (EQQUXGDG) ............ 214 Application-description-validation exit Application-description-validation (EQQUXPIF) 214 (EQQUXPIF) ............. 258 Daily-planning-scheduling environment exit Installing the exit ........... 258 EQQDPX01 ............. 215 Interface to the exit .......... 258 Tivoli Workload Scheduler for z/OS Start/Stop exit System Automation for z/OS user exit (EQQUX000) ............. 216 (EQQUXSAZ) ............. 259 Installing the exit ........... 216 Installing the exit ........... 260 Interface to the exit .......... 217 Interface to the exit .......... 260 Job-submit exit (EQQUX001) ........ 217 Installing the exit ........... 217 Interface to the exit .......... 218 Chapter 5. Open Systems Integration 263 Job-library-read exit (EQQUX002) ...... 222 Controlling heterogeneous systems ...... 263 Installing the exit ........... 222 Setting up the environment........ 264 Interface to the exit .......... 222 Submitting and tracking the workload .... 264 Application-description-feedback exit (EQQUX003) 226 An alternate method for controlling VM processing 265 Installing the exit ........... 227 Method of use ............ 265 Interface to the exit .......... 227 Event-filtering exit (EQQUX004) ....... 228 Installing the exit ........... 228 Interface to the exit .......... 228 SYSOUT archiving exit (EQQUX005) ..... 229 iv Tivoli Workload Scheduler for z/OS: Customization and Tuning Chapter 6. Reporting events to Tivoli Customizing Tivoli Workload Scheduler for z/OS Workload Scheduler for z/OS .... 269 panels ................ 315 Supplying event information to Tivoli Workload Customizing ended-in-error-list and ready-list Scheduler for z/OS ........... 269 default layouts ............. 315 General information about Tivoli Workload Invoking hiperbatch support ........ 316 Scheduler for z/OS subroutines ...... 270 Customizing GMT clock.......... 316 Using the general Tivoli Workload Scheduler for Monitoring special resources through RODM... 317 z/OS subroutine (EQQUSIN) ........ 271 Creating case-code-definition modules ..... 319 Invocation requirements ......... 271 Invoking the data set deletion utility ..... 320 EQQUSIN parameters ......... 271 Customizing Tivoli Workload Scheduler