IBM Scheduler Version 8 Release 1, Modification Level 0 Program Number 5698-WKB for Use with OS/390 z/os Document Date: October 2001 GI10-5796-00
Note Before using this information and the product it supports, be sure to read the general information under Notices on page v. 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 92086/A). BVQI is a world leader in quality certification and is currently recognized by more than 20 accreditation bodies. A form for reader's comments appears at the back of this publication. 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 IBM Corporation 1991, 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 Rights-Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Copyright International Business Machines Corporation 1991, 2001. 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....................................................... v Trademarks..................................................... vi 1.0 Introduction.................................................. 1 1.1 Scheduler Description................................... 1 1.2 Scheduler FMIDs..................................... 2 2.0 Program Materials.............................................. 3 2.1 Basic Machine-Readable Material..................................... 3 2.2 Optional Machine-Readable Material.................................... 4 2.3 Program Publications............................................. 5 2.4 Program Source Materials.......................................... 5 2.5 Publications Useful During Installation................................... 6 3.0 Program Support.............................................. 7 3.1 Program Services............................................... 7 3.2 Preventive Service Planning......................................... 7 3.3 Statement of Support Procedures..................................... 7 4.0 Program and Service Level Information................................ 9 5.0 Installation Requirements and Considerations............................ 11 5.1 Driving System Requirements........................................ 11 5.1.1 Machine Requirements......................................... 11 5.1.2 Programming Requirements...................................... 11 5.2 Target System Requirements........................................ 12 6.0 Installation Instructions.......................................... 13 Contacting Customer Support......................................... 15 Reader's Comments............................................... 17 Copyright IBM Corp. 1991, 2001 iii
Figures 1. Location of Basic Materials for the Scheduler.................... 3 2. Location of Optional Materials for the Scheduler................... 4 3. Location of Basic and Optional Publications for the Scheduler........... 5 4. Publications Useful During Installation.................................. 6 5. Location of Upgrade, Subset, COMPID and FMID Information.................... 7 6. Location of APAR and PTF Information for the Scheduler............. 9 7. Driving System Software Requirements................................. 11 8. Location of System Requirements Information for the Scheduler......... 12 9. Location of Installation Instructions for the Scheduler................ 13 10. Sample Installation Jobs.......................................... 13 iv Scheduler Program Directory
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. APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoing problem reporting may result in additional APARs being created. Therefore, the APAR lists in this document may not be complete. To obtain current service recommendations and to identify current product service requirements, always contact the IBM and/or Tivoli Customer Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". IBM and/or Tivoli 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 10504-1785 USA For online versions of this book, we authorize you to: Copy, modify, and print the documentation contained on the media, for use within your enterprise, provided you reproduce the copyright notice, all warning statements, and other required statements on each copy or partial copy. Transfer the original unaltered copy of the documentation when you transfer the related IBM and/or Tivoli product (which may be either machines you own, or programs, if the program's license terms permit a transfer). You must, at the same time, destroy all other copies of the documentation. You are responsible for payment of any taxes, including personal property taxes, resulting from this authorization. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. Copyright IBM Corp. 1991, 2001 v
Your failure to comply with the terms above terminates this authorization. Upon termination, you must destroy your machine readable documentation. Trademarks The following terms are trademarks of the IBM Corporation in the United States or other countries or both: CBPDO IBM OS/390 Tivoli DFSMS/MVS DFSORT IBMLink MVS/ESA OPC RETAIN S/390 SystemPac vi Scheduler Program Directory
1.0 Introduction This program directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the installation of Scheduler. This publication refers to Scheduler as Tivoli Workload Scheduler. You should read all of this program directory before installing the program and then keep it for future reference. The program directory contains the following sections: 2.0, Program Materials on page 3 identifies the basic and optional program materials and documentation for Scheduler. 3.0, Program Support on page 7 describes the IBM and/or Tivoli support available for Tivoli Workload Scheduler. 4.0, Program and Service Level Information on page 9 lists the APARs (program level) and PTFs (service level) incorporated into Scheduler. 5.0, Installation Requirements and Considerations on page 11 identifies the resources and considerations for installing and using Scheduler. 6.0, Installation Instructions on page 13 provides detailed installation instructions for Scheduler. It also describes the procedures for activating the functions of Scheduler, or refers to appropriate publications. Before installing Scheduler, read 3.2, Preventive Service Planning on page 7. This section tells you how to find any updates to the information and procedures in this program directory. Do not use this program directory if you are installing Scheduler with a SystemPac or ServerPac. When using these offerings, use the jobs and documentation supplied with the offering. This documentation may point you to specific sections of the program directory as required. If you are installing Scheduler using the MVS Custom-Built Product Delivery Offering (CBPDO, 5751-CS3), a softcopy program directory is provided on the CBPDO tape which is identical to the printed copy shipped with your order. Your CBPDO contains a softcopy preventive service planning (PSP) upgrade for this product. All service and HOLDDATA for Scheduler are included on the CBPDO tape. 1.1 Scheduler Description Scheduler is a collection of Tivoli products that allow you to automatically plan, control and monitor your production workload. This program directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the Copyright IBM Corp. 1991, 2001 1
installation of Scheduler for OS/390 or z/os. You should read all of this program directory before installing the program and then keep it for future reference. 1.2 Scheduler FMIDs Scheduler for z/os consists of the following FMIDs: HWSZ100 JWSZ102 JWSZ1A4 JWSZ101 JWSZ103 JWSZ1C0 JWSZ1A3 JWSZ1A2 JWSZ1A1 2 Scheduler Program Directory
2.0 Program Materials An IBM and/or Tivoli program is identified by a program number and a feature number. The program number for Scheduler is 5698-WKB. Basic Machine-Readable Materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional Machine-Readable Materials are orderable under separate feature codes, and are not required for the product to function. The program announcement material describes the features supported by Scheduler. Ask your IBM and/or Tivoli representative for this information if you have not already received a copy. Basic Machine-Readable Materials are materials that are supplied under the base license and feature code, and are required for the use of the product. Optional Machine-Readable Materials are orderable under separate feature codes, and are not required for the product to function. The program announcement material describes the features supported by Scheduler. Ask your Tivoli representative for this information if you have not already received a copy. For additional information about the Scheduler, refer to the Tivoli Web site, http://www.tivoli.com. 2.1 Basic Machine-Readable Material The distribution medium for this program is 3480 cartridge. The tape or cartridge contains all the programs and data needed for installation. It is installed using SMP/E, and is in SMP/E RELFILE format. The basic machine-readable material for the Scheduler can be found in Figure 1. Figure 1. Location of Basic Materials for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 Copyright IBM Corp. 1991, 2001 3
2.2 Optional Machine-Readable Material Any optional machine-readable material for the Scheduler can be found in Figure 2. Additionally, softcopy publications in PDF and HTML format are available at the www.support.tivoli.com Web site. Figure 2. Location of Optional Materials for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 4 Scheduler Program Directory
2.3 Program Publications The following sections identify the basic and optional publications for Scheduler. Additionally, softcopy publications in PDF and HTML format are available at the www.support.tivoli.com Web site. Figure 3. Location of Basic and Optional Publications for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 The Scheduler Program Directory, along with other Tivoli Program Directories can be found at the following Web site: https://www.tivoli.com/secure/support/documents/s390/program_directories 2.4 Program Source Materials Customers with access to View Program Listings (VPL), such as through S/390 SoftwareXcel, can use the VPL facility for online viewing of available program listings. Those customers without access to VPL can contact their IBM and/or Tivoli representative. Program Materials 5
2.5 Publications Useful During Installation The publications listed in Figure 4 may be useful during the installation of Scheduler. To order copies, contact your IBM and/or Tivoli representative. Figure 4. Publications Useful During Installation Publication Title OS/390 SMP/E User's Guide OS/390 SMP/E Commands OS/390 SMP/E Reference OS/390 SMP/E Messages and Codes Form Number SC28-1740 SC28-1805 SC28-1806 SC28-1738 6 Scheduler Program Directory
3.0 Program Support This section describes the IBM and/or Tivoli support available for Scheduler. 3.1 Program Services Contact your IBM and/or Tivoli representative for specific information about available program services. 3.2 Preventive Service Planning Before installing Scheduler, you should review the current Preventive Service Planning (PSP) information. If you obtained Scheduler as part of a CBPDO, there is HOLDDATA and PSP information included on the CBPDO tape. If you obtained Scheduler on a product tape, or if the CBPDO is more than two weeks old when you install it, you should contact the IBM and/or Tivoli Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. The UPGRADE and SUBSET values for Scheduler can be found by looking in the references listed in Figure 5. Figure 5. Location of Upgrade, Subset, COMPID and FMID Information Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 3.3 Statement of Support Procedures Report any difficulties you have using this program to your IBM and/or Tivoli Support Center. If an APAR is required, the Support Center will provide the address to which any needed documentation can be sent. Figure 5 identifies where to find the component IDs (COMPID) for the Scheduler. Copyright IBM Corp. 1991, 2001 7
8 Scheduler Program Directory
4.0 Program and Service Level Information This section identifies the program and any relevant service levels of Scheduler. Information on APARs, PTFs, and cumulative service tapes can be found in Figure 6. Figure 6. Location of APAR and PTF Information for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 Copyright IBM Corp. 1991, 2001 9
10 Scheduler Program Directory
5.0 Installation Requirements and Considerations The following sections identify the system requirements for installing and activating Scheduler. The following terminology is used: Driving system: the system used to install the program. Target system: the system on which the program is installed. In many cases, the same system can be used as both a driving system and a target system. However, you may want to set up a clone of your system to use as a target system by making a separate IPL-able copy of the running system. The clone should include copies of all system libraries that SMP/E updates, copies of the SMP/E CSI data sets that describe the system libraries, and your PARMLIB and PROCLIB. Some cases where two systems should be used include the following: When installing a new level of a product that is already installed, the new product will delete the old one. By installing onto a separate target system, you can test the new product while still keeping the old one in production. When installing a product that shares libraries or load modules with other products, the installation can disrupt the other products. Installing onto a test system or clone will allow you to assess these impacts without disrupting your production system. 5.1 Driving System Requirements This section describes the environment of the driving system required to install Scheduler. 5.1.1 Machine Requirements The driving system can run in any hardware environment that supports the required software. 5.1.2 Programming Requirements Figure 7. Driving System Software Requirements Program Number Any one of the following: Product Name and Minimum VRM/Service Level 5668-949 System Modification Program/Extended (SMP/E) Release 1.8.1 with PTF UR51070 5647-A01 OS/390 SMP/E Version 2 Release 6 with PTF UR51068 5647-A01 OS/390 SMP/E Version 2 Release 7 or higher 5694-A01 z/os Version 1.1 or higher Copyright IBM Corp. 1991, 2001 11
5.2 Target System Requirements The information needed to identify the target system requirements and to install and activate Tivoli Workload Scheduler can be found in the references listed in Figure 8 on page 12. This information includes driving and target system requirements, FMIDs deleted, and any special considerations. Figure 8. Location of System Requirements Information for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 12 Scheduler Program Directory
6.0 Installation Instructions Installation method and step-by-step procedures to install and activate the functions of Scheduler can be found in the references listed in Figure 9 Figure 9. Location of Installation Instructions for the Scheduler Included Component Scheduler (ENU CHS FRA ITA KOR PTB) FCs 5802, 5872, 5812, 5862, 5882, 5832 Scheduler (Jap) FCs 5822 Scheduler (Deu) FCs 5842 Scheduler (Esp) FCs 5852 TWS for z/os 8.1.0 (English) GI10-5777-00 (Japanese) GI10-5780-00 (German) GI10-5778-00 (Spanish) GI10-5779-00 The sample installation jobs for the various components of the Scheduler can be found in the references listed in Figure 10. Figure 10. Sample Installation Jobs Note: For information on where to find the sample installation jobs for Scheduler, refer to Figure 9. Additionally, to assist you in doing this, Tivoli has provided samples to help you create an SMP/E environment at the following url: https://www.tivoli.com/secure/support/documents/s390/zone_creation_samples. This is on the Tivoli support web site and if you have not already registered with Tivoli for access you will need to do so the first time you access this url. Once you register, you will receive a userid and password within 72 hours. Copyright IBM Corp. 1991, 2001 13
14 Scheduler Program Directory
Contacting Customer Support For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. Submit a problem management record (PMR) electronically from our Web site at http://www.tivoli.com/support. Send e-mail to support tivoli.com. Customers in the United States can also call 1-800-TIVOLI8 (1-800-848-6548). International customers should consult the Web site for customer support telephone numbers. You can also review the Customer Support Handbook, which is available on our Web site at http://www.tivoli.com/support/handbook/. When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site. The support Web site offers extensive information, including a guide to support services (the Customer Support Handbook); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases. You can order documentation by e-mail at swdist tivoli.com. Please provide the publication number, part number, or order number of the desired document. Alternatively, you can provide the document title, version number, and date of publication. We are very interested in hearing about your experience with Tivoli products and documentation. We also welcome your suggestions for improvements. If you have comments or suggestions about our documentation, please contact us in one of the following ways: Send e-mail to pubs tivoli.com. Complete our customer feedback survey at http://www.tivoli.com/support/feedback. Copyright IBM Corp. 1991, 2001 15
16 Scheduler Program Directory
Reader's Comments Scheduler You may use this form to comment about this document, its organization, or subject matter with the understanding that IBM may use or distribute whatever information you supply in any way it believes appropriate without incurring any obligation to you. For each of the topics below please indicate your satisfaction level by circling your choice from the rating scale. If a statement does not apply, please circle N. RATING SCALE very very not satisfied <=====================> dissatisfied applicable 1 2 3 45 N Satisfaction Ease of product installation 1 2 3 4 5 N Contents of program directory 1 2 3 4 5 N Installation Verification Programs 1 2 3 4 5 N Time to install the product 1 2 3 4 5 N Readability and organization of program directory tasks 1 2 3 4 5 N Necessity of all installation tasks 1 2 3 4 5 N Accuracy of the definition of the installation tasks 1 2 3 4 5 N Technical level of the installation tasks 1 2 3 4 5 N Ease of getting the system into production after installation 1 2 3 4 5 N How did you order this product? CBPDO CustomPac ServerPac Independent Other Is this the first time your organization has installed this product? Yes No Were the people who did the installation experienced with the installation of MVS products? Yes No Copyright IBM Corp. 1991, 2001 17
If yes, how many years? If you have any comments to make about your ratings above, or any other aspect of the product installation, please list them below: Please provide the following contact information: Name and Job Title Organization Address Telephone Thank you for your participation. Please send the completed form to (or give to your IBM representative who will forward it to the Scheduler Development group): IBM Tivoli Lab Attn: Tivoli OPC Development Via Sciangai, 53 RMSCI100 00144, ROME, ITALY. FAX Number: 039-06-5966-2456/2483/2077 E-Mail: ROMERCF@VNET.IBM.COM 18 Scheduler Program Directory
IBM Program Number: 5698-WKB 5802 5872 5852 5812 5862 5882 5832 5822 5842 Printed in U.S.A. GI1-5796-