IBM Tivoli Workload Scheduler for z/os. Installation Guide. Version 8.2 (Maintenance Release April 2004) SC

Transcription

1 IBM Tioli Workload Scheduler for z/os Installation Guide Version 8.2 (Maintenance Release April 2004) SC

2

3 IBM Tioli Workload Scheduler for z/os Installation Guide Version 8.2 (Maintenance Release April 2004) SC

4 Note Before using this information and the product it supports, read the information in Notices on page 213. Refreshed Edition (April 2004) This edition applies to ersion 8, release 2, modification 0 of IBM Tioli Workload Scheduler for z/os (program number 5697-WSZ) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 1991, All rights resered. US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Figures ii Tables ix Preface xi Maintenance Release xi Who Should Read This Manual xii What This Manual Contains xii Publications xiii Publications for IBM Tioli Workload Scheduler for z/os xiii Publications for IBM Tioli Workload Scheduler xi Using LookAt to Look up Message Explanations x Accessing Publications Online x Softcopy Collection Kit x Ordering Publications xi Accessibility xi Contacting IBM Software Support xi Conentions Used in This Manual xi What Is New in This Version xii z/os Functions xii End-to-End Functions xii Serer Connectiity xiii How to Read Syntax Diagrams xiii Part 1. Planning Chapter 1. Oeriew Parts and Their Relationships Tracker Controller Serer Data Store Configurations Controlling System Controlled Systems Integration with IBM Tioli Workload Scheduler Subtasks Relationship between the Scheduler and z/os...8 Using the IBM Tioli Workload Scheduler for z/os Program Directory Sample Library The Installation Process Chapter 2. Planning Your Configuration 11 Planning Considerations Trackers Initialization Statements Communication Ways to Connect IBM Tioli Workload Scheduler for z/os Systems Shared DASD z/os Cross-System Coupling Facility VTAM (Network Communication Function)..13 TCP/IP Workstation Destination Workload Restart JES Considerations Basic Serer Configuration Example Basic Configuration Examples DASD Connected VTAM Connected XCF Connected Tracker and Controller in a Single Address Space 21 Basic Data Store Configuration Examples SNA Only Connection XCF Only Connection Mixed SNA and XCF Connection Part 2. Installing Tioli Workload Scheduler for z/os Chapter 3. Planning Your Installation 33 Installation Considerations Configuring for Aailability Hot Standby Starting an Eent Writer with an Eent Reader Function Using a Hierarchical File System (HFS) Cluster 34 Checklist for Installing IBM Tioli Workload Scheduler for z/os Chapter 4. Installing Step 1. Loading Tracker Software Step 2. Loading Controller Software Step 3. Loading National Language Support Software Step 4. Using the EQQJOBS Installation Aid...44 Setting Up the EQQJOBS Installation Aid...44 Creating the Sample Job JCL Generating Batch-Job Skeletons Generating Data Store Samples Step 5. Adding SMF and JES Exits for Eent Tracking SMF Only JES2 Only JES3 Only Step 6. Updating SYS1.PARMLIB Defining Subsystems Calculating MAXECSA Values Authorizing the Load-Module Library Updating SMF Parameters Updating z/os Dump Options Updating the z/os Link-Library Definition...65 Updating XCF Initialization Options Modifying TSO Parameters Performance Considerations Copyright IBM Corp. 1991, 2004 iii

6 Defining the DLF Exit for Hiperbatch Support..68 Starting the Product Automatically Updating APPC Options Implementing Support for Data Set Triggering..68 Step 7. Setting Up the RACF Enironment Controlling the User ID of the Address Space..69 Controlling the User ID of Submitted Jobs...70 Normal Batch Jobs Batch Jobs Protecting Data Sets Controlling Access to Resources Permitting Access to the Controller through the API Controlling Access to IBM Tioli Workload Scheduler for z/os Resources when Using IBM Tioli Workload Scheduler Job Scheduling Console Permitting Access to the Controller through the IBM Tioli Workload Scheduler Job Scheduling Console Authorizing IBM Tioli Workload Scheduler for z/os as a Job Submitter Authorizing IBM Tioli Workload Scheduler for z/os to Issue JES Commands Authorizing IBM Tioli Workload Scheduler for z/os Data Store to Issue JES Commands...75 Step 8. Allocating Data Sets Allocating the VSAM Data Sets Application Description Data set (EQQADDS) 81 Current Plan Data sets (EQQCPnDS) Current Plan Backup Copy Dataset to Create Symphony (EQQSCPDS) JCL Repository Data sets (EQQJSnDS)...82 Allocating Restart and Clean Up VSAM Data Sets Restart and Clean Up Data Sets (EQQPKIxx, EQQSKIxx, and EQQSDFxx) Allocating Non-VSAM Data Sets Internal Reader Data Set (EQQBRDS) Checkpoint Data Set (EQQCKPT) Diagnostic Data Sets (EQQDMSG, EQQDUMP, and SYSMDUMP) Eent Data Set (EQQEVDS and EQQEVDnn) 87 Job Library Data Set (EQQJBLIB) Job-Completion-Checker Data Sets Job-Tracking Data Sets (EQQJTARC, EQQJTnn, EQQDLnn) Message Log Data Set (EQQMLOG) Parameter Library (EQQPARM) PIF Parameter Data Set (EQQYPARM)...91 Automatic-Recoery-Procedure Library (EQQPRLIB) End-to-end Script Library (EQQSCLIB)...91 Started-Task-Submit Data Set (EQQSTC)...92 Submit/Release Data Set (EQQSUDS)...92 End-to-end Centralized Script Data Set (EQQTWSCS) End-to-end Input and Output Eents Data Sets (EQQTWSIN and EQQTWSOU) Allocating Data Store Data Sets Allocating the Files and Directories Step 9. Creating JCL Procedures for Address Spaces 95 Implementing Support for Started-Task Operations Required Data Sets Optional Data Sets Step 10. Defining the Initialization Statements Step 11. Creating the DB2 Database Sample to Migrate the History Database Step 12. Setting Up the ISPF Enironment Setting Up the CLIST Library Setting Up the ISPF Tables Setting Up the Default Dialog controller Connection Table Setting Up List Tables and Graphical Attribute Tables Allocating Dialog Data Sets to Your TSO Session 104 Inoking the IBM Tioli Workload Scheduler for z/os Dialog Using the EQQOPCAC Sample CLIST Modifying an Existing ISPF Selection Menu 105 Selecting the Main Menu Directly from TSO 106 Using the ISPF Select Serice Step 13. Using XCF for Communication XCF Groups XCF Run-Time Options Initialization Statements Used for XCF Step 14. Actiating the Network Communication Function Adding NCF to the VTAM Network Definitions 109 Adding NCF Session Parameters COS Table Actiating Network Resources Diagnostic Data Set Step 15. Actiating Support for the API Defining VTAM Resources Defining a Local LU Defining Logon Modes Defining Cross-Domain Resources Updating APPC Options Actiating Support for APPC Step 16. Actiating Support for the Product Dialog and Programming Interface Using the Serer Defining VTAM Resources for the Product Dialog and Program Interface Using the Serer.115 Defining VTAM Resources for the Serer Defining a Local LU for the Serer Defining Logon Modes for the Serer Updating APPC Options for the Serer Defining VTAM Resources in a Parallel Sysplex 117 Starting the Serer Step 17. Actiating Support for the End-to-end Feature Actiating Serer Support for the End-to-end Feature Step 18. Actiating Support for the IBM Tioli Workload Scheduler Job Scheduling Console Actiating Serer Support for the IBM Tioli Workload Scheduler Job Scheduling Console..119 Chapter 5. Verifying Your Installation 121 Oeriew of Verification i IBM Tioli Workload Scheduler for z/os Installation Guide

7 Verifying Installation of a Tracker Ensuring that All Installation Tasks Are Complete Checking the Message Log (EQQMLOG) Verifying Tracking Eents The Eent Writer The Eent Data set Performing Problem Determination for Tracking Eents Verifying Installation of a Controller and Dialogs 127 Ensuring that All Installation Tasks Are Complete Checking the Message Log (EQQMLOG) Checking the Serer Message Log Checking Dialog Functions Performing Problem Determination Dialog Problems Authority Problems Verifying Installation of a Standby Controller Ensuring that All Installation Tasks Are Complete Checking the Message Log (EQQMLOG) Verifying Installation of the Restart and Cleanup Function Checking the Message Log (EQQMLOG) Verifying Configuration Creating Entries in the Databases Running Batch Jobs Checking the Message Logs (EQQMLOG) Controller Message Log Tracker Message Log Verifying Workload Submission Controlling System Controlled Systems Verifying Job Submission Verifying Takeoer by a Standby Controller Part 3. Migrating Chapter 6. Planning for Migration Installation Considerations Customization Considerations Migration Strategies JES and SMF Exits Migrating to Existing Subsystem Definitions Migrating to New Subsystem Definitions Getting the Right Software Parts Load Modules The ISPF enironment Migration Oeriew Migration Oeriew Establishing the Required Enironment Program Requirements Installation and Verification Parallel Testing Migrating an End-to-end Network Migrating from a Tracker Agent to a Distributed Agent Using the Tracker Jobs Migration Tool Migrating Backwards Migrating DB Running on Upgraded Operating Systems Chapter 7. Migration Actions Migrating Data Sets EQQICTOP VSAM Data Set Conersion Program Data Sets that You Need to Conert Data Sets that Can Be Used Empty Data Sets Switching into Production Mode Closing Down Your Production System Ensuring that LTP and NCP Data Sets Are Current Conerting VSAM Files to the New System Format Starting the New System Starting the New System in a Heay Workload Enironment Validating the New System Performing Fallback Part 4. Appendixes Appendix A. Accessibility Naigating the interface using the keyboard Magnifying what is displayed on the screen Appendix B. Sample Library (SEQQSAMP) Using the Visual Age Compiler SMP/E Samples Enironment Setup RECEIVE Processing APPLY Processing ACCEPT Processing SMF Exits Exit Installation Job Step Termination Exit Initialization Exit Record Write Exit JES Exits Exit Installation JES2 JCT I/O Exit JES3 OSE Modification Exit JES3 Input Serice Final-User Exit RACF Samples Class Descriptor Table Router Table Sample Library (SEQQSAMP) Appendix C. Configuration Examples 187 The Controlling System Automatic Restart Actions Initialization Statements Multi-Access Spool Systems Connected ia Shared DASD Indiidual Systems Connected ia Shared DASD 190 A z/os Sysplex Contents

8 A PLEX Configuration Controlling a z/os System ia a VTAM Link Controlling a JES2 MAS System ia a VTAM Link 198 Appendix D. Inoking the EQQEXIT Macro Inoking EQQEXIT in SMF Exits Inoking EQQEXIT in JES Exits Macro Inocation Syntax for EQQEXIT Appendix E. Inoking the EQQLSENT Macro Inoking EQQLSENT to Create EQQDSLST Macro Inocation Syntax for EQQLSENT Hardware Requirements Software Requirements and Optional Software Controlling System Controlled OS/390 Systems Optional Software Related Software Software Compatibility Notices Trademarks Glossary Index Appendix F. Hardware and Software Requirements i IBM Tioli Workload Scheduler for z/os Installation Guide

9 Figures 1. A Basic Serer Configuration Example A z/os System Connected ia Shared DASD A z/os System with a VTAM Connection A z/os System with an XCF Connection A Tracker and Controller Configured in a Single Address Space Controller and Tracker in Same Address Space with Tracker Connected ia SNA Controller, Tracker, and Data Store Connected ia XCF A Mixed SNA and XCF Connection EQQJOBS0 EQQJOBS Application Menu EQQJOBS3 Create Sample Job JCL EQQJOBS4 Create Sample Job JCL EQQJOBS8 Create Sample Job JCL EQQJOBS1 Generate IBM Tioli Workload Scheduler for z/os Batch-Job Skeletons EQQJOBS2 Generate IBM Tioli Workload Scheduler for z/os Batch-Job Skeletons EQQJOBSA Generate IBM Tioli Workload Scheduler for z/os Batch-Job Skeletons EQQJOBS5 Create Data Store Samples EQQJOBS6 Create Data Store Samples EQQJOBS7 Create Data Store Samples Sample Message Log for a Standby controller Sample Message Log for a Controller Sample Message Log for a Tracker Two z/os JES2 MAS Complexes Connected ia Shared DASD Indiidual Systems Connected ia Shared DASD A z/os Sysplex An IBM Tioli Workload Scheduler for z/os PLEX Enironment Controlling an z/os System ia a VTAM Link Controlling a JES2 MAS System ia a VTAM Link Copyright IBM Corp. 1991, 2004 ii

10 iii IBM Tioli Workload Scheduler for z/os Installation Guide

11 Tables 1. IBM Tioli Workload Scheduler for z/os Subtasks These Stages Summarize the IBM Tioli Workload Scheduler for z/os Installation Process Example EQQSERP Members for Figure Example EQQPARM Members for Figure Example EQQPARM Members for Figure 3 on page Example EQQPARM Members for Figure 4 on page Example EQQPARM Members for Figure 5 on page Example Members for Figure 6 on page Example Members for Figure 7 on page Example Members for Figure 8 on page Checklist for Installing IBM Tioli Workload Scheduler for z/os IBM Tioli Workload Scheduler for z/os Installation Tasks Tracker Libraries Loaded by SMP/E controller Libraries Loaded by SMP/E NLS Libraries Loaded by SMP/E Sample JCL Generated by the EQQJOBS Dialog controller Skeleton JCL Generated by the EQQJOBS Dialog Data Store Samples Generated by the EQQJOBS Dialog Sample Exits for IBM Tioli Workload Scheduler for z/os Examples of MAXECSA Storage Values Sample Library Members for Updating RACF Tables IBM Tioli Workload Scheduler for z/os VSAM Data sets Calculations of VSAM Data Set Size Restart and Clean Up VSAM data sets IBM Tioli Workload Scheduler for z/os Non-VSAM Data sets Data Store VSAM data sets Started task JCL samples for IBM Tioli Workload Scheduler for z/os address spaces IBM Tioli Workload Scheduler for z/os Required data sets IBM Tioli Workload Scheduler for z/os Optional data sets ISPF and IBM Tioli Workload Scheduler for z/os Dialog Data Sets Problem Determination for Missing Tracking Eents Recommended PTFs for Preious Versions of IBM Tioli Workload Scheduler for z/os for JES2 EXIT Data Sets that You Need to Conert Data Sets that IBM Tioli Workload Scheduler for z/os Can Use SEQQSAMP Library Members Example EQQPARM Members for the Preious Figure Example EQQPARM Members for the Preious Figure Example EQQPARM Members for Figure 24 on page Example EQQPARM Members for the Preious Figure Example EQQPARM Members for Figure Example EQQPARM Members for Figure Copyright IBM Corp. 1991, 2004 ix

12 x IBM Tioli Workload Scheduler for z/os Installation Guide

13 Preface Installation Guide describes the configuration planning and installation tasks of IBM Tioli Workload Scheduler for z/os. Installation is the task of making a program ready to do useful work. This task includes adding the materials on the IBM distribution tape to your system, initializing the program, and applying PTFs to the program. When you install a product, you are carrying out decisions you made in the planning step. Customization, an optional step, gies you the opportunity to tailor the program to the desired behaior or special needs of your site. Your workload can run on arious platforms, but you control it from a central z/os system that runs the Tioli Workload Scheduler for z/os controller. The term the scheduler, when used in this book, refers to Tioli Workload Scheduler for z/os. The term DB2, when used in this book, also applies to DATABASE2 and DB2 Uniersal Database. The term z/os is used in this manual to mean z/os and OS/390 operating systems. Where the term OS/390 appears, the related information applies only to OS/390 operating systems. This manual complements the IBM Tioli Workload Scheduler for z/os Program Directory which coers adding the materials on the IBM distribution tape to your system. The Program Directory comes with the IBM Tioli Workload Scheduler for z/os installation tape. It describes all of the installation materials and gies installation instructions specific to the product release leel or feature number. If any differences exist between this manual and the Program Directory use the information in the Program Directory. Maintenance Release This is a maintenance refresh of the corresponding IBM Tioli Workload Scheduler for z/os Version 8.2 manual, form number SC It contains updates for the following APARS: PQ78043 PQ78350 PQ79246 PQ79567 PQ80229 PQ80811 PQ81700 Throughout the book, the changed or new sections are marked by reision bars. If your ersion of the product has not been fixed for a particular APAR, refer to the original ersion of the manual for the corresponding information. Copyright IBM Corp. 1991, 2004 xi

14 Who Should Read This Manual This book is intended for system programmers who are responsible for software on an z/os system and plan on installing IBM Tioli Workload Scheduler for z/os. To use this book effectiely, you must be familiar with the following topics: Job control language (JCL) IBM System Modification Program Extended (SMP/E) z/os JES concepts and facilities Writing small code fragments in the Assembler H language Interactie System Productiity Facility (ISPF) Interactie System Productiity Facility/Program Deelopment Facility (ISPF/PDF) Time-Sharing Option (TSO) What This Manual Contains Virtual Storage Access Method (VSAM) (desirable but not essential) The IBM Tioli Workload Scheduler for z/os Application Programming Interface (API) uses adanced program-to-program communication (APPC) serices. Defining and configuring the conersation partners requires some knowledge of APPC serices. This manual contains the following sections: Part 1, Planning This part contains the following chapters: Chapter 1, Oeriew, on page 3 Describes the IBM Tioli Workload Scheduler for z/os parts, subtasks, and introduces the IBM Tioli Workload Scheduler for z/os configuration options. Chapter 2, Planning Your Configuration, on page 11 Describes connections between IBM Tioli Workload Scheduler for z/os systems and proides possible configurations to consider when planning your installation. Part 2, Installing Tioli Workload Scheduler for z/os This part contains the following chapters: Chapter 3, Planning Your Installation, on page 33 Offers considerations for the installation process and proides a checklist that you can use to perform the installation. Chapter 4, Installing, on page 41 Guides you, step-by-step, through the installation process, from loading software to erifying that the product has been installed correctly. Chapter 5, Verifying Your Installation, on page 121 Contains the installation erification process. Part 3, Migrating xii IBM Tioli Workload Scheduler for z/os Installation Guide

15 This part contains the following chapters: Chapter 6, Planning for Migration, on page 149 Describes planning for migration. Chapter 7, Migration Actions, on page 159 Guides you, step-by-step, through the conersion process to Version 8.2 from earlier ersions and releases of the product. Part 4. Appendixes This part contains the following appendixes: Appendix A, Accessibility, on page 173 Describes the features that make the product and the documentation accessible to users with physical disabilities, such as restricted mobility or limited ision. Appendix B, Sample Library (SEQQSAMP), on page 175 Describes the members of the sample library. Appendix C, Configuration Examples, on page 187 Contains complex configuration examples for multiple systems and multiple data centers. Appendix D, Inoking the EQQEXIT Macro, on page 201 Describes how you generate eent-tracking code using the eent-tracking-exits macro. Appendix E, Inoking the EQQLSENT Macro, on page 205 Describes how to create a table of data set names that you want to monitor for data set close. Appendix F, Hardware and Software Requirements, on page 209 Lists the hardware and software prerequisites. Publications This section lists publications in the Tioli Workload Scheduler for z/os library and any other related documents. It also describes how to access Tioli publications online, how to order Tioli publications, and how to make comments on Tioli publications. Publications for IBM Tioli Workload Scheduler for z/os The following documents are aailable in the IBM Tioli Workload Scheduler for z/os library: Customization and Tuning, SC Describes how to customize IBM Tioli Workload Scheduler for z/os. Diagnosis Guide and Reference, SC Proides information to help diagnose and correct possible problems when using the product. General Information, SC Describes the benefits of the entire IBM Tioli Workload Scheduler suite. Getting Started, SC Describes concepts and terminology of IBM Tioli Workload Scheduler for z/os and proides instructions to get you working with the product as soon as possible. IBM Tioli Workload Scheduler Job Scheduling Console Release Notes, SC Preface xiii

16 Proides information about working with IBM Tioli Workload Scheduler, regardless of platform, from a common GUI. IBM Tioli Workload Scheduler Job Scheduling Console User s Guide, SC Proides information about working with IBM Tioli Workload Scheduler, regardless of platform, from a common GUI. Licensed Program Specifications, GI Proides planning information to plan about IBM Tioli Workload Scheduler for z/os. Managing the Workload, SC Explains how to plan and schedule the workload and how to control and monitor the current plan. Memo to Users, GI Proides a summary of changes for the current release of the product. Messages and Codes, SC Explains messages and codes. Program Directory, GI Proided with the IBM Tioli Workload Scheduler for z/os installation tape, describes all of the installation materials and gies installation instructions specific to the product release leel or feature number. Programming Interfaces, SC Proides information to write application programs. Quick Reference, SC Proides a quick and easy consultation reference to operate the product. Publications for IBM Tioli Workload Scheduler The following manuals are aailable in the IBM Tioli Workload Scheduler library: IBM Tioli Workload Scheduler Planning and Installation Guide, SC Describes planning and installing IBM Tioli Workload Scheduler. IBM Tioli Workload Scheduler Reference Guide, SC Explains the IBM Tioli Workload Scheduler command line, understanding how extended and network agents work, and integrating IBM Tioli Workload Scheduler with NetView and with IBM Tioli Business Systems Manager. IBM Tioli Workload Scheduler Troubleshooting and Error Messages, SC Interprets IBM Tioli Workload Scheduler error messages, and proides sources of information that will help you in soling problems with IBM Tioli Workload Scheduler. IBM Tioli Workload Scheduler for Applications User s Guide, SC Describes installing, using, and troubleshooting for the IBM Tioli Workload Scheduler extended agents. IBM Tioli Workload Scheduler for Applications Release Notes, SC Proides last-minute information about the IBM Tioli Workload Scheduler extended agents. IBM Tioli Workload Scheduler Limited Fault-tolerant Agent for AS/400 User s Guide, SC Describes installing, configuring, and using IBM Tioli Workload Scheduler fault-tolerant agents on AS/400. IBM Tioli Workload Scheduler Plus Module User s Guide, SC Explains setting up and using the IBM Tioli Workload Scheduler Plus module. xi IBM Tioli Workload Scheduler for z/os Installation Guide

17 IBM Tioli Workload Scheduler Release Notes, SC Explains late-breaking information about IBM Tioli Workload Scheduler. 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. To use LookAt as a TSO/E command, you must hae LookAt installed on your host system. You can obtain the LookAt code for TSO/E from a disk on your SK3T-4270 Collection Kit or from the LookAt Web site s Download link. Accessing Publications Online The product CD contains the publications that are in the product library. The format of the publications is PDF, HTML, or both. To access the publications using a Web browser, open the infocenter.html file. The file is in the appropriate publications directory on the product CD. 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: Click the Tioli Workload Scheduler for z/os link to access the product library. 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. Softcopy Collection Kit All the books in the library, except the licensed publications, are aailable in softcopy in the following collection kits: IBM Online Library Omnibus Edition OS/390 Collection Kit, SK2T IBM Online Library z/os Software Products Collection Kit, SK2T You can read the softcopy books on CD-ROMs using these IBM licensed programs: Softcopy Reader BookManager READ/2 BookManager READ/DOS BookManager READ/6000 Preface x

18 All the BookManager programs need a personal computer equipped with a CD-ROM disk drie (capable of reading disks formatted in the ISO 9660 standard) and a matching adapter and cable. For additional hardware and software information, refer to the documentation for the specific BookManager product you are using. Updates to books between releases are proided in PDF and HTML on the Web. Ordering Publications You can order many Tioli publications online at the following Web site: Accessibility You can also order by telephone by calling one of these numbers: In the United States: In Canada: 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 Appendix A, Accessibility, on page 173. Contacting IBM Software Support If you hae a problem with any Tioli product, you can contact IBM 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 Conentions Used in This Manual The manual uses seeral typeface conentions for special terms and actions. Technical changes to the text are indicated by a ertical line to the left of the change. These conentions hae the following meanings: Information type Style conention Example Commands All capital letters CREATE xi IBM Tioli Workload Scheduler for z/os Installation Guide

19 Information type Style conention Example References in the text to fields on panels Input you should type in panel fields First time new term introduced, book titles All capital letters Monospace Italics QUANTITY MYAPPLICATION Application What Is New in This Version The following sections summarize the changes in this ersion of IBM Tioli Workload Scheduler. z/os Functions You can hae the local time on a z/os system change automatically, for example, for daylight saings time, without haing to stop and restart IBM Tioli Workload Scheduler. Note: The local time automatic change cannot happen when Tioli Workload Scheduler for z/os runs in a Sysplex enironment with a Sysplex Timer configured with ETRMODE YES and ETRZONE YES. You can turn the JESLOG SPIN option on or off using the SPIN keyword in the OPCOPTS statement. By default IBM Tioli Workload Scheduler adds the JESLOG=NOSPIN parameter to the JOB card when the following conditions both occur: You submit a JCL on a CPU running z/os Version 1.2 or higher. In the OPCOPTS initialization statement, you specify data store or job completion checker actiities. To facilitate migration from other scheduling products, IBM Tioli Workload Scheduler operations now accept a new symbolic name that can be up to 54 characters long. This operation extended name enables you to represent the job with something other than the operation number. You can specify the operation extended name when you define an operation in the database or when you copy it into the current plan. You can also use it to filter queries on operations in the database and current plan. You can use a mixed connection (SNA and XCF) between the controller and allocated data stores. A new exit routine, EQQUXPIF, alidates changes in an application description (AD) made using the programming interface (PIF), batch loader (BL), and the Job Scheduling Console (JSC). To increase the irtual storage from 16 MB to 2 GB, the IBM Tioli Workload Scheduler components hae been changed to use 31-bit addressing mode instead of 24-bit. End-to-End Functions For fault-tolerant workstations, you can continue to use centralized scripts, which are stored in the JOBLIB data set. With centralized scripts, you can perform ariable substitution, automatic recoery, JCL editing, and job setup (as for the jobs in the JOBLIB). Howeer, this implies a loss of fault tolerance and requires downloading the script to the agent eery time the job is submitted. You need to weigh the benefits and disadantages of using centralized scripts. Preface xii

20 You can use a new syntax to recoer non-centralized jobs on distributed agents automatically when the jobs abend. This recoery is similar to the recoery in the distributed enironment. You can use ariable substitution for jobs that run on fault-tolerant workstations and that do not use centralized scripts. IBM Tioli Workload Scheduler supplied-ariable and user-defined ariable tables are supported. You can enable firewall support and SSL authentication in end-to-end scheduling. You can specify a success condition for each job that determines whether a job is considered successful or abended. You can specify or modify the deadline time for a job or a job stream. There are new log files for netman, batchman, mailman, the writer, and the translator. Multiple domain managers can be connected to the controller. This allows greater flexibility, scalability, and improed performance. You can make an application or an operation dependent on the existence of one or more files before it can begin execution. You can actiate and deactiate the submission of jobs scheduled in an end-to-end enironment. You can enable or disable the auditing trail of a plan. You can change the status of distributed agents and switch their domain manager. You can refresh the content of the work directory. You can use the ISPF panels to produce an APAR tape that collects end-to-end data. You can use the Job Migration Tool to migrate from tracker agents to distributed agents. Serer Connectiity How to Read Syntax Diagrams The serer can use APPC and TCP/IP in simultaneous connections with the Job Scheduling Console, PIF, ISPF panels, and distributed agents. When an application is moed to another system in a sysplex enironment, for example, for maintenance of the current system or for a failure, the application can be reached under the same irtual IP address. Using a dynamic irtual IP address makes the end-to-end configuration more flexible, because your application is independent of the TCP/IP stack within the sysplex. Throughout this book, syntax is described in diagrams like the one shown here, which describes the SRSTAT TSO command: SRSTAT ' resource name ' OPCA SUBSYS( subsystem name ) MSTR xiii IBM Tioli Workload Scheduler for z/os Installation Guide

21 KEEP AVAIL( RESET ) NO YES KEEP DEVIATION( amount ) RESET KEEP QUANTITY( amount ) RESET YES CREATE( NO ) 0 TRACE( trace leel ) The symbols hae these meanings: The statement begins here. The statement is continued on the next line. The statement is continued from a preious line. The statement ends here. Read the syntax diagrams from left to right and from top to bottom, following the path of the line. These are the conentions used in the diagrams: Required items appear on the horizontal line (main path): STATEMENT required item Optional items appear below the main path: STATEMENT optional item An arrow returning to the left aboe the item indicates an item that you can repeat. If a separator is required between items, it is shown on the repeat arrow. STATEMENT, repeatable item If you can choose from two or more items, they appear ertically in a stack. If you must choose one of the items, one item of the stack appears on the main path: STATEMENT required choice 1 required choice 2 Preface xix

22 If choosing one of the items is optional, the entire stack appears below the main path: STATEMENT optional choice 1 optional choice 2 A repeat arrow aboe a stack indicates that you can make more than one choice from the stacked items:, STATEMENT optional choice 1 optional choice 2 optional choice 3, STATEMENT required choice 1 required choice 2 required choice 3 Parameters that are aboe the main line are default parameters: STATEMENT default alternatie Keywords appear in uppercase (for example, STATEMENT). Parentheses and commas must be entered as part of the command syntax, as shown. For complex commands, the item attributes might not fit on one horizontal line. If that line cannot be split, the attributes appear at the bottom of the syntax diagram: STATEMENT required choice 1 required choice 2 required choice 3 option 1 option 2 option 1 default optional choice 1( alternatie ) option 2 default optional choice 2( alternatie ) xx IBM Tioli Workload Scheduler for z/os Installation Guide

23 Part 1. Planning Chapter 1. Oeriew Parts and Their Relationships Tracker Controller Serer Data Store Configurations Controlling System Controlled Systems Integration with IBM Tioli Workload Scheduler Subtasks Relationship between the Scheduler and z/os...8 Using the IBM Tioli Workload Scheduler for z/os Program Directory Sample Library The Installation Process Chapter 2. Planning Your Configuration Planning Considerations Trackers Initialization Statements Communication Ways to Connect IBM Tioli Workload Scheduler for z/os Systems Shared DASD z/os Cross-System Coupling Facility VTAM (Network Communication Function)..13 TCP/IP Workstation Destination Workload Restart JES Considerations Basic Serer Configuration Example Basic Configuration Examples DASD Connected VTAM Connected XCF Connected Tracker and Controller in a Single Address Space 21 Basic Data Store Configuration Examples SNA Only Connection XCF Only Connection Mixed SNA and XCF Connection Copyright IBM Corp. 1991,

24 2 IBM Tioli Workload Scheduler for z/os Installation Guide

25 Chapter 1. Oeriew Parts and Their Relationships IBM Tioli Workload Scheduler for z/os can plan, control, and automate the entire production workload in your enterprise, not just the z/os batch subset. It automatically plans, controls, and monitors your production workload to maximize the throughput and optimize resource use, but lets you interene manually when required. If you are currently using preiously supported ersions, follow the instructions in Part 3, Migrating, on page 147. This chapter introduces IBM Tioli Workload Scheduler for z/os and its implementation. Later chapters describe the installation and migration tasks in greater detail. If you are not familiar with IBM Tioli Workload Scheduler for z/os terminology or functions, read the General Information. IBM Tioli Workload Scheduler for z/os consists of a base product, the agent, and a number of features. You need the base product to track the workload. Hereafter, you might see the agent referred to as the tracker and the engine referred to as the controller. One z/os system in your complex is designated the controlling system and runs the controller feature. Only one controller feature is required, een when you want to start standby controllers on other z/os systems in a sysplex. You can control work that runs on non-z/os operating enironments from a central controller. You need the appropriate fault-tolerant workstation and the end-to-end enabler feature on the controlling system of the scheduler. Refer to IBM Tioli Workload Scheduler Planning and Installation Guide for a list of supported operating enironments. The workload on other operating enironments can also be controlled using the end-to-end scheduling functionality proided by IBM Tioli Workload Scheduler for z/os and by IBM Tioli Workload Scheduler. Additionally, national language features let you see the IBM Tioli Workload Scheduler for z/os ISPF dialogs in the language of your choice. These languages are aailable: English German Japanese Spanish This section describes the tracker and controller, their relationship, and the ways in which you can configure them. Tracker A tracker is required for eery z/os system in a IBM Tioli Workload Scheduler for z/os configuration. The tracker handles the submission of jobs and tasks on the system, and keeps track of the status of the workload. In conjunction with Copyright IBM Corp. 1991,

26 standard interfaces to JES and SMF, IBM Tioli Workload Scheduler for z/os records the releant information about the workload by generating eent records. The eent records are captured and stored by the tracker. The tracker then communicates eent information to the controller for further processing. The log where eents are written by the tracker is called the eent data set. IBM Tioli Workload Scheduler for z/os address spaces are defined as z/os subsystems. IBM Tioli Workload Scheduler for z/os routines that execute during subsystem initialization establish serices that enable eent information to be generated and stored in common storage (ECSA) een when an address space is not actie. You can optionally install a data store for each JES spool in a system. In a simple JES configuration this would mean one data store for each tracker. In systems with shared spools (for example, JES2 MAS), there is a data store for each spool, and there are fewer data stores than trackers. Controller The controller is the focal point of your IBM Tioli Workload Scheduler for z/os configuration. It contains the controlling functions, the ISPF dialogs, the databases, and the plans. The system that the controller is started on is called the IBM Tioli Workload Scheduler for z/os controlling system. IBM Tioli Workload Scheduler for z/os systems that communicate with the controlling system are called controlled, or tracker systems. You need to install at least one controller for your production systems. It can control the entire IBM Tioli Workload Scheduler for z/os configuration, the OPCplex, both local and remote. You can use the controller to proide a single, consistent, control point for submitting and tracking the workload on any operating enironment. IBM Tioli Workload Scheduler for z/os proides distributed agents and open interfaces that enable you to integrate the planning, scheduling, and control of work units such as online transactions, file transfers, or batch processing in any operating enironment that can communicate with z/os. Serer IBM Tioli Workload Scheduler for z/os proides a serer that enables you to access the controller remotely from ISPF dialogs, PIFs, and from the IBM Tioli Workload Scheduler Job Scheduling Console interface. Connections with the serer run through adanced program-to-program communications APPC sessions, or just for the IBM Tioli Workload Scheduler Job Scheduling Console using TCP/IP connections. The serer runs in its own address space; howeer, it is optional if you do not access the controller remotely. The serer is also used to communicate with the distributed agents for the end-to-end feature. A Started Task JCL enables you to start and stop one or more serers either indiidually, using the Start and Stop operator commands, or automatically with the controller, using a keyword in the OPCOPTS statement. A serer must start on the same z/os image as its controller. Only one serer can be started with the end-to-end feature actie. The PIF dialog connection to the controller, whether ia serer or subsystem interface, is only allowed when the code is at the same leel on both sides of the interface. 4 IBM Tioli Workload Scheduler for z/os Installation Guide

27 Data Store Data store is a separate address space. Its function is to collect structured (steps and data sets) and, optionally, unstructured (SYSOUT) information for all submitted jobs. Data store is required in order to use the restart and cleanup functions: Restart at the job or step leel Data set clean up JOBLOG retrieal The controller can be connected to data store ia XCF or SNA. Configurations You can configure IBM Tioli Workload Scheduler for z/os to control irtually any combination of operating enironments. IBM Tioli Workload Scheduler for z/os can automatically schedule, submit, and track batch jobs, started tasks, and write-to-operator (WTO) messages. You can also use IBM Tioli Workload Scheduler for z/os to coordinate manual actiities in your production workload. Your IBM Tioli Workload Scheduler for z/os configuration can include: A controlling system Controlled systems: Local and remote controlled z/os systems, including a parallel sysplex Standby controller systems Preious OPC Releases. Controlled systems that run on distributed agents. Other operating enironments that do not support the distributed agents. Chapter 2, Planning Your Configuration, on page 11 explains connections between IBM Tioli Workload Scheduler for z/os systems and shows examples of configurations. Controlling System A controlling IBM Tioli Workload Scheduler for z/os system requires both a tracker and a controller. If you install only one IBM Tioli Workload Scheduler for z/os system, this is the controlling system. The controlling IBM Tioli Workload Scheduler for z/os system can communicate with controlled z/os systems using shared DASD, the cross-system coupling facility (XCF), and the network communication function (NCF). Controlled Systems A controlled z/os system requires a tracker. Communication with the controlling system is through shared DASD, XCF, or NCF. The tracker writes eent records to an eent data set, and transfers the records to the controlling system if connected ia XCF or NCF. NCF uses ACF/VTAM to link IBM Tioli Workload Scheduler for z/os systems. If you use XCF for communication, you can include a standby controller on one or more controlled systems. A standby controller is started in its own address space. It can take oer the functions of the controller if z/os fails or if the controller itself fails. It cannot perform the functions of a tracker while in standby mode. Chapter 1. Oeriew 5

28 You can use IBM Tioli Workload Scheduler for z/os to control workloads on operating enironments that hae the end-to-end feature. Controlled systems connect to the controlling system using adanced program-to-program communication (APPC) serices. The controller can also control the workload in other operating enironments, such as VM/ESA. The Customization and Tuning publication describes in detail controlling other operating enironments. Integration with IBM Tioli Workload Scheduler The end-to-end feature is based on the Common Agent Technology and it enables IBM Tioli Workload Scheduler for z/os to be the master of a IBM Tioli Workload Scheduler distributed network. This configuration is implemented by connecting a IBM Tioli Workload Scheduler domain manager directly to IBM Tioli Workload Scheduler for z/os. IBM Tioli Workload Scheduler for z/os receies eents from the IBM Tioli Workload Scheduler distributed network and updates the current plan (CP) according to these eents. Conersely, eery time the current plan is updated, an eent is sent to the distributed network to update local plans on the distributed agents. Being fault-tolerant, the distributed agents can independently carry on with scheduling when communications with IBM Tioli Workload Scheduler for z/os are interrupted due to network problems. At the same time, the distributed agents are preented from acting on IBM Tioli Workload Scheduler for z/os jobs since these are iewed as running on the Master that is the only node that has the authorization to operate on those jobs. A new type of CPU, named fault-tolerant workstation, is added to IBM Tioli Workload Scheduler for z/os to logically define in the database and in the plan the distributed agents that will be running jobs for IBM Tioli Workload Scheduler for z/os. Subtasks A IBM Tioli Workload Scheduler for z/os address space consists of many z/os subtasks. Some of these subtasks are always attached when the IBM Tioli Workload Scheduler for z/os address space is started, others are conditionally attached according to initialization parameters specified for the scheduler options (OPCOPTS) statement in the IBM Tioli Workload Scheduler for z/os parameter library. The following table describes the subtasks. Table 1. IBM Tioli Workload Scheduler for z/os Subtasks Subtask ID Component code Description APPC PP APPC functions AR AR Automatic recoery Component of FMID Actiated by OPCOPTS parameter Function JWSZ202 APPCTASK(YES) Starts APPC support JWSZ202 RECOVERY(YES) Manages failing operations DRT DX Data router HWSZ200 Always actiated Routes data to other subtasks or IBM Tioli Workload Scheduler for z/os subsystems EMGR EM Eent manager JWSZ202 OPCHOST(YES) Processes job-tracking eents 6 IBM Tioli Workload Scheduler for z/os Installation Guide