program directory for tivoli workload scheduler -...

IBMProgram Directory for

Tivoli Workload Scheduler

Version 8 Release 1, Modification Level 0

Program Number 5698-WKB

for Use withOS/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 anonexclusive 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 LicenseAgreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No partof this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computerlanguage, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without priorwritten permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions ofany machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporationcopyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document isnot intended for production and is furnished "as is" without warranty of any kind. All warranties on this document are herebydisclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users RestrictedRights-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 torestrictions set forth in GSA ADP Schedule Contract with IBM Corp.

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

1.0 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.1 Tivoli Workload Scheduler Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11.2 Tivoli Workload Scheduler FMIDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

2.0 Program Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.1 Basic Machine-Readable Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32.2 Optional Machine-Readable Material . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42.3 Program Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.4 Program Source Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.5 Publications Useful During Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

3.0 Program Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.1 Program Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.2 Preventive Service Planning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73.3 Statement of Support Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

4.0 Program and Service Level Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

5.0 Installation Requirements and Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115.1 Driving System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5.1.1 Machine Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115.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 Tivoli Workload Scheduler . . . . . . . . . . . . . . . . . . . . 32. Location of Optional Materials for the Tivoli Workload Scheduler . . . . . . . . . . . . . . . . . . . 43. Location of Basic and Optional Publications for the Tivoli Workload Scheduler . . . . . . . . . . . 54. Publications Useful During Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65. Location of Upgrade, Subset, COMPID and FMID Information . . . . . . . . . . . . . . . . . . . . 76. Location of APAR and PTF Information for the Tivoli Workload Scheduler . . . . . . . . . . . . . 97. Driving System Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118. Location of System Requirements Information for the Tivoli Workload Scheduler . . . . . . . . . 129. Location of Installation Instructions for the Tivoli Workload Scheduler . . . . . . . . . . . . . . . . 13

10. Sample Installation Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

iv Tivoli Workload Scheduler Program Directory

Notices

References in this publication to Tivoli Systems or IBM products, programs, or services do not imply thatthey will be available in all countries in which Tivoli Systems or IBM operates. Any reference to theseproducts, 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 ofTivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of thereferenced product, program, or service. The evaluation and verification of operation in conjunction withother products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of theuser.

APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoingproblem reporting may result in additional APARs being created. Therefore, the APAR lists in thisdocument may not be complete. To obtain current service recommendations and to identify currentproduct service requirements, always contact the IBM and/or Tivoli Customer Support Center or use S/390SoftwareXcel to obtain the current "PSP Bucket".

IBM and/or Tivoli may have patents or pending patent applications covering subject matter in thisdocument. The furnishing of this document does not give you any license to these patents. You can sendlicense inquiries, in writing, to the

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, New York 10504-1785USA

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 oneach copy or partial copy.

� Transfer the original unaltered copy of the documentation when you transfer the related IBM and/orTivoli product (which may be either machines you own, or programs, if the program's license termspermit 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 thisauthorization.

THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not applyto you.

Copyright IBM Corp. 1991, 2001 v

Your failure to comply with the terms above terminates this authorization. Upon termination, you mustdestroy your machine readable documentation.

Trademarks

The following terms are trademarks of the IBM Corporation in the United States or other countries or both:

CBPDOIBMOS/390TivoliDFSMS/MVSDFSORT

IBMLinkMVS/ESAOPCRETAINS/390SystemPac

vi Tivoli Workload Scheduler Program Directory

1.0 Introduction

This program directory is intended for the system programmer responsible for program installation andmaintenance. It contains information concerning the material and procedures associated with theinstallation of Tivoli Workload Scheduler. This publication refers to Tivoli Workload Scheduler as TivoliWorkload Scheduler. You should read all of this program directory before installing the program and thenkeep 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 anddocumentation for Tivoli Workload Scheduler.

� 3.0, “Program Support” on page 7 describes the IBM and/or Tivoli support available for TivoliWorkload Scheduler.

� 4.0, “Program and Service Level Information” on page 9 lists the APARs (program level) and PTFs(service level) incorporated into Tivoli Workload Scheduler.

� 5.0, “Installation Requirements and Considerations” on page 11 identifies the resources andconsiderations for installing and using Tivoli Workload Scheduler.

� 6.0, “Installation Instructions” on page 13 provides detailed installation instructions for Tivoli WorkloadScheduler. It also describes the procedures for activating the functions of Tivoli Workload Scheduler,or refers to appropriate publications.

Before installing Tivoli Workload Scheduler, read 3.2, “Preventive Service Planning” on page 7. Thissection 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 Tivoli Workload Scheduler with a SystemPac orServerPac. When using these offerings, use the jobs and documentation supplied with the offering. Thisdocumentation may point you to specific sections of the program directory as required.

If you are installing Tivoli Workload 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 tothe printed copy shipped with your order. Your CBPDO contains a softcopy preventive service planning(PSP) upgrade for this product. All service and HOLDDATA for Tivoli Workload Scheduler are included onthe CBPDO tape.

1.1 Tivoli Workload Scheduler Description

Tivoli Workload Scheduler is a collection of Tivoli products that allow you to automatically plan, control andmonitor your production workload.

This program directory is intended for the system programmer responsible for program installation andmaintenance. It contains information concerning the material and procedures associated with the

Copyright IBM Corp. 1991, 2001 1

installation of Tivoli Workload Scheduler for OS/390 or z/OS. You should read all of this program directorybefore installing the program and then keep it for future reference.

1.2 Tivoli Workload Scheduler FMIDs

Tivoli Workload Scheduler for z/OS consists of the following FMIDs:

HWSZ100 JWSZ102 JWSZ1A4 JWSZ101 JWSZ103 JWSZ1C0 JWSZ1A3 JWSZ1A2 JWSZ1A1

2 Tivoli Workload Scheduler Program Directory

2.0 Program Materials

An IBM and/or Tivoli program is identified by a program number and a feature number. The programnumber for Tivoli Workload Scheduler is 5698-WKB.

Basic Machine-Readable Materials are materials that are supplied under the base license and featurecode, and are required for the use of the product. Optional Machine-Readable Materials are orderableunder separate feature codes, and are not required for the product to function.

The program announcement material describes the features supported by Tivoli Workload Scheduler. Askyour 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 featurecode, and are required for the use of the product. Optional Machine-Readable Materials are orderableunder separate feature codes, and are not required for the product to function.

The program announcement material describes the features supported by Tivoli Workload Scheduler. Askyour Tivoli representative for this information if you have not already received a copy. For additionalinformation about the Tivoli Workload 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 theprograms 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 Tivoli Workload Scheduler can be found in Figure 1.

Figure 1. Location of Basic Materials for the Tivoli Workload Scheduler

IncludedComponent

Tivoli WorkloadScheduler (ENU CHSFRA ITA KOR PTB)FCs 5802, 5872, 5812,5862, 5882, 5832

Tivoli WorkloadScheduler (Jap)FCs 5822

Tivoli WorkloadScheduler (Deu)FCs 5842

Tivoli WorkloadScheduler (Esp)FCs 5852

TWS for z/OS8.1.0

Program Directory forTWS for z/OS 8.1.0(English)GI10-5777-00

Program Directory forTWS for z/OS 8.1.0(Japanese)GI10-5780-00

Program Directory forTWS for z/OS 8.1.0(German)GI10-5778-00

Program Directory forTWS for z/OS 8.1.0(Spanish)GI10-5779-00


2.2 Optional Machine-Readable Material

Any optional machine-readable material for the Tivoli Workload Scheduler can be found in Figure 2.Additionally, softcopy publications in PDF and HTML format are available at the www.support.tivoli.comWeb site.

Figure 2. Location of Optional Materials for the Tivoli Workload Scheduler

IncludedComponent





TWS for z/OS8.1.0






2.3 Program Publications

The following sections identify the basic and optional publications for Tivoli Workload Scheduler.Additionally, softcopy publications in PDF and HTML format are available at the www.support.tivoli.comWeb site.

The Tivoli Workload Scheduler Program Directory, along with other Tivoli Program Directories can befound 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 theVPL facility for online viewing of available program listings. Those customers without access to VPL cancontact their IBM and/or Tivoli representative.

Figure 3. Location of Basic and Optional Publications for the Tivoli Workload Scheduler

IncludedComponent





TWS for z/OS8.1.0





Program Materials 5

2.5 Publications Useful During Installation

The publications listed in Figure 4 may be useful during the installation of Tivoli Workload Scheduler. Toorder copies, contact your IBM and/or Tivoli representative.

Figure 4. Publications Useful During Installation

Publication TitleForm

Number

OS/390 SMP/E User's Guide SC28-1740

OS/390 SMP/E Commands SC28-1805

OS/390 SMP/E Reference SC28-1806

OS/390 SMP/E Messages and Codes SC28-1738


3.0 Program Support

This section describes the IBM and/or Tivoli support available for Tivoli Workload 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 Tivoli Workload Scheduler, you should review the current Preventive Service Planning(PSP) information. If you obtained Tivoli Workload Scheduler as part of a CBPDO, there is HOLDDATAand PSP information included on the CBPDO tape.

If you obtained Tivoli Workload Scheduler on a product tape, or if the CBPDO is more than two weeks oldwhen you install it, you should contact the IBM and/or Tivoli Support Center or use S/390 SoftwareXcel toobtain the current "PSP Bucket".

PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify theFMIDs for a product level. The UPGRADE and SUBSET values for Tivoli Workload Scheduler can befound by looking in the references listed in Figure 5.

3.3 Statement of Support Procedures

Report any difficulties you have using this program to your IBM and/or Tivoli Support Center. If an APARis 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 Tivoli Workload Scheduler.

Figure 5. Location of Upgrade, Subset, COMPID and FMID Information

IncludedComponent





TWS for z/OS8.1.0






4.0 Program and Service Level Information

This section identifies the program and any relevant service levels of Tivoli Workload 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 Tivoli Workload Scheduler

IncludedComponent





TWS for z/OS8.1.0






5.0 Installation Requirements and Considerations

The following sections identify the system requirements for installing and activating Tivoli WorkloadScheduler. 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-ablecopy 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 oldone. By installing onto a separate target system, you can test the new product while still keeping theold one in production.

� When installing a product that shares libraries or load modules with other products, the installation candisrupt the other products. Installing onto a test system or clone will allow you to assess theseimpacts without disrupting your production system.

5.1 Driving System Requirements

This section describes the environment of the driving system required to install Tivoli Workload 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

ProgramNumber

Product Name andMinimum VRM/Service Level

Any one of the following:

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


5.2 Target System Requirements

The information needed to identify the target system requirements and to install and activate TivoliWorkload Scheduler can be found in the references listed in Figure 8 on page 12. This informationincludes driving and target system requirements, FMIDs deleted, and any special considerations.

Figure 8. Location of System Requirements Information for the Tivoli Workload Scheduler

IncludedComponent





TWS for z/OS8.1.0






6.0 Installation Instructions

Installation method and step-by-step procedures to install and activate the functions of Tivoli WorkloadScheduler can be found in the references listed in Figure 9

The sample installation jobs for the various components of the Tivoli Workload Scheduler can be found inthe references listed in Figure 10.

Additionally, to assist you in doing this, Tivoli has provided samples to help you create an SMP/Eenvironment 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 willneed to do so the first time you access this url. Once you register, you will receive a userid and passwordwithin 72 hours.

Figure 9. Location of Installation Instructions for the Tivoli Workload Scheduler

IncludedComponent





TWS for z/OS8.1.0





Figure 10. Sample Installation Jobs

Note: For information on where to find the sample installation jobs for Tivoli Workload Scheduler, refer toFigure 9.


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 athttp://www.tivoli.com/support/handbook/.

When you contact Tivoli Customer Support, be prepared to provide identification information for your company so thatsupport personnel can readily assist you. Company identification information may also be needed to access variousonline services available on the Web site.

The support Web site offers extensive information, including a guide to support services (the Customer SupportHandbook); 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 HTMLformats. 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, ororder number of the desired document. Alternatively, you can provide the document title, version number, and date ofpublication.

We are very interested in hearing about your experience with Tivoli products and documentation. We also welcomeyour suggestions for improvements. If you have comments or suggestions about our documentation, please contact usin one of the following ways:

Send e-mail to pubs§tivoli.com.

Complete our customer feedback survey at http://www.tivoli.com/support/feedback.


Reader's Comments

Program Directory for Tivoli Workload Scheduler

You may use this form to comment about this document, its organization, or subject matter with the understanding thatIBM may use or distribute whatever information you supply in any way it believes appropriate without incurring anyobligation to you.

For each of the topics below please indicate your satisfaction level by circling your choice from the rating scale. If astatement does not apply, please circle N.

RATING SCALE

very very notsatisfied <=====================> dissatisfied applicable

1 2 3 4 5 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 afterinstallation

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


If yes, how many years? __

If you have any comments to make about your ratings above, or any other aspect of the product installation, pleaselist 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 Tivoli WorkloadScheduler Development group):

IBM Tivoli LabAttn: Tivoli OPC DevelopmentVia Sciangai, 53RMSCI10000144, ROME, ITALY.

FAX Number: 039-06-5966-2456/2483/2077

E-Mail: [email protected]


IBM

Program Number: 5698-WKB 5802 5872 5852 5812 5862 5882 5832 5822 5842

Printed in U.S.A.

GI1%-5796-%%

program directory for tivoli workload scheduler -...

Documents