Tivoli Guide

Tivoli® Workload Scheduler
Job Scheduling Console

User’s Guide
Version 8.1 SH19-4552-00
Tivoli® Workload Scheduler
User’s Guide
Version 8.1 SH19-4552-00
Tivoli Workload Scheduler, Job Scheduling Console User’s Guide, Version 8.1
Copyright Notice
© Copyright IBM Corporation 1990, 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.
Trademarks
IBM, Tivoli, the Tivoli logo, AIX, BookManager, Hiperbatch, OS/390, RACF, and z/OS are trademarks or registered trademarks of
International Business Machines Corporation or Tivoli Systems Inc. in the United States, other countries, or both.
Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the United States, other countries, or
both.
Other company, product, and service names may be trademarks or service marks of others.
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. Tivoli Systems or IBM 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, U.S.A.
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.
Contents
Figures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii
Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii
Who Should Read This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii
What This Guide Contains. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxvii
Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxix
Tivoli Workload Scheduler for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxix
Tivoli Workload Scheduler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxx
Accessing Publications Online . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxx
Workload Scheduler for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
Ordering Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
Providing Feedback about Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
LookAt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxi
Contacting Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxii
Conventions Used in This Book. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxii
Typeface Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxii
Operating System-dependent Variables and Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiii
Other Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxxiii
Part I. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Tivoli Workload Scheduler for z/OS Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Planning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Operator Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Tivoli Workload Scheduler Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Planning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Operator Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Terminology Used in the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 2. Installing Tivoli Job Scheduling Services . . . . . . . . . . . . . . . . . . . . 13

Before Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Tivoli Job Scheduling Console User’s Guide iii

Uninstalling Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installing Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Chapter 3. Installing the Tivoli Workload Scheduler for z/OS

Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Installing the Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Customizing the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Creating Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Authorization Roles Required for Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Managing Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Uninstalling the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 4. Installing the Tivoli Workload Scheduler Connector . . . . . . . . . 25

Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Workload Scheduler Master . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Fault-tolerant Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Installing the Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Where to Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Customizing the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Creating Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Authorization Roles Required for Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Managing Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Uninstalling the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
iv Version 8.1
Updating Workload Scheduler Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Chapter 5. Installing the Tivoli Job Scheduling Console. . . . . . . . . . . . . . . . . 33

Installing on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Installing on AIX and HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Updating AIXconsole.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing on Solaris and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Starting the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Uninstalling the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Uninstalling on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Uninstalling on AIX, HP-UX, Solaris, and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Chapter 6. Working with the Job Scheduling Console . . . . . . . . . . . . . . . . . . . 41

The Job Scheduling View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Using the Buttons of the Job Scheduling View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Working with Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Default Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Creating a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Specifying Defaults for Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Creating a Group of Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Detaching a List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Modifying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Deleting a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Example: Finding a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Part II. Using the Job Scheduling Console with Tivoli Workload
Scheduler for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Chapter 7. Managing Workstations in the Database . . . . . . . . . . . . . . . . . . . . . 55

Creating a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Defining Open Time Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Managing Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Tivoli Job Scheduling Console User’s Guide v

Default Workstation Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Creating a List of Workstations in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Using Workstation Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Chapter 8. Managing Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . 69

Creating Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Resource Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Default Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Availability Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Managing Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Default Resource Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Listing Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Using Resource Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Chapter 9. Creating Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Specifying Properties for the Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Creating a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Creating a Job Using Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Creating a Job Using Copy and Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Creating Dependencies between Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Creating Dependencies within a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Creating Dependencies between Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Scheduling Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Types of Run Cycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Creating a Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Creating Rule-based Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Creating Offset-based Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Checking Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Activity Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Table Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Time Restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Other Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Saving a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Submit a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Chapter 10. Listing and Modifying Job Streams . . . . . . . . . . . . . . . . . . . . . . . . 109

Default Job Stream List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Creating a Job Stream List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Displaying a Job Stream List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
vi Version 8.1
Modifying Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Modifying Job Stream Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Adding and Modifying Jobs and Dependencies in the Graph View . . . . . . . . . . . . . . . . . . . . . 113
Adding and Modifying Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Viewing and Modifying Time Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Deleting Job Streams from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using Copy to Add an External Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using Existing Definitions to Create Other Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Chapter 11. Listing Job Stream and Job Instances . . . . . . . . . . . . . . . . . . . . . 119

Creating Lists of Job Stream and Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Default Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Listing Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Listing Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Chapter 12. Managing Job Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Job Stream Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Browsing and Modifying Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Using the General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Using the Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Changing Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Rescheduling the Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Rescheduling the Start Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Rescheduling the Deadline Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Deleting a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Setting a Job Stream Instance to Complete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Setting a Job Stream Instance to Waiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Rerunning a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Additional Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Chapter 13. Managing Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Job Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Browsing and Modifying Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Tivoli Job Scheduling Console User’s Guide vii

Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Browsing and Modifying Job Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Changing Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Deleting Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Putting Job Instances on Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Releasing Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Displaying Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Set as Root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Browsing the Job Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Removing a Job Instance from the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Restoring a Job Instance to the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Running a Job Instance Immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Changing the Status of a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Editing JCL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Viewing Operator Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Modifying Job Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Restart and Cleanup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Chapter 14. Managing Workstations in the Plan . . . . . . . . . . . . . . . . . . . . . . . . 161

Creating a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Displaying Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Browsing and Modifying Workstation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Job Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Open Time Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Linking Fault-Tolerant Workstations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Changing Workstation Status and Rerouting Scheduled Job Instances . . . . . . . . . . . . . . . . . . . . . . . 170
Displaying by Status the Job Instances Scheduled on a Workstation . . . . . . . . . . . . . . . . . . . . . . . . 171
Modifying the Job Instances Scheduled on a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Chapter 15. Managing Resources in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Creating a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Displaying Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
viii Version 8.1

Browsing and Modifying Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Default Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Availability Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Displaying the Job Instances Associated with a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Modifying Job Instances Associated with a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Part III. Using the Job Scheduling Console with Tivoli Workload
Scheduler. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
Chapter 16. Managing Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Creating a Group for Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Creating Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Creating a List of Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Creating a List of Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Creating a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Creating a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Creating a List of Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Creating a List of Prompts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Creating a List of Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Creating a List of NT Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Creating a List of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Creating a List of Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Working with Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Detaching a List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Modifying a Database List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Deleting a List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Creating a Job Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Displaying a List of Job Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Displaying a Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Displaying Job Definition Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Modifying a Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Deleting Job Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Tivoli Job Scheduling Console User’s Guide ix

Using the Job Stream Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Run Cycle View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Creating a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Specifying Job Stream Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Adding External Dependencies for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Deleting External Dependencies from a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Adding a Job to a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Copying and Pasting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Cloning the Job Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Adding an Internetwork Dependency to a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Adding an External Job Stream to a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Adding an External Job to a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Creating Dependencies Between Jobs in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Specifying Run Cycles for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Inclusionary or Exclusionary Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Rule for Freedays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Colored Bars on Dates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Specifying Simple Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Specifying Weekly Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Specifying Calendar Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Modifying Run Cycles for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Deleting Run Cycles from a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Specifying Time Restrictions in the Timeline View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Specifying Time Restrictions for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Specifying Time Restrictions for a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Saving a Job Stream in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Closing the Job Stream Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Displaying a List of Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Displaying a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Modifying a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Modifying a Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Deleting a Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Modifying an Internetwork Dependency in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Deleting an Internetwork Dependency in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Modifying an External Job Stream in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
x Version 8.1
Deleting an External Job Stream in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Modifying an External Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Deleting an External Job in a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Deleting Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Chapter 19. Managing Workstations and Workstation Classes . . . . . . . . 251

Managing Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Creating a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Displaying a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Displaying a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Modifying a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Deleting Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Creating a Workstation by Copying Another Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Managing Workstation Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Creating a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Displaying a List of Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Displaying a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Modifying a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Deleting Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Chapter 20. Managing Domains, Users, and Calendars . . . . . . . . . . . . . . . . 261

Managing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Creating a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Displaying a List of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Displaying a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Modifying a Domain in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Deleting Domains in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Managing Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Creating a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Displaying a List of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Displaying a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Modifying a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Deleting Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Changing User Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Managing Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
The Holidays Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Freedays Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Creating a Calendar in the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Displaying a List of Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Viewing Calendar Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Tivoli Job Scheduling Console User’s Guide xi

Modifying a Calendar in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Deleting Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Chapter 21. Managing Resources, Prompts, and Parameters . . . . . . . . . . 271

Managing Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Creating a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Displaying a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Displaying a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Modifying a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Deleting Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Creating a Resource by Copying Another Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Managing Prompts in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Creating a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Displaying a List of Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Displaying a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Modifying a Prompt in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Deleting Prompts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Managing Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Creating a Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Displaying a List of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Displaying a Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Modifying a Parameter in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Deleting Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Chapter 22. Plan Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Using Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Group for Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Plan List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Plan List of Domain Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Creating a Plan List of Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Creating a Plan List of Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Creating a Plan List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Creating a Plan List of Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Creating a Plan List of Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Modifying the Properties of a Plan List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Deleting a Plan List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Detaching a Plan List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Finding Objects in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Managing Job Instances in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Displaying a List of Jobs in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
xii Version 8.1

Modifying the Properties of a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Displaying Dependencies of a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Adding Predecessors to a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Deleting Predecessors from a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Displaying Successors of a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Holding a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Releasing a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Browsing the Job Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Rerunning a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Canceling a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Killing a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Confirming a Job Instance SUCC or ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Releasing a Job Instance from Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Managing Job Stream Instances in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Displaying a List of Job Streams in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Displaying and Changing the Properties of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . 319
Displaying Dependencies of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Adding Predecessors to a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Deleting Predecessors from a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Displaying Successors of a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Holding a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Releasing a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Canceling a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Changing the Job Limit of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Changing the Priority of a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Releasing a Job Stream Instance from Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Re-submitting a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Submitting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Monitoring Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Submitting Jobs and Job Streams into the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Submitting a Job Stream into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Submitting a Job into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Viewing or Modifying the Properties of the Job to Submit . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Submitting an Ad Hoc Job into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
Managing Workstations in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Displaying a List of Workstations in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Displaying a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Tivoli Job Scheduling Console User’s Guide xiii

Changing the Job Limit of a Workstation in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Changing the Job Fence of a Workstation in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Starting a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Stopping a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Linking a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Unlinking a Workstation Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Managing Domains in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Displaying a List of Domains in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Starting the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Stopping the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Linking the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Unlinking the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Switching the Domain Manager in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Managing File Dependencies in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Displaying File Dependencies Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Managing Prompt Dependencies in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Displaying Prompt Dependencies Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Replying to a Prompt Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Managing Resource Dependencies in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Displaying Resource Dependencies Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Displaying the Properties of a Resource Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Changing the Number of Units of a Resource Dependency. . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Setting an Alternate Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
Part IV. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Appendix A. Using Common Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Creating a Common List of Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Listing All Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Using Filter Criteria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
Creating a Common List of Job Stream Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Listing All Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Using Filter Criteria. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Displaying a Common List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Modifying a Common List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Deleting a Common List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Appendix B. Setting Traces for the Job Scheduling Console . . . . . . . . . . 381

Appendix C. Enabling Time Zones in the Workload Scheduler . . . . . . . . 385
xiv Version 8.1

Appendix D. Status Description and Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . 387
Appendix E. Job Scheduling Console Messages . . . . . . . . . . . . . . . . . . . . . . . 391

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Tivoli Job Scheduling Console User’s Guide xv

xvi Version 8.1
Figures
1. Job Scheduling View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2. Properties - Database Resource List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3. Properties - Group of Lists Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4. Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5. Properties - Workstation in Database Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
6. Find Workstations Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
7. Properties - Workstation in Database General Window General Page. . . . . . . . . . . . . . . . . . . . . . . . . 56
8. Properties - Workstation in Database Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
9. Adding an Open Time Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
10. The Properties - Database Workstation List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
11. Properties - Resource in Database Window Resource Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
12. Properties - Resource in Database Default Workstations Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
13. Properties - Resource in Database Availability Intervals Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
14. The Properties - Database Resource List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
15. List of Resources in the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
16. The Properties - Resource in Database Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
17. Properties - Job Stream Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
18. Properties - JCL Job General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
19. Properties - JCL Job Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
20. Properties - JCL Job Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
21. Properties - JCL Job Resources Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
22. Job Stream Editor Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
23. Job Stream Editor - Add Link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
24. Job Stream Editor - Example Dependent Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
25. Properties - External Job Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
26. Selecting the External Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
27. Job Stream Editor — External Job Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
28. Job Stream Editor — Example External Job Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
29. Job Stream Editor - Run Cycle View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
30. Properties - Rule-based Run Cycle General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
31. Properties - Rule-based Run Cycle Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
32. Properties - Rule-based Run Cycle Rules Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
33. Example Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
34. Example 1: Rule-based Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
35. Example 2: Exclusionary Run Cycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
36. Example 3: Exclusionary Run Cycle Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
37. Properties - Offset-based Run Cycle Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
38. Example 1: Offset-based Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
39. Example 2: Offset-based Run Cycle Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
40. Job Stream Editor - Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
41. Submit Job Stream Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
42. The Properties - Job Stream List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
43. Displaying the Results of a Job Stream List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
44. Properties - External Job Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
45. Job Stream Editor - External Job Added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
46. Properties - Job Stream Instance List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
47. The Properties - Job Instance List window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
48. Job Stream Instances List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
49. Job Stream Instances Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Tivoli Job Scheduling Console User’s Guide xvii

50. Properties - Job Stream Instance General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
51. Properties - Job Stream Instance Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
52. Timeline View - Left Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
53. Timeline View - Right Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
54. Rescheduling a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
55. Properties - Job Stream Instance Time Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
56. Rescheduling the Start time of a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
57. Rescheduling the Deadline Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
58. Job Instances List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
59. Job Instances Groups in the Timeline View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
60. Properties - JCL Job Instance Instance General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
61. Properties - JCL Job Instance Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
62. Properties - JCL Job Instance Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
63. Properties - JCL Job Instance Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
64. Properties - JCL Job Instance Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
65. Properties - JCL Job Instance Resources Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
66. Target Resources for a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
67. Logical Resources for a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
68. Dependencies - JCL Job Instance Predecessors Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
69. Dependencies - JCL Job Instance Successors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
70. Timeline View of Job Instances - Left Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
71. Timeline View of Job Instances - Right Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
72. Rescheduling a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
73. Rescheduling the Start Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
74. Rescheduling the Deadline Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
75. Impact View Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
76. Change Status Dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
77. Edit JCL Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
78. The Properties - Plan Workstation List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
79. Plan Workstation List Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
80. Properties - Workstation in Plan General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
81. Properties - Workstation in Plan Resource Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
82. Properties - Workstation in Plan Job Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
83. Properties - Workstation in Plan Open Time Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
84. Changing the Start Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
85. Changing the Start Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
86. Changing the Quantity of Resource 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
87. Change Status - Workstation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
88. List of Jobs Scheduled on the Workstation and in Complete Status . . . . . . . . . . . . . . . . . . . . . . . . . 171
89. The Properties - Plan Resource List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
90. A Plan Resource List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
91. Properties - Resource in Plan Resource Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
92. Properties - Resource in Plan Default Workstations Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
93. Properties - Resource in Plan Availability Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
94. Properties - Group of Lists Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
95. Create Database List Pop-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
96. Properties - Job Stream List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
97. Properties - Job List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
98. Properties - Database Workstation List window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
99. Properties - Database Resource List window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
100. Properties - Workstation Class List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
101. Properties - Prompt List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
xviii Version 8.1

102. Properties - Parameter List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
103. Properties - NT User List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
104. Properties - Domain List Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
105. Properties - Calendar List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
106. Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
107. Properties - Resource in Database Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
108. Find Workstation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
109. Select a Task Type Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
110. Properties - Job Definition General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
111. Properties - Job Definition: Task Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
112. Job Definition List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
113. Details for Job Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
114. Properties - Job Definition Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
115. Job Stream Editor Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
116. Job Stream Editor Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
117. Job Stream Editor Run Cycle View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
118. Properties - Job Stream Properties General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
119. Properties - Job Stream Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
120. Properties - Job Stream Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
121. Properties - Job Stream Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
122. Properties - Job Stream Prompts Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
123. Job Stream External Dependencies Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
124. External Dependencies Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
125. Properties - Job General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
126. Properties - Job Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
127. Properties - Job Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
128. Properties - Job Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
129. Properties - Job Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
130. External Job Stream Dependency Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
131. External Job Dependency Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
132. Job Stream Editor Window Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
133. Simple Run Cycle General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
134. Simple Run Cycle Rule Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
135. Weekly Run Cycle General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
136. Weekly Run Cycle Rule Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
137. Calendar Run Cycle General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
138. Calendar Run Cycle Rule Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
139. Job Streams List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
140. Properties - Workstation in Database Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
141. Workstation List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
142. Properties - Workstation Class General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
143. Properties - Workstation Class Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
144. Workstation Class List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
145. Properties - Domain Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
146. Properties - NT User Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
147. Users List Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
148. Properties - Calendar Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
149. Monthly Yearly Calendar Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
150. Day of Month Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
151. Properties - Resource in Database Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
152. Resource List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
153. Properties - Prompt Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Tivoli Job Scheduling Console User’s Guide xix

154. Prompts List Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
155. Properties - Parameter Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
156. Parameter List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
157. Properties - Group of Lists Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
158. Properties - Plan Workstation List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
159. Properties - Domains Status List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
160. Properties - Job Stream Instance List General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
161. Properties - Job Stream Instance List Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
162. Properties - Job Stream Instance List Dependencies Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
163. Properties - Job Instance List General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
164. Properties - Job Instance List Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
165. Properties - Job Instance List Dependencies Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
166. Properties - Plan Resource List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
167. Properties - Prompt Status List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
168. Properties - File Status List window.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
169. Example of a Find Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
170. Example Find Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
171. Job Instance List View Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
172. Job Instance List: Timeline View window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
173. Properties - NT Script Instance General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
174. Properties - NT Script Instance Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
175. Properties - NT Script Instance Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
176. Properties - NT Script Instance Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
177. Properties - NT Script Instance Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
178. Properties - NT Script Instance Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
179. Dependencies - NT Script Instance Successors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
181. Job instance Log File Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
182. Rerun Job Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
183. Job Stream Instances Timeline View Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
184. Job Stream Instances List View Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
185. Properties - Job Stream Instance General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
186. Properties - Job Stream Instance Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
187. Properties - Job Stream Instance Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
188. Properties - Job Stream Instance Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
189. Properties - Job Stream Instance Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
190. Dependencies Predecessors Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
192. Change Limit - Job Stream Instance Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
193. Change Priority - Job Stream Instance Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
194. Re-Submit Job Stream Instance Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
195. Submit Job Stream into Plan Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
196. Submit Job into Plan Window - Default Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
197. Submit Job into Plan Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
198. Properties - Job Instance General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
199. Properties - Job Instance Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
200. Properties - Job Instance Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
201. Properties - Job Instance Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
202. Properties - Job Instance Prompts Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
203. Properties - Job Instance Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
204. Properties - Job Instance Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
205. Submit Ad Hoc Job into Plan Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
xx Version 8.1
206. Properties - Job Instance General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
207. Properties - Job Instance Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
208. Properties - Job Instance Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
209. Properties - Job Instance Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
210. Properties - Job Instance Prompts Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
211. Properties - Job Instance Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
212. Properties - Job Instance Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
213. Workstation Status List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
214. Properties - Workstation in Plan Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
215. Change Limit - Workstation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
216. Change Fence - Workstation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
217. Switch Manager - Domain Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
218. Status of All Files List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
219. Set Alternate Plan Files Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
220. Properties - Job Instance Common List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
221. Properties - Job Stream Instance Common List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Tivoli Job Scheduling Console User’s Guide xxi

xxii Version 8.1
Tables
1. List of Publications for Tivoli Workload Scheduler for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxix
2. List of Publications for Tivoli Workload Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxx
3. Job Scheduling Console Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4. Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
6. Authorization Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7. Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
9. Authorization Roles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
10. Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
11. Job Scheduling Console Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
12. Starting the Job Scheduling Console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
13. Job Scheduling View Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
14. Object List Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
15. Default Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
16. Default Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
17. Properties List Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
18. Properties - Workstation in Database General Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
19. Properties - Workstation in Database Open Time Intervals Information . . . . . . . . . . . . . . . . . . . . . . . 63
20. User-defined Workstation Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
21. Default Workstation Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
22. Properties - Database Workstation List Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
23. Create a Resource Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
24. Define an Availability Interval Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
25. User-defined Resource Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
26. Default Resource Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
27. Database Resource List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
28. Tasks in Creating a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
29. Properties - Job Stream Window Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
30. What Happens When You Define a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
31. Graph View Job Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
32. Properties - JCL Job General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
33. Properties - JCL Job Task Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
34. Properties - JCL Job Time Restrictions Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
35. Filter Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
36. Run Cycle Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
37. Run Cycle General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
38. Run Cycle Time Restrictions Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
39. Rule-based Run Cycle Rules Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
40. Offset-based Run Cycle Rules Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
41. Submit Job Stream Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
42. Properties - Job Stream List Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
43. Adding and Modifying Jobs and Dependencies in the Graph View . . . . . . . . . . . . . . . . . . . . . . . . . 113
44. Adding and Modifying Run Cycles – Pop-up Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
45. Examples of How to Use Job and Job Stream Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
46. Properties - Job Stream Instance List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
47. Properties - Job Instance List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
48. Job Instance Details Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
49. Properties - JCL Job Instance General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Tivoli Job Scheduling Console User’s Guide xxiii

50. Properties - JCL Job Instance Task Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
51. Properties - JCL Job Instance Details Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
52. Properties - Write-to-Operator Job Instance Options Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
53. Logical Resources Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
54. Dependencies Predecessors Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
55. Dependencies Predecessors Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
56. Dependencies Successors Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
57. Dependencies Predecessors Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
58. Timeline View Job Instance Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
59. Impact View Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
60. Properties - Plan Workstation List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
61. Properties - Workstation in Plan General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
62. Workstation List Jobs Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
63. Modifying Job Instance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
64. Plan Resource List Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
65. Properties - Resource in Plan Resource Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
66. Properties - Resource in Plan Default Workstations Information . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
67. Properties - Resource in Plan Availability Intervals Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
68. Modifying Job Instance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
69. Properties List Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
70. Properties List Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
71. New Job Definition Task Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
72. Properties - Job Definition General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
73. Job Stream Recovery Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
74. Task Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
75. Job Definition List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
76. Details for Job Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
77. Job Stream Editor Graph View Toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
78. Job Stream Editor Timeline View Toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215
79. Job Stream Editor Run Cycles View Toolbar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
80. Job Stream Properties Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
81. Job Stream Properties General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
82. Job Stream Time Restrictions Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
83. Properties - Job General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
84. Properties - Job Time Restrictions Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
85. Colored Bars on Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
86. Properties Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
87. Properties Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
88. Job Streams List Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
89. Modifying Objects in a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
90. Properties - Workstation in Database Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
91. Workstation List Window Columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
92. Properties - Workstation Class Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
93. Workstation Class List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
94. Properties - Domain Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
95. Domain List Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
96. Properties - NT User Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
97. Users List Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
98. Example Calendars. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
99. Properties - Resource in Database Window Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
100. Properties - Job Stream Instance List General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
101. Properties - Job Stream Instance List Time Restrictions Information . . . . . . . . . . . . . . . . . . . . . . . . 283
xxiv Version 8.1

102. Properties - Job Stream Instance List Dependency Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
103. Properties - Job Instance List General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
104. Properties - Job Instance List Time Restrictions Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
105. Properties - Job Instance List Dependency Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
106. Properties - Plan Resource List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
107. Properties - Prompt Status List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
108. Job Instance Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
109. Job Instance List View Columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
110. Job Instance Timeline View Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
111. Properties - NT Script Instance General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
112. Properties - NT Script Instance Task Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
113. Properties - NT Script Instance Time Restrictions Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
114. Properties - NT Script Instance Files Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
115. Properties - NT Script Instance Prompts Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
116. Properties - NT Script Instance Resources Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
117. Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
118. Internetwork Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
119. Successors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
121. Rerun Job Window Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
122. Job Stream Instance Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
123. Job Stream Instances Timeline View Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
124. Job Stream Instances List View Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
125. Properties - Job Stream Instance General Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
126. Properties - Job Stream Instance Time Restrictions Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
127. Properties - Job Stream Instance Files Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
128. Properties - Job Stream Instance Prompts Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
129. Properties - Job Stream Instance Resources Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
130. Dependencies - Job Stream Instance Predecessor Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
132. Job Stream Instance Priorities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
133. Submit Job Stream into Plan Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
134. Submit Job into Plan Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
135. Submit Job into Plan Window - Specific Job stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
136. Properties - Job Instance General Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
137. Properties - Job Instance Time Restrictions Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342
138. Properties - Job Instance Files Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
139. Ad Hoc Prompt Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
140. Predefined Prompt Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346
141. Properties - Job Instance Resources Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
142. Properties - Job Instance Predecessors Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348
143. Properties - Job Instance General Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
144. Task Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
145. Properties - Job Instance Time Restrictions Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
146. Properties - Job Instance Files Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
147. Ad Hoc Prompt Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
148. Predefined Prompt Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
149. Properties - Job Instance Resources Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
150. Properties - Job Instance Predecessors Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
151. Workstation Status List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
152. List of Domains in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
153. Status of All Files List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Tivoli Job Scheduling Console User’s Guide xxv

154. Prompt Dependencies Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
155. Resource Dependencies Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
156. Set Alternate Plan Files Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
157. Properties - Job Instance List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
158. Properties - Job Stream Instance List Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
159. Trace Variable Location by Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
160. Job Scheduling Console Job States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
161. Workload Scheduler Internal Job States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
162. Job Scheduling Console Job Stream States . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
163. Workload Scheduler Internal Job Stream States. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
164. Job Status Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
165. Job Stream Status Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
xxvi Version 8.1

Preface
This guide describes Tivoli Workload Scheduler for z/OS™, Tivoli Workload Scheduler, and
the Tivoli Job Scheduling Console, which make up the Tivoli Workload Scheduler suite of
applications. The Tivoli Job Scheduling Console provides users with a Java™-based user
interface to Tivoli Workload Scheduler for z/OS and Tivoli Workload Scheduler. The Job
Scheduling Console supplements, but does not totally replace, the traditional z/OS ISPF
panes on the host. It allows you to work with scheduling objects in the following ways:
¶ Define job streams, jobs, workstations, and logical resources in the scheduling database.
¶ Monitor and modify job stream instances, job instances, workstation instances, and
resource instances in the plan.
The Tivoli Job Scheduling Console User’s Guide provides an introduction to and an
explanation of the Tivoli Job Scheduling Console Feature Level 1.2. It explains how to
install the console and provides instructions for performing scheduling tasks using Tivoli
Workload Scheduler for z/OS and Tivoli Workload Scheduler.
Who Should Read This Guide

This guide is intended for use by:
¶ System administrators who have the task of installing the Tivoli Job Scheduling
Console. They should be familiar with one or more of the following operating systems:
Microsoft® Windows®
AIX®
HP-UX
Sun Solaris
Linux
¶ Schedulers who have the responsibility of creating and updating definitions of objects in
the scheduler database and of creating lists of objects in the scheduler database and plan.
They should be familiar with performing these specific tasks and with working in the
IBM® z/OS and Microsoft Windows NT® environments:
¶ Operators who have the responsibility of controlling and monitoring the scheduler plan.
They should be familiar with performing the tasks related to monitoring and modifying
objects in the plan and with working in the IBM z/OS and Windows NT environment.
What This Guide Contains

This book contains the following sections:
Part I. Getting started
Part I contains the following chapters:

¶ Chapter 1, “Introduction” on page 5
provides an introduction to the Job Scheduling Console
¶ Chapter 2, “Installing Tivoli Job Scheduling Services” on page 13
describes how to install Job Scheduling Services.
¶ Chapter 3, “Installing the Tivoli Workload Scheduler for z/OS Connector” on page 17
describes how to install the Tivoli Workload Scheduler for z/OS Connector.
Tivoli Job Scheduling Console User’s Guide xxvii

¶ Chapter 4, “Installing the Tivoli Workload Scheduler Connector” on page 25
describes how to install the Tivoli Workload Scheduler Connector.
¶ Chapter 5, “Installing the Tivoli Job Scheduling Console” on page 33
describes how to install the Tivoli Job Scheduling Console.
¶ Chapter 6, “Working with the Job Scheduling Console” on page 41
describes the main features of the Job Scheduling Console.
Part II. Using the Job Scheduling Console with Tivoli Workload Scheduler for z/OS
Part II contains the following chapters:

¶ Chapter 7, “Managing Workstations in the Database” on page 55
describes how to create workstations and workstation lists.
¶ Chapter 8, “Managing Resources in the Database” on page 69
describes how to create and list resources.
¶ Chapter 9, “Creating Job Streams” on page 79
describes how to create job streams, specify dependencies, schedule and submit job
streams.
¶ Chapter 10, “Listing and Modifying Job Streams” on page 109
describes how to create job stream lists and how to modify them.
¶ Chapter 11, “Listing Job Stream and Job Instances” on page 119
describes how to create lists of jobs and job instances.
¶ Chapter 12, “Managing Job Streams” on page 127
describes how to display and modify job stream instances.
¶ Chapter 13, “Managing Jobs” on page 137
describes how to display and modify job instances.
¶ Chapter 14, “Managing Workstations in the Plan” on page 161
describes how to display and modify workstations.
¶ Chapter 15, “Managing Resources in the Plan” on page 173
describes how to display and modify resources in the plan.
Part III. Using the Job Scheduling Console with Tivoli Workload Scheduler
Part III contains the following chapters:

¶ Chapter 16, “Managing Database Lists” on page 189
describes how to create all types of Workload Scheduler lists.
¶ Chapter 17, “Managing Jobs” on page 201
describes how to create and manage job definitions.
¶ Chapter 18, “Managing Job Streams” on page 213
describes how to use the Job Stream Editor to create, display, and modify job streams.
¶ Chapter 19, “Managing Workstations and Workstation Classes” on page 251
describes how to create, display, and modify workstations and workstation classes.
¶ Chapter 20, “Managing Domains, Users, and Calendars” on page 261
describes how to create, display, and modify domains, users, and calendars.
xxviii Version 8.1

¶ Chapter 21, “Managing Resources, Prompts, and Parameters” on page 271
describes how to create, display, and modify resources, prompts, and parameters.
¶ Chapter 22, “Plan Tasks” on page 279 describes how to create and manage resources in
the plan.
Part IV. Appendixes
Part IV contains the following Appendixes:

¶ Appendix A, “Using Common Lists” on page 375
describes how to create and modify common lists.
¶ Appendix B, “Setting Traces for the Job Scheduling Console” on page 381
describes how to use the Job Scheduling Console tracing facility.
¶ Appendix C, “Enabling Time Zones in the Workload Scheduler” on page 385
describes how to enable the time zone facility.
¶ Appendix D, “Status Description and Mapping” on page 387
provides information about job and job stream status.
¶ Appendix E, “Job Scheduling Console Messages” on page 391
lists the messages produced by the Job Scheduling Console.
Publications
This section lists publications in the Tivoli Workload Scheduler suite. It also describes how
to access Tivoli publications online, how to order Tivoli publications, and how to make
comments on Tivoli publications.
The Tivoli Workload Scheduler libraries comprise:

¶ Publications for Tivoli Workload Scheduler for z/OS
¶ Publications for Tivoli Workload Scheduler
Tivoli Workload Scheduler for z/OS
Publications
The following table lists the publications in the Tivoli Workload Scheduler for z/OS library.
Table 1. List of Publications for Tivoli Workload Scheduler for z/OS
Task Publication Order number
Planning Tivoli Workload Tivoli Workload Scheduler for z/OS GH19-4540
Scheduler for z/OS Licensed Program Specifications
Understanding the Tivoli Tivoli Workload Scheduler for z/OS GH19-4539
Workload Scheduling Suite General Information
Learning concepts and Tivoli Workload Scheduler for z/OS SH19-4542
terminology Getting Started
Using the Java GUI Tivoli Workload Scheduler for z/OS GI10-5781
Tivoli Job Scheduling Console User’s
Guide Release Notes
Interpreting messages and codes Tivoli Workload Scheduler for z/OS SH19-4548
Messages and Codes
Tivoli Job Scheduling Console User’s Guide xxix

Table 1. List of Publications for Tivoli Workload Scheduler for z/OS (continued)
Installing Tivoli Workload Tivoli Workload Scheduler for z/OS SH19-4543
Scheduler for z/OS Installation Guide
Customizing and tuning Tivoli Tivoli Workload Scheduler for z/OS SH19-4544
Workload Scheduler for z/OS Customization and Tuning
Planning and scheduling the Tivoli Workload Scheduler for z/OS SH19-4546
workload Planning and Scheduling the Workload
Controlling and monitoring the Tivoli Workload Scheduler for z/OS SH19-4547
current plan Controlling and Monitoring the
Workload
Writing application programs Tivoli Workload Scheduler for z/OS SH19-4545
Programming Interfaces
Quick reference Tivoli Workload Scheduler for z/OS GH19-4541
Quick Reference
Diagnosing failures Tivoli Workload Scheduler for z/OS LY19-6410
Diagnosis Guide and Reference
Tivoli Workload Scheduler

Publications
The following table lists the publications in the Tivoli Workload Scheduler library.
Table 2. List of Publications for Tivoli Workload Scheduler
Installing a Tivoli Workload Tivoli Workload Scheduler Planning SH19-4555
Scheduler network and Installation
Using the command line interface, Tivoli Workload Scheduler Reference SH19-4556
scheduling language, and utility Guide
commands
Installing and configuring limited Tivoli Workload Scheduler Limited SH19-4558
fault-tolerant agents on AS/400 Fault-Tolerant Agent for AS/400 User’s
Guide
Setting up and using the Plus Tivoli Workload Scheduler Plus Module SH19-4562
module User’s Guide
Interpreting messages Tivoli Workload Scheduler Error SH19-4557
Messages
Accessing Publications Online

You can access many Tivoli publications online at the Tivoli Customer Support Web site:
http://www.tivoli.com/support/documents/
These publications are available in PDF or HTML format, or both. Translated documents are
also available for some products.
xxx Version 8.1

Workload Scheduler for z/OS
All the books in the Tivoli Workload Scheduler for z/OS library, except the licensed
publications, are available in displayable softcopy form on CD-ROM in the following
Softcopy Collection Kit:
¶ OS/390®, SK2T-6951
You can read the softcopy books on CD-ROMs using these IBM licensed programs:
¶ BookManager® READ/2
¶ BookManager READ/DOS
¶ BookManager READ/6000
All the BookManager programs need a personal computer equipped with a CD-ROM disk
drive (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 provided in softcopy only.

Ordering Publications
You can order many Tivoli publications online at:
http://www.tivoli.com/support/Prodman/html/pub_order.html
You can also order by telephone by calling one of these numbers:

¶ In the U.S.: 800-879-2755
¶ In Canada: 800-426-4968
¶ In other countries, for a list of telephone numbers, see the following Web site:
http://www.tivoli.com/inside/store/lit_order.html
Providing Feedback about Publications
We are very interested in hearing about your experience with Tivoli products and
documentation, and we welcome your suggestions for improvements. If you have comments
or suggestions about our products and documentation, contact us in one of the following
ways:
¶ Send an e-mail to pubs@tivoli.com.
¶ Complete our customer feedback survey at the following Web site:
http://www.tivoli.com/support/survey/
¶ Complete the Readers Comment Form provided at the back of the book.
LookAt
LookAt is an online facility that allows you to look up explanations for z/OS messages and
system abends. Using LookAt to find information is faster than a conventional search
because LookAt goes directly to the explanation. LookAt can be accessed from the internet
or from a Time Sharing Option (TSO) command line.
You can use LookAt on the Internet at:
http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/lookat.html
Tivoli Job Scheduling Console User’s Guide xxxi

To use LookAt as a TSO command, LookAt must be installed on your host system. You can
obtain the LookAt code for TSO from the LookAt Web site by clicking on News and Help,
or from the SK3T-4269.
To find a message explanation from a TSO command line, type the message ID, as in the
following example:
lookat iec192i
This results in direct access to the message explanation for message IEC192I.
To find a message explanation from the LookAt Web site, type the message ID. You can
select the release if needed.
Some messages have information in more than one book. For example, IEC192I has routing
and descriptor codes listed in OS/390 MVS Routing and Descriptor Codes, GC28-1778. For
such messages, LookAt prompts you to choose which book to open.
Contacting Customer Support

If you have a problem with any Tivoli product, you can contact Tivoli Customer Support.
See the Tivoli Customer Support Handbook at the following Web site:
http://www.tivoli.com/support/handbook/
The handbook provides information about how to contact Customer Support, depending on
the severity of your problem, as well as the following information:
¶ Registration and eligibility
¶ Telephone numbers and e-mail addresses, depending on the country you are in
¶ What information you should gather before contacting support
Conventions Used in This Book

This book uses several conventions for special terms and actions, operating
system-dependent commands and paths, and margin graphics.
Typeface Conventions
The following typeface conventions are used in this book:
Bold Lowercase and mixed-case commands, command options, and flags that
appear within text appear like this, in bold type.
Graphical user interface elements, except for titles of windows and dialogs
and names of keys also appear like this, in bold type.
Italic Variables, values you must provide, new terms, and words and phrases that
are emphasized appear like this, in italic type.
Monospace Commands, command options, and flags that appear on a separate line, code
examples, output, and message text appear like this, in monospace type.
Names of files and directories, text strings you must type, when they appear
within text, names of Java methods and classes, and HTML and XML tags
also appear like this, in monospace type.
xxxii Version 8.1

Operating System-dependent Variables and Paths
This book uses the UNIX® convention for specifying environment variables and for
directory notation.
When using the Microsoft Windows command line, replace $variable with %variable% for
environment variables and replace each forward slash (/) with a backslash (\) in directory
paths.
Note: If you are using the bash shell on a Windows system, you can use the UNIX
conventions.
Other Conventions
Wildcards, as used in this book, are defined as:
* (asterisk) Used to represent a character string.
? (question mark) Used to represent a single character.
Tivoli Job Scheduling Console User’s Guide xxxiii

xxxiv Version 8.1
I — Getting Started
Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Tivoli Workload Scheduler for z/OS Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Planning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Working with Job Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Working with Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Working with Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Working with Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Working with Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Operator Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Working with Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Working with Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Working with Resource Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Tivoli Workload Scheduler Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Planning Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Working with Job Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Operator Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Workstations in the Current Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Working with Resources in the Current Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Scheduling Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Terminology Used in the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Chapter 2. Installing Tivoli Job Scheduling Services . . . . . . . . . . . . . . . . . . . . 13

Before Installing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Uninstalling Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Installing Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Chapter 3. Installing the Tivoli Workload Scheduler for z/OS

Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Supported Platforms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Installing the Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Tivoli Job Scheduling Console User’s Guide 1

Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Customizing the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Creating Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Authorization Roles Required for Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Managing Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Uninstalling the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Chapter 4. Installing the Tivoli Workload Scheduler Connector . . . . . . . . . 25

Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Job Scheduling Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Workload Scheduler Master . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Fault-tolerant Agents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Installing the Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Where to Install. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Setting the Tivoli Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installing from the Tivoli Desktop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Installing from the Command Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Customizing the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Creating Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Authorization Roles Required for Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Managing Connector Instances. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Uninstalling the Connector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Updating Workload Scheduler Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Useful Framework Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Chapter 5. Installing the Tivoli Job Scheduling Console. . . . . . . . . . . . . . . . . 33

For Use With Tivoli Workload Scheduler for z/OS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
For Use With Tivoli Workload Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Installing on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
Installing on AIX and HP-UX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Updating AIXconsole.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Installing on Solaris and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Starting the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Uninstalling the Job Scheduling Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Uninstalling on Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Uninstalling on AIX, HP-UX, Solaris, and Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
Chapter 6. Working with the Job Scheduling Console . . . . . . . . . . . . . . . . . . . 41

The Job Scheduling View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Using the Buttons of the Job Scheduling View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
2 Version 8.1
Working with Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Default Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Default Database Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Default Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Creating a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
Specifying Defaults for Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Creating a Group of Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Detaching a List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Modifying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Deleting a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Example: Finding a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

4 Version 8.1
1. Introduction
1
Introduction
The Tivoli Job Scheduling Console for Tivoli Workload Scheduler is an interactive interface
for creating, modifying, and deleting objects in the product database. It also allows you to
monitor and control objects scheduled in the current plan.
The Job Scheduling Console allows you to work with Tivoli Workload Scheduler for z/OS
and Tivoli Workload Scheduler. You can work with these products simultaneously from the
same graphical console.
Extensions, built into the Job Scheduling Console, extend its base scheduling functions to
specific scheduling functions of Tivoli Workload Scheduler for z/OS and of Tivoli Workload
Scheduler.
Connectors manage the traffic between the Job Scheduling Console and the job schedulers.
Connectors are installed separately on a Tivoli management server and on managed nodes
that have access to the scheduler.
Note: To use the Job Scheduling Console with Tivoli Workload Scheduler for z/OS, you
must install the Workload Scheduler for z/OS Connector. To use the Job Scheduling
Console with Workload Scheduler, you must install the Workload Scheduler
Connector.
To use the Job Scheduling Console with both schedulers, you must install both types
of Connector, one for each type of scheduler.
The Job Scheduling Console provides two main functions:

Scheduling
Enables you to define and list job streams, jobs, and resource availability in the
scheduler database.
Monitoring and control
Enables you to monitor and control scheduled jobs and job streams in the scheduler
plan. In the Job Scheduling Console, a scheduled job stream is called a job stream
instance whereas a scheduled job is called a job instance.
For each of these functions, you can use a list creation mechanism that enables you to list
database or plan objects that you select according to filtering criteria. Filtering criteria
narrow a list down to selected objects that you want to work with. You can list objects
without using filtering criteria. In this case, the list displays all the existing objects of a kind.
You can use both predefined lists that are packaged with the Job Scheduling Console, and
lists that you create.

This chapter describes the features of the base Job Scheduling Console. The base Job
Scheduling Console provides a common set of functions on which the specific functions of
the supported job scheduler extensions are implemented. The rest of this chapter provides a
functional overview of the Job Scheduling Console for Tivoli Workload Scheduler for z/OS
and for Tivoli Workload Scheduler.
Tivoli Workload Scheduler for z/OS Tasks

Planning Tasks
From the Job Scheduling Console, you can define and manage the following objects in the
scheduler database:
¶ Job streams
¶ Jobs
¶ Resources
¶ Workstations
Working with Job Streams

Job streams are a collection of jobs, scheduling information, and the resources they require
to run. The jobs that comprise a job stream usually follow a sequence where the running of
a job depends on the successful completion of another job. Creating a job stream involves:
¶ Defining job stream properties
¶ Creating jobs, which includes defining what resources each job requires to run and the
start time
¶ Defining the necessary dependencies, or sequencing, among the jobs of the job stream
and with jobs that belong to other job streams
¶ Defining one or more run cycles, or the days on which the job stream must run and
when it must start
Modifying a job stream involves adding, deleting, or modifying any of the jobs that
comprise it, along with the dependencies and run cycles. You can also delete an entire job
stream.
Job stream definitions are stored in the job scheduler databases. To browse or update job
streams you have created, you must make and run a list of job streams in the database.
Working with Jobs

Jobs are the units of work in a job stream. You cannot create jobs outside of a job stream.
You must first create a job stream and define its properties before you can start to create the
jobs that comprise it. Creating a job involves:
¶ Defining job properties
¶ Specifying when the job must run (time restrictions) within its job stream run cycle
¶ Defining the properties of the task associated with the job, if applicable
¶ Specifying the resources that the job requires to run
Jobs are stored in the job scheduler database as parts of job streams. To browse, update, or
delete a job definition, you must list the parent job stream in the database.
6 Version 8.1
1. Introduction
Working with Run Cycles
A run cycle provides the scheduling information of a job stream. Like jobs, you can create
run cycles only after you have defined the job streams to which they apply. A job stream can
have more than one run cycle. Creating a run cycle involves:
¶ Defining run cycle properties
¶ Specifying when the run cycle starts and how long it lasts
¶ Specifying the rules that define the run days for the job stream
Run cycle definitions are stored in the job scheduler database as parts of job streams. To
browse, update, or delete a run cycle definition, you must list the parent job stream in the
database.
Working with Workstations

A workstation describes how and when jobs have to be run. A workstation is not necessarily
hardware—it is a stage in the processing that is controlled by the scheduler. Workstations are
usually created to represent specific elements in your system configuration. Defining a
workstation involves:
¶ Defining workstation properties
¶ Defining resources and their capacity
¶ Defining the availability of servers
Working with Resources

Resources represent physical or logical devices that jobs use in order to run. Defining a
resource involves:
¶ Defining the resource general properties
¶ Specifying availability intervals, periods during which the resource state and quantity
available for running jobs differ from the values specified as general properties.
Resource definitions are stored in the job scheduler database. To browse, update, or delete a
resource definition, you must make and run a list of resources in the database.
Operator Tasks
From the Job Scheduling Console, you can monitor and control the following objects in the
scheduler plan:
¶ Job stream instances
¶ Job instances
¶ Resource instances
¶ Workstations
To monitor and control these objects, you must first display them in a list in the Job
Scheduling Console.
Working with Job Stream Instances

Job streams that are scheduled in the plan are job stream instances. You can browse, modify,
and delete job stream instances, provided you display them in a job stream instance list.
Modifying a job stream instance includes changing some of its general properties, the start
and deadline times, the job instances it contains, and their dependencies.

Working with Job Instances
Jobs belonging to a job stream that is scheduled in the plan are job instances. You can
browse, modify, and delete job instances after displaying them in a job instance list.
Modifying a job instance involves:
¶ Changing its state, resource dependencies, and time restrictions
¶ Deleting predecessor and successor jobs in the job instance dependency chain
Working with Resource Instances

A resource instance is a resource allocated to the plan. The resource is reserved for the
duration of the plan for use by the jobs that depend on it. The status and quantities of the
resource are specified in the general properties and availability intervals definitions in the
database. You can, however, modify the resource availability intervals and quantity after the
resource has been allocated to the plan.

You can create, update, and delete workstation definitions in the scheduler database. You
define the following workstation characteristics:
¶ General properties
¶ Availability status during specific periods of time
¶ Available quantities during specific periods of time
You can list workstations defined in the scheduler database, selected according to filtering
criteria, and browse or modify their properties. You can also delete workstations from the
database.
Tivoli Workload Scheduler Tasks

The Tivoli Workload Scheduler extension supports all the tasks of the base Job Scheduling
Console. In addition, it supports specific functions and resources, such as scheduling
resources and workstations. These are described in the following sections of this chapter.
Planning Tasks
All the tasks that involve working with object definitions in the scheduling database are
referred to as scheduler tasks in this guide. Once you have saved an object in the database,
you must first list it in the Job Scheduling Console if you want to browse, change, or delete
it.

You can create, update, and delete workstation definitions in the scheduler database. You
define the following workstation characteristics:
¶ Availability status during specific periods of time
¶ Available quantities during specific periods of time
You can list workstations defined in the scheduler database, selected according to filtering
criteria, and browse or modify their properties. You can also delete workstations from the
database.
8 Version 8.1
1. Introduction
Working with Job Streams
You can use the Job Scheduling Console to work with job streams and job stream templates.
Job stream templates contain only scheduling information. When you define a job stream as
belonging to a template, you imply that it must share the template calendar and run cycles.
You can:
¶ Create, update, or delete job stream templates
¶ Add or remove a job stream from a job stream template
¶ List job stream templates in the scheduler database
Working with Jobs

When you create or modify a job, the Tivoli Workload Scheduler extension adds the
following features to a basic job definition:
¶ Assigning the necessary special (logical) and workstation resources for the running of
the job
¶ Defining the automatic and feedback options
Working with Resources

You can create, update, and delete resource definitions in the scheduler database. You define
the following resource characteristics:
¶ Availability status on a given workstation during specific periods of time
¶ Available quantities on a given workstation during specific periods of time
¶ Workstations connected to the resource
You can list resources defined in the scheduler database, selected according to filtering
criteria, and browse or modify their properties. You can also delete resources from the
database.
Operator Tasks
All the tasks that involve working with objects in the plan, are referred to as operator tasks
in this book. You must first list the objects in the plan in order to work with any of them.
Working with Job Stream Instances

In addition to monitoring job stream instances, you can change the status of a job stream
instance to Waiting and Complete.
Working with Job Instances

You can:
¶ Change the status of job instances to: Running, Ready, Interrupted, Error, or Successful
¶ Run, hold, or release the job instance
¶ Remove or restore (NOP or UN-NOP) the job instance in the plan
Working with Workstations in the Current Plan

You can create and update workstation instance definitions in the plan. This includes editing:
¶ Control properties
¶ Availability status to run jobs during specific intervals of time

¶ Available quantities that jobs can use during specific intervals of time
You can also view the job instances scheduled to run on a given workstation at any time
during the plan.
Working with Resources in the Current Plan

You can create and update resource instance definitions in the plan. This includes editing the
following:
¶ Control properties
¶ Availability status on a given workstation during specific intervals of time
¶ Available quantities on a given workstation during specific intervals of time
¶ Workstations connected to the resource
Scheduling Job Streams

When you create a job stream, the job stream run cycles are used to generate the dates and
times at which the job stream will run. Each occurrence of a job stream is called a job
stream instance, and each job stream instance contains job instances.
After you complete the definition of a job stream in terms of jobs, dependencies, and run
cycles, and you mark it active in the Job Stream Properties window, you have to go to the
scheduler to schedule the job stream into the current plan. You cannot add a job stream to
the plan from the Job Scheduling Console.
Terminology Used in the Job Scheduling Console

The terminology used in the Job Scheduling Console varies from that used in Tivoli
Workload Scheduler for z/OS. Table 3 lists Tivoli Workload Scheduler for z/OS terms, their
Job Scheduling Console equivalents, and a brief explanation. For more information, see the
“Glossary” on page 395.
Table 3. Job Scheduling Console Terminology
Tivoli Workload Tivoli Workload Explanation
Scheduler for z/OS Scheduler
Application description Job stream A sequence of jobs, including the resources and
workstations that support them, and scheduling
information.
Application group Job stream template A grouping of job streams that provides
scheduling information, such as a calendar, a
free-day rule, and run cycles that can be inherited
by all the job streams that have been created
using the template.
Current plan Plan A detailed plan of system activity that covers a
period of at least one minute and not more than
21 days, but typically one or two days. The plan
encompasses all job and job stream instances and
the resources and workstations involved in
running them.
External dependency External job A job from one job stream that is a predecessor
for a job in another job stream.
10 Version 8.1
1. Introduction
Table 3. Job Scheduling Console Terminology (continued)
Tivoli Workload Tivoli Workload Explanation
Scheduler for z/OS Scheduler
In-effect date for run Valid from The first date that a run cycle is valid.
cycles
Input arrival time (Earliest) start time The time before when a job or job stream is
planned to be ready for processing.
Negative run cycle Exclusionary run cycle Specifies when a job stream must not run.
Occurrence Job stream instance A job stream that is scheduled for a specific run
date in the plan.
Controller Engine The component that runs on the controlling
system, and that contains the tasks that manage
the plans and databases.
Operation Job A unit of work that is part of a job stream and
that is processed at a workstation.
Operation number Job identifier The number that identifies a job.
Operations in the current Job instances A job scheduled for a specific run date in the
plan plan.
Out-of-effect date for run Valid to The last date that a run cycle is valid.
cycles
Run cycle with offsets Offset-based run cycle Includes a user-defined period and an offset, such
as the 3rd day in a 90-day period.
Run cycle with rules Rule-based run cycle Includes a rule, such as the first Friday of March
or the second workday of the week.
Special resources Logical resources Any type of limited resource, such as tape drives,
communication lines, databases, or printers, that
is needed to run a job.
Status: Complete Successful The job or job stream has been completed.
Status: Delete Canceled The job or job stream has been deleted from the
plan.
Status: Started Running The job has started (jobs only).
Task Job A job performed at a computer workstation.

12 Version 8.1
2
Installing Tivoli Job Scheduling Services
2. Installing Tivoli Job

Scheduling Services
This chapter describes how to install Tivoli Job Scheduling Services. You must install Job
Scheduling Services before you install either the Workload Scheduler for z/OS Connector or
the Workload Scheduler Connector.
You can install Job Scheduling Services either from the Tivoli desktop or from the command
line.
Note: You must install Job Scheduling Services on the Tivoli server and on each managed
node where the Connector is to be installed.
Before Installing
Read this information before you install Job Scheduling Services.
System Requirements
The Connector has the following system requirements:
Software
¶ Tivoli Management Framework:
Version 3.7.1 for Microsoft Windows, AIX, HP-UX, and Sun Solaris
Version 3.7B for Linux
Hardware
¶ CD-ROM drive for installation.
¶ Approximately 4 MB of free disk space.
Setting the Tivoli Environment

To install Job Scheduling Services, you must first set the Tivoli environment. To do this, log
in as root or administrator, then enter one of the following commands:
Table 4. Setting the Tivoli Environment
For this operating system ... Enter this command ...
AIX, Solaris, HP-UX, Linux ./etc/Tivoli/setup_env.sh
Microsoft Windows, UNIX shell .c:/windir/system32/drivers/etc/Tivoli/setup_env.sh
Microsoft Windows, DOS shell c:\windir\system32\drivers\etc\Tivoli\setup_env.cmd
where windir is the name of the Microsoft Windows installation directory.

Installing from the Tivoli Desktop
To install the Connector from the Tivoli Desktop, ensure you have set the Tivoli
environment (see “Setting the Tivoli Environment” on page 13), then:
1. Open the Tivoli Desktop.
2. From the Desktop menu select Install, then Install Product. The Install Product
window is displayed.
3. Click Select Media to select the installation directory. The File Browser window is
displayed.
4. Type or select the installation path. This path includes the directory containing the
CONTENTS.LST file.
5. Click Set Media & Close. You return to the Install Product window.
6. In the Select Product to Install list, select Tivoli Job Scheduling Services.
7. In the Available Clients list, select the managed nodes to install on and move them to
the Clients to Install On list.
Note: You must install Job Scheduling Services on at least the Tivoli management
server. You can install the Connector only on managed nodes where Job
Scheduling Services is installed.
8. Click Install. The Product Install window is displayed, which shows you the progress
of the installation.
9. Click Continue Install to continue the installation or click Cancel to cancel the
installation.
10. The installation program copies the files and configures the Tivoli database with the
new classes. When the installation is complete, the message Finished product
installation appears. Click Close.
14 Version 8.1
Installing from the Command Line
To install the Connector from the command line, ensure you have set the Tivoli environment
(see “Setting the Tivoli Environment” on page 13), then enter one of the following
commands:
¶ To install on all managed nodes:
winstall -c install_dir -i TMF_JSS
¶ To install on only one managed node:
winstall -c install_dir -i TMF_JSS node
2. Installing Tivoli Job

Scheduling Services
where:
install_dir
is the path containing the Job Scheduling Services installation program.
node
is the name of the destination managed node.
You must install Job Scheduling Services on at least the Tivoli management server. You can
only install the Connector on managed nodes where Job Scheduling Services is installed.

Uninstalling Job Scheduling Services
Before you uninstall Job Scheduling Services, ensure you have uninstalled the Workload
Scheduler for z/OS Connector, the Workload Scheduler Connector, or both.
To uninstall Job Scheduling Services, ensure you have set the Tivoli environment (see
“Setting the Tivoli Environment” on page 13), then enter one of the following commands:
¶ On AIX, Solaris, HP-UX, and Linux, enter:
wuninst TMF_JSS node -rmfiles
¶ On Microsoft Windows, first enter:
bash
then enter:
wuninst TMF_JSS node -rmfiles
where:
node
is the name of the system from which you want to remove Job Scheduling Services.
This removes the Job Scheduling Services classes and installation files.
Installing Patches
To install patches, ensure you have set the Tivoli environment (see “Setting the Tivoli
Environment” on page 13), then:
2. From the Desktop menu select Install, then Install Patch. The Install Patch window is
displayed.
3. Follow the instructions presented online.
16 Version 8.1
3
Installing the Tivoli Workload Scheduler
for z/OS Connector
This chapter describes how to install the Tivoli Workload Scheduler for z/OS Connector. The
Job Scheduling Console communicates with the Workload Scheduler for z/OS system
through the Connector, a protocol converter that translates the instructions entered through
the console into scheduler commands. Although the Connector must be running to use the
console, you can install them in the order you prefer.
You must install the Connector on a Tivoli server or managed node, while the Job
Scheduling Console can be installed on any workstation that has a TCP/IP connection with
3. Installing Scheduler for

the machine running the Connector. For information about how to install a Tivoli server or
managed node, refer to the Tivoli Framework Planning and Installation Guide and the Tivoli
z/OS Connector
Framework Release Notes.
This chapter explains how to install the Workload Scheduler for z/OS Connector. “Installing
the Tivoli Workload Scheduler Connector” on page 25 explains how to install the Workload
Scheduler Connector. “Installing the Tivoli Job Scheduling Console” on page 33 explains
how to install the Job Scheduling Console.
Before Installing
Read this information before you install the Connector.
System Requirements
Software
¶ Tivoli Workload Scheduler for z/OS 8.1, or Tivoli OPC 2.1 or later
¶ Tivoli Job Scheduling Services 1.2
¶ TCP/IP network communications.
¶ A Workload Scheduler for z/OS user account is required for proper installation. You can
create the account beforehand, or have the Setup program create it for you.
Hardware
¶ CD-ROM drive for installation.

¶ Approximately 100 MB of free disk space for domain managers, and fault-tolerant
agents. Approximately 40 MB for standard agents. In addition, the Workload Scheduler
for z/OS produces log files and temporary files, which are placed on the local hard
drive. The amount of space required depends on the number of jobs managed by
Workload Scheduler for z/OS, and the amount of time you choose to retain log files.
¶ 128 MB RAM and 128 MB swap space for domain managers and fault-tolerant agents.
Standard agents require less.
Supported Platforms
The Tivoli Workload Scheduler for z/OS Connector is supported on the following platforms:
¶ Microsoft Windows:
NT 4.0 with Service Pack 5 or Service Pack 6a
Professional, Server, and Advanced Server 2000 with Service Pack 1 and Service
Pack 2
¶ IBM AIX 4.3.3, 4.3.3s, 5.1
¶ HP-UX PA-RISC 11.0, 11i
¶ Sun Solaris 2.7, 2.8
¶ Linux Red Hat 7.1
Job Scheduling Services
Job Scheduling Services 1.2 must be installed in your Tivoli environment before you install
the Connector.
Installing the Connector

Installation comprises the following:
1. Installing the Connector on the Tivoli server.
2. Creating Connector instances. You must create one instance for each engine that you
want to access from the Job Scheduling Console. The Connector instance name must be
unique within the scheduler network.
You can install the Connector either from the Tivoli desktop or from the command line.
Note: Ensure that you have already installed Job Scheduling Services. If you have not yet
done so, see “Installing Tivoli Job Scheduling Services” on page 13.
If you want to re-install the Connector, you must uninstall the existing one before you do.
See “Uninstalling the Connector” on page 22.
To install the Connector, you must first set the Tivoli environment. To do this, log in as root
or administrator, then enter one of the following commands:
18 Version 8.1
environment (see “Setting the Tivoli Environment” on page 18), then:
2. From the Desktop menu, select Install, then Install Product. The Install Product
displayed.
4. Type or select the installation path. The path includes the directory containing the
CONTENTS.LST file.
6. Select Tivoli OPC Connector.
7. In the Available Clients list, select the managed nodes to install on and move them to
the Clients to Install On list.

Note: You must install the Connector on at least the Tivoli management server. You
z/OS Connector
can create instances only on managed nodes where the Connector is installed.
8. Click Install. The Product Install window is displayed, which shows you the progress
of the installation.
installation.
commands:
winstall -c install_dir -i opc
winstall -c install_dir -i opc node
where:
install_dir
is the path containing the Connector installation program.
node
You must install the Connector on at least the Tivoli management server. You can create
instances only on managed nodes where the Connector is installed.

Customizing the Connector
This section describes how to customize the Connector.
Creating Connector Instances
Create one Connector instance for each engine that you want to access with the Tivoli Job
Scheduling Console. To create an instance, provide the information that enables the
Connector to connect to the TCP/IP server. For information about activating server support
for TCP/IP, refer to the Tivoli Workload Scheduler for z/OS Installation Guide.
Note: You must be a Tivoli administrator with admin, senior, or super authorization roles.
For more information refer to “Authorization Roles Required for Instances”.
Enter the following command on the Tivoli server or managed node where you installed the
Connector that you need to access through the Job Scheduling Console:
wopcconn -create [-h node] -e engine_name -a address -p port
where:
node
is the name or the ID of the managed node on which you are creating the instance. The
name of the Tivoli server is the default.
engine_name
is the name of the new instance.
address
is the IP address of the z/OS system where the scheduler subsystem that you want to
connect to is installed.
port
is the port number of the TCP/IP server to which the Connector will connect.
You can also run the wopcconn utility in interactive mode. To do this:
1. On the command line, enter wopcconn with no arguments.
2. Select choice number 1 in the first menu.
Authorization Roles Required for Instances
To manage Connector instances from a Tivoli server or managed node, you must be a Tivoli
administrator with one or more of the following roles:
Table 6. Authorization Roles
These roles ... Can perform these tasks ...
user Use the instances
View instance settings
admin, senior, super Perform all actions available to the user role
Create and remove instances
Change instance settings
Start and stop instances
Note: To control access to the scheduler, the TCP/IP server associates each Tivoli
administrator to a Remote Access Control Facility (RACF®) user. For this reason, a
20 Version 8.1
Tivoli administrator should be defined for every RACF user. For additional
information, refer to the Tivoli Workload Scheduler for z/OS Customization and
Tuning book.
Managing Connector Instances
Use the wopcconn utility to create, remove, and manage Connector instances. This program
is downloaded when you install the Connector.
Note: Before you use wopcconn, you must set the Tivoli environment. See “Setting the
Tivoli Environment” on page 18.
The following table describes how to use wopcconn on the command line to manage
Connector instances:
To do this ... Use this command ...

Create an instance wopcconn -create -h node -e engine_name -a address -p port
Stop an instance wopcconn -stop -e engine_name | -o object_id
Start an instance wopcconn -start -e engine_name | -o object_id
Restart an instance wopcconn -restart -e engine_name | -o object_id
Remove an instance wopcconn -remove -e engine_name | -o object_id

View the settings of an wopcconn -view -e engine_name | -o object_id
instance. Also view other
z/OS Connector
information, such as product
version and the object ID of
the instance.
Change the settings of an wopcconn -view -e engine_name | -o object_id -n new_name -a
instance address -p port -t trace_level -l trace_length
where:
node
is the name or the object ID (OID) of the managed node on which you are creating the
instance. The name of the Tivoli server is the default.
engine_name
is the name of the new or existing instance.
object_id
is the object ID of the instance.
new_name
is the new name for the instance.
address
is the IP address of the z/OS system where the Workload Scheduler for z/OS subsystem
that you want to connect to is installed.
port
is the port number of the Workload Scheduler for z/OS TCP/IP server to which the
Connector must connect.
trace_level
is the trace detail level, from 0 to 5.
trace_length
is the maximum length of the trace file.

You can also use wopcconn in interactive mode. To do this, simply enter the command,
without arguments, in the command line.
Uninstalling the Connector

To uninstall the Connector, ensure you have set the Tivoli environment (see “Setting the
Tivoli Environment” on page 18), then enter one of the following commands:
¶ On AIX, HP-UX, Solaris, and Linux, enter:
wuninst OPCConnector node -rmfiles
$bash
then enter:
wuninst OPCConnector node -rmfiles
where:
node
is the name of the system from which you want to remove the Connector. To uninstall
the Connector from all the managed nodes on which it is installed, replace node with the
name of the Tivoli server.
This command removes:

¶ The Connector files
¶ All the defined Connector instances
¶ All the related class definitions
Installing Patches
displayed.
Useful Framework Commands

These commands can be used to check your Framework environment. Refer to the Tivoli
Framework Reference Guide for more details.
Table 7. Useful Framework Commands
This command ... Performs this function ...
wlookup -ar ProductInfo Lists the products installed on the Tivoli server.
wlookup -ar PatchInfo Lists the patches installed on the Tivoli server.
22 Version 8.1
Table 7. Useful Framework Commands (continued)
wlookup -ar MaestroEngine Lists the instances of this class type (same for the other classes).
For example::
barb 1318267480.2.19#Maestro::Engine#
The number before the first period (.) is the region number and the
second number is the managed node ID (1 is the Tivoli server). In
a multi-Tivoli environment, you can determine where a particular
instance is installed by looking at this number because all Tivoli
regions have a unique ID.
wuninst -list Lists all the products that can be uninstalled.
wuninst {ProductName} -list Lists the managed nodes where a product is installed.

z/OS Connector

24 Version 8.1
4. Installing Scheduler
Connector
4
Installing the Tivoli Workload Scheduler
Connector
This chapter describes how to install the Tivoli Workload Scheduler Connector. The Job
Scheduling Console communicates with the Tivoli Workload Scheduler system through the
Connector, a protocol converter that translates the instructions entered through the console
into scheduler commands. Although the Connector must be running to use the console, you
can install them in the order you prefer.
You must install the Connector on a Tivoli server or managed node, while the Job
Scheduling Console can be installed on any workstation that has a TCP/IP connection with
the machine running the Connector. For information about how to install a Tivoli server or
managed node, refer to the Tivoli Framework Planning and Installation Guide and the Tivoli
Framework Release Notes.
Before Installing
Read this information before you install the Connector.
System Requirements
Software
¶ Tivoli Workload Scheduler 8.1
¶ TCP/IP network communications.
¶ A Workload Scheduler user account is required for proper installation. You can create
the account beforehand, or have the Setup program create it for you.
Hardware
¶ CD-ROM drive for installation
¶ Approximately 100 MB of free disk space for domain managers, and fault-tolerant
agents. Approximately 40 MB for standard agents. In addition, the Workload Scheduler
produces log files and temporary files, which are placed on the local hard drive. The
amount of space required depends on the number of jobs managed by Workload
Scheduler, and the amount of time you choose to retain log files.

¶ 128 MB RAM and 128 MB swap space for domain managers and fault-tolerant agents.
Standard agents require less.
Supported Platforms
The Tivoli Workload Scheduler Connector is supported on the following platforms:
Pack 2
¶ IBM AIX 4.3.3, 4.3.3s, 5.1
Job Scheduling Services
Job Scheduling Services 1.2 must be installed in your Tivoli environment before you install
the Connector.
Workload Scheduler Master
The Connector installation and customization varies depending on whether your Workload
Scheduler master is on a Tivoli Server or on a managed node.
¶ When the Workload Scheduler master is on a Tivoli server, you must install both the Job
Scheduling Services and the Connector on the Tivoli server of your environment. You
must also create a Connector instance for the Tivoli server. You can do this during
installation by using the Create Instance checkbox and completing the required fields.
¶ When the Workload Scheduler master is on a managed node, you must install Job
Scheduling Services on the Tivoli Server and on the managed node where the master is
located. You must then install the Connector on the Tivoli server and on the same nodes
where you installed Job Scheduling Services. Ensure that you do not select the Create
Instance checkbox.
If you have more than one node where you want to install the Connector (for example,
if you want to access the local data of a fault-tolerant agent through the Job Scheduling
Console), you can install the connector on multiple machines. However, in this case you
should deselect the Create Instance checkbox, because each instance must have a
unique name in the Workload Scheduler network.
After you have installed the connector on the workstations in your network, you can
proceed with the creation of Connector instances on the machines you need to access the
scheduler through the Job Scheduling Console.
Note: Each Connector instance name must be unique within the Workload Scheduler
network, so you must create each instance separately. Preferably, use the name of
the scheduler agent as the instance name.
Fault-tolerant Agents
Workload Scheduler fault-tolerant agents that are accessed through the Job Scheduling
Console to check local data, must have Job Scheduling Services and a Connector installed.
In addition, there must be a unique Connector instance for each installation you need to
access through the Job Scheduling Console.
26 Version 8.1
Note: Each Connector instance name must be unique within your scheduler network.
Connector
Installing the Connector
Installation comprises the following:
1. Installing Job Scheduling Services (see “Installing Tivoli Job Scheduling Services” on
page 13). Skip this step if you have already done this.
Note: Job Scheduling Services must be installed before the Connector, and must be
installed on the Tivoli server.
2. Installing the Connector on the Tivoli server.
3. Creating the Connector instance. There must be one instance for every Workload
Scheduler engine you want to access through the Job Scheduling Console. The
Connector instance name must be unique within the scheduler network.
You can install the Connector either from the Tivoli desktop or from the command line.
Note: Ensure that you have already installed Job Scheduling Services. If you have not yet
done so, see “Installing Tivoli Job Scheduling Services” on page 13.
If you want to re-install the Connector, you must uninstall the existing one before you do.
See “Uninstalling the Connector” on page 31.
Where to Install
Install the Connector on the Tivoli server and on the managed node where the scheduler
master is installed.
You can also install the connector on a fault-tolerant agent, if you want to access local data
on the fault-tolerant agent from the Job Scheduling Console.
To install the Connector, you must first set the Tivoli environment. To do this, log in as root
or administrator, then enter one of the following commands:

environment (see “Setting the Tivoli Environment”), then:
2. From the Desktop menu choose Install, then Install Product. The Install Product
displayed.

4. Type or select the installation path. This path includes the directory containing the
CONTENTS.LST file.
6. In the Select Product to Install list, select Tivoli TWS Connector. The Install Options
7. This window enables you to:
¶ Install the Connector only.
¶ Install the Connector and create a Connector instance.
Note: If you decide not to create the instance at this time, you can create it later by
using the wtwsconn utility from the command line (see “Creating Connector
Instances” on page 29). Creating the Connector instance later is
recommended when installing the Connector on multiple nodes, because you
can perform the installation simultaneously on all the nodes while creating
the instance locally using wtwsconn.
8. To install the Connector without creating a Connector instance, leave the Create
Instance checkbox clear and leave the General Installation Options fields blank.
These fields are used only during the creation of the Connector Instance.
9. To install the Connector and create a Connector Instance:
a. Select the Create Instance checkbox.
b. In the TWS directory field, specify the directory where Workload Scheduler is
installed.
c. In the TWS instance name field, specify a name for the Workload Scheduler
instance on the managed node. This name must be unique in the network.
10. Click Set to close the Install Options window and return to the Install Product window.
11. In the Available Clients list, select the nodes to install on and move them to the
Clients to Install On list.
You must install the Connector on at least the Tivoli management server. You can install
the Connector only on managed nodes on which Job Scheduling Services is installed.
Note: If you choose to create a Connector instance during the installation, you must
select only one node from the list, because the instance name must be unique
within the Workload Scheduler Network.
12. In the Install Product window, click Install. The Product Install window is displayed,
which shows you the progress of the installation.
installation.
commands:
28 Version 8.1
winstall -c install_dir -i TWS_CONN twsdir=/users/maestro iname= instance_name
Connector
owner=maestro
winstall -c install_dir -i twsdir=/users/maestro iname=instance_name
owner=maestro createinst=1 node
where:
install_dir
is the path containing the Job Scheduling Services installation program.
instance_name
is the name of the instance that appears in the Job Scheduling view.
maestro
is the owner name.
node
You must install the Connector on at least the Tivoli management server. You can create
instances only on managed nodes where the Connector is installed.
Customizing the Connector

This section describes how to customize the Connector.
Creating Connector Instances
Create one Connector instance for each engine that you want to access with the Job
Scheduling Console. To create an instance, you must be a Tivoli administrator with admin,
senior, or super authorization roles. For more information refer to “Authorization Roles
Required for Instances”.
Enter the following command on the Tivoli server or managed node where you installed the
Connector that you need to access through the Job Scheduling Console:
wtwsconn -create -h node -n instance_name -t TWS_directory
where:
node
specifies the node where the instance is created. If not specified, it defaults to the node
where the script file is run.
instance_name
is the name of the new instance. This name identifies the engine node in the Job
Scheduling tree of the Job Scheduling Console. The name must be unique within the
scheduler network.
TWS_directory
specifies the value for the TWSdir attribute. This is the Workload Scheduler installation
directory on the specified node.
Authorization Roles Required for Instances
To manage Connector instances from a Tivoli server or managed node, you must be a Tivoli
administrator with one or more of the following roles:

Table 9. Authorization Roles
These roles ... Can perform these tasks ...
user Use the instances
View instance settings
admin, senior, super Perform all actions available to the user role
Create and remove instances
Change instance settings
Start and stop instances
Note: To control access to the scheduler, the TCP/IP server associates each Tivoli
administrator to a Remote Access Control Facility (RACF) user. For this reason, a
Tivoli administrator should be defined for every RACF user. For additional
information, refer to the Tivoli Workload Scheduler for z/OS: Customization and
Tuning book.
Managing Connector Instances
Use the wtwsconn utility to create, remove, and manage connector instances. This program
is downloaded when you install the Connector.
Note: Before you use wtwsconn, you must set the Tivoli environment. See “Setting the
Tivoli Environment” on page 27.
The following table describes how to use wtwsconn in the command line to manage
Connector instances.
To do this ... Use this command ...

Create an instance wtwsconn.sh -create [-h node] -n instance -t twsdir
Stop an instance wtwsconn.sh -stop -n instance | -t twsdir
Two stop actions are supported:

When -n instance is specified, the instance with that name is stopped.
When -t twsdir is specified, all the instances on this node (the node
where the script is run) whose TWSdir attribute matches twsdir are
stopped.
Remove an instance wtwsconn.sh -remove -n instance
View the settings of an wtwsconn.sh -view -n instance
instance.
Change the settings of wtwsconn.sh -set -n instance -t twsdir
an instance
where:
node
specifies the node where instance is created. If not specified, it defaults to the node
where the script is run from.
instance
is the name of the new instance. This name identifies the engine node in the Job
Scheduling tree of the Job Scheduling Console. The name must be unique within the
scheduler network.
30 Version 8.1
twsdir
Connector
specifies the value for the scheduler dir attribute. This is the Workload Scheduler
installation directory in node.
Uninstalling the Connector

To uninstall the Connector, ensure you have set the Tivoli environment (see “Setting the
Tivoli Environment” on page 27), then enter one of the following commands:
¶ On AIX, Solaris, HP-UX, and Linux:
wuninst TWSConnector node -rmfiles
$bash
then enter:
wuninst TWSConnector node -rmfiles
where:
node
is the name of the system from which you want to remove the Connector.
This stops all Connector processes, then removes Connector classes and installation files.
Installing Patches
displayed.
Updating Workload Scheduler Security

Before you update Workload Scheduler security, you must add the scheduler user as a Tivoli
administrator on the Tivoli desktop. To do this:
1. Open the Tivoli desktop.
2. Do one of the following:
¶ Add the user login to the Edit Logins window for Tivoli Administrators.
¶ Create a Tivoli administrator that has the login of the user.
To update the scheduler security file:

1. Login as the user (usually, TWSuser or maestro).
2. Change directory to TWS home.
3. Enter:
dumpsec >tempsec
4. Edit the tempsec file so it contains the Admin name.

Note: To get the Admin name, open the Tivoli desktop and double-click
Administrators. The Admin name is the Administrators group to which your
login belongs. Usually the name looks like Root_dallas-region. If the Admin
name contains a blank, enclose it in double quotes.
5. Enter:
wmaeutil ALL -stop
This stops the Connector.

6. Enter:
makesec tempsec
Useful Framework Commands

These commands can be used to check your Framework environment. Refer to the Tivoli
Framework Reference Guide for more details.
Table 10. Useful Framework Commands
wlookup -ar ProductInfo Lists the products installed on the Tivoli server.
wlookup -ar PatchInfo Lists the patches installed on the Tivoli server.
wlookup -ar MaestroEngine Lists the instances of this class type (same for the other classes).
For example::
barb 1318267480.2.19#Maestro::Engine#
The number before the first period (.) is the region number and the
second number is the managed node ID (1 is the Tivoli server). In
a multi-Tivoli environment, you can determine where a particular
instance is installed by looking at this number because all Tivoli
regions have a unique ID.
wuninst -list Lists all the products that can be uninstalled.
wuninst {ProductName} -list Lists the managed nodes where a product is installed.
wmaeutil Maestro -Version * Lists the versions of the installed engine, database, and plan.
wmaeutil Maestro -dbinfo * Lists information about the database and the plan.
wmaeutil Maestro -gethome Lists the installation directory of the Connector.
32 Version 8.1
5
Installing the Tivoli Job Scheduling
5. Installing the Tivoli Job

Console
Scheduling Console
This chapter describes how to install the Tivoli Job Scheduling Console on each of the
following operating systems:
Table 11. Job Scheduling Console Supported Platforms
To install on this operating system ... Go to page ...
Microsoft Windows (see “Supported Platforms” on page 34) 35
AIX, HP-UX 36
Sun Solaris, Linux 38
Before Installing
Read this information before you install the Job Scheduling Console.
System Requirements
The Job Scheduling Console has the following system requirements:
For Use With Tivoli Workload Scheduler for z/OS
Software
¶ Tivoli Workload Scheduler for z/OS Connector Version 1.2
¶ Tivoli Workload Scheduler for z/OS Version 8.1 or OPC 2.1 or later
¶ TCP/IP network communication
¶ Java Runtime Environment Version 1.3
Hardware
¶ 70 MB disk space for full installation, or 34 MB for customized (English base) installation
plus approximately 4 MB for each additional language

For Use With Tivoli Workload Scheduler
Software
¶ Tivoli Workload Scheduler Connector
¶ Tivoli Workload Scheduler Version 7.0 or 8.1
¶ TCP/IP network communication
¶ Java Runtime Environment Version 1.3
Hardware
¶ 70 MB disk space for full installation, or 34 MB for customized (English base) installation
plus approximately 4 MB for each additional language
Supported Platforms
The Job Scheduling Console is supported on the following platforms:
Pack 2
98
Millennium Edition
¶ IBM AIX 4.3.3, 4.3.3s, 5.1
34 Version 8.1
Installing on Microsoft Windows
To install the Job Scheduling Console on Microsoft Windows:
1. Insert the Tivoli Job Scheduling Console CD-ROM into the CD-ROM drive.
2. Click Start and select Run.
3. In the Open field, enter:
drv:\Install
where:

drv:
Scheduling Console
is the name of the CD-ROM drive.
The Job Scheduling Console splash window is displayed.
4. Click the down arrow in the language field. This displays a drop-down list containing
all the available languages in which you can perform installation.
5. Select your language and click OK. The Introduction window is displayed.
This window leads you through the installation process, displaying a series of option
windows that enable you to provide the necessary information. You can use the
Previous, Next, or Exit buttons, when enabled, to move through these windows.
6. Click Next. The Choose Install Folder window is displayed.
7. Enter the path where you want to install the Job Scheduling Console. If you need to,
edit the default location provided in the field, or select Choose to open the Select a
folder window where you can specify another location.
8. Click Next. The Choose Shortcut Location window is displayed.
9. Click one of the available radio buttons to specify where the Job Scheduling Console
buttons are to be placed.
10. Click Next. The Choose Install Set window is displayed.
11. If you want to install the Job Scheduling Console in all available languages (Full
Package), click Install. A progress information window is displayed. Go to Step 13.
If you want to select the languages installed with the Job Scheduling Console
(Customized Install), click Customize. The Customize Install window is displayed.
Continue with Step 12.
12. Select in which languages, besides English, you want to install the Job Scheduling
Console. Click Install.
Notes:
a. The Job Scheduling Console displays in your selected language only if the language
matches the regional settings of your computer. If it does not, English is the default.
b. The Job Scheduling Console automatically adjusts to the country, language and time
zone settings of your system.
A progress information window is displayed.

13. When installation is finished, the Install Complete window is displayed.
14. Click Done to close the window. The Job Scheduling Console is now installed.

Installing on AIX and HP-UX
To install the Job Scheduling Console on AIX:
1. Ensure that the Java Runtime Environment is installed. If in doubt, refer to your system
administrator.
2. Add to your system path the ../jre/bin subdirectory of the directory where you
installed the Job Scheduling Console.
3. Mount the CD-ROM drive.
4. Enter:
sh install.bin

6. Select your language and click OK. The Introduction window is displayed.
The window leads you through the installation process, displaying a series of option
10. If you want to install the Job scheduling Console in all available languages (Full
Notes:

13. Click Done. The Job Scheduling Console is installed.
Updating AIXconsole.sh
To complete installation, you must update the AIXconsole.sh file with the path where you
installed the Java Runtime Environment.
36 Version 8.1
To do this:
1. Go to the /bin/java subdirectory of the directory where you installed the Job
Scheduling Console.
2. Open AIXconsole.sh in editing mode.
3. Find the following statement:
JAVAPATH=%ENTRY%
4. Change %ENTRY% with the path to the Java Runtime Environment.

5. Save your changes and exit the editor. You can now start the Job Scheduling Console.
Scheduling Console

Installing on Solaris and Linux
To install the Job Scheduling Console on Solaris:
1. Change to the directory where you downloaded the install.zip file before running the
installer.
2. Enter:
sh install.bin

4. Select your language and click OK.
The Introduction window is displayed.
This window leads you through the installation process, displaying a series of option
7. Click Next. The Choose Shortcut Location window is displayed.
8. Select one of the available radio buttons to specify where the Job Scheduling Console
buttons are to be placed.
10. If you want to install the Job Scheduling Console in all available languages (Full
Notes:

13. Click Done. The Job Scheduling Console is installed.
38 Version 8.1
Starting the Job Scheduling Console
1. Depending on your platform, start the Job Scheduling Console in one of the following
ways:
Table 12. Starting the Job Scheduling Console
On this platform ... In the ..\bin\java subdirectory of the installation path ...
Microsoft Windows NT, 2000 Enter NTconsole
Microsoft Windows 98, ME Enter console

Note: You can also start the Job Scheduling Console by double-clicking the Job Scheduling
Scheduling Console
Console button on the Windows Desktop or by selecting the corresponding item from the Start
menu.
AIX Enter ./AIXconsole.sh
SUN Solaris Enter ./SUNconsole.sh
HP-UX Enter ./HPconsole.sh
Linux Enter ./LINUXconsole.sh
The Tivoli Job Scheduling Console startup window is displayed.

2. In the Login As field, enter the user ID of the Tivoli administrator of the host machine
running the scheduler engine.
3. In the Password field, enter the password to the host machine running the scheduler
Connector
4. In the Host Machine field, enter the name of the Tivoli managed node that runs the
scheduler Connector.
5. Click OK to continue.
6. If you are logging onto the managed node of Host Machine for the first time, an
information pop-up is displayed, telling you how to specify a user preference file for
initialization, if it exists.
7. Click OK. The Open Location window is displayed.
¶ Specify a URL where user preferences are defined. Enter the URL and click on
Load from URL.
¶ Click Get from file to open a window from where you can select a file that contains
initialization data.
¶ Click Cancel to use default user preferences.
The Welcome window is displayed.
Select a radio button, then click OK to start working with the Job Scheduling
Console.
Click Cancel to close the window and work with the Job Scheduling Console
without online assistance.

Uninstalling the Job Scheduling Console
Uninstalling on Microsoft Windows
To uninstall the Job Scheduling Console on Microsoft Windows:
1. Use the Start menu to go to the shortcut location that you specified during installation,
and click Uninstall Tivoli Job Scheduling Console. The InstallAnywhere Uninstaller
2. Click Uninstall. A progress indicator is displayed. When the process completes, it lists
any files that the program was not able to uninstall. You will need to delete those files
manually.
3. Click Exit to close the window and end the uninstall process.
Uninstalling on AIX, HP-UX, Solaris, and Linux
To uninstall the Job Scheduling Console on UNIX platforms, go to the /UninstallerData
subdirectory of the installation path and enter:
./Uninstall_JSconsole
40 Version 8.1
6
Working with the Job Scheduling Console
The Job Scheduling View
The Job Scheduling view is the main window of the Job Scheduling Console.
6. Working with the Job

Scheduling Console
Figure 1. Job Scheduling View
The view consists of two panes. The left pane is a tree view that displays your scheduler
engines (Workload Scheduler, Workload Scheduler for z/OS, or other). If you expand any of
the objects that represent the scheduler engines, you see the lists and groups of lists
available for that particular engine.
The right-hand pane displays a detailed view of the object selected in the tree. This can be
either a number of list objects or the contents of a list in the shape of a table or a Gantt
chart.
The upper part of the Job Scheduling view contains the menu bar and a number of buttons.
You can use the buttons to:
¶ Size the panes
¶ Browse scheduler general properties and set defaults for refreshing list contents
¶ Remove an object from the tree
¶ Create objects in the sheduler database
¶ Create lists of objects in the database and in the plan
¶ Create groups of lists
As an alternative to using the buttons, you can right-click your intended engine to open a
pop-up menu displaying the same options for creating lists, groups of lists, and objects in
the database.

Using the Buttons of the Job Scheduling View
Use the following buttons, located in the toolbar of the Job Scheduling view, to create an
object in the scheduler database, or to create a list of objects defined in the database or in
the plan:
Table 13. Job Scheduling View Buttons
Use this button ... To do this ...
Browse or modify the properties of the selected object. Displays the
properties of the object selected in the tree view. If you have selected a
scheduler, it opens the Properties - Scheduler window. If you have
selected a list, it opens the Properties window of that list. If you have
opened the Job Stream Editor, it displays the Properties window of the
job stream.
Delete the object selected in the tree view.
Open a resource list in a separate window (detached view), instead if the

list displaying in the right hand pane of the Job Scheduling view.
Stop loading a list. This button is active while the results of a list are
being uploaded.
Refresh the results of a list. This button becomes available only after you
have opened a list. Click the button to reload the results of the list on
display in the right-hand pane of the Job Scheduling view.
Create a job stream in the database. Displays the Job Stream Editor
window, where you define job stream properties and create jobs, job
dependencies, and run cycles.
Create a job in the database. Opens the Properties - Job Definition
window.
Create a workstation in the database. Displays the Properties -

Workstation in Database window, where you define workstation
properties, resources, and availability intervals.
Create a resource in the database. Displays the Properties - Resource
window, where you define a resource properties, associated workstations,
and availability intervals.
List job streams defined in the database.
Lists jobs defined in the database. Displays the Properties - Job List
window, where you create a filtered list of selected jobs.
List workstations defined in the database. Displays the Properties -

Database Workstation List window, where you create a filtered list of
selected workstations.
List resources defined in the database. Displays the Properties - Database
Resource List window, where you create a filtered list of selected
resources.
List job stream instances in the plan. Displays the Properties - Job
Stream Instance List window, where you create a filtered list of selected
job streams scheduled in the plan.
42 Version 8.1
Table 13. Job Scheduling View Buttons (continued)
Use this button ... To do this ...
List job instances in the plan. Displays the Properties - Job Instance List
window, where you create a filtered list of selected jobs scheduled in the
plan.
List workstations in the plan. Displays the Properties - Plan Workstation
List window, where you create a filtered list of selected workstations
allocated to the plan.
List resources in the plan. Displays the Properties - Plan Resource List
window, where you create a filtered list of selected resources allocated to
the plan.
Create a group of lists. Displays the Properties - Group of Lists window,
where you enter a name for the new group. The group is added to the
tree of your selected scheduler and you can thereafter create lists as part
of it.
Note: Remember to select your intended engine in the tree before you use an button to
create or to list an object. By default, the Job Scheduling Console selects the first
engine in the list.

Scheduling Console
Button availability in the Job Scheduling view follows the tasks you perform dynamically.
For instance, if you open a list, many of the buttons described above disappear from the Job
Scheduling view. To display the initial layout, collapse the tree view to engine level.
Working with Lists

To browse, update, or delete objects already defined in the database and plan, you must
create and display a list of the objects.
Lists and list groups are displayed both in the tree view and in the right-hand pane of the
Job Scheduling view. The right-hand pane displays all lists and list groups available for the
selected engine. In the right-hand pane, you can only double-click a list to display its results.
In the tree view, double-click an engine to display the lists available for the engine.
Right-click one of the lists to open a pop-up menu that displays the following options:
Table 14. Object List Properties
Select this option ... To do this ...
Properties Open the list properties window. Choose this option to change the
list name, refresh options, or filter criteria.
Delete Delete the list from the tree.
Open Run the list and display the results in the right-hand pane of the
Job Scheduling view.
Detach View Take the results of a list from the Job Scheduling view and places
them in a separate window.
Default Lists
The console provides default lists for every scheduler engine in your installation. There is a
default list for each type of scheduler object. Default lists are general; that is, no selection

criteria are specified. They therefore list all the existing objects. Default lists are grouped in
lists that show objects defined in the database and lists that show objects defined in the
current plan.
You can edit the properties of each default list to add more restrictive selection criteria or to
change its name or refresh options.
Default Database Lists

Table 15 describes the default database lists.
Table 15. Default Database Lists
This list ... Shows ...
All Job Streams All job stream definitions, including jobs,
dependencies, and run cycles.
All Resources All resource definitions.
All Workstations All workstation definitions.
Default Plan Lists

Table 16 describes the default plan lists.
Table 16. Default Plan Lists
This list ... Shows ...
All Scheduled Job Streams All job stream instances.
All Scheduled Jobs All job instances.
Status of all Resources The status of every resource instance.
Status of all Workstations Shows the status of every workstation instance.
You can edit the properties of each default list to add more restrictive selection criteria or to
change its name or refresh options.
Creating a List
To create a list:
1. Select an engine in the tree.
2. Click one of the buttons displayed in the Job Scheduling view. The Properties - Database
Resource List window is displayed.
44 Version 8.1
Figure 2. Properties - Database Resource List Window
3. In the Name field, enter a name for the list. You can use the same name for more than
one list. Different lists maintain their individual properties even if they have the same

name.
Scheduling Console
4. Specify refresh options for the list. This is optional. If a default periodic refresh period is
already specified in the Properties - Scheduler window, this value is automatically
displayed for each new list. You can change or deselect the default. See “Specifying
Defaults for Lists”.
5. Enter or select filtering criteria from those displayed in the window. You can use
combinations of more parameters. The more filters you use, the more restricted is the
search. To generalize your search, use wildcard characters. If you leave all fields blank,
all objects are displayed when you open the list.
For lists of resources only, you can specify if you want the special characters in the
search items to be treated as wildcards, real letters, prefixes, or suffixes.
When you have finished:

¶ Click Apply to display the list results immediately.
¶ Click OK to save the list. The new list is added in the tree under the engine you
selected when creating the list.
Specifying Defaults for Lists
You can use the Properties - Scheduler window to set or change the following defaults for
lists. To do this:
1. In the Job Scheduling view, select a scheduler engine and click the Properties button in
the toolbar. The Properties - Scheduler window is displayed.
2. Open the Settings page and make your adjustments.
Periodic refresh
Select the check box and type the number of seconds after which a list display
will periodically refresh. After you do this, this information is used every time
you click Apply defaults in the properties window of a list. This information is

also automatically displayed in editable form in the Periodic Refresh Options
group of the properties window of each new list you create.
Buffer size for lists
Select a value from the drop-down list. The value determines at which rate the
results of a list are sent onto your screen. For example, if you select 100, the
results of a list are sent in blocks of 100 lines. The default is 50. If you select a
higher number, it takes more time to display the list initially, but less time to
display the entire list when it is scrolled.
Creating a Group of Lists
The Job Scheduling Console allows you to organize your lists into groups. You can organize
your groups of lists by any criterion that will help you to quickly display the objects that
you want to work with. For example, you can create a group gathering lists that enable you
to work with all the objects associated with a particular plan.
First you must create a group, then you can create the lists that comprise it. To create a
group of lists:
2. Click the Create a Group of Lists button or right-click on the engine button and select
Create Group from the pop-up menu.
To create a group in an existing group, select the group and click Create a Group of
Lists on the toolbar or right-click the existing group button and select Create Group
from the pop-up menu.
The Properties - Group of Lists window is displayed.
Figure 3. Properties - Group of Lists Window
3. Enter a name for the group. You can use the same name for more than one group.
Different groups maintain their individual properties even if they have the same name.

¶ Click OK to close the window and save the new group. An button is created for the new
group in the tree view of the Job Scheduling Console.
¶ Click Cancel to close the window without saving the new group.
After creating a group, you can create its member lists and subgroups. Right-click the group
to display a pop-up menu with the following options:
Table 17. Properties List Options
Properties Change the group name.
Delete Delete the group and all its contents.
Create Database List Create a new list of job stream, resource, or workstation
definitions in the database.
46 Version 8.1
Table 17. Properties List Options (continued)
Create Plan List Create a new list of job streams, jobs, resources, or
workstations in the plan.
Create Group Create a subgroup of more lists.
Displaying a List
To display a list:
1. In the tree of the Job Scheduling view, double-click an engine.
2. Right-click the list you want to run and select Load List from the pop-up menu. The list
tool searches the database or plan and displays the objects it finds in the right-hand pane
of the Job Scheduling view.

Scheduling Console
Figure 4. Displaying a List
Note: Alternatively, you can select an engine in the tree and, in the right-hand pane,
double-click the list you want to run.
You can display several lists in sequence. The newest list is displayed above the preceding
ones. However, as long as a list is kept open, it is maintained and refreshed according to the
refresh options specified. To view the list, click the corresponding object in the Job
Scheduling view.
Detaching a List Display
Detaching a list frees the right-pane of the Job Scheduling Console to display other objects.
You can detach multiple lists to view several objects simultaneously.
To detach a list display:

1. Open a list and wait for the results to be displayed.
2. Right-click the list in the tree view and select Detach View from the pop-up menu. The
list window is displayed separately from the Job Scheduling view.
3. To place the list back in the right-hand pane, either close the detached window or
right-click the list in the tree view and select Attach View from the pop-up menu.
Notes:
1. The right-hand pane of the console is not disabled. This is so that you can run other lists
or perform other tasks.

2. You can have a maximum number of seven detached views open at the same time.
3. To prevent your system from overloading, do not have frequent refreshes of many
detached views open at the same time.
Modifying a List
2. Right-click the list you want to modify and select Properties from the pop-up menu.
3. The properties window of the list is displayed.
4. Make your changes.

¶ Click Apply to run the list without closing the window. The list results are displayed in
the right pane of the Job Scheduling Console.
¶ Click OK to save the changes and to close the window.
¶ Click Cancel to close the window without running or saving the changes.
Deleting a List
2. Right-click the list you want to delete and select Delete from the pop-up menu. A
confirmation message is displayed.
3. Click OK. The list is deleted from the tree.
Finding Objects
A contextual find tool in the Job Scheduling Console helps you to find the name of a
resource, workstation, job, or job stream when you need to provide one. The find tool is
available when you can see an ellipsis (...) next to the field where you are asked to enter the
name. An example is shown in the Properties - Workstation in Database window, shown in
the next figure, in which the Find tool ellipsis is identified by the cursor arrow.
48 Version 8.1
Scheduling Console
Figure 5. Properties - Workstation in Database Window
Example: Finding a Workstation

The following example shows how you can use the Find tool to enter the name of an
alternate workstation when you are defining workstation open time intervals.
To use the Find tool:

1. Click the ellipsis. The Find Workstations window is displayed.
Figure 6. Find Workstations Window
2. Enter your search criteria. You can do one or more of the following:
¶ Enter a name in the Find field. You can generalize your search by using wildcards
or leave the field blank to use no filters.
¶ Select one or more check boxes when available.

¶ Add no input. This results in an unfiltered search that produces a list of all the
objects (workstations in this example) defined in Workload Scheduler for z/OS.
3. Click Start. The window expands, and the objects found are listed at the bottom of the
window.
4. Select an object and click Apply. The Find window closes and the name of the object is
automatically entered in the required field.
5. Click OK to close the Properties - Workstation in Database window.
50 Version 8.1
II — Using the Job Scheduling Console
with Tivoli Workload Scheduler for
z/OS
Chapter 7. Managing Workstations in the Database . . . . . . . . . . . . . . . . . . . . . 55
Creating a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Defining Open Time Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Managing Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Default Workstation Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Creating a List of Workstations in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Using Workstation Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Displaying a List of Workstations in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Modifying Workstation Properties in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Deleting a Workstation from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Creating Workstations from Existing Ones in the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Chapter 8. Managing Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . 69

Creating Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Resource Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Default Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Availability Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Managing Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Default Resource Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Listing Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Using Resource Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Displaying a List of Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
Modifying Resource Properties in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Deleting Resources from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Creating Resources from Existing Ones in the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Chapter 9. Creating Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Specifying Properties for the Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Creating a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Creating a Job Using Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Creating a Job Using Copy and Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Creating Dependencies between Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Creating Dependencies within a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Creating Dependencies between Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Finding a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Scheduling Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Types of Run Cycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Creating a Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

General Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
Creating Rule-based Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
Example 1: Rule-based Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Example 2: Exclusionary Run Cycle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Example 3: Exclusionary Run Cycle Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Creating Offset-based Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
Example 1: Offset-based Run Cycle. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Example 2: Offset-based Run Cycle Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Checking Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Activity Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Table Frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
Time Restrictions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Other Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Saving a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Submit a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Chapter 10. Listing and Modifying Job Streams . . . . . . . . . . . . . . . . . . . . . . . . 109

Default Job Stream List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Creating a Job Stream List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Displaying a Job Stream List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Modifying Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Modifying Job Stream Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Adding and Modifying Jobs and Dependencies in the Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Modifying a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
Adding a New Job using Copy and Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Deleting a Job or External Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Editing Another Job Stream from an External Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Removing a Dependency between Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Adding and Modifying Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Viewing and Modifying Time Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Deleting Job Streams from the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using Copy to Add an External Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Using Existing Definitions to Create Other Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Chapter 11. Listing Job Stream and Job Instances . . . . . . . . . . . . . . . . . . . . . 119

Creating Lists of Job Stream and Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Default Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Listing Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Listing Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Job Stream Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Browsing and Modifying Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Using the General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Using the Time Restrictions Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Changing Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Rescheduling the Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Rescheduling the Start Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
52 Version 8.1
Rescheduling the Deadline Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
Deleting a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Setting a Job Stream Instance to Complete. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Setting a Job Stream Instance to Waiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Rerunning a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Additional Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

Job Instance Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Browsing and Modifying Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Details Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Options Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Target Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
Logical Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Browsing and Modifying Job Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Predecessors Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Successors Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Changing Time Restrictions in the Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
Rescheduling the Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
Rescheduling the Start Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Rescheduling the Deadline Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Deleting Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Putting Job Instances on Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Releasing Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Displaying Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Set as Root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Browsing the Job Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Removing a Job Instance from the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Restoring a Job Instance to the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Running a Job Instance Immediately . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Changing the Status of a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Editing JCL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Viewing Operator Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Modifying Job Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Restart and Cleanup. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Chapter 14. Managing Workstations in the Plan . . . . . . . . . . . . . . . . . . . . . . . . 161

Creating a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Displaying Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Browsing and Modifying Workstation Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Job Summary Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Open Time Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167

Linking Fault-Tolerant Workstations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Changing Workstation Status and Rerouting Scheduled Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Displaying by Status the Job Instances Scheduled on a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Modifying the Job Instances Scheduled on a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Chapter 15. Managing Resources in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Creating a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Displaying Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Browsing and Modifying Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Default Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Availability Intervals Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Displaying the Job Instances Associated with a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
Modifying Job Instances Associated with a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
54 Version 8.1
7. Managing Workstations
in the Database
7
Managing Workstations in the Database
The Tivoli Workload Scheduler for z/OS environment is defined in terms of resources and
workstations. A workstation describes how jobs have to be run. A workstation is not
necessarily hardware. It is a stage in the processing that is controlled by the scheduler.
To schedule a job instance, you must define a workstation beforehand. Before the scheduler
can start a job instance, the workstation on which the job instance is defined must be
available. So, by controlling workstation availability, you control the running of job
instances that are defined on the workstation.
The scheduler establishes the availability of a workstation by using the open intervals in the
list of available workstations in the database. These are the times when workstation
resources and parallel servers are available to process work. Parallel servers and resources
are usually necessary to run work at the workstation.
Workstations are usually created to represent specific elements in your system configuration.
The availability of these workstations should reflect the availability of those elements in the
real world. For instance, a computer workstation might be created for each z/OS system in a
scheduler complex. So, the availability of the computer workstation should reflect the
availability of the z/OS system it represents. This prevents the scheduler from submitting
work to a z/OS system that is not physically available. Also, the accuracy of any planning
predictions that the scheduler produces for you depends on how accurately you have
described the installation to the scheduler.
This chapter describes how to use the Job Scheduling Console to define and administer the
availability of workstations. For a full description of workstations, refer to the Tivoli
Workload Scheduler for z/OS Planning and Scheduling the Workload book.

Creating a Workstation
This section describes how to create a workstation in the Workload Scheduler for z/OS
database.
In the Job Scheduling view, select the engine in whose database you want to work, then
click the New Workstation button in the toolbar. The new workstation will be defined in
the database of that engine.
General Page
When you click the New Workstation button, the Properties - Workstation in Database
General page is displayed. This is where you enter general information for the workstation.
Figure 7. Properties - Workstation in Database General Window General Page
56 Version 8.1
in the Database
Use the information in Table 18 to enter all the information required to create the
workstation.
Table 18. Properties - Workstation in Database General Information
In this area ... Enter this information ...
Name Required. Specify a name for the new workstation.
Description Enter a description of the workstation.
Workstation type Select one of the following:
General for preparation of jobs and for control of
operations that are normally not controlled
automatically.
Computer for running of jobs and started tasks.
Printer for printing.
Reporting attribute Select one of the following mechanisms for reporting status
updates on the jobs defined on the workstation:
Automatic if the status change of jobs is reported
automatically, in response to event records
created by Tivoli Workload Scheduler for z/OS.
Typically, you should use this reporting
attribute for computer and print workstations, or
for workstations that specify a user-defined
destination.
Manual start and completion
if the status change of jobs is reported either
from the Ready List ISPF panes on the host or
from the results of a workstation status list (see
“Using Workstation Lists” on page 67 for
details). Typically, you should use this reporting
attribute for general workstations that are used
for job preparation, or for other general
workstations if the duration of the task needs to
be tracked.
Completion only
if the status change of jobs is reported either
from the Ready List ISPF panes on the host or
from the results of a workstation status list (see
“Using Workstation Lists” on page 67 for
details). Typically, you should use this reporting
attribute for general workstations that are not
used for job preparation.
Non reporting if jobs on this workstation are set to complete
as soon as they become eligible to be started.
Typically, you should use this reporting
attribute for dummy jobs created to simplify the
sequencing of other jobs.
Printout routing Enter the ddname of the daily printout data set where reports for
this workstation are to be written.

Table 18. Properties - Workstation in Database General Information (continued)
Control on servers Use the two check boxes, Control on servers and Planning on
Planning on servers servers, to specify how the workstation uses parallel servers.
When you create a Tivoli Workload Scheduler for z/OS job, you
specify how many parallel servers it requires. The workstation
that the job is using must have that number of parallel servers
available before the job can run. You set this value when you
create the workstation, but you can change it later.
We recommend that you select both the Control on servers and

the Planning on servers check boxes, so that Tivoli Workload
Scheduler for z/OS submits jobs only up to the limit of the
number of servers specified. If you select the Planning on
servers check box only, or no check box at all, then Tivoli
Workload Scheduler for z/OS will not evaluate the number of
parallel servers when deciding when to start an operation. In
addition, the number of parallel servers will be used only for
planning purposes, and the plans that Tivoli Workload Scheduler
for z/OS produces cannot accurately predict the behavior of real
work in your system, because Tivoli Workload Scheduler for
z/OS will submit as many jobs as are ready, regardless of its
count of the number of servers in use.
Note: At a non–STC computer workstation, a parallel server can
represent a Job Entry Subsystem initiator. You must allocate at
least one parallel server when you define a job. If you select
both check boxes, or the Control on servers box only, the
number of parallel servers required by the job must also be
available on the workstation before the job can be started.
Splittable Select this box to specify that jobs on the workstation can be
interrupted and then continued at a later time. Use this attribute
for a job setup general workstation where you prepare JCL for
submission. If the preparation of the JCL is interrupted by the
preparer issuing the TSAVE command, the operation is given
status I, interrupted. Preparation of the JCL can continue at a
later time. Printer workstations can also be split, but operations
on computer workstations cannot be split.
Started task, STC Select one of these three check boxes according to which
Job setup workstation type you chose:
WTO Started task, STC
if this is a computer workstation that will run
started tasks rather than jobs.
Job setup if this is a general workstation on which to
prepare job JCLs or started task JCLs manually
before running. You do not need this attribute if
Tivoli Workload Scheduler for z/OS can resolve
all the JCL variables automatically.
WTO if this is a general workstation on which the
Tivoli Workload Scheduler for z/OS scheduling
facilities can issue a write-to-operator message
at the operator console designated in
Destination.
58 Version 8.1
in the Database
Table 18. Properties - Workstation in Database General Information (continued)
Fault Tolerant Select this to define the workstation as fault-tolerant. Use
fault-tolerant workstations to run Tivoli Workload Scheduler jobs
in a Tivoli Workload Scheduler for z/OS plan. Fault-tolerant
workstations are automatically defined as computer workstation
types with an automatic reporting attribute. When you select this
box, all the properties for this workstation are disabled and set to
their default value.
Destination Enter a destination that corresponds to the destination specified
on a ROUTOPTS initialization statement. For computer
workstations and WTO general workstations this is the name of
the Tivoli Workload Scheduler for z/OS tracker. The default
destination is the system where the Tivoli Workload Scheduler
for z/OS engine is started.
Defaults
Transport time Enter the time, in hours:minutes (HH:MM)
format, that the system should allow between
the end of a predecessor job and the beginning
of the present job. The transport time of the
workstation is the default transport time for all
the jobs defined on the workstation and is used
for planning purposes only.
Duration Enter the default estimated processing time, in
HH:MM:SS format, for all jobs on that
workstation. Tivoli Workload Scheduler for
z/OS uses the estimated processing time, when
creating the plan, to work out a timetable for
all jobs. You do not need to give an exact
figure, because Tivoli Workload Scheduler for
z/OS can adjust this figure dynamically from its
experience of the actual durations, however you
should attempt to estimate as close as possible.
You can override this value by specifying a
duration when you create a new job.
Access Methods Enter details of any optional access methods that enable the
workstation to submit and track jobs that are run by an external
product.
Note: This option applies only to workstations running on OPC
2.2 or later.
Name Enter the name of the access method that
handles the external product.
Node address Write the optional TCP/IP address or hostname
of the tracker agent that is hosting the access
method.
Port number Enter the optional TCP/IP port number of the
tracker agent that is hosting the access method.
Select Resources in the left pane. The Resources page is displayed.

Resources Page
Figure 8. Properties - Workstation in Database Resources Page
You can define a maximum of two workstations, or fixed resources, called Resource 1 (R1)
and Resource 2 (R2), to schedule or run jobs on this workstation.
When defined, the two resources are associated to the workstation and are recognized
automatically when you schedule and run jobs on the workstation. However, they are subject
to the following limitations, that in some instances could make it more practical to use
logical resources in their place:
¶ You can have a quantity of no more than 99 of each resource.
¶ They cannot be shared by other workstations.
¶ Their name is limited to two characters.
R1 and R2 can represent any physical resource in your system that is significant for
scheduling purposes. When you create a new job, you can specify how many of the
workstation resources (R1, R2, or both) the job will use. Unless the specified quantity of
resources is available, the job will not start.
60 Version 8.1
in the Database
To define the use of each resource:
1. Enter a 2-character name in Name if you want to change its name from the R1 or R2
default.
2. Select the Used for planning check box, if you want this resource to be considered
when a plan involving this workstation is built.
3. Select the Used for control check box, if you want this resource to be used when a job
runs on this workstation.
The plan contains the best estimation of when operations will start. If something
unexpected happens (for example, a job exceeds its expected run time), Tivoli Workload
Scheduler for z/OS may need to reassess the start time of some of its operations. At this
point, the Control option becomes important. If you selected it, Tivoli Workload
Scheduler for z/OS considers the workstation resource when rescheduling its operations.
Otherwise, the workstation resource is ignored.
Select Open Time Intervals in the left pane. The Open Time Intervals page is displayed.

Defining Open Time Intervals
In this window you define, on a time-interval basis, the availability of parallel servers, the
capacity of workstation resources, and the name of an alternate workstation that will allow
work to run at this workstation.
1. To add or delete an open time interval, click the Add Row or Remove Row buttons. To
delete an interval, you must first select the row, then click the button.
2. After adding a row, to define the new interval, double-click under each heading to make
a choice or to write data. See Figure 9.
Figure 9. Adding an Open Time Interval
62 Version 8.1
in the Database
Use the information in Table 19 to complete all the necessary fields in the window.
Table 19. Properties - Workstation in Database Open Time Intervals Information
In this column ... Do this ...
Day menu Choose: a day of the week, Standard, or Specific Date (where a
calendar pops up from which you select a date). The Standard
interval defines the values that are true at all times, with the exception
of the additional intervals that you also specify on this page. When
you define a new workstation, you find a default Standard row where
you enter the name of an alternate workstation and the quantities of
parallel servers and of workstation resources that you want to be
available on a general basis. Select a day or Specific Date to specify
the time intervals where the quantities, name, or both are different
from Standard.
Status menu Specify the availability status of the workstation in the given interval.
Select one of the following:
Defined
To specify that during the interval the workstation is available in
the quantities and with the properties defined in the current row.
Closed
To specify that the workstation is not available during the
interval. If you select this value, the remaining cells in the row
are disabled.
From Time and To Time A time range, with times in the 12-hour format.
Parallel Servers The quantity, to a maximum of 99, of parallel servers available to the
workstation during the time interval. Leave this field blank if you did
not specify usage of parallel servers in the General page.
R1 Capacity and R2 The available quantities, to a maximum of 99 each for every interval,
Capacity of resources R1 and R2 if you specified their use for this workstation
in the Resources page.
Alternate Workstation The name of another workstation of the same type that can be used
during the interval if this workstation becomes unavailable. This
option is possible only for computer workstations and for WTO
general workstations.
Note: For best results, make the configurations of the two
workstations symmetrical, so that the two workstations can be
alternates for each other.
If you need assistance in finding the alternate workstation, click the

ellipsis next to the field to open a Find Workstations window. See
“Finding Objects” on page 48 for instructions on using the Find
Workstations window.

¶ Click OK to add the new workstation to the database and to close the window.
¶ Click Cancel to close the window without adding the workstation.

Managing Workstations
After you have created the workstations, create one or more workstation lists to manage
them. You can use workstation lists to:
¶ View workstation characteristics
¶ View workstation status
¶ Modify workstation properties
¶ Delete workstations
You can create two types of list:

Table 20. User-defined Workstation Lists
Use this type of list ... To do this ...
Database workstation lists View and update workstation definitions stored in the Workload
Scheduler for z/OS workstation description database.
Plan workstation lists View and update the status and properties of the workstations
allocated to the plan and of the jobs associated with them.
The following sections explain how to create database and plan workstation lists. They also
explain how to use database workstation lists to update definitions in the Workload
Scheduler for z/OS database. “Managing Workstations in the Plan” on page 161 provides
information on how to use plan workstation lists to modify the allocation of workstations in
the plan.
Default Workstation Lists
The Job Scheduling Console provides two workstation lists. You can find them in the default
lists groups in the tree of each Workload Scheduler for z/OS engine shown in the Job
Scheduling view.
Table 21. Default Workstation Lists
Use this list ... To do this ...
All Workstations Display a list of all the workstations defined in the workstation
definition database. Resides in the Default Database Lists group.
Status of All Workstations Display a list of all the workstations currently allocated to the plan.
Resides in the Default Plan Lists group.
The default workstation lists have the same behavior as the user lists. You can display their
properties and see from the empty fields that no selection criteria are specified. You can
modify their properties and make them less general by adding the filters of your choice.
64 Version 8.1
in the Database
Creating a List of Workstations in the Database
A workstation list produces a filtered list of workstations defined in the Workload Scheduler
for z/OS workstation description database.
To create a database workstation list, in the Job Scheduling view, select an engine and click
the List Workstations in Database button.
The Properties - Database Workstation List window is displayed.
Figure 10. The Properties - Database Workstation List Window

Use the information in Table 22 to enter all the information needed to create the database
workstation list.
Table 22. Properties - Database Workstation List Information
In this area ... Do this ...
Name Enter a name for the list.
Periodic Refresh Options ¶ Select Periodic Refresh to specify an automatic refresh
interval in seconds.
—OR—
¶ Select Apply Defaults to use the default specified in the
Scheduler Properties window available from the Job
Scheduling view.
Filter Criteria In the group, specify any of the following search parameters or
combinations of two or more parameters. To generalize your
search, use wildcard characters, such as an asterisk (*) to represent
strings of characters, or a question mark (?) to represent a single
character. If you leave all fields blank, all the workstations defined
in the database are displayed when you open the list.
Workstation
Lists all the workstations with this name or namestring.
Reporting Attributes
Lists all the workstations characterized by the reporting
attributes you select with the following check boxes:
¶ Automatic
¶ Completion only
¶ Manual start at completion
¶ Non reporting
Types
Lists all the workstations of the type you select with the
following check boxes:
¶ General
¶ Computer
¶ Printer
Is Fault Tolerant
Lists fault-tolerant workstations. These workstations are
used to run the Workload Scheduler jobs in the Workload
Scheduler for z/OS plan.
Select :
Yes To list fault-tolerant workstations
No To list workstations that are not fault-tolerant
Ignore criteria
To list workstations regardless of whether they are
fault-tolerant or not

¶ Click OK to add the object for the new list to the tree under the engine you selected
when creating the list. To display the list, right-click it and click Open.
66 Version 8.1
in the Database
Using Workstation Lists
When you open a database workstation list object, all the workstations defined in the
database that respond to the filter criteria are displayed in the right-hand pane of the Job
Scheduling Console.
This section explains how to use database workstation lists to:

¶ Modify workstation properties
¶ Delete workstation definitions
¶ Define new workstations
To work with workstations allocated to the plan, you must use a plan workstation list. For
further information, see “Browsing and Modifying Workstation Properties” on page 164. To
work with workstations defined in the database, continue with “Displaying a List of
Workstations in the Database”
Displaying a List of Workstations in the Database

To display a list of workstations defined in the database, in the Job Scheduling view,
right-click the list object for which you want to use to list the workstations and select Open
The workstations found are displayed in the right-hand pane.
For each workstation, the following are displayed:

¶ Name and description
¶ Reporting attribute
¶ Type
¶ Whether or not it is fault-tolerant
¶ Date and operator user ID of last update of the workstation properties
Modifying Workstation Properties in the Database

To modify the properties of a workstation displayed in a list:
1. In the Job Scheduling view, right-click the workstation and select Properties from the
pop-up menu. The Properties - Workstation in Database window is displayed.
2. Make your changes to the workstation properties. For a description of the fields in the
Properties - Workstation in Database window, see “Creating a Workstation” on page 56.
3. Click OK to save your changes.
Deleting a Workstation from the Database

To delete a workstation displayed in a list:
1. In the Job Scheduling view, right-click the workstation and select Delete from the
pop-up menu. A confirmation window is displayed.
2. Click Yes. The workstation is deleted from the database.

Creating Workstations from Existing Ones in the Database
You can select a workstation from a list and use its definition to create other workstations
with the same or similar properties. To do this:
1. In the Job Scheduling view, right-click the workstation that you want to use as a model
for the new workstation, and select Create Another from the pop-up menu.
2. The Properties - Workstation in Database window is displayed.
3. In the Name field, change the default name to the name of your choice. If you do not
change the name, the new workstation is saved as COPY (a Workload Scheduler for
z/OS workstation name cannot be more than four characters in length).
4. Change any other properties that you need to customize for the new workstation.
5. Click OK to save the new workstation and close the window. The new workstation is
added to the database.
6. To view the new workstation, either click the Refresh List Results button in the Job
Scheduling Console window or run another list.
68 Version 8.1
8
Managing Resources in the Database
8. Managing Resources in
In Workload Scheduler for z/OS, resources represent the physical or logical objects that are
the Database
used by jobs. You can use resources to prioritize access to a data set or to limit the number
of simultaneous file transfers on a particular network link.
You specify how a job uses resources when you create the job. But first you must:
¶ Create the resource and its attributes
¶ Specify the associated workstations
¶ Specify the number of resources available in each interval

Creating Resources
To create a resource in the Workload Scheduler for z/OS database, select an engine in the
Job Scheduling view and click the New Resource button.
The Properties - Resource in Database window is displayed. This window contains the
Resource, Default Workstations, and Availability Intervals pages. On the first two pages, you
enter the default information for the new resource. These values are valid at all times, except
for the periods that you optionally define on the Availability Intervals page.
Resource Page
In this Properties - Resource in Database Resource page, you enter information that
describes the resource you are creating.
Figure 11. Properties - Resource in Database Window Resource Page
70 Version 8.1
Use the information in Table 23 to enter all the information needed to create the resource.
Table 23. Create a Resource Information
Name Specify a name identifying the resource. The name is converted to
uppercase.
Description Provide a description of the resource.
Default The quantity of the resource (from 1 to 999999) in Quantity. Specify
the number of the resource that is available (when you select the Is
Available box) for the availability intervals associated with the
resource. This information is used as the default unless otherwise
specified for a given interval on the Availability Intervals page.
the Database
Group ID A name of up to eight characters that identifies a group to which the
resource belongs. The group ID can be used as a list filter for selecting
subsets of resources.
Hiperbatch Select to specify whether the resource is a data set eligible for
Hiperbatch™. Hiperbatch is a host performance enhancement that
works with the Data Lookaside Facility (DLF) to enable batch jobs and
started tasks to share access to data sets.
Used for Select from the drop-down list how the resource is to be used, for:
¶ Planning
¶ Control
¶ Planning and control
¶ Neither planning nor control
On error Select from the drop-down list box what action to take on the resource
when a job that allocates this resource ends in error (and does not have
an overriding keep-on-error specification in the job definition):
Free
Free the full allocation of this resource, both exclusive and shared.
Keep
Keep the full allocation of this resource. You may want critical
jobs to keep their resources even when they fail, to avoid having
to wait for resources when the job is restarted.
Free if exclusive
Free the full exclusive allocation of this resource.
Free if shared
Free the full shared allocation of this resource.
Assume System Default
Use the default specified in the ONERROR keyword of the
RESOPTS statement. Refer to the Customization and Tuning
manual.
Select Default Workstations in the left pane. The Properties - Resource in Database Default
Workstations page is displayed.

Default Workstations Page
On this page, you list the workstations associated with and reserved for the resource.
Figure 12. Properties - Resource in Database Default Workstations Window
1. To add all the workstations defined in Workload Scheduler for z/OS, click the Add All
Workstations button in the toolbar. An asterisk (*) is added to the list of connected
workstations.
Note: By default, all workstations are already added when the Resource Editor window
for a new resource opens.
2. To remove a workstation from the list, select it, then click the Remove Row button.
3. The Find tool allows you to pick from a list of available workstations. Click the Find
Workstation button. The Find Workstation window is displayed.
4. Several filtering items are available to search for connected workstations. Either enter a
name directly in the Workstation field or select one or more boxes in the Reporting
Attributes and Types groups.
5. Click Start.
6. When the search results are displayed, select a workstation and click Add to add it to the
Default Workstations list.
Select Availability Intervals in the left pane. The Properties - Resource in Database
Availability Intervals page is displayed.
72 Version 8.1
Availability Intervals Page
On this page, you define the time intervals when the resource can be used with either the
Quantity, Availability, and Connected Workstations values in the Resource and Default
Workstations pages, or with other values that you specify for each different interval.
the Database
Figure 13. Properties - Resource in Database Availability Intervals Window
To add or delete an availability interval, click the Add Row or Remove Row buttons, then
select the specific interval. After you have added a row, you can define the new interval.
Use the information in Table 24 to enter the information to define the availability interval.
Table 24. Define an Availability Interval Information
In this column ... Do this ...
Day menu Choose: a day of the week, Standard, or Specific Date.
The Standard interval represents the norm where the resource is used
with the values you entered in the other two pages. When you define a
new resource, you find a default Standard row where you need not add
any values except, optionally, for a time range.
Select a day or Specific Date to specify the intervals in which the

resource is available with different Quantity, Availability, and Connected
Workstations characteristics that you specify in the row itself.
From Time and To Time Specify a time range.
Quantity Type the quantity of the resource in this time interval.
Is available menu Choose: Available, Not Available, or Default (the default specified in the
Resource page). To put a resource off limits for a certain period, click No.
Workstations Write the names of one or more connected workstations, each separated
by a blank. Alternatively, click the ellipsis (...), then Find Workstation.
This opens a Find window that helps you search for available
workstations. See “Finding Objects” on page 48 for an explanation of
using the Find window.

¶ Click OK to save the new resource and close the window.

¶ Click Cancel to close the window without saving the resource.
Managing Resources
Once you have created resources, create one or more resource lists to manage them. From a
resource list you can:
¶ View the characteristics and status of resources
¶ Modify resource properties
¶ Delete resources
You can create two types of list:

Table 25. User-defined Resource Lists
Database resource lists View and update resource definitions stored in the resource
description database.
Plan resource lists View and update the status and properties of the resource allocated to
the plan and of the jobs associated with them.
The following sections explain how to create database and plan resource lists. They also
explain how to use database resource lists to update definitions in the database. “Managing
Resources in the Plan” on page 173 provides information on how to use plan resource lists
to modify resource allocation in the plan.
Default Resource Lists
The Job Scheduling Console provides two resource lists. You can find them in the default
lists groups in the tree of each engine displayed in the Job Scheduling view.
Table 26. Default Resource Lists
All Resources Display a list of all the resources defined in the resource definition
database. Resides in the Default Database Lists group.
Status of all Resources Display a list of all the resources currently allocated to the plan.
Resides in the Plan Lists group.
Default resource lists have the same behavior as user-defined lists. You can display their
modify their properties and make them less general by adding the filters of your choice.
Listing Resources in the Database
A database resource list shows a filtered list of resources defined in the Workload Scheduler
for z/OS resource description database.
To make a database resource list, select an engine in the Job Scheduling view, then click the
List Resources in Database button. The Properties - Database Resource List window is
displayed.
74 Version 8.1
the Database
Figure 14. The Properties - Database Resource List Window
Use the information in Table 27 to enter all the information needed to create the list.
Table 27. Database Resource List Information
Name Enter a name to identify the query.
Periodic Refresh Options To refresh the list results automatically, select the Periodic Refresh
check box and specify a refresh interval in seconds. Alternatively,
click Apply Defaults to use the defaults specified in the scheduler
Properties window available in the Job Scheduling view.
Filter Criteria Specify search parameters or combinations of parameters.
To generalize your search, use wildcard characters. If you leave all

fields blank, then all resources are displayed when you open the list.
Specify a parameter or a combination of parameters:

¶ In Resource specify a resource name.
¶ Specify in Treat input as how you want the input you entered
in the Resource field to be treated. Select one of the following
options:
Wildcard Treat special characters as wildcards.
Exact match Treat special characters as part of the resource
name.
Prefix Treat the string as a name prefix.
Suffix Treat the string as a name suffix.
¶ Specify a resource group name in Group ID.
¶ Specify whether the resources are data sets with the DLF
attribute or not, or if this is to be ignored, in Hiperbatch.

¶ Click OK to add the new list to the engine tree.
To display the list, right-click it and select Load List.

Using Resource Lists
When you open a database resource list, all the resources defined in the database that
respond to the filter criteria are displayed in the right-hand pane of the Job Scheduling
Console.
The following sections explain how to use database resource lists to work with resources
defined in the resource description database. From the display produced by opening a
database resource list, you can:
¶ Browse and modify the properties of resources defined in the database
¶ Delete resource definitions from the database
¶ Define new resources starting from existing definitions
To work with resources allocated to the plan, you must use a plan resource list. For
information about how to work with plan resources, see “Browsing and Modifying
Resources” on page 176.
Displaying a List of Resources in the Database

To display a list of resources defined in the database:
1. In the Job Scheduling view, right-click the list object you want to use to list the
resources and select Load List from the pop-up menu.
2. The resources are displayed in the right-hand pane.
Figure 15. List of Resources in the Database
For each resource, the display shows:

¶ Name and description
¶ Resource group name
¶ If the resource has the DLF attribute
¶ How the resource is to be acted upon when a job that allocates this resource ends in
error
¶ Date and operator of last update of the resource properties
76 Version 8.1
Modifying Resource Properties in the Database
To modify the properties of a resource displayed in a list:
1. In the Job Scheduling view, right-click the resource and select Properties from the
pop-up menu.
The Properties - Resource in Database window is displayed.
the Database
Figure 16. The Properties - Resource in Database Window
2. Make your changes to the resource properties. For a description of the fields in this
window, see “Creating Resources” on page 70.
3. Click OK to save your changes to the resource definition.
Deleting Resources from the Database

To use a list to delete a resource from the resource description database:
1. In the Job Scheduling view, right-click the resource and select Delete from the pop-up
menu. A confirmation window is displayed.
2. Click OK to delete the resource from the database.
Creating Resources from Existing Ones in the Database

You can select a resource in a list and use its definition to create other resources with equal
or similar properties. After you have displayed a list of resources, do the following:
1. In the Job Scheduling view, right-click the resource that you want to use as a model for
creating another resource and select Create Another from the pop-up menu. The
Properties - Resource in Database window is displayed, showing the resource you
selected.
2. In the Name field, change the default name to the name of your choice. If you do not
change the name, the new resource is saved as CopyOfname, where name is the model
resource name.
3. Change any other properties that you need to customize for the new resource.
4. Click OK to save the new resource. The window is closed and the new resource is
added to the database.
5. To view the new resource, either click the Refresh List Results button or run another
list.

78 Version 8.1
9
Creating Job Streams
A job stream is a sequence of jobs that includes the resources and workstations that support
the jobs, together with scheduling information. There are three types of job stream:
Job stream template
Does not go into the plan. Contains only scheduling information for the job streams that
belong to it. You create run cycles but no jobs.
Job stream that inherits its scheduling information from a job stream template
Uses the scheduling information defined in the job stream template. You therefore
create jobs but no run cycles.
9. Creating Job Streams

Normal job stream
You create both jobs and run cycles.
You determine the type when you specify the job stream properties.
To create a job stream, you perform the following tasks:

Table 28. Tasks in Creating a Job Stream
To perform this task ... See ...
Specify the new job stream properties “Specifying Properties for the Job Stream” on
page 80
Create jobs “Creating a Job” on page 82
Create dependencies between jobs, where “Creating Dependencies between Jobs” on page 91
necessary and “Creating Dependencies between Job Streams”
on page 92
Create one or more run cycles to specify when “Scheduling Job Streams” on page 94
the job stream runs

Specifying Properties for the Job Stream
To create a job stream or job stream template, select a Workload Scheduler for z/OS engine
in the Job Scheduling view and click the New Job Stream button. The Job Stream Editor
and the Properties - Job Stream window are displayed.
Figure 17. Properties - Job Stream Window
Use the information in Table 29 to enter all the information needed for this window.
Table 29. Properties - Job Stream Window Information
Name Enter a name for the job stream or template.
Note: The name, valid date, and status uniquely identify each job stream
or template. You can define up to four job streams and job stream
templates that share the same name but have different valid dates.
Description Enter a description for the job stream or template.
Is a template Select this check box to define a new job stream template. A job stream
template contains run cycles but no jobs. All job streams defined as
belonging to a template inherit the run cycles defined for the template.
Inherits from template Enter the name of the template if you are defining a job stream that
belongs to a job stream template. The job stream is scheduled using the
template run cycle information.
Active Select this check box to schedule the job stream. If you are creating a
complex job stream that requires time to define, do not select this check
box until you have added all jobs, specified dependencies, and created a
run cycle. This avoids the risk that the incomplete job stream will be
included in any plans. You can make the job stream active after you have
completed it.
Valid Date Specify the time period covered by the job stream. You can specify only
the From date. A To date of 12/31/2071 is automatically assigned by
Workload Scheduler for z/OS. To change the From value, click the small
calendar button to select a valid From date. You can create several job
streams with the same name but with different dates in the From field.
The scheduler picks the correct version for the day it is planning.
80 Version 8.1
Table 29. Properties - Job Stream Window Information (continued)
Priority Specify how the job stream ranks in importance compared to other jobs
streams. The lowest priority is 1 and the highest priority is 9. This means
that, when job streams are competing for resources, a job stream with a
priority of 3 will run before a job stream with a priority of 1. This value
is not definitive. Other factors, such as resource and workstation
dependency, are considered in determining priority. This field does not
apply to job stream templates.
Authority group name Enter a name to be used to generate a RACF resource name for authority
checking. This information is optional.
Calendar Specify the name of the calendar of workdays and freedays, including
holidays, that you associate to the job stream. If you need to, click the
ellipsis (...) to open a Find window (see “Finding Objects” on page 48).
If you leave this field blank, the scheduler uses the calendar specified in
the initialization parameter CALENDAR during startup of the TCP/IP
server.
Note: The calendar that you specify here is used to display the run days
of the job stream in the Run Cycle view of the Job Stream Editor. It is
not necessarily the calendar that is used to determine the actual run days
of the job stream instances that are generated.

Owner Enter the name of the person responsible for the job stream or template.
Owner description Enter a description of the job stream or template.
Contains Monitored Job Indicates whether any jobs in this job stream will be monitored by Tivoli
Business Systems Manager when they run. The value is Yes if Is
Monitored Job is selected in the properties window of one or more of
the jobs in the job stream. This field is read-only.
Click OK to proceed. The following happens:

Table 30. What Happens When You Define a Job Stream
If you are creating a ... This happens ...
Job stream template The Job Stream Editor opens the Timeline view, where you can
open the Run Cycle view. You can add only run cycle
information.
Job stream as belonging to a The Job Stream Editor opens the Graph view where you can
template create jobs.
Single job stream The Job Stream Editor opens the Graph view from where you
can add jobs and dependencies, and switch to the Run Cycle
view to add run cycles.
Note: The Workload Scheduler for z/OS ISPF main panel, option 1.8, allows you to create a
job stream containing a single job by specifying only the name of the JCL associated
with the operation. This option is not available in the Job Scheduling Console. To
create job streams with a single job, you must follow the steps in this chapter.

Creating a Job
After you have specified the properties of a job stream, you can create the jobs that
comprise it in the Graph view of the Job Stream Editor.
The Graph view displays an button for each possible type of job that you can define in
Workload Scheduler for z/OS. Table 31 describes these job buttons:
Table 31. Graph View Job Buttons
This button ... Denotes this job type ...
Add JCL JobA job that consists of JCL statements. Runs on computer
workstations.
Add Started Task JobA job to start or stop a task that has already
started. Runs on computer workstations.
Add Printer JobA job to print the output of a predecessor job. Runs on
printer workstations.
Add General JobA job to include activities other than printing and
processing, such as manual activities. Runs on general workstations.
Add Setup JobA job containing a set of JCL statements for a JCL or
started task job. Runs on general workstations.
Add Write-to-Operator JobA job containing an operator instruction

displayed on the system console. Runs on general workstations.
Add FTW TaskAdd a task to run on a fault-tolerant workstation.
Add Dependency on External JobCreate, browse, or modify a

dependency on a job that is part of another job stream.
Add LinkCreate a link between jobs.
Graph ViewChange to the Graph view.
Timeline ViewChange to the Timeline view.
Run Cycle ViewChange to the Run Cycle view.
The property windows for the different job types are identical. However, when you save the
job stream, Workload Scheduler for z/OS applies different validation policies, based on the
job type, to the properties that you specified. Moreover, when you use the Find tool to
search for a target workstation, the tool lists only workstations that are compatible with the
specific job type.
82 Version 8.1
Creating a Job Using Buttons
To create a job in the job stream, click one of the job buttons in the Graph view of the Job
Stream Editor, depending on the type of job that you want to define. For example, the Add
JCL Job button. The Properties - JCL Job window is displayed.
General Page

Figure 18. Properties - JCL Job General Page
Use the information in Table 32 to enter all the information needed to define the job details.
Table 32. Properties - JCL Job General Information
Identifier Enter the job number. This information is required and must be unique
within the job stream.
Target workstation The name of the workstation on which the job is run. This information
is required. If you do not know the name:
1. Click the ellipsis (...) button. The Find Workstation window is
displayed.
2. In the Find field, enter the name of the workstation or you can use
wildcard characters. You can also run your search by selecting boxes
in the Reporting attributes group box.
3. Click Start. A list of workstations is displayed.
4. Double-click the name of a workstation, or click it once then click
on OK. The name of the workstation is displayed in the Target
workstation field in the Properties - JCL Job General page.
Description A brief description of the job.
Auto submit Select this to start the job automatically or to issue a WTO message
(when all dependencies have been satisfied and all required resources
are available). Auto submit is selected by default.

Table 32. Properties - JCL Job General Information (continued)
Cancel if late Select this to prevent the job from being started if it is late (according
to the time dependencies specified in the Time Restrictions page).
Note: select this option only for time-dependent jobs (time-dependent
jobs must have an earliest start time and a deadline specified on the
Time Restrictions page).
Deadline WTO Select this to issue an operator message if the job passes its deadline.
The message is also written to the message log.
Auto release Select this to release the job when it is not submitted by Workload
Scheduler for z/OS and is in HOLD status. The job is released when all
dependencies are satisfied and the requested resources are available.
Auto release is selected by default.
Auto error completion Select this to mark the job ended-in-error (E) if an error occurs when it
runs. Auto error completion is selected by default. If you clear it, the
job is marked complete (C) when it ends, regardless of the outcome.
Is Monitored Job Select this to specify that the running of this job is to be monitored by
Tivoli Business Systems Manager.
Restart and Cleanup Specify which data set and job restart actions must be performed if the
job ends in error. This option is not available for fault-tolerant
workstations.
None
No cleanup and restart actions are performed. This is the default.
Immediate
Data set cleanup is performed automatically when the job fails.
This option is not linked to a restart, which must be initiated
separately.
Automatic
Data set cleanup is performed automatically during the rerun of the
failed job. The engine builds a set of cleanup actions that are
performed when the first step of the restarted job runs (inserted by
the scheduler). This is the preferred method of running restart and
cleanup.
Manual
Restart and cleanup actions are to be initiated manually from the
Modify Current Plan ISPF dialog.
Expanded JCL
Specifies that the JCL used for step-level restarts and, optionally,
job reruns, should not be the JCL contained in the scheduler
libraries but the JCL image captured from the JESJCL sysout data
set. This is the default and recommended option.
Use Sys Out
Specifies that user sys out data sets should be used for job restarts.
84 Version 8.1
Restartable Specify whether to restart the job if its workstation becomes inactive:
Yes Restarts the job from the beginning on the alternate workstation (if
one was defined), or on this workstation when it becomes active
again.
No Restarts the job, even if it overrules the installation default in the
WSFAILURE or WSOFFLINE parameters of the JTOPTS
initialization statement.
Default
Uses the installation default action specified in the
OPRESTARTDEFAULT keyword of the JTOPTS statement. This is
selected by default.
Reroutable Specify whether to make the job eligible to be rerouted if its
workstation becomes inactive. This option applies to the job only when
it is in ready (R) or waiting (W) status.
Yes Makes the job reroutable.
No Makes the job not reroutable
Default
Takes the installation default action specified in the
OPRESTARTDEFAULT keyword of the JTOPTS statement. This is

selected by default.
Highest acceptable return Specify the highest acceptable return code from any step in the job
code before the job is set to ended-in-error (E) status. If you leave this field
blank, Workload Scheduler for z/OS uses the value specified in
HIGHRC in the initialization parameter JTOPTS.
Feedback options The scheduler automatically monitors the actual durations of jobs. It can
use these durations to modify the estimates in the application description
(AD) database. In the Feedback options group box, specify two
parameters that control how measured durations are used:
¶ In the Smoothing factor field, type a number, from 0 to 999, that
determines how much a measured duration will change existing
values in the AD database. If a measured duration is outside the
limits established by the Limit for feedback field, the smoothing
factor is not applied and the AD database is not updated.
¶ In the Limit for feedback field, type a number, from 100 to 999, to
establish the limits within which measured values are regarded as
normal and acceptable. A measured value outside the limits is
ignored. That is, no smoothing factor is applied and the AD
database is not updated.
Critical job Select this if you want to define the job as a critical job. This makes the
job eligible for Workload Manager (WLM) service class promotion
when the job runs late. Available for OPC 2.3 only.

WLM policy If you selected the Critical job check box, click the WLM policy
drop-down list to select the type of policy applied for WLM service
class promotion when this job is late. The policy can be:
Conditional
The scheduler uses an algorithm to determine whether to apply
the Deadline or the Latest start option.
Deadline
The scheduler intervenes if the job runs beyond the deadline.
Latest start
The scheduler intervenes immediately if the job starts after the
latest start time.
Long duration
The scheduler intervenes if the job takes longer than it should as
compared to the statistics that it keeps.
This option is available for OPC 2.3 or later.
Select Task in the left pane. The Task page is displayed.
Task Page
In the Task page, enter information about the program associated with the job.
Note: If the task is a manual operation, leave this page blank.
Figure 19. Properties - JCL Job Task Page
86 Version 8.1
Use the information in Table 33 to enter all the information needed to define the task.
Table 33. Properties - JCL Job Task Information
Task name The name of the JCL associated with the job, when applicable. Together
with the identifier you specified in the previous page, the task name
labels the job in the Graph view of the Job Stream Editor.
Form number The printer form number that appears on the daily plan and ready lists.
For printer workstations with automatic reporting, it enables the engine
to identify the different print operations that belong to a specific job.
Job class click the drop-down list and select a letter that matches the host job
class from the JCL.
Select Time Restrictions in the left pane. The Time Restrictions page is displayed.
Time Restrictions Page

In the Time Restrictions page, specify the period of time that the job is allowed to run and
the amount of time the job requires.

Figure 20. Properties - JCL Job Time Restrictions Page
Use the information in Table 34 on page 88 to enter all the information required to define the
time restrictions.

Table 34. Properties - JCL Job Time Restrictions Information
Start Specify the time at which the job can start, in one of the following
ways:
¶ Select No restrictions to run the job as soon as all dependencies are
met. No time restrictions can result in more efficient processing for
certain jobs when extending a plan. In this way, they are run as
soon as dependencies are satisfied. If this job is not time dependent,
click this option.
Note: This choice is not valid if you selected Cancel if late in the
General page.
¶ Select Follow job stream rules to specify that the earliest time the
job can start is when the job stream starts. This is the default.
Note: This choice is not valid if you selected the Cancel if late
box in the General page.
¶ Select Specify earliest start time to define a specific time before
which the job should not start. Then:
1. In the At field, enter a time, according to your local settings.
For example, enter 12:00 if you do not want the job to start
before noon.
2. In the Delay for field, type a number of days to defer thestart
time. For example, if you type 3, the job will start three days
after the time you originally specified in the At field.
Deadline Specify the latest time that the job can end. To do this, select Specify
deadline and use the At and Delay for fields. The default is no
deadline time.
Duration Specify how long the job is expected to run, in hours, minutes, and
seconds.
88 Version 8.1
Resources Page
In the Resources page, describe the parallel servers, and the logical and workstation
resources that the job uses.

Figure 21. Properties - JCL Job Resources Window
In the following procedure, you perform the following actions on target resources and
logical resources, which you access from the drop-down list:
Target resources
Where you specify the workstation (or fixed) resources, and the parallel servers, that
the job needs to run.
Logical resources
Where you specify the logical and physical resources that the job needs to run
1. Click the arrow next to Target resources. Columns are displayed where you can specify
the target resoruces.
2. Double-click each cell in the Quantity column to edit the amount of resources Resource
1 and Resource 2 are required by the job. Do the same for parallel servers.
3. Click the arrow again and select Logical resources. Columns are displayed where you
can specify the logical resoruces.
4. Click the Add row button for each resource you need to assign to the job.
5. Type the name of the resource. If you do not know it, use the Find tool (...).

6. For each logical resource, double-click under each of the next three columns to edit the
following attributes:
Quantity
Specify the amount of the resource needed by the job.
Access type
Specify whether the job needs shared or exclusive access to the resource.
Keep on error
Specify whether the job keeps or frees the resource when it fails. You can also
specify to use the default defined in the ONERROR keyword of the RESOPTS
statement.
When you have finished, click OK to save your changes and close the window. The new job
is displayed as an button in the Graph view of the Job Stream Editor.
Figure 22. Job Stream Editor Graph View
The name of the button is made up of the name of the task with which the job is associated
and by the job identifier. You can drag and drop the button to position it.
Repeat the steps in this section to create as many jobs as you need.
Note: You can use the slider, positioned on the left margin of the Graph view, to zoom in
and zoom out the jobs displayed. When you move the slider downwards to zoom out
of the Graph view, the job buttons change their appearance, changing color depending
on the job type.
Creating a Job Using Copy and Paste
To create a job using the copy and paste functions on an existing job:
1. In the Job Stream Editor, right-click the job you want to copy and select Copy from the
pop-up menu.
2. Right-click the mouse somewhere in the window and select Paste from the pop-up
menu. The Properties - JCL Job window for the copied job is displayed.
3. Change the identifier and edit the properties as required.
4. Click OK to save your changes and close the window. The new job is added in the
Graph view.
90 Version 8.1
Creating Dependencies between Jobs
When you create dependencies, you link jobs in a sequence. A successor job cannot begin
until the predecessor job is complete. Dependencies determine when the successor job runs,
even if the successor job has time restrictions.
For example, to print bank account statements, you must first subtract withdrawals from an
account (Job A) before you calculate the account balance (Job B). Here, Job A is the
predecessor and Job B the successor.
Creating Dependencies within a Job Stream
To create a dependency between jobs within the same job stream:
1. In the Graph view of the Job Stream Editor, click the Add Link button.
2. Click the predecessor job and drag the link to the successor job. A line is displayed
between the two jobs, with an arrow pointing to the successor job.

Figure 23. Job Stream Editor - Add Link
3. Repeat the previous steps to create as many dependencies as you need.
Figure 24. Job Stream Editor - Example Dependent Jobs
Figure 24 shows that jobs 04 and 05 can start only when job 03 has finished, and that
job 03 can start only when job 02 has finished.

Creating Dependencies between Job Streams
External jobs represent jobs that are part of other job streams. You create a dependency
between jobs in different jobs streams by creating a dependency on an external job. For
example, if Job C in the Accounts job stream depends on Job B in the Reports job stream,
you create an external job in the Accounts job stream to represent Job B, then you create a
dependency between Job C and the external job.
This section describes one way to add an external job to a job stream. Another method,
based on the use of job stream lists, is described in “Using Copy to Add an External Job” on
page 115.
To create a dependency between job streams:

1. In the Job Stream Editor Graph view, click the Add Dependency on External Job
button. The Properties - External Job window is displayed.
Figure 25. Properties - External Job Window
2. In the Job Stream field, enter the name of the job stream containing the external job. If
you do not know the name of the job stream, see “Finding a Job Stream” on page 94.
3. Click Show Jobs. The jobs in the job stream are displayed.
Figure 26. Selecting the External Job
4. Select a job and click OK. An button for the external job is displayed in the Graph view.
92 Version 8.1
Figure 27. Job Stream Editor — External Job Button
5. Repeat the steps explained in “Creating Dependencies between Jobs” on page 91 to

define links with the other jobs. In the example in Figure 28, job 05 can start only after
job 03 has finished, and also after job 1 of the TWSPRO1 job stream has completed.

Figure 28. Job Stream Editor — Example External Job Dependency

Finding a Job Stream
If you do not know the name of the job stream that contains the external job, perform the
following steps to search the job streams database:
1. Click the ellipsis (...) to open the Find Job Stream window. This window allows you to
enter criteria to search the database for existing job streams.
2. In the Find field, enter a search string to locate the job stream. You can use wildcards or
leave the field blank to display a list of all job streams.
3. Use any of the Filter Criteria elements to find the job stream that contains the job you
want. You can write search strings with wildcard characters. Use the information in
Table 35 to specify the filter criteria.
Table 35. Filter Criteria
Task name Name of a task contained in the job stream.
Job stream template Name of the job stream template to which the job
stream belongs.
Owner Identity of the owner of the job stream.
Is a template Select this to search for job stream templates.
Status of Job Stream Select one of the buttons to search for active,
inactive, or all job streams regardless of their status.
4. Click Start. A list of job streams is displayed.

5. Double-click the name of a job stream. The Find Job Stream window closes and the job
stream is displayed in the Job Stream field in the External Dependency Properties
window.
Scheduling Job Streams

After creating the jobs and defining any existing dependencies between them, you specify
the scheduling information for the job stream using run cycles. Run cycles are generated
from a combination of:
¶ A calendar of workdays and freedays. The calendar is defined in Workload Scheduler for
z/OS. You specify its name in the Job Stream Properties window (see “Specifying
Properties for the Job Stream” on page 80).
¶ The validity date of the job stream, which you specify in the Job Stream Properties
window.
Types of Run Cycle
You can create two types of run cycle:
¶ Rule-based
Uses rules based on lists of ordinal numbers, types of days, and common calendar
intervals or period names. For example, the last Thursday of every month. Rule-based
run cycles are based on conventional periods, such as calendar months, weeks of the
year, and days of the week, or periods that you define, such as a semester.
¶ Offset-based
Uses a combination of user-defined periods and offsets. For example, an offset of 3 in a
94 Version 8.1
period of 15 days is the third day from the beginning of the period. It is more practical
to use offset-based run cycles when the cycle is based on cyclic periods.
You can specify multiple run cycles when you create a job stream, and you can add new
ones afterwards. You can also mix rule-based and offset-based run cycles.
Both types of run cycles can be either inclusionary or exclusionary. Inclusionary run cycles
specify the days that the job stream must run. Exclusionary run cycles specify the days that
the job stream must not run. You can add run cycles to generate more days, or to have
multiple instances on the same day. You can add exclusionary run cycles to exclude some of
the days already generated.
Creating a Run Cycle
To create a run cycle, in the Job Stream Editor, click the Run Cycle button. The Run Cycle
view is displayed.

Figure 29. Job Stream Editor - Run Cycle View
Table 36. Run Cycle Buttons

If you are going to use ... Click the ...
Rules Rule-based Run Cycle button
Offsets Offset-based Run Cycle button
Depending on which choice you make, either the Properties - Rule-based Run Cycle window
or the Properties - Offset-based Run Cycle window is displayed.
General Page
The Properties - Rule-based Run Cycle General page is similar to the Properties -
Offset-based Run Cycle General page.

Figure 30. Properties - Rule-based Run Cycle General Page
Use the information in Table 37 to specify whether the run cycle is exclusionary, the period
that the run cycle is valid, and how to handle freedays in the schedule.
Table 37. Run Cycle General Information
Name Type a name for the run cycle.
Note: Offset-based run cycles take the name of the
period specified in the Offsets page. See “Creating
Offset-based Run Cycles” on page 102.
Description Type a description of the run cycle.
Exclusionary run cycle Select this if the run cycle keeps the job stream from
running.
Valid Date Use the From and To drop-down lists to specify an
interval of time for which the run cycle applies. Click the
calendar buttons next to each field to select dates using
pop-up calendars. The intersection between this valid date
and the valid date you defined in the Job Stream
Properties window is the interval during which the job
stream is actually scheduled.
96 Version 8.1
Table 37. Run Cycle General Information (continued)
Rule for freedays Specify how you want Workload Scheduler for z/OS to
treat freedays when calculating the rundays of the job
stream, by selecting one of the following:
Count workdays only
Excludes freedays when calculating on which days
the job stream runs. This is the default for
offset-based run cycles.
Schedule on last workday before freeday
Counts both workdays and freedays. If the runday
falls on a freeday, it is shifted to the closest workday
before the freeday.
Schedule on next workday after freeday
falls on a freeday, it is shifted to the closest workday
after the freeday.
Count workdays and freedays alike
Counts both workdays and freedays. The job stream
is scheduled on the runday, regardless whether it is a
freeday or a workday. This is the default for

rule-based run cycles.
If freeday, do not schedule at all
falls on a freeday, the job stream is not scheduled to
run.
JCL variable table Type a name of the variable table that the scheduler can
use on the days generated by this run cycle. Alternatively,
click the ellipsis (...)to search for a variable table name.

The Properties - Rule-based Run Cycle Time Restrictions page is similar to the Properties -
Offset-based Run Cycle Time Restrictions page.
Figure 31. Properties - Rule-based Run Cycle Time Restrictions Page

Use the information in Table 38 to complete the fields in this window.
Table 38. Run Cycle Time Restrictions Information
Start In the At field, enter the time when the job stream must start. The
default is 00:00 of the scheduled day.
Deadline You can use deadline time to control the correct completion of the
schedule and also to make closer estimates of the duration of a job
stream.
At Type a time when the job stream must stop.
Type for
Enter a number of days after the start of the schedule.
The default is no deadline time.
Note: If you are creating an exclusionary run cycle, be sure to match the time restrictions of the run
cycle that it is intended to annul.
If you are creating a rule-based run cycle, select Rules in the left pane. The Properties -
Rule-based Run Cycle Rules page is displayed. Continue with “Creating Rule-based Run
Cycles”.
If you are creating an offset-based run cycle, select Offsets in the left pane. Properties -
Offset-based Run Cycle Rules page is displayed. Continue with “Creating Offset-based Run
Cycles” on page 102.
Creating Rule-based Run Cycles
Use the information in Table 39 on page 99 to specify the elements that make up the rules
on which the run cycle is based.
Figure 32. Properties - Rule-based Run Cycle Rules Page
98 Version 8.1
Table 39. Rule-based Run Cycle Rules Information
Periods Select Week, Month, Year, or User-defined (a period that you
have defined in the scheduler). You can check more than one
period at a time for complex rules specifying more cycles. For
example, you can check Week and Month, and then choose the
days that apply to both rules. You do not need to select the same
days twice, since they are fitted automatically to all cycles.
Ensure that the period you select is also highlighted so that the
other options in the page are enabled. The period that you select
affects the number of days listed in the Available days
scroll-list. Also, the In the following group changes depending
on the period you select.
Frequency Only
Select this if the rule applies to only one day in the
specified period. The rule does not repeat within the period.
For example, Only last Monday in Month schedules the job
stream to run on the last Monday of the month.
Every
Select this if the rule is used to calculate more than one day

within the period. For example, Every last Monday in
Month schedules the job stream to run on every Monday in
the month, since this rule generates a series of Mondays
starting from the last Monday.
Note: Every first day yields the same rundays as Every day.
Shift origin
If you use Every, you can shift the origin of the run cycle
by the number of days you write in the Shift origin field.
You shift the origin of the run cycle with respect to the
default origin, which is Monday in the Week period, and the
first week with at least 4 days in the Month and Year
periods. You can also shift the origin from the end, if you
specify a combination of Every and ordinal-last days.
Available days Select the days of the period to which the rule applies. The
number of available days changes according to the period you
select. You can also specify ordinal-last days to count backwards
from the end of the period. The days you select are displayed in
the Selected Days field.
Available types of days Select the types of days to which the rule applies. The types of
days you select are displayed in the Selected Types of Days
field.
In the following ... Select this to specify by name the periods to which you want the
rule to apply. Depending on the period you select (Week, Month,
Year, User-defined), this option displays lists of weeks of the
year by number, or months by name.
If you selected a user-defined period, a list of available periods is

displayed in the In the following Periods group. Select the
check box next to the period you want to use.

The next figure shows a rule that schedules the job stream to run on the fifth day of every
week.
Figure 33. Example Rule
Click OK. The following happens:

¶ Workload Scheduler for z/OS calculates the days of the run cycle.
¶ The run cycle name is displayed in a list to the left of the graphic calendar in the Run
Cycle view. If you right-click it, you can then select a number of actions on the run
cycle, such as Properties, Copy, and Delete.
¶ The rundays are displayed in blue in the graphic calendar. When you select the run cycle
from the list, a blue stripe is displayed at the top of the corresponding generated days.
Example 1: Rule-based Run Cycle

The next figure shows a rule-based run cycle that uses the rule shown in the preceding
example, starting from a Valid date of July 20, 2001, and where workdays and freedays are
counted alike.
Figure 34. Example 1: Rule-based Run Cycle
100 Version 8.1

Example 2: Exclusionary Run Cycle
The next figure shows an exclusionary run cycle called WPREXCEP that prevents job
stream PAYRO21 from running on the last Friday of July 2001.
The rundays of an exclusionary run cycle are marked with a red bar in the graphic calendar.

Figure 35. Example 2: Exclusionary Run Cycle
WPREXCEP annuls the WEEKLYPR run cycle in the week marked in red.
Example 3: Exclusionary Run Cycle Defined

The next figure shows the rule defined for the WPREXCEP exclusionary run cycle . The
selected days are equal to those for the WEEKLYPR run cycle. The week when the job
stream must not run is specified in the In the following weeks check box.
Figure 36. Example 3: Exclusionary Run Cycle Defined

Creating Offset-based Run Cycles
Figure 37. Properties - Offset-based Run Cycle Window
Use the information in Table 40 to specify the combination of period and offsets on which
the run cycle is based.
Table 40. Offset-based Run Cycle Rules Information
In the following period Type the name of a user-defined period. If you do not know the
name, click the ellipsis to use the Find Period window to find
all the available user-defined periods. For further information,
see “Finding Objects” on page 48.
Note: The name of the period is also used as the run cycle
name.
If you need to specify more than one period, create an

offset-based run cycle for each period within the job stream.
Available offsets Select the days when you want the job stream to run in the
period. Select ordinal last days to count the days from the end
of the period.
Click OK. The following happens:

¶ Workload Scheduler for z/OS calculates the days of the run cycle.
¶ The run cycle name is displayed in a list to the left of the graphic calendar in the Run
Cycle view. If you right-click it, you can then select a number of actions on the run
cycle, such as Properties, Add, and Delete.
¶ The rundays are displayed in blue in the graphic calendar. When you select the run cycle
from the list, a blue stripe is displayed at the top of the corresponding generated days.
102 Version 8.1

Example 1: Offset-based Run Cycle
The next figure shows an offset-based run cycle named PER1. This run cycle schedules job
stream PAYRO21 to run on every second day of each cycle, beginning from a Valid date of
August 21, 2001.

Figure 38. Example 1: Offset-based Run Cycle
Example 2: Offset-based Run Cycle Defined

The next figure shows the offset for run cycle PER1. The offset is the second day of the
user defined period, also named PER1.
Figure 39. Example 2: Offset-based Run Cycle Defined

Checking Time Restrictions in the Timeline View
The Timeline view of the Job Stream Editor shows graphically the time restrictions of the
jobs and run cycles of a job stream in the database. While you create a job stream, the
Timeline view helps you, at a glance, to ensure that the time dependencies you specified are
correct and coherent. The view can point out inconsistencies between the time restrictions of
jobs and those of run cycles. It can also show if there are inconsistencies within the time
restrictions of individual jobs. You can modify the time restrictions of a job or run cycle
with a click of your mouse.
To open the Timeline view of a job stream, click the Timeline button from the toolbar of
any of the other views of the Job Stream Editor.
See the sample Timeline view in shown in the next figure.
Figure 40. Job Stream Editor - Timeline View
The inside of the window has four panes. You can size the panes by dragging the horizontal
and vertical lines that divide the window. The left half of the window, lists the job stream
run cycles in the top pane, and the job stream jobs in the lower pane.
Activity Bars
The right half of the window contains activity bars that represent, on a daily and hourly
scale, the time restrictions defined for every run cycle and job. You can customize the
timescale in the following way:
1. Right-click anywhere along the lower scale. A pop-up menu is displayed.
2. Move your pointer to Timescale to display available choices.
3. Select the radio button that matches your preference.
Table Frame
The table frame is the left half of the window and contains columns that display the
following information:
104 Version 8.1

¶ A warning button for inconsistencies in time restrictions. This button marks a run cycle
when Workload Scheduler for z/OS detects that there are jobs with time restrictions
outside the time restrictions of the run cycle.
¶ The run cycle name or job identifier .
¶ An information button showing what type of time restriction, if any, each job has. The
jobs with no restrictions have a lightning bolt, the jobs with a specified start time have a
clock, and the jobs that follow job stream rules have a clock superimposed on a job
stream.
¶ The expected start and deadline times of the run cycle or job.
¶ The expected duration of the job.
Time Restrictions
In the upper right pane, the run cycle time restrictions are displayed by a blue bar that
represents the time interval from the start to the deadline of the run cycle. The deadline is
indicated by a vertical black line at the end of the blue bar. You can change the start and the
deadline by dragging the left and right ends of the two bars, or by dragging the whole
activity bar. As you move the bar, an indicator displays the selected time.
Note: The run cycle time restrictions inherited from a template are displayed in read-only

mode. To modify them, you have to open the Job Stream Editor window of the
particular template.
Time restrictions for a job are shown by a thick blue bar that represents the time interval
from the start to the deadline of the job, and by a thinner, light blue line that represents the
expected duration. Where the duration of the job exceeds the deadline, the blue bar becomes
red. You can move the interval of time between the start and the deadline times of the job
by dragging either end of the thicker bar (or the whole bar). You can only move the right
end of the thinner bar because the start position is calculated automatically based on the job
dependencies. The job deadline is indicated by a black vertical line. If a job has no specified
deadline, the thick bar is replaced by a vertical stripe indicating the start. You can only move
it forward or backward. To specify a deadline for the job, you have to double-click the job
in the upper left pane and open a Time Restrictions page.
Other Tasks
In the Timeline view you can also:
¶ Detect inconsistencies in time restrictions. Specifically, if the time restrictions of any job
are such that it is not within the time restrictions of a run cycle, a warning icon marks
the run cycle that does not include the job. If you point your mouse on the triangle, a
hover help on the triangle lists the jobs that are not included.
¶ View the earliest start time of the first job and latest deadline time for the last job to see
the total run time of the job stream.
¶ Click a run cycle to see how it affects the jobs that start with the job stream. The
activity bars for jobs that start with the job stream change position when you select
different run cycles.
¶ See which jobs have a specified start time, which jobs follow job stream rules, and
which jobs have no restrictions on start time, by looking at the button at the beginning
of the job activity bar.

¶ Open the Time Restrictions page of a Run Cycle Properties window or of a Job
Properties window by double-clicking on a run cycle or job in the Table frame.
¶ Change the earliest start time, duration, and deadline time of a job by moving different
components of the activity bar. In the same way, you can change the earliest start time
and deadline of a run cycle.
¶ See which jobs start according to the start time of the job stream, and how those jobs
are affected by various rules.
Saving a Job Stream

After you have specified job stream properties and defined jobs, job dependencies, and run
cycles, you can save the job stream. Job streams are saved in the scheduler database. To
save the new job stream, click the Save button in the Job Stream Editor toolbar.
The Job Stream Editor checks for any missing or invalid information, then saves the job
stream in the application description database.
Note: You can save a job stream from any of the three views available in the Job Stream
Editor. You can define parts of a job stream, for instance the jobs that are in it, then
save it and open it again later, as explained in the next chapter, to define its run
cycles. Just remember to wait to mark it active when it is ready to be scheduled.
Submit a Job Stream

To submit an existing job stream into the plan, right-click a scheduler engine and select
Submit Job Stream from the pop-up menu. The Submit Job Stream window is displayed.
Figure 41. Submit Job Stream Window
Use Table 41 to complete the information needed to submit the job stream.
Table 41. Submit Job Stream Window
Job Stream Name The name of the job stream. If you do not remember the name of the
job stream, click the ellipsis (...) to open a Find Job Stream window.
106 Version 8.1

Table 41. Submit Job Stream Window (continued)
Start The Date and Time when the job can start. The defaults are the values
in the first run cycle.
Deadline The latest Date and Time when the job stream can end. The defaults
are the values in the first run cycle.
Status of Job Stream One of the following:
Simple Submit
Adds a new job stream instance in the plan.
Submit & Hold
Adds a new job stream instance in the plan but it does not start.
It is on hold.
Submit & Edit
Adds a new job stream instance in the plan and opens the Graph
view so you can modify the submitted job stream instance.
Properties Opens the Submit Job Stream Header Info window where you can
modify various properties of the job stream:
Priority
How the job stream ranks in importance compared to other jobs
streams. The lowest priority is 1 and the highest priority is 9. This

means that a job stream with a priority of 3 will run before a job
stream with a priority of 1 when job streams are competing for
resources. This value is not definitive. Other factors, such as
resource and workstation dependency, are considered in
determining priority. This field does not apply to job stream
templates.
Authority Group
Name used to generate a RACF resource name for authority
checking. This information is optional.
Description
A brief description of the job stream.
Owner
Name of the person responsible for the job stream.
Owner description
A brief description of the job stream owner.
JCL variable table
Name of the variable table that the scheduler can use on the days
generated by this run cycle. Alternatively, click the ellipsis to
search for a variable table name.
Job stream template
Name of the job stream template to which the job stream belongs.

¶ Click OK to submit the job stream and close the window.
¶ Click Cancel to close the window without submitting the job stream.

108 Version 8.1
10. Listing and Modifying
Job Streams
10
Listing and Modifying Job Streams
To view job streams, you must create and display a job stream list in the Job Scheduling
view. You can create two types of job stream list:
Job stream list
Produces a filtered list of job streams or job stream templates defined in the Workload
Scheduler for z/OS Application Description database.
Job stream instance list
Produces a filtered list of already scheduled job stream instances together with their
time restrictions.
This chapter explains how to list job streams from the Workload Scheduler for z/OS
database and how to use job stream lists. To learn how to list job stream instances, see
“Listing Job Stream and Job Instances” on page 119. To learn how to use job stream instance
lists, see “Managing Job Streams” on page 127.
Default Job Stream List

The Job Scheduling Console provides a job stream list. You can find it in the Default
Database Lists group in the tree of every engine shown in the Job Scheduling view. The list
is called All Job Streams and displays all the job streams defined in the Workload
Scheduler for z/OS database.
This list works like any other user list. You can display its properties and see from the
empty fields that no selection criteria are specified. You can modify properties and make
them less general by adding the filters of your choice.
Creating a Job Stream List

A job stream list allows you to view and modify job stream definitions, which are stored in
the database. You can:
¶ Open and delete a job stream, and modify job stream properties
¶ Define new job streams starting from existing definitions
¶ Create and delete jobs and external jobs, and modify job properties
¶ Add and delete dependencies between jobs
¶ Create and delete run cycles, and modify run cycle properties
¶ View and change the time restrictions of run cycles and jobs

The changes you make from a job stream list already generated will not reflect these
changes.
To create a job stream list, select an engine in the Job Scheduling view and click the List
Job Streams button. The Properties - Job Stream List window is displayed.
Figure 42. The Properties - Job Stream List Window
Use the information in Table 42 to enter the requested information to create the job stream
list.
Table 42. Properties - Job Stream List Information
Name Type a name for the job stream list.
Periodic Refresh Options Periodic Refresh
Select this if you want the list results refreshed automatically, then
specify a refresh interval in seconds.
Note: Do not specify frequent refreshes of many detached views
open at the same time in order to prevent from overloading your
system.
—OR—
Apply Defaults
Click this to use the defaults specified in the Scheduler Properties
window available in the Job Scheduling view.
110 Version 8.1

Table 42. Properties - Job Stream List Information (continued)
Job Streams
Filter Criteria Specify any of the following search parameters, or combinations of two
or more parameters. Use wildcards to help your search.
Job stream
Lists all the job streams with this name or namestring.
Task name
Lists all the job streams where this task or JCL is used.
Job stream template
Lists all the job streams that are part of this template.
Owner
Lists all the job streams that belong to this owner.
Authority group
Lists all the job streams that use this authority group for RACF
authority checking.
Calendar
Lists all the job streams that use this calendar.
Workstation
Lists all job streams containing jobs that run on this workstation.
Is a template
Lists only job streams that are templates.
Exclude template
Lists only job streams that are not templates.
Priority
Lists all the jobs streams that have the priority level you select in
From and To.
Dates
Lists all the job streams valid within the interval you specify in
From and To.
Status of Job Stream
Lists all the currently active or inactive job streams, depending on
which button you select. The default is to ignore this criteria.
Contains Monitored Job
Yes
lists only job streams that contain jobs selected for monitoring
by Tivoli Business Systems Manager.
No
lists only job streams that contain jobs that are not selected for
monitoring by Tivoli Business Systems Manager.
Ignore criteria
lists job streams, regardless of whether they contained jobs
that are monitored by Tivoli Business Systems Manager.
Click OK to save the list. A list object with the name you specified is added to the tree
under the engine you selected at the beginning. Optionally, before saving it, you can run the
list by clicking Apply.

Displaying a Job Stream List
To display a list of job streams in the database, create a list as described in “Creating a Job
Stream List” on page 109 and run it by clicking on Apply. Alternatively, use an existing list.
To use an existing Job stream list:

1. Select an engine to display all the created lists in the right-hand view of the console.
2. Double-click the list object you want to use, as shown in the next figure.
The list of job streams is displayed in the right-hand pane.
Figure 43. Displaying the Results of a Job Stream List
The job streams are listed by:

¶ Name
¶ Description
¶ Priority level
¶ Start of validity
¶ End of validity
¶ Status (active or inactive)
¶ Authority group ID
¶ Calendar
¶ The owner ID and description
¶ When and by whom the definition was last updated
Modifying Job Streams

Modifying a job stream involves changing any of the following:
¶ The job stream properties.
¶ Any of the jobs that it comprises, as well as any dependencies that might exist among
them.
¶ Any of the run cycles that define its scheduling.
112 Version 8.1

To modify jobs and run cycles, open the job stream from the list. The type of job stream
Job Streams
determines which views you can access in the Job Stream Editor:
¶ For job stream templates, you can open the Timeline and Run Cycle views.
¶ For normal job streams you can open the Graph, Timeline, and Run Cycle views.
¶ For job streams that inherit their scheduling information from a template, you can open
the Graph view only. Open the template to see the scheduling information for the job
stream.
Modifying Job Stream Properties
To modify the properties of a job stream in the database:
1. Run a job stream list.
2. Right-click the job stream and select Properties from the pop-up menu.
3. Make the changes you want in the window (see “Specifying Properties for the Job
Stream” on page 80 for details about the Job Stream Properties window).

¶ Click OK to save the changes.
¶ Click Cancel to discard your changes and close the window.
Adding and Modifying Jobs and Dependencies in the Graph View
To add, modify, or delete jobs and dependencies in an existing job stream:
1. Display a job stream list.
2. When the list is displayed, double-click the job stream you want to open. The Graph
view of the Job Stream Editor opens.
Table 43. Adding and Modifying Jobs and Dependencies in the Graph View
To do this ... See ...
Create a new job in the job stream “Creating a Job” on page 82.
Add a new external job in the job stream “Creating Dependencies between Job Streams” on
page 92.
Add a new dependency between jobs in “Creating Dependencies between Jobs” on page 91.
the job stream
Modifying a Job
1. In the Graph view of the Job Stream Editor, right-click the job and select Properties
Note: If any of the job buttons in the Graph view display a superimposed question
mark, this is an indication that the definition of the workstation associated with
the particular job cannot be found in the database. Likewise, if an button label
displays a (Not Found) string, it means that an external job is missing because
the job or the job stream to which it belongs were deleted in the meantime.
2. Apply your changes (for information about how to do this, see “Creating a Job” on
page 82).
3. Click on Save.

Adding a New Job using Copy and Paste
You can use the Copy and Paste functions to save time when creating a job that shares many
of the properties of an existing job in the job stream. For more information, see “Creating a
Job Using Copy and Paste” on page 90.
Deleting a Job or External Job

To delete a job or external job from the job stream:
1. In the Graph view of the Job Stream Editor, right-click the job or external job and select
Delete from the pop-up menu.
2. Click OK in the confirmation window. The job is deleted from the job stream.
Note: If you change your mind, you can use the Undo Delete option in the same pop-up
menu or in the toolbar of the Graph view to put the job back in the job stream.
This option is valid until you save the job stream.
3. Click Save to save the job stream.
Editing Another Job Stream from an External Job

Use an external job to open a second Job Stream Editor window and edit the job stream to
which the job belongs. To do this:
1. In the Graph view of the Job Stream Editor, right-click the external job and select Edit
from the pop-up menu, then External Job Stream. An additional Job Stream Editor
2. As necessary, open the views to work on the job stream and its components.
Removing a Dependency between Jobs

1. In the Graph view of the Job Stream Editor, right-click the line that represents the
dependency. The line becomes red and a pop-up menu is displayed
2. Select Delete from the pop-up menu. A confirmation window is displayed.
3. Click OK in the confirmation window. The dependency is removed.
4. Click Save to save the job stream.
Adding and Modifying Run Cycles
Select a job stream from a job stream list and open the Run Cycle view of the Job Stream
Editor. In this way, you can work on existing run cycles or create new ones.
2. When the list is displayed, double-click the job stream you want to open.
3. Click the Run Cycle button to open the Run Cycle view of the job stream.
4. Select a run cycle in the run cycle list and right-click it to display the pop-up menu.
Table 44. Adding and Modifying Run Cycles – Pop-up Menu
click this option ... To do this ...
Properties... Edit the run cycle properties in the Run Cycle Properties window.
See “Scheduling Job Streams” on page 94 for reference.
114 Version 8.1

Table 44. Adding and Modifying Run Cycles – Pop-up Menu (continued)
Job Streams
click this option ... To do this ...
Copy Create an additional run cycle with the same properties as the
selected one. A Rule-based Run Cycle Properties window or an
Offset-based Run Cycle Properties window opens with the same
definitions as the model run cycle. Modify any definitions you need
to, and enter a new name before saving.
Delete Delete the run cycle from the job stream.
Viewing and Modifying Time Restrictions

The Timeline view of the Job Stream Editor shows the time restrictions of the jobs and run
cycles of a job stream. You can modify the time restrictions of a job or of a run cycle, in the
same way you created them, by using either the Job Properties window of the Graph view or
the Run Cycle Properties window of the Run Cycle view.
In addition, you can view and modify time restrictions for more than one run cycle and
more than one job in the Timeline view. For a full description of the Timeline view of a job
stream, see “Checking Time Restrictions in the Timeline View” on page 104.
Deleting Job Streams from the Database

To delete a job stream from the database, you use a job stream list.
To do this:
2. When the list is opened, right-click the job stream you want to delete and select Delete
3. Click OK in the confirmation window. The job stream is deleted.
Using Copy to Add an External Job

You can use the Copy function on a listed job stream to add any of the jobs that comprise it
as external jobs to another job stream.
For example:
2. Right-click a job stream and select Open. The job stream opens in the Graph view of the
Job Stream Editor.
3. Right-click another job stream in the list and this time select Copy from the pop-up
menu.
4. Go to the Job Stream Editor where the first job stream is open..
5. Right-click anywhere in the window and select Paste from the pop-up menu.
6. In the Properties - External Job window, select Show jobs. All the jobs that comprise the
second job stream are displayed.

Figure 44. Properties - External Job Window
7. Select the job or jobs that you want to add as external jobs of the first job stream.
8. Click OK to close the Properties - External Job window. Icons for the added jobs are
displayed in the Graph view of the first job stream.
Figure 45. Job Stream Editor - External Job Added
116 Version 8.1

Using Existing Definitions to Create Other Job Streams
Job Streams
You can select a job stream from a list and use its definition to create other job streams with
equal or similar properties. To do this:
1. Display a list of job streams.
2. Right-click the job stream that you want to use as a model for creating another job
stream and select Create Another from the pop-up menu. The Job Stream Editor and the
job stream properties windows for the job stream that you selected are displayed.
3. In the Name field of the job stream properties window, change the default name to the
name of your choice. If you do not change the name, the new job stream is saved as
CopyOfname, where name is the name of the model job stream.
4. In the job stream properties and Job Stream Editor windows make any other changes that
you need to customize the new job stream for your requirements.
5. Save the new job stream and close the Job Stream Editor window.
6. In the Job Scheduling Console window, either click the Refresh List Results button or
run another list to view the new job stream.

118 Version 8.1
11
Listing Job Stream and Job Instances
11. Listing Job Stream and

For jobs and job streams, an instance, also known as an occurrence, is a job or job stream
Job Instances
that has been scheduled in the plan. The plan contains past, present, and future scheduled
job streams. It also contains the workstations and resources that support this workload.
To monitor and modify job and job stream instances, you create and display lists for each.
This chapter describes how to list job stream and job instances. “Managing Job Streams” on
page 127 describes how to work with instances from the lists you create.
Creating Lists of Job Stream and Job Instances

You can maintain several lists by creating list objects with different sets of filter criteria. For
example, you can maintain lists of job streams for different status and error conditions. You
can also create lists to monitor the workload in progress or the outcome of scheduled jobs.
Table 45 shows some examples of how to use job and job stream instance lists:
Table 45. Examples of How to Use Job and Job Stream Instance Lists
To do this ... Perform this task ...
List jobs that have ended in error in the Create a list of jobs with a status of Error and a time
last 24 hours interval between yesterday’s and today’s dates.
Discover all the scheduled jobs that List the job in error and look at all its successors.
depend on a job that you know will end
in error
Search for all job streams that include a Create a job instance list and specify the identifier in the
specific job 3 filter criteria. The resulting list displays all instances of job
3 and the job stream instance to which it belongs.
See all job stream instances scheduled Create a job stream instance list and specify the dates in the
for the month of December 2001 filter criteria.
Default Instance Lists

The Job Scheduling Console provides instance lists. You can find them in the Default Plan
Lists group in the tree of every Workload Scheduler for z/OS engine shown in the Job
Scheduling view. The instance lists are:
All Scheduled Job Streams
Displays a list of all the existing job stream instances.
All Scheduled Jobs
Displays a list of all the existing job instances.

The default instance lists work in the same way as user lists. You can display their
modify their properties and make them less general by adding filters of your choice.
Listing Job Stream Instances
To list job stream instances, in the Job Scheduling view, select an engine and click the List
Job Stream Instances button in the toolbar. The Properties - Job Stream Instance List
Figure 46. Properties - Job Stream Instance List Window
Use the information in Table 46 to specify the selection criteria for the list.
Table 46. Properties - Job Stream Instance List Information
Name Type a name for the job stream instance list.
Periodic Refresh Options Periodic refresh
Select this to specify a refresh interval in seconds, if you
want the list results refreshed automatically.
Apply defaults
Click this to use the default specified in the Settings page of
the Scheduler Properties window.
Filter Criteria
Specify any of the following search parameters, or combinations of two or more parameters. Use
wildcards to help your search.
120 Version 8.1

Table 46. Properties - Job Stream Instance List Information (continued)
Job stream Lists all the job stream instances with this name or namestring.
Job stream template Lists all the job stream instances that are part of this template.
Occurrence Token Lists the job stream that is identified by this occurrence token in
the plan. The token is a unique 16-character hexadecimal string
assigned to the job stream by the scheduler.
Owner Lists all the job stream instances that belong to this owner.

Authority group Lists all the job stream instances that use this authority group for
RACF authority checking.
Job Instances
Dates Lists all job stream instances scheduled to run in an interval
period starting on the day and time specified in the From Date
and Time fields and ending in the day and time specified in the
To Date and Time fields. Pop-up calendars are provided to help
you select the days.
Priority Lists all the job stream instances that have the priority level you
select in From and To.
Manually Added Lists all those job stream instances that were added manually to
the plan (and not automatically through a plan extension), if you
select the Yes radio button. Select No to exclude manually added
job streams from the list. Select Ignore criteria to omit this filter.
Rerun requested Lists all those job stream instances for which a rerun was
requested, if you select the Yes radio button. Select No to exclude
these job stream instances from the list. Select Ignore criteria to
omit this filter.
Contains Monitored Job Yes
lists only job streams that contain jobs selected for monitoring
by Tivoli Business Systems Manager.
No
lists only job streams that contain jobs that are not selected for
monitoring by Tivoli Business Systems Manager.
Ignore criteria
lists job streams, regardless of whether they contained jobs
that are monitored by Tivoli Business Systems Manager.
Most Critical Job The start time of the most critical job. If the job stream has no
critical job, the field is blank.
Status Lists all the job stream instances with any of the following Job
Scheduling Console status codes that you specify in the
drop-down list:
¶ Waiting
¶ Running
¶ Successful
¶ Error
¶ Canceled

Table 46. Properties - Job Stream Instance List Information (continued)
Internal Status Lists all the job stream instances with any of the following status
codes that you specify in the drop-down list:
¶ Complete
¶ Deleted
¶ Error
¶ Pending predecessor
¶ Started
¶ Undecided
¶ Waiting
Note: Status and internal status exclude each other as filter criteria. However, they are both
displayed among the properties of job stream instances. Internal status refers to the
status code assigned by the specific job scheduling engine. It generally provides more
detail than the broader status code assigned by the Job Scheduling Console.
Click OK. An button of the new list is displayed in the tree under the engine you selected
when creating it. To display the list, right-click it and select Open. List results are displayed
in the right hand pane. Optionally, before saving the list, you can click Apply to display the
list results immediately.
122 Version 8.1

Listing Job Instances
To list job instances, in the Job Scheduling view, select an engine and click the List Job
Instances button. The Properties - Job Instance List window is displayed.

Job Instances
Figure 47. The Properties - Job Instance List window
Table 47. Properties - Job Instance List Information
Name Type a name for the list.
Select this to specify a refresh interval in seconds, if you want
the list results refreshed automatically.
Apply defaults
Click this to use the default specified in the Settings page of
the Scheduler Properties window.
Filter Criteria
Job stream Lists all the job instances that are in the job stream with this name
or namestring.
Job identifier Lists all the job instances that have this identifier. You cannot use
wildcard characters with this filter.
Task name Lists all the job instances that are associated with this task or JCL.
Workstation Lists all the job instances run on this workstation.
Owner Lists all the job instances that belong to this owner.

Table 47. Properties - Job Instance List Information (continued)
Authority group Lists all the job instances that use this authority group for RACF
authority checking.
Priority Lists all the job instances that have the priority level you select in
From and To.
Dates Lists all job instances that are part of job stream instances scheduled
to run in an interval period starting on the day and time specified in
the From Date and Time fields and ending in the day and time
specified in the To Date and Time fields. Pop-up calendars are
provided to help you select the days.
Is Monitored Job Select this to specify whether to list jobs monitored by Tivoli
Business Systems Manager.
Yes
lists only jobs that are selected for monitoring by Tivoli
No
lists only jobs that are not selected for monitoring by Tivoli
Ignore criteria
lists jobs, regardless of whether they are monitored by Tivoli
Restart Option Lists jobs according to their restart and dataset cleanup
specifications.You can use the following filters:
CleanUp Type
Select from the drop down list job instances that have one of
the following cleanup and restart specifications:
None
Immediate
Automatic
Manual
CleanUp Status
Select from the drop down list job instances with either a
Completed or Error cleanup state.
Status Lists all the job instances with any of the following Job Scheduling
Console status codes that you specify in the drop-down list:
¶ Waiting
¶ Ready
¶ Running
¶ Successful
¶ Error
¶ Canceled
¶ Interrupted
¶ Undecided
124 Version 8.1

Table 47. Properties - Job Instance List Information (continued)
Internal Status Lists all the job instances with any of the following status codes
that you specify in the drop-down list:
¶ Arriving
¶ Ready
¶ Started
¶ Complete
¶ Deleted

¶ Interrupted
¶ Ready-non reporting workstation
¶ Error
Job Instances
¶ Waiting
¶ Undecided
Critical job Lists all the job instances defined as critical jobs. Available for OPC
2.3 or later.
WLM policy Lists all the job instances defined as critical jobs and for which the
WLM policy you indicate here was defined. click the arrow and
select one of the available policies. Available for OPC 2.3 or later.
Note: Status and internal status exclude each other as filter criteria. However, they are both
displayed among the properties of job instances. Internal status refers to the status
code assigned by the specific job scheduling engine. It generally provides more detail
than the broader status code assigned by the Job Scheduling Console.
Click OK. An button of the new list is displayed in the tree under the engine you selected
when creating it. To display the list, right-click it and select Open. List results are displayed
in the right-hand pane. Optionally, before saving the list, you can click Apply to display the
list results immediately.

126 Version 8.1
12
Managing Job Streams
This chapter explains how to:
¶ Browse and modify a job stream instance
¶ Delete a job stream instance
¶ Change the status of a job stream instance to complete
¶ Change the status of a job stream instance to waiting
To perform these actions, you use job stream instance lists.
12. Managing Job Streams

Job Stream Instance Lists
Job stream instance lists are displayed in two ways, the List View and the Timeline View.
List View
The List View shows details about each instance.
Figure 48. Job Stream Instances List View
Timeline View
The Timeline View displays graphic information about time restrictions.
In the Timeline View, job stream instances with the same names are listed in groups. A
group contains two or more job stream instances that have the same job stream name but

different run times. Groups are indicated by a small arrow on their left side. Click the arrow
to display the individual instances.
Figure 49. Job Stream Instances Timeline View
The only possible action on a group of job stream instances is Delete all, which you can
select when you right-click the group. To perform the actions listed above and to display
activity bars on the individual instances, you must first expand the group by clicking on the
arrow.
Browsing and Modifying Job Stream Instances

You can browse and modify job stream instances in the Properties - Job Stream Instance
window, using the General page, the Time Restrictions page, or both.
Using the General Page
Right-click the job stream instance and select Properties from the pop-up menu. The
Properties - Job Stream Instance window is displayed. Most of the details you see are in
read-only mode. However, you can modify some editable fields.
128 Version 8.1

Figure 50. Properties - Job Stream Instance General Page
The General page displays:

¶ The name and description of the job stream.
¶ The occurrence token that identifies where the job stream is in the plan.
¶ If the status is running, at what time the instance started.
¶ If the status is successful, the amount of time it took the instance to complete.
¶ The current status.
¶ The earliest time at which you estimated the instance should start.
¶ The authority group name, if applicable, and the owner.
¶ The name of the calendar used for the schedule.
¶ The priority level. You can raise or lower it if the instance has not yet started.
¶ The name of the table of JCL variables, if any, used by the job stream. You can enter or
change the name of a table. Click the ellipsis button (...) to search for available tables.
¶ The name of the job stream template, if any, to which the job stream belongs.
¶ The name of the function used to schedule the job stream.
¶ Whether the instance has been run again.
¶ The number of jobs that remain to be run in the critical path, their expected duration,
and the identifier of the next job scheduled to run on the critical path.
Using the Time Restrictions Page
The Time Restrictions page contains the earliest start time and deadline that you specified
when you created the job stream. You can change them here in the same way as you can
change them by moving the activity bar in the Timeline View.

Figure 51. Properties - Job Stream Instance Time Restrictions Page

¶ Click Apply to save any changes and keep the window open.
¶ Click OK to save any changes and close the window.
¶ Click Cancel to disregard any changes and close the window.
Changing Time Restrictions in the Timeline View

The left-hand pane of the Timeline View displays the following job stream instance details:
Table 48. Job Instance Details Timeline View
This column ... Specifies ...
Name The job stream name.
Status The current status.
Started The actual start time.
Runtime The actual duration.
Start at The planned start time.
Deadline The planned deadline.
130 Version 8.1

Figure 52. Timeline View - Left Pane
The right-hand pane has activity bars that show the actual run time if the instances have
begun, as well as the specified time restrictions for the instances.

Figure 53. Timeline View - Right Pane
By moving components of the activity bars, you can change the time restrictions of each
instance and view the results of your changes, as you would by following the steps
described in “Browsing and Modifying Job Stream Instances” on page 128 and going
directly to the Time Restrictions page of the Properties - Job Stream Instance window.
The activity bar shows the runtime of a job stream instance in terms of the start and
deadline times that were specified as time restrictions for the job stream. The deadline is
indicated by a vertical black stripe at the end of the blue activity bar. As the instance starts,
a horizontal black line unfolds inside the activity bar to show the actual runtime.
You can change the time restrictions of an instance that has yet to run or that is running by:
¶ Rescheduling the instance
¶ Rescheduling the start time
¶ Rescheduling the deadline time

Rescheduling the Instance
To reschedule the instance:
1. Move the activity bar by positioning the mouse pointer inside the bar and, when the
pointer becomes cross-shaped, hold down the left mouse button while moving the bar in
either direction.
Figure 54. Rescheduling a Job Stream Instance
As you move the bar, a tooltip tells you the new deadline time at every position of the
right end of the bar.
2. When you find the position you want, release the mouse button. The Properties - Job
Stream Instance Time Restrictions window is displayed, showing the new start and
deadline times.
Figure 55. Properties - Job Stream Instance Time Restrictions
132 Version 8.1

3. Click OK. The activity bar is set on the new position.
Rescheduling the Start Time
To reschedule the start time:
1. Position the mouse pointer on the left end of the bar. When the pointer becomes a
double arrow, hold down the left mouse button while moving the end of the bar.

Figure 56. Rescheduling the Start time of a Job Stream Instance
As you move your mouse, a tooltip tells you the corresponding start time at every new
position of the left end of the bar.
Stream Instance Time Restrictions window is displayed, showing the new start time.
3. ClickOK to save the new settings. The left end of the activity bar is set on the new
position.
Rescheduling the Deadline Time
To reschedule the deadline time:
1. Position the mouse pointer on the right end of the bar. When the pointer becomes a

Figure 57. Rescheduling the Deadline Time
As you move your mouse, a tooltip tells you the corresponding deadline time at every
new position of the right end of the bar.
Stream Instance Time Restrictions window is displayed, showing the new deadline time.
3. Click OK to save the new settings. The right end of the activity bar is set on the new
position.
Deleting a Job Stream Instance

To delete a job stream instance:
1. In a list, right-click the name of an instance or group of instances and select Delete from
the pop-up menu. A confirmation window is displayed.
2. Click OK in the confirmation window. The instance or instances are deleted and
removed from the plan.
Setting a Job Stream Instance to Complete

To force the completion of a job stream instance:
1. In a list, right-click the job stream instance and select Set to Complete from the pop-up
menu.
2. Click OK in the confirmation window. The status of the job stream instance is changed
to Complete. The status of all the job instances that are part of the job stream is also set
to Complete.
Setting a Job Stream Instance to Waiting

Note: Use this option only if no external jobs have started.
To set a job stream instance to Waiting status to force it to restart:

1. In a list, right-click the job stream instance and select Set to Waiting from the pop-up
menu. A confirmation window is displayed.
134 Version 8.1

2. Click OK in the confirmation window. The status of the job stream instance is changed
to Waiting. The status of all the job instances that are part of the job stream is also set to
Waiting.
Rerunning a Job Stream Instance

You can change the status of a job and rerun a job stream instance. When you rerun the
instance, you can specify with which job is to start first.
Note: To be able to rerun a job stream instance, restart cleanup must be enabled in the job
properties. This can only be done on the host.
To rerun a job stream instance:

1. In a list, right-click the job stream instance and select Rerun from the pop-up menu. The
Job Stream Instance Rerun Editor is displayed.
2. Right-click the job where you want to start the rerun and select StartFrom. The Rerun
Impact List window is displayed, showing information about the instance.
3. If you want to, select Use Restart and Cleanup, otherwise, continue with step 4. The
following additional options become available from the drop-down list box:

Step Restart Select this to specify at which point in the JCL the job should restart.
Data Set List Select this to specify with which data set to restart.
Edit JCL Select this to edit the JCL for the job.
Execute Select this to run the restart and cleanup with specifying any specific
instructions.
4. Click OK to rerun the job.
Additional Options
In addition to the StartFrom option in the pop-up menu, you can also select:
StartCleanup
Starts a cleanup operation.
DisplayCleanup
Displays the last data set to be cleaned up.
For further information, see “Restart and Cleanup” on page 160.

136 Version 8.1
13. Managing Jobs
13
Managing Jobs
This chapter explains how to:
¶ Browse and modify a job instance
¶ Add, remove, or change the dependencies of a job instance on other jobs
¶ Delete a job instance from the plan
¶ Hold a job instance
¶ Release a held job instance
¶ Show predecessors and successors
¶ View the job log file
¶ Remove a job instance from the plan
¶ Restore a job instance to the plan
¶ Run a job instance immediately
¶ Change the status of a job instance
¶ Modify the variables and instructions associated with a job instance
¶ View operator instructions associated with a job instance
¶ Tailor job statements
¶ Restart a job instance and perform cleanup operations
To perform these actions, you use job instance lists.

Job Instance Lists
Job instance lists are displayed in two ways, the List View and the Timeline View.
List View
The List View shows details about each instance.
Figure 58. Job Instances List View
Timeline View
The Timeline View displays graphic information about time restrictions.
In the Timeline View, job instances that share the same job stream instance and runtime are
listed in groups. A group contains two or more job instances that have the same runtime but
different identifiers. Groups are indicated by a small arrow on their left side. Click the arrow
and the individual instances are displayed.
Figure 59. Job Instances Groups in the Timeline View
138 Version 8.1

13. Managing Jobs
As shown in Figure 59 on page 138, you can perform the following actions on a group of
job instances:
¶ Delete all the job instances
¶ Put all the job instances on hold
¶ Release all the held job instances
To perform the actions available to individual job instances and to display activity bars on
the job instances arranged in a group, you must first expand the group by clicking on the
arrow.
Browsing and Modifying Job Instances

List the job instance that you want to work on then right-click it and select Properties from
the pop-up menu.
This section describes the following pages of the the properties window:
¶ General
¶ Task
¶ Time Restrictions
¶ Details
¶ Options
¶ Resources
When you have completed your changes:

¶ Click Apply to save the changes and keep the window open.
¶ Click OK to save any changes you made and close the window.
¶ Click Cancel to disregard the changes and close the window.

General Page
The General page contains general information about the job instance. This information is
mainly read-only.
Figure 60. Properties - JCL Job Instance Instance General Page
Table 49 describes the contents of the window.

Table 49. Properties - JCL Job Instance General Information
This area ... Contains this information ...
Occurrence Token Identifies where the instance is in the plan.
Identifier The job identifier.
Workstation The name of the workstation running the job.
Priority The priority level of the job stream to which the job belongs.
Started The actual date the instance started.
Runtime The time it took the instance to run if completed.
Belongs to job stream The name of the job stream to which the job belongs.
Description A description of the job. This field is editable.
Authority group The name of the authority group of the job stream.
Internal status The status of the job instance.
Status details Additional information about the status of the job instance.
Error code The code with which the instance ended in error, when applicable.
Start Time The earliest, latest, planned, and actual start times of the job
instance.
140 Version 8.1

13. Managing Jobs
Task Page
The Task page contains editable information about any task or JCL that the job instance may
be associated with:
Figure 61. Properties - JCL Job Instance Task Page

Table 50. Properties - JCL Job Instance Task Information
Task name The name of the task associated with the job instance.
Form number The printer form number if the job is a printer job.
Job class The job class letter.

The Time Restrictions page contains the start time, deadline, and duration that you specified
when you defined the job in the database. You can change them here if the job has not
started yet. However, Workload Scheduler for z/OS calculates the planned start time and
deadline.
Figure 62. Properties - JCL Job Instance Time Restrictions Page
142 Version 8.1

13. Managing Jobs
Details Page
The Details page displays additional information about the job instance.
Figure 63. Properties - JCL Job Instance Details Page

Table 51. Properties - JCL Job Instance Details Information
JES job number The job number assigned by JES.
Planned duration The planned duration time.
Intermediate start If there is an intermediate start.
Actual end The time of actual end, if the instance completed.
Transport time The transport time.
Dependencies This group box displays:
¶ The number of jobs whose completion is necessary for this
instance to run. See the Predecessors page of the Job Instance
Dependencies window for a list.
¶ The number of predecessors that have completed.
¶ The number of jobs that depend on the completion of this
instance. See the Successors page of the Job Instance
Dependencies window for a list.
¶ The number of logical resources reserved for the job.
CleanUp Status The status code of the data set cleanup action. This can be one of:
¶ Completed
¶ Error ended
If no status is displayed, either data set cleanup has been reset or
it has not yet started.
Latest out passed The latest end time passed.
On critical path Whether the job instance is on the critical path.
Urgent The urgency indicator.
JCL preparation Whether JCL preparation is required.

Table 51. Properties - JCL Job Instance Details Information (continued)
Deadline WTO Whether a write-to-operator message should be sent when the job
misses its deadline.
WLM policy The policy applied for WLM service class promotion if this job is
late. To use this option, you must also select the Critical job
check box. Available for OPC 2.3 or later. The policy can be:
Conditional
The scheduler uses an algorithm to determine whether to
apply the Deadline or the Latest start option.
Deadline
The scheduler intervenes if the job runs beyond the deadline.
Latest start
The scheduler intervenes immediately if the job starts after
the latest start time.
Long duration
The scheduler intervenes if the job takes longer than it
should as compared to the statistics that it keeps.
Critical job Whether or not the job has been defined as a critical job. If a
critical job runs late, it is eligible for Workload Manager (WLM)
service class promotion. Available for OPC 2.3 or later.
144 Version 8.1

13. Managing Jobs
Options Page
The Options page contains job instance properties that you can change.
Figure 64. Properties - JCL Job Instance Options Page

Table 52. Properties - Write-to-Operator Job Instance Options Information
Auto release Whether the instance should be automatically released. Click the
check box to set this feature on or off.
Auto error completion Whether the instance should be automatically completed in the
event it ends in error. Select the check box to set this feature on
or off.
Cancel if late Whether the instance should be cancelled automatically if late on
schedule. Select the check box to set this feature on or off.
Auto submit Whether the instance should be submitted automatically. Click the
check box to set this feature on or off.
Restartable Whether the instance should be made restartable. You can change
to Yes, No, or Default to keep the original job definition.
Reroutable Whether the instance should be made reroutable. You can change
to Yes, No, or Default to keep the original job definition.
Restart CleanUp Whether Restart CleanUp is used if the job instance ends in error.
This field is read-only.
Highest acceptable return code The highest acceptable return code for the instance. You can
update this field.
User data Editable user data.

Resources Page
The Resources page, shown in the next figure, contains information about the target and
logical resources used by the job instance.
Figure 65. Properties - JCL Job Instance Resources Page
Click the pull-down arrow and select the type of resources you want to see.
Target Resources
The Target resources list, shown in the next figure, displays the quantities of workstation
resources 1 and 2, and of the parallel server. You can modify quantities by double-clicking
the field and entering a new value.
Figure 66. Target Resources for a Job Instance
146 Version 8.1

13. Managing Jobs
Logical Resources
The Logical resources list, shown in the next figure, displays information about any defined
resource. Double-click any cell to enter new values or to choose values from the drop-down
lists.
Figure 67. Logical Resources for a Job Instance

Table 53. Logical Resources Information
Resource The resource name.
Quantity The resource quantity.
Access type The access type. Available options are Shared or Exclusive.
Keep on error Whether to keep the resource allocated, if it goes on error. Available
options are Yes, No, and Default to use the choice specified in the
original job definition.
To add or remove resources in the list, click the Add Row or Remove Row buttons. When
adding a resource, click the ellipsis (...) under the Resource field to locate resources with
theFind tool. When removing a resource, select the resource before clicking on Remove
Row.
Note: You can only add or remove logical resources, not target resources.

Browsing and Modifying Job Dependencies
This section describes how to browse and modify the job dependencies of a job instance.
List the job instance that you want to work on, then right-click it and select Dependencies
from the pop-up menu. The Dependencies - JCL Job Instance Predecessors window is
displayed.
Predecessors Window
The Predecessors window displays information about the job instances that must complete
before this instance can start running:
Figure 68. Dependencies - JCL Job Instance Predecessors Window

Table 54. Dependencies Predecessors Information
Job Stream Name The name of the job stream to which the predecessor belongs, if it
is external.
Identifier The identifier of the predecessor job.
Job Stream Start The start time of the job stream to which the predecessor belongs,
if it is external.
Task Name The name of the task associated with the predecessor job.
Status The current status of the predecessor.
Note: If you cannot read the headings completely, widen the column heading cells with
your mouse.
148 Version 8.1

13. Managing Jobs
You can modify the information of this page in the following way:
Table 55. Dependencies Predecessors Tasks
Change listed predecessors Double-click each field to replace the information.
Add a predecessor Click the Add Row button in the top right of the window, then
complete the fields of the new row.
If you need help to find an external predecessor job, or information

about it, select the ellipsis that displays when you double-click the
Job Stream Name, Identifier, or Job Stream Start fields. This
opens a Find Job Instance window where you can start a filtered
search of the job you are seeking. The search produces information
in terms of job stream name, job identifier, and job stream start
date. To insert these data in the row you are working on, just click
Apply in the Find Job Instance window.
Delete a predecessor Select the predecessor, then click on the Delete Row button in the
top right of the window.
Select Successors in the left pane. The Successors page is displayed.

Successors Window
The Successors page displays information about other job instances that depend on the
completion of this instance to start running.
Figure 69. Dependencies - JCL Job Instance Successors Page

Table 56. Dependencies Successors Information
Job Stream Name The name of the job stream to which the successor belongs, if it
is external.
Identifier The identifier of the successor job.
On critical path Whether the successor job is on the critical path
Job Stream Start The start time of the job stream to which the successor belongs, if
it is external.
Task Name The name of the task associated with the successor job.
Status The current status of the successor.
Note: If you cannot read the headings completely, widen the column heading cells with
your mouse.
150 Version 8.1

13. Managing Jobs
You can modify the information of this page in the following way:
Table 57. Dependencies Predecessors Tasks
Change listed successors Double-click each field to replace the information.
Add a successor Click the Add Row button, then complete the fields of the new
row.
If you need help to find an external successor job, or information

about it, select the ellipsis (...) that displays when you
double-click the Job Stream Name, Identifier, or Job Stream
Start fields. This opens a Find Job Instance window where you
can start a filtered search of the job you are seeking. The search
produces information in terms of job stream name, job identifier,
and job stream start date. To insert this data in the row you are
working on, just click Apply in the Find Job Instance window.
Delete a successor Select the successor, then click the Delete Row button.

¶ Click Cancel to disregard the changes and close thge window.

Changing Time Restrictions in the Timeline View
The left-hand pane of the Timeline View displays the following job instance details:
Table 58. Timeline View Job Instance Details
Name The job name
Status The current status
Started The actual start time
Runtime The actual duration
Start at The planned start time
Duration The planned duration
Deadline The planned deadline
Figure 70. Timeline View of Job Instances - Left Pane
The right-hand pane, see Figure 71, has activity bars that show the runtime of a job instance
in terms of start, duration, and deadline times.
Figure 71. Timeline View of Job Instances - Right Pane
152 Version 8.1

13. Managing Jobs
The deadline is indicated by a black stripe at the end of the blue activity bar. The activity
bar represents the time difference between the earliest planned start and the planned end that
were specified as time restrictions for the job. A pale blue bar represents the duration of the
job. It turns red if the duration exceeds the deadline and it becomes diamond shaped if the
duration is zero. A black line represents the actual runtime of the job instance.
By moving components of the activity bars, you can change the time restrictions of each
instance and view the results of your changes, as you would by following the steps
described in “Browsing and Modifying Job Instances” on page 139 and going directly to the
Time Restrictions page of the job instance properties window.
You can change the time restrictions of an instance by:

¶ Rescheduling the instance
¶ Rescheduling the start time
¶ Rescheduling the deadline time
Rescheduling the Instance

To reschedule the instance in ready status:
1. Move the activity bar by positioning the mouse pointer inside the bar. When the pointer
becomes cross-shaped, hold down the left mouse button while moving the bar in either
direction.
Figure 72. Rescheduling a Job Instance
As you move the bar, a tooltip tells you the new deadline time at every position of the
right end of the bar.
Instance Properties Time Restrictions page is displayed, showing the new times.
3. Click OK in the Time Restrictions page to save the new settings. The activity bar is set
on the new position.

Rescheduling the Start Time
To reschedule the start time:
1. Position the mouse pointer on the left end of the bar. When the pointer becomes a
double-headed arrow, hold down the left mouse button while moving the end of the bar.
Figure 73. Rescheduling the Start Time
As you move your mouse, a tooltip tells you the corresponding start time for every new
position of the left end of the bar.
Instance Properties Time Restrictions page is displayed, showing the new start time.
3. Click OK to save the new settings. The left end of the activity bar is set in the new
position.
Rescheduling the Deadline Time

To reschedule the deadline time:
1. Position the mouse pointer on the right end of the bar. When the pointer becomes a
Figure 74. Rescheduling the Deadline Time
154 Version 8.1

13. Managing Jobs
As you move your mouse, a tooltip tells you the corresponding deadline time for every
new position of the right end of the bar.
Instance Time Restrictions page is displayed, showing the new deadline time.
3. Click OK in the to save the new settings. The right end of the activity bar is set in the
new position.
Deleting Job Instances

To delete a job instance:
1. Right-click the name of a job instance or group of job instances and select either Delete
or Delete all from the pop-up menu. A confirmation window is displayed.
2. Click OK in the confirmation window to delete the instance or group of instances. The
instance or instances are deleted and removed from the plan.
Putting Job Instances on Hold

To put a job instance on hold:
1. Right-click the name of a job instance or group of job instances and select either Hold
or Hold all from the pop-up menu. A confirmation window is displayed.
2. Click OK in the confirmation window. The instance or instances are placed on hold in
the plan until they are released again.
Releasing Job Instances

To release a job instance:
1. Right-click the name of a job instance or group of job instances and select either
Release or Release All from the pop-up menu. A confirmation window is displayed.
2. Click OK in the confirmation window. The instance or instances are released into the
plan.

Showing Predecessors and Successors
To show the predecessors of a job instance or its successors, right-click a job instance and
select Impact View from the pop-up menu, then either Predecessors or Successors. The
Impact View window is displayed.
Figure 75. Impact View Window
You can change the way the view is displayed by using the following buttons in the toolbar.
Table 59. Impact View Options
Select this button ... To display this type of view ...
Radial
Left
Right
Up
Down
Displaying Dependencies
To display a dependency of a job instance, right-click the job instance and select
Dependencies from the pop-up menu. Any dependent job instances are displayed.
Only the first level of dependenct job instances is displayed. If you want to display more
than one level of dependency, you must right-click each dependent job instance in turn,
selecting Dependencies from the pop-up menu each time.
Note: If you display dependencies for more than one job, then refresh the display, only the
first level of dependent job instances is displayed.
156 Version 8.1

13. Managing Jobs
Set as Root
At any time, you can reset the display using one particular job instance as the starting, or
root, job instance. To do this, right-click the job instance you want to use as as the root job
instance and select Set As Root from the pop-up menu. The display is refreshed, showing
the selected job instance as the root instance.
To reset the display in a separate window, right-click the job instance you want to use as as
the root job instance and select Set As Root In New Frame from the pop-up menu.
Browsing the Job Log

To browse the job instance log, right-click a job instance and select Browse Job Log from
the pop-up menu. The Job Instance Output window is displayed.
When you have finished, click Cancel to close the window.
Removing a Job Instance from the Plan

You can use the NOP option to remove a job instance that is already in the plan and is
ready or waiting to run. Use this option on job instances whose internal status is one of the
following:
¶ Arriving
¶ Ready
¶ Ready-non reporting workstation
¶ Waiting
¶ Completed (only for workstations with automatic reporting)
To use the NOP option, right-click the name of a job instance and select NOP from the
pop-up menu.

Restoring a Job Instance to the Plan
You can use the UN-NOP option to restore to the plan a job instance previously removed
with the NOP option.
To do this, right-click the name of a job instance and select UN-NOP from the pop-up
menu. The job instance is restored to the plan.
Running a Job Instance Immediately

You can use the Execute option to immediately run a job instance that is ready to run
regardless of normal scheduling rules excluding dependencies. In order to run, the resources
the job instance depends on must be available. Otherwise, the option is rejected.
To force the running of a job instance, right-click the name of a job instance and select
Execute from the pop-up menu. If all conditions are met, the job instance is run
immediately.
Changing the Status of a Job Instance

You can set the status of a job instance manually. To do this:
1. Right-click the name of a job instance and select Set Status from the pop-up menu. A
Change Status dialog is displayed.
Figure 76. Change Status Dialog
2. Select the button for the status you want to use.
Note: If you are changing to an Error status, a field becomes available for entering any
code you want to show in the properties window.
158 Version 8.1

13. Managing Jobs
Editing JCL
You can modify the variables and instructions associated with a job instance before
submitting a job by editing the JCL associated with the instance.
To edit the JCL:

1. In a list, right-click a job instance and select Edit JCL from the pop-up menu. The Edit
JCL window is displayed.
Figure 77. Edit JCL Window
2. Make the changes you want.
3. Click the Import button to open a JCL file and copy JCL into the edit window.
4. Click the Export button to save any JCL from the job you are editing.

¶ Click OK to save the changes and close the window.
¶ Click Cancel to close the window without saving any changes.

Viewing Operator Instructions
You can view any operator instructions associated with a job instance. To do this:
1. Right-click the name of a job instance and select Browse Operator Instruction from the
pop-up menu. The Browse Operator Instruction window is displayed.
2. When you have finished, click OK.
Note: The Browse Operator Instruction option is only available if an operator instruction
has been defined for the job instance.
Modifying Job Setup

The Job Setup option allows you to tailor a job before it is submitted. To do this, right-click
a Job Setup job instance and select Job Setup from the pop-up menu. If there are
promptable variables that have not yet been set, the Job Setup window is displayed where
you can change the values of the promptable variables.
Note: You can only change the variable value. A default value is displayed, if it has been
set beforehand.
When you have made your changes, click OK. A second Job Setup window is displayed for
each successor job instance. Each window shows the JCL for the instance, reflecting the
change made to the promptable variables.
When you have finished, for each Job Setup JCL window:
¶ Click OK to save the changes and close the window.
¶ Click Cancel to close the window without saving any changes.
Restart and Cleanup

Note: Before using this function, you should refer to the Restart and Cleanup description in
Tivoli Workload Scheduler for z/OS Planning and Scheduling.
You can restart a job instance and perform cleanup operations. To do this:
1. Right-click a job instance and select Restart and Cleanup from the pop-up menu. The
Restart and Cleanup window is displayed.
2. Select one of the following:
Step Restart Choose at what step of the JCL the job is to restart.
Job Restart Completely restart the job.
Start Clean Up Only clean up the environment.
Display Clean Up Result View the results of the clean up.
Use Expanded JCL Select this to use expanded JCL.
160 Version 8.1

14
Managing Workstations in the Plan

This chapter describes how to monitor and update workstations in the plan. You can:
in the Plan
¶ Monitor the status of a workstation in the plan and of the job instances scheduled to run
on it
¶ Modify the settings and availability of the workstation
¶ Reroute the job instances that are scheduled to run on a workstation
¶ Modify the status of the job instances running on the workstation
To perform these tasks, you use a filtered list of workstations in the plan.

Creating a List of Workstations
A plan workstation list produces a filtered list of workstations allocated to the plan.
To create a list of workstations in the plan, in the Job Scheduling view, select an engine and
click the List Workstations in Plan button. The Properties - Plan Workstation List window
is displayed.
Figure 78. The Properties - Plan Workstation List Window
162 Version 8.1

Use the information in Table 60 to enter all the information needed to create the plan
workstation list.
Table 60. Properties - Plan Workstation List Information
Name Enter a name for the list.
Periodic Refresh Options ¶ Select Periodic Refresh to specify an automatic refresh
interval in seconds.
—OR—

¶ Click Apply Defaults to use the default specified in the
Scheduler Properties window available from the Job
Scheduling view.
in the Plan
Filter Criteria In the group, specify any of the following search parameters or
combinations of two or more parameters. To generalize your
search, use wildcard characters, such as an asterisk (*) to represent
strings of characters, or a question mark (?) to represent a single
character. If you leave all fields blank, all the workstations defined
in the database are displayed when you open the list.
Workstation
Lists all the workstations with this name or namestring.
Reporting Attributes
Lists all the workstations characterized by the reporting
attributes you select with the following check boxes:
¶ Automatic
¶ Completion only
¶ Manual start at completion
¶ Non reporting
Types
Lists all the workstations of the type you select with the
following check boxes:
¶ General
¶ Computer
¶ Printer
Is Fault Tolerant
Lists fault-tolerant workstations. These workstations are
used to run the Workload Scheduler jobs in the Workload
Scheduler for z/OS plan. Select:
Yes To list fault-tolerant workstations
No To list workstations that are not fault-tolerant
Ignore criteria
To list workstations regardless of whether they are
fault-tolerant or not

Displaying Workstations
To display a list of workstations in the plan:
1. Double-click an engine.
2. In the tree that is displayed, right-click Status of all Workstations and select Load List
from the pop-up menu. A list of workstations in the plan is displayed in the right pane of
the Job Scheduling view.
Plan workstation lists are displayed in windows composed of two horizontal panes. In
addition to the workstation list, there is a lower pane that contains details about the jobs
scheduled on the workstations. To see the lower pane, drag the horizontal dividing bar
located at the bottom of the window.
Figure 79. Plan Workstation List Display
For more information, see “Displaying by Status the Job Instances Scheduled on a
Workstation” on page 171.
Browsing and Modifying Workstation Properties

From a workstation list you can view workstation details. You can also:
¶ Modify some of the attributes of the workstation
¶ Specify what action to take on either jobs running or scheduled to run on the
workstation if it becomes unavailable
¶ Change the quantities of workstation resources available for defined time slots and
update time slot definitions
¶ Check the statistics of jobs scheduled on the workstation
¶ Specify the name of a new alternate workstation
The changes you make from a workstation status list update the current workstation plan
information. This information is stored in the current plan data set.
Right-click a workstation in the list and select Properties from the pop-up menu. The
Properties - Workstation in Plan General page is displayed. Several fields are read-only.
164 Version 8.1

General Page

in the Plan
Figure 80. Properties - Workstation in Plan General Page

Table 61. Properties - Workstation in Plan General Information
This field ... Specifies this information ...
Name Workstation name. Read-only.
Description Workstation description. Read-only.
Workstation type Workstation type. For example, computer. Read-only.
Reporting attribute The reporting attribute. Editable. This is one of:
¶ Manual start and completion
¶ Automatic
¶ Completion only
¶ Non reporting
Control on servers Changes the control on servers selection status. If you select
Control on servers, the system will not start more job instances
at the workstation than there are available servers.
Job setup Whether the workstation is used for job setup. Read-only.
Started task, STC Whether the workstation is used for started task support.
Read-only.
WTO Whether the workstation is used for WTO purposes. Read-only.
Reroute jobs Whether the workstation will reroute job instances to an alternate
workstation, before failing or going offline. Read-only.
Alternate workstation Whether an alternate workstation was defined. Read-only.
Status The current status of the workstation. Read-only.
Fault Tolerant Whether the workstation is fault-tolerant. Read-only.
Linked Whether the workstation is linked to the master. Read-only.
Select Resource in the left pane. The Properties - Workstation in Plan Resource page is
displayed

Resources Page
Figure 81. Properties - Workstation in Plan Resource Page
This page displays details about the two workstation resources. For each of the two
resources the window displays the name, the amount in use, and the type of use.
To change the type of use of each resource, select Used for control. This means that, if an
unexpected event happens while job instances are running, the system considers the resource
when it reschedules them.
Job Summary Page
Select Job Summary in the left pane. The Job Summary page is displayed.
Figure 82. Properties - Workstation in Plan Job Summary Page
This page displays the number, estimated duration, and actual duration (where applicable) of
all the job instances scheduled to run on the workstation. The information is provided for
instances in the following status:
166 Version 8.1

¶ Completed
¶ Interrupted
¶ Started
¶ Ready
¶ Waiting
Select Open Time Intervals in the left pane. The Open Time Intervals page is displayed.

Open Time Intervals Page
in the Plan
Figure 83. Properties - Workstation in Plan Open Time Intervals Page
This page shows a list of time slots when the workstation is available to run jobs with
resource quantities different from the default. The list shows the boundaries of each time slot
and, for every slot, the planned quantities of workstation resources and of parallel servers
available, together with the name of the alternate workstation.
You cannot edit the resource quantities and the alternate workstation names in the Planned
fields. They correspond to the workstation Open Time Intervals definitions in the system
database and can only be modified there (from a list of workstations in the database, for
example). You can change the time boundaries and the values in the Modified fields. These
values override the Planned values for the duration of the plan.

You can also add and delete time slots. To alter a value in a time slot, select the row
describing the time slot and double-click the field you want to change.
1. To change the starting day, double-click a date in the Start Date column.
2. Click the pop-up calendar button and select the new day in the calendar. The new day
is automatically entered in the field.
Figure 84. Changing the Start Date
3. To change the initial time, double-click in the Start Time column and enter the new
time.
Figure 85. Changing the Start Time
4. To change the last day, double-click the date field in the End Date column.
5. Click the pop-up calendar button and select the new day in the calendar. The new day
is automatically entered in the field.
6. To change the final time, double-click the time field in the End Time column header.
7. Enter the new time.
8. To adjust the quantity of available parallel servers, double-click the field in the
Modified PS column.
9. Enter a new quantity.
168 Version 8.1

10. To adjust the available quantity of resource R1, double-click the field in the Modified
R1 column.

in the Plan
Figure 86. Changing the Quantity of Resource 1

12. To adjust the available quantity of resource R2, double-click the field in the Modified
R2 column.
14. To change or add the name of the alternate workstation, double-click the field in the
Modified Alternate column.
15. Enter a name for the workstation. To open a Find Workstations window, click the
ellipsis (...).
16. To add a new time interval, click the Add Row button and enter details as explained in
the previous steps.
17. To delete a time interval, select the row and click the Remove Row button.


Linking Fault-Tolerant Workstations
If a workstation is fault-tolerant, you can link the workstation to the master workstation. To
do this, right-click on a workstation in the list and select Link from the pop-up menu.
Changing Workstation Status and Rerouting Scheduled Job

Instances
You can manually change the status of a workstation and reroute scheduled job instances to
an alternate workstation. This overrides, for the duration of the current plan, the
corresponding values defined in the database.
To do this:
1. Right-click a workstation in the list and select Set Status from the pop-up menu. The
Change Status - Workstation window is displayed.
Figure 87. Change Status - Workstation Window
2. Select one of the following:

¶ Active When the workstation is functioning and available.
¶ Offline When communication fails between Workload Scheduler for z/OS and the
workstation.
¶ Failed When system failure makes the workstation unavailable.
Notes:
a. The options in the adjacent group box only become available if you change the status
to Offline or Failed.
b. If the workstation is fault-tolerant, only the Active and Offline options are available.
3. To specify how to handle the job instances scheduled on the workstation, if they have
already started when the status is changed, click the arrow in the drop-down list. The
choices are:
¶ Restart
¶ Leave
¶ Set to error
4. To reroute scheduled job instances to an alternate workstation other than the one defined
in the database, select Reroute jobs.
5. Enter a valid name in the Alternate workstation field.

¶ Click OK to save your changes and close the window.
¶ ClickCancel to close the window without saving any changes.
170 Version 8.1

Displaying by Status the Job Instances Scheduled on a Workstation
Use a workstation status list to browse the status of the job instances scheduled on a
workstation and also to take action on a job instance of which you know the status.
To display the job instances, right-click a workstation from the list and select List Jobs, then
Complete (for example) from the pop-up menu.
All the job instances scheduled to run on the workstation and currently in Complete status

are displayed in the bottom pane of the window.
in the Plan
Figure 88. List of Jobs Scheduled on the Workstation and in Complete Status
Table 62 shows the list of options that you can select from the pop-up menu.
Table 62. Workstation List Jobs Options
Select this option ... To display jobs that ...
Arriving Are scheduled to run on the workstation
Complete Have completed without errors
Deleted Have been canceled on the workstation
Error Have ended in error on the selected workstation
Interrupted Have been interrupted on the workstation
Ready Are ready to run on the workstation
Ready List Are ready to run, including jobs that have a predecessor on a
nonreporting workstation, but are ready to run on the selected
workstation
Ready - Non Reporting Have a predecessor on a non-reporting workstation, but are ready
Workstation to run on the selected workstation
Started Are running on the workstation
Undecided Have an unknown status

Modifying the Job Instances Scheduled on a Workstation
Workstation status lists are useful, because they allow you to perform the same actions on
job instances as the Timeline or List Views of a job instance list.
1. Run a list of jobs scheduled on a workstation.
2. Right-click a selected job and select one of the following options from the pop-up menu:
Table 63. Modifying Job Instance Options
Properties Browse and modify the properties of the job instance
Dependencies Browse and modify the dependencies of the job instance
Delete Delete the job instance from the plan
Hold Hold the job instance
Release Release the job instance
Browse Job Log View the job log file
Impact View Show the predecessors and successors of the job instance
NOP / UN-NOP NOP or UN-NOP the job instance
Execute Run the job instance immediately
Set status Change the status of the job instance
Edit JCL Modify the variables and instructions associated with a job
instance
Browse Operator View operator instructions associated with a job instance
Instruction
Job Setup Tailor job statements
Restart and Cleanup Restart a job instance and perform cleanup operations
For an explanation about how to use these options, see “Managing Jobs” on page 137.
172 Version 8.1

15
Managing Resources in the Plan
This chapter describes how to monitor and update resources allocated to the plan. You can:
¶ Browse and modify the status of a resource
¶ Modify the names of the workstations connected with a resource
¶ Modify the availability of a resource
To perform these tasks, you use a filtered list of resources in the plan.

the Plan

Creating a List of Resources
A plan resource list produces a filtered list of resources allocated to the plan.
To make a plan resource list object, select an engine in the Job Scheduling view and click
the List Resources in Plan button.
The Properties - Plan Resource List window is displayed.
Figure 89. The Properties - Plan Resource List Window
174 Version 8.1

Use the information in Table 64 to enter all the information needed to define the availability
interval.
Table 64. Plan Resource List Information
Name Enter a name to identify the query.
Periodic Refresh Options Select the Periodic Refresh check box and specify a refresh
interval in seconds, if you want the list results refreshed
automatically. Alternatively, click Apply Defaults to use the default
specified in the Scheduler Properties window available in the Job
Scheduling view.
Filter Criteria Specify search parameters or combinations of parameters.
To generalize your search, use wildcard characters, such as an

asterisk (*) to represent strings of characters, or a question mark (?)
to represent a single character. If you leave all fields blank, then all
the resources defined in the Resource Description database are
displayed when you open the list.
Specify a parameter or a combination of parameters:

¶ In Resource specify a resource name.

¶ Specify in Treat input as how you want the input you entered
in the Resource field to be treated. Select one of the following
options:
Wildcard
the Plan
Treat special characters as wildcards and character
substitutes.
Exact match
Treat special characters as part of the resource name.
Prefix
Treat the string as a name prefix.
Suffix
Treat the string as a name suffix.
¶ Specify a resource group name in Group.
¶
¶ Specify whether the resources are data sets with the DLF
attribute or not, or if this is to be ignored, in Hiperbatch.
¶ In Allocation Options, specify whether or not the resources
have been allocated for shared or exclusive use, or whether this
is to be ignored.
¶ In Waiting, specify whether or not there are job instances
waiting to allocate the resources, or whether this is to be
ignored.
¶ In Available, specify whether or not the resources are
available, or whether this is to be ignored.

¶ Click OK to add the new list to the engine tree.
To display the list, right-click it and select Load List.

Displaying Resources
To display a list of resources in the plan, first double-click an engine. In the resulting tree,
right-click a plan resource list object and select Load List from the pop-up menu.
A list of resources allocated to the plan is displayed in the right pane of the Job Scheduling
view. The entries displayed are read-only. To modify details of resources already allocated to
the plan, you must use the Properties - Resource in Plan window as explained in “General
Page” on page 177.
Plan resource lists are displayed in windows composed of two horizontal panes. In addition
to the resource list, there is a lower pane that contains details about the jobs associated with
the resources. To view the lower pane, drag the horizontal dividing bar located at the bottom
of the window, as shown in the next figure.
Figure 90. A Plan Resource List Display
See“Displaying the Job Instances Associated with a Resource” on page 181 for details.
Browsing and Modifying Resources

From a plan resource list you can view details of a resource in the plan. You can also:
¶ Change some of the resource’s attributes
¶ Change a resource’s status
¶ Specify which workstations can use the resource
¶ Specify time intervals during which the resource allocation is different from specified
defaults
The changes you make from a plan resource list update the current resource plan
information, which is stored in the plan.
Right-click a resource from the list and select Properties from the pop-up menu.The page of
the Properties - Resource in Plan Resource page is displayed.
176 Version 8.1

General Page

Figure 91. Properties - Resource in Plan Resource Page
Table 65 describes the contents of this window. Some of the information displayed is
read-only. Other information you can edit.
the Plan
Table 65. Properties - Resource in Plan Resource Information
Name Name of the resource. Read-only.
Description Description of the resource. Read-only.
Default Is Available
Changes the availability status of the resource.
Quantity
Adjusts the default resource quantity that must be available while
the plan is running by entering a new quantity in the Quantity
field.
Group ID Resource group ID. Read-only.
Hiperbatch Whether the resource is enabled to Hiperbatch. It can be Yes or No.
Read-only.
Used for Modifies the type of use of the resource. Choices are
Planning
Control
Planning And Control
Neither Planning Nor Control
On Error What to do with the resource if a job instance that allocates the
resource ends in error (and does not have an overriding keep-on-error
specification in the job definition). Select one of:
Free
Keep
Free if Exclusive
Free if Shared
Assume System Default

Table 65. Properties - Resource in Plan Resource Information (continued)
Deviation Specifies the deviation in the resource quantity that must be available
while the plan is running. To change the deviation, enter a value here.
The deviation is an additional quantity with respect to the default
quantity. A value of 0 means that no change in quantity was made for
the plan.
Note: If you change the deviation, then verify in the Quantity field
the new total quantity available as the sum of the default and
deviation quantities. If you did not specify any changes, the Deviation
field displays 0, meaning that no change in quantity was made for the
plan.
Is available Specifies the type of resource availability. To change it, select one of
Yes, No, or Ignore.
Note: While the updates you make to most of these details are replaced by the database
values at the end of the plan, the updates in Quantity and Deviation are retained also
through plan extensions, unless they are changed manually.
Click Default Workstations in the left pane. The Properties - Resource in Plan Default
178 Version 8.1

Default Workstations Page

Figure 92. Properties - Resource in Plan Default Workstations Page
This page displays the workstations that can use the resource. Table 66 shows how to add or
remove workstations in this list by using the buttons in the upper-right side of the page.
the Plan
Table 66. Properties - Resource in Plan Default Workstations Information
To perform this task ... Do this ...
Remove a workstation Select the workstation and click on the Remove Row button.
Add all available workstations click the Add All Workstations button. A new row is added.
It contains an asterisk, meaning that all available workstations
are connected to the resource
Add specific workstations click the Find Workstations button. A Find dialog is
displayed.
Enter search parameters, or leave the field blank to make a

general search, then click Start. The found workstations are
displayed in a list. Double-click them to copy their name to
the Default Workstations page
Click Availability Intervals in the left pane. The Properties - Resource in Plan Availability
Intervals page is displayed.

Availability Intervals Page
Figure 93. Properties - Resource in Plan Availability Intervals Page
This page shows a list of time intervals when the resource is available with properties
different from the defaults. You can use this list to change the resource availability values in
the defined intervals, or to add or remove availability intervals. Blank fields in an
availability interval mean that the default values, as specified in the database or in the other
pages of this window, are the valid ones during the interval.
Table 67 shows how to add or remove workstations in this list by using the buttons in the
upper-right side of the page.
Table 67. Properties - Resource in Plan Availability Intervals Information
Change the day in which the interval Double-click the Date field and select the pop-up calendar
occurs button. In the pop-up calendar, choose a date and click it to
enter it in the field.
Change the starting time Double-click the From Time field and enter the new time.
Change the finishing time Double-click the To Time field and enter the new time.
Change the resource quantity that is Double-click the Quantity field and enter a number.
made available or unavailable for the
workstations defined in the
availability interval
Change the availability status of the Double-click the Is available field and select one of:
quantity defined in the previous field Available
Not available
Default
Default uses the value specified in the database.
180 Version 8.1

Table 67. Properties - Resource in Plan Availability Intervals Information (continued)
Browse the workstations for which Click the ellipsis in the Workstations field to display a dialog
the availability specified in the with a list of workstations already defined for the time
previous fields is applicable interval.
The dialog also contains the Find Workstations, Add all

Workstations, and Remove Row buttons featured in the
Default Workstations page that enable you to update the list
Add a new availability interval click the Add Row button and enter details as explained in
the preceding steps.
Delete an availability interval Select the row and click the Remove Row button.

Displaying the Job Instances Associated with a Resource

Use a plan resource list to browse the status of the job instances associated with a resource
and also to take action on a job instance of which you know the status.
the Plan
To display the job instances, right-click a resource from the list display and select List Jobs
from the pop-up menu, then select either Waiting for Resource or Using Resource.
All the job instances scheduled to use the resource and currently in this status are displayed
in the bottom pane of the window.
Modifying Job Instances Associated with a Resource

Plan resource lists are useful, because they allow you to perform the same actions on job
instances as the Timeline or List views of a job instance list.
Obtain a list of jobs associated with a resource, then right-click a selected job and select one
of the follwing options:
Table 68. Modifying Job Instance Options
Properties Browse and modify the properties of the job instance.
Dependencies Browse and modify the dependencies of the job instance.
Delete Delete the job instance from the plan.
Hold Hold the job instance.
Release Release the job instance.
NOP / UN-NOP NOP or UN-NOP the job instance.
Execute Run the job instance immediately.
Set status Change the status of the job instance.
For an explanation on how to use these options, see “Managing Jobs” on page 137.

182 Version 8.1
III — Using the Job Scheduling
Console with Tivoli Workload
Scheduler
Chapter 16. Managing Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Creating a Group for Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
Creating Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Creating a List of Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Creating a List of Jobs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Creating a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
Creating a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Creating a List of Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
Creating a List of Prompts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
Creating a List of Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Creating a List of NT Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
Creating a List of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Creating a List of Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
Working with Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Displaying a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Detaching a List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Modifying a Database List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Deleting a List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Finding Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199

Creating a Job Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
UNIX Script, NT Script, or Workstation Class Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
UNIX Command, NT Command, or Workstation Class Command . . . . . . . . . . . . . . . . . . . . . . . . . 207
MPE Job File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
MPE User Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
Extended Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
SAP Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Displaying a List of Job Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Displaying a Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Displaying Job Definition Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Modifying a Job Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Deleting Job Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Using the Job Stream Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Graph View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Timeline View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214
Run Cycle View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Creating a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
Specifying Job Stream Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Time Restrictions Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Adding External Dependencies for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Adding an External Job Stream Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Adding an Internetwork Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Adding an External Job Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Deleting External Dependencies from a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Adding a Job to a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Specifying Job Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Copying and Pasting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Cloning the Job Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Adding an Internetwork Dependency to a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Adding an External Job Stream to a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Adding an External Job to a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Creating Dependencies Between Jobs in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Specifying Run Cycles for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Inclusionary or Exclusionary Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Rule for Freedays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Colored Bars on Dates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Specifying Simple Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Specifying Weekly Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Specifying Calendar Run Cycles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Modifying Run Cycles for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Deleting Run Cycles from a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Specifying Time Restrictions in the Timeline View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Specifying Time Restrictions for a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Using the Timeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Using a Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Specifying Time Restrictions for a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
Using the Timeline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Using a Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Saving a Job Stream in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Closing the Job Stream Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Displaying a List of Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Displaying a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Modifying a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Modifying a Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Deleting a Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Modifying an Internetwork Dependency in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Deleting an Internetwork Dependency in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Modifying an External Job Stream in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Deleting an External Job Stream in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Modifying an External Job in a Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Deleting an External Job in a Job Stream. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Deleting Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250
Chapter 19. Managing Workstations and Workstation Classes . . . . . . . . 251

Managing Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
Creating a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
184 Version 8.1

Displaying a List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255
Displaying a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Modifying a Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Deleting Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256
Creating a Workstation by Copying Another Workstation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Managing Workstation Classes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
Creating a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Workstations Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258
Displaying a List of Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Displaying a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259
Modifying a Workstation Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Deleting Workstation Classes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Chapter 20. Managing Domains, Users, and Calendars . . . . . . . . . . . . . . . . 261

Managing Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Creating a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
Displaying a List of Domains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Displaying a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Modifying a Domain in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Deleting Domains in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Managing Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Creating a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Displaying a List of Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Displaying a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Modifying a User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Deleting Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Changing User Passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Managing Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
The Holidays Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Freedays Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Creating a Calendar in the Database. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 267
Displaying a List of Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Viewing Calendar Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Modifying a Calendar in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Deleting Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Chapter 21. Managing Resources, Prompts, and Parameters . . . . . . . . . . 271

Managing Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Creating a Resource. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Displaying a List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Displaying a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272
Modifying a Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Deleting Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Creating a Resource by Copying Another Resource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Managing Prompts in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Creating a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Displaying a List of Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Displaying a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Modifying a Prompt in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Deleting Prompts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Managing Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Creating a Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Displaying a List of Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Displaying a Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
Modifying a Parameter in the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Deleting Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
Chapter 22. Plan Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Using Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Group for Plan Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Plan List of Workstations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
Creating a Plan List of Domain Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
Creating a Plan List of Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Dependencies Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Creating a Plan List of Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Dependencies Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
Creating a Plan List of Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Creating a Plan List of Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Creating a Plan List of Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Modifying the Properties of a Plan List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Deleting a Plan List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Detaching a Plan List Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
Finding Objects in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 293
Managing Job Instances in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Displaying a List of Jobs in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
List View of Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294
Timeline View of Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Modifying the Properties of a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Displaying Dependencies of a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Internetwork Predecessors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Successors Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Adding Predecessors to a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308
Deleting Predecessors from a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Displaying Successors of a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Holding a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Holding a Single Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Holding All Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Releasing a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Releasing a Single Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
Releasing All Job Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310
186 Version 8.1

Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Displaying Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Set as Root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Browsing the Job Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Rerunning a Job Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Canceling a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Killing a Job Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314
Confirming a Job Instance SUCC or ABEND . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Releasing a Job Instance from Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Managing Job Stream Instances in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Displaying a List of Job Streams in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Timeline View of Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
List View of Job Stream Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Displaying and Changing the Properties of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Displaying Dependencies of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
Adding Predecessors to a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Deleting Predecessors from a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Displaying Successors of a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Holding a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Releasing a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Showing Predecessors and Successors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Canceling a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Changing the Job Limit of a Job Stream Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Changing the Priority of a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Releasing a Job Stream Instance from Dependencies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
Re-submitting a Job Stream Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333
Submitting Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Monitoring Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
Submitting Jobs and Job Streams into the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Submitting a Job Stream into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
Submitting a Job into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Using a Default Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336
Using a Specific Job Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
Viewing or Modifying the Properties of the Job to Submit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343
Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347
Submitting an Ad Hoc Job into the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349
General Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
Task Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352
Files Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Prompts Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357

Resources Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Managing Workstations in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Displaying a List of Workstations in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Displaying a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Changing the Job Limit of a Workstation in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Changing the Job Fence of a Workstation in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Starting a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364
Stopping a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Linking a Workstation Instance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Unlinking a Workstation Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Managing Domains in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Displaying a List of Domains in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Starting the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Stopping the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Linking the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Unlinking the Workstations in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
Switching the Domain Manager in a Domain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Managing File Dependencies in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Displaying File Dependencies Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
Managing Prompt Dependencies in the Plan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Displaying Prompt Dependencies Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
Replying to a Prompt Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Managing Resource Dependencies in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Displaying Resource Dependencies Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
Displaying the Properties of a Resource Dependency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Changing the Number of Units of a Resource Dependency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
Setting an Alternate Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
188 Version 8.1

16. Managing Database
16
Lists
Managing Database Lists
Database lists are used to display objects in the scheduler database. When you create a list,
you give it a name and specify filtering criteria. When you run a list, it displays a filtered
table of objects in the database. Each list you create is represented by an button in the tree
view of the Job Scheduling Console.
You can create lists in the Workload Scheduler branch or you can create groups below the
branch to organize your lists. Tivoli supplies a basic set of lists in a group called Default
Database Lists.
Creating a Group for Database Lists

To create a group for database lists:
2. Click the Create a Group of Lists button on the toolbar or right-click the scheduler
engine button and select Create Group from the pop-up menu.
Lists on the toolbar or right-click the existing group button and select Create Group
3. Enter a name for the group. You can use the same name for more than one group, if you
want. Different groups maintain their individual properties even if they have the same
name.

¶ Click OK to close the window and save the new group. An button is created for the new
group in the tree view of the Job Scheduling Console.
¶ Click Cancel to close the window without saving the new group.
After creating a group, you can create its member lists and subgroups. Right-click the group
to display a pop-up menu with the following options:

Properties Change the group name.
Delete Delete the group and all its contents.
Create Database List Create a new list of job stream, resource, workstation, and
other definitions in the database.
Create Plan List Create a new list of job streams, jobs, resources, workstations,
and other objects in the plan.
Create Group Create a subgroup of more lists.
Creating Lists
To create a database list, right-click an engine and select one of the following options:
Figure 95. Create Database List Pop-up

To create this type of list ... Go to page ...
Job Stream 190
Job 191
Workstation 192
Resource 193
Workstation Class 193
Prompt 194
Parameter 195
NT User 195
Domain 196
Calendar 197
Creating a List of Job Streams

To create a list of job streams:
To create the list in the scheduler branch, expand the branch and select a group button.
2. Click the List Job Streams button on the toolbar. Alternatively, right-click the engine or
group button and select Create Database List then Job Stream from the pop-up menu.
190 Version 8.1

The Properties - Job Stream List window is displayed.
Lists
Figure 96. Properties - Job Stream List Window
3. Enter a name for the list in the Name field.

4. If you want the list results refreshed automatically, select Periodic Refresh and enter a
refresh interval in seconds in the Period (secs) field.
5. Click Apply defaults to enter the default refresh settings from the scheduler properties.
6. To filter the list results, enter a job stream name in the Job Stream Name field and a
workstation name in the Workstation Name field. You can also use wildcards or leave
the field blank to obtain an unfiltered list.

¶ Click OK to save the list and close the window. A new button is created for the list in
the tree view of the Job Scheduling Console.
¶ Click Cancel to close the window without running or saving the list.
Creating a List of Jobs
To create a list of job streams:
2. Click the List Job Definitions button on the toolbar. Alternatively, right-click the engine
or group button and select Create Database List then Job from the pop-up menu.
The Properties - Job List window is displayed.
Figure 97. Properties - Job List Window

5. Click Apply defaults to enter the default refresh settings from the scheduler properties.
6. To filter the list results, enter a job name in the Job Name field and a workstation name
in the Workstation Name field. You can also use wildcards or leave the field blank to
obtain an unfiltered list.

Creating a List of Workstations
To create a list of workstations:
2. Click the List Workstations in Database button on the toolbar. Alternatively, right-click
the scheduler engine button or group button and select Create Database List then
Workstations from the pop-up menu.
The Properties - Database Workstation List window is displayed.
Figure 98. Properties - Database Workstation List window.

4. To have the list results refreshed automatically, select Periodic Refresh and enter a
5. Click Apply defaults to enter the default periodic refresh settings.
6. To filter the list results, enter a workstation name in the Workstation Name field. You
can also use wildcards or leave the field blank to obtain an unfiltered list.

192 Version 8.1

Creating a List of Resources
Lists
To create a list of resources:
2. Click the List Resources in Database button on the toolbar. Alternatively, right-click the
scheduler engine button or group button and select Create Database List then Resource
The Properties - Database Resource List window is displayed.
Figure 99. Properties - Database Resource List window.

6. To filter the list results, enter a resource name in the Resource Name field and a
workstation name in the Workstation Name field. You can also use wildcards or leave
the field blank to obtain an unfiltered list.

Creating a List of Workstation Classes
To create a list of workstation classes:
2. Right-click the scheduler engine button or group button and select Create Database List
then Workstation Class from the pop-up menu.
The Properties - Workstation Class List window is displayed.

Figure 100. Properties - Workstation Class List Window

6. To filter the list results, enter a workstation class name in the Workstation Class Name
field. You can also use wildcards or leave the field blank to obtain an unfiltered list.

Creating a List of Prompts
To create a list of prompts:
then Prompt from the pop-up menu.
The Properties - Prompt List window is displayed.
Figure 101. Properties - Prompt List Window

194 Version 8.1

6. To filter the list results, enter a prompt name in the Prompt Name field. You can also
use wildcards or leave the field blank to obtain an unfiltered list.
Lists
¶ Click Cancel buttonto close the window without running or saving the list.
Creating a List of Parameters
To create a list of parameters:
then Parameter from the pop-up menu.
The Properties - Parameter List window is displayed.
Figure 102. Properties - Parameter List Window

6. To filter the list results, enter a parameter name in the Parameter Name field. You can
also use wildcards or leave the field blank to obtain an unfiltered list.

Creating a List of NT Users
To create a list of users:

then NT User from the pop-up menu.
The Properties - NT User List window is displayed.
Figure 103. Properties - NT User List Window

6. To filter the list results, enter a domain or user name in the NT Domain\User Name
field. You can also use wildcards or leave the field blank to obtain an unfiltered list.

Creating a List of Domains
To create a list of domains:
then Domain from the pop-up menu.
The Properties - Domain List window is displayed.
196 Version 8.1

Lists
Figure 104. Properties - Domain List Window

6. To filter the list results, enter a domain name in the Domain Name field. You can also

Creating a List of Calendars
To create a list of calendars:
then Calendar from the pop-up menu.
The Properties - Calendar List window is displayed.
Figure 105. Properties - Calendar List Window


6. To filter the list results, enter a calendar name in the Calendar Name field. You can also

Working with Lists

Displaying a List
To display a list:
2. Right-click the list you want to run and select Load List from the pop-up menu. The list
tool searches the database or plan and displays the objects it finds in the right-hand pane
of the Job Scheduling view.
Figure 106. Displaying a List
Note: Alternatively, you can select an engine in the tree and double-click the list you
want to run in the right-hand pane of the Job Scheduling view.
You can display several lists in sequence. The newest list is displayed above the preceding
ones. However, as long as a list is kept open, it is maintained and refreshed according to the
refresh options specified. To view the list, click the corresponding object in the Job
Scheduling view.
Detaching a List Display
Detaching a list frees the right-pane of the Job Scheduling Console to display other objects.
You can detach multiple lists to view several objects simultaneously.
To detach a database list display:

1. Open a list and wait for the results to be displayed.
198 Version 8.1

2. Right-click the list in the tree view and select Detach View from the pop-up menu. The
list window is displayed separately from the Job Scheduling view.
Lists
3. To place the list back in the right-hand pane, either close the detached window or
right-click the list in the tree view and select Attach View from the pop-up menu.
Notes:
1. The right-hand pane of the console is not disabled. This is so that you can run other lists
or perform other tasks.
2. You can have a maximum number of seven detached views open at the same time.
3. To prevent your system from overloading, do not have frequent refreshes of many
detached views open at the same time.
Modifying a Database List
To modify the properties of a list:
3. The properties window of the list is displayed.
4. Make your changes.

¶ Click Cancel to close the window without running or saving the changes.
Deleting a List
To delete a list:
1. Select a list button.
2. Click the Delete button in the toolbar or right-click on the list button and select Delete
A confirmation message is displayed.
3. Click Yes to delete the list or click Cancel to cancel the delete operation.
Finding Objects
Search tools are provided in the Job Scheduling Console to help you find objects in the
database. The availability of a search tool is indicated by an ellipsis located next to the field
where you enter an object name. In the following example of the Properties - Resource in
Database window, the Workstation field provides a search tool.

Figure 107. Properties - Resource in Database Window
When you click the ellipsis, the Find Workstation window is displayed.
Figure 108. Find Workstation Window
To use the Find window:

1. Type search arguments in the available fields. You can also use wildcards or leave the
field blank to obtain an unfiltered list.
2. click Start. The results of the search are listed in the lower part of the Find window.
3. Select an object in the list and do one of the following:
¶ Click Apply to insert the name of the object in the text box on the parent window.
The Find window remains open to permit you to select other objects from the list.
¶ Double-click the object in the list or click OK to insert the name of the object in the
text box on the parent window and close the Find window.
¶ Click Cancel to close the Find window without inserting an object name.
200 Version 8.1

17
Managing Jobs
17. Managing Jobs

A job is a unit of work that is part of a job stream processed at a workstation. It usually
includes all necessary computer programs, links, files, and instructions to the operating
system.
Creating a Job Definition

You create jobs in the database using the Properties - Job Definition window. To create a
new job:
2. Click the New Job Definition button on the toolbar or right-click the engine button and
select New Job Definition from the pop-up menu. This opens the Select a Task Type
window.
Figure 109. Select a Task Type Window
3. In the Select a task type window, select a task type from the drop-down list. Once a task
type is defined for a job it cannot be changed. Table 71 describes the task types:
Table 71. New Job Definition Task Types
This task type ... Specifies that ...
UNIX Script The job is an executable file on a UNIX computer.
UNIX Command The job is a UNIX command.
NT Script The job is an executable file on a Windows NT computer.
NT Command The job is a Windows NT command.
Workstation Class Script The job is an executable file that runs on a workstation class.
Workstation Class Command The job is a command that runs on a workstation class.
Extended Agent The job is associated with an Extended Agent workstation.
MPE Job File The job is an executable file on an MPE computer.

Table 71. New Job Definition Task Types (continued)
This task type ... Specifies that ...
MPE User Job The job is streamed by an MPE user and is managed by the
Workload Scheduler.
SAP The job is an SAP job that runs on a Workload Scheduler
Extended Agent for SAP. The SAP task type is only displayed if
the Extended Agent for SAP has been installed.
4. Click OK to proceed. The Properties - Job Definition General page is displayed.

Alternatively, click Cancel to cancel the operation.
General Page
Figure 110. Properties - Job Definition General Page
Use the information in Table 72 to complete the text boxes and select options.
Table 72. Properties - Job Definition General Information
Name The name of the job. The name must start with a letter, and can
contain alphanumeric characters, dashes, and underscores. For
non-expanded databases, it can contain up to eight characters. For
expanded databases, it can contain up to 40 characters.
Workstation The name of the workstation or workstation class on which the job
runs. You can type a name directly or you can click Find and select a
workstation or workstation class from a list. If you specify a
workstation class, it must match the workstation class of any job
stream in which the job will be included. For information about using
the Find button, refer to “Finding Objects” on page 199.
Description A description of the job. The description can contain up to 64
characters.
202 Version 8.1

Table 72. Properties - Job Definition General Information (continued)
Is Interactive Select this to indicate that the job runs interactively on the Windows
NT desktop. For Windows NT jobs only.
Login The user name under which the job runs. The name can contain up to
47 characters. If the name contains special characters it must be
enclosed in quotes (“”). Specify a user that can log on to the
workstation on which the job runs. For Windows NT jobs, the user
must also be defined in the database. For more information, see
“Managing Users” on page 263.
17. Managing Jobs

To include a parameter in the name:
¶ Place the cursor in the Login where you want to insert the
parameter and click the Add Parameter button. The Find
Parameters window is displayed.
¶ Enter a parameter name in the Find text box. The name can
contain wildcard characters.
¶ Click Start to display a list of parameter names.
¶ Select a parameter name in the list and do one of the following:
v Click Apply to insert the parameter name in the Login text box
of the Properties - Job Definition window and keep the Find
Parameters window open.
v Click OK or double-click the parameter in the list to insert the
parameter name in the Login text box of the Properties - Job
Definition window and close the Find Parameters window.
v Click Cancel to close the Find Parameters window without
inserting a parameter name.
A parameter can be used for all or part of the text box and multiple
parameters are permitted.

Table 72. Properties - Job Definition General Information (continued)
Recovery Options The recovery options for the job:
Action
Specifies the action to be taken if the job ends abnormally
(abends). Select one of the following. The default is Stop.
Stop If the job abends, do not continue with the next job.
Continue
If the job abends, continue with the next job.
Rerun If the job abends, rerun the job.
Prompt
Specify the text of a recovery prompt, enclosed in quotes, to be
displayed if the job abends. The text can contain up to 64
characters. The recovery prompt is a local prompt and is
responded to using the Job Scheduling Console.
Job
Specify the name of a recovery job to run if the parent job
abends. Click the Find button and select a job from a list.
Recovery jobs are run only once for each abended instance of the
parent job. For information about using the Find button, refer to
“Finding Objects” on page 199.
Workstation
Specify the name of the workstation on which the recovery job
runs. The name is entered automatically when you select a
recovery job.
Not all jobs are eligible to have recovery jobs run on a different
workstation. Follow these guidelines:
¶ If either workstation is an extended agent, it must be hosted
by a domain manager or a fault-tolerant agent that runs in
Full Status mode.
¶ The recovery job’s workstation must be in the same domain as
the parent job’s workstation.
¶ If the recovery job’s workstation is a fault-tolerant agent, it
must run in Full Status mode.
Table 73 on page 204 summarizes all possible combinations of recovery options and actions.
The table is based on the following criteria from a job stream called sked1:
¶ Job stream sked1 has two jobs, job1 and job2.
¶ If selected for job1, the recovery job is jobr.
¶ job2 is dependent on job1 and will not start until job1 is complete.
Table 73. Job Stream Recovery Options
Prompt / Job Stop Continue Rerun
Recovery prompt: No Intervention is Run job2. Rerun job1. If job1 abends,
Recovery job: No required. issue scheduler prompt. If
reply is yes, repeat above.
If job1 is successful, run
job2.
204 Version 8.1

Table 73. Job Stream Recovery Options (continued)
Prompt / Job Stop Continue Rerun
Recovery prompt: Yes Issue recovery Issue recovery Issue recovery prompt. If
Recovery job: No prompt. Intervention prompt. If reply is reply is yes, rerun job1. If
is required. yes, run job2. job1 abends, repeat above.
job2.
Recovery prompt: No Run jobr. If it Run jobr. Run job2. Run jobr. If jobr abends,
Recovery job: Yes abends, intervention intervention is required. If
is required. If it is jobr is successful, rerun
17. Managing Jobs

successful, run job2. job1. If job1 abends, issue
scheduler prompt. If reply
is yes, repeat above. If
job1 is successful, run
job2.
Recovery prompt: Yes Issue recovery Issue recovery Issue recovery prompt. If
Recovery job: Yes prompt. If reply is prompt. If reply is reply is yes, run jobr. If
yes, run jobr. If it yes, run jobr. Run jobr abends, intervention is
abends, intervention job2. required. If jobr is
is required. If it is successful, rerun job1. If
successful, run job2. job1 abends, repeat above.
job2.
Notes:
1. ″Intervention is required″ means that job2 is not released from its dependency on job1,
and therefore must be released by the operator.
2. The continue recovery option overrides the abend state, which may cause the schedule
containing the abended job to be marked as successful. This will prevent the schedule
from being carried forward to the next day.
3. If you select the Rerun option without supplying a recovery prompt, Workload Scheduler
generates its own prompt.
4. To reference a recovery job in Conman, you must use the name of the original job (job1
in the scenario above, not jobr). Recovery jobs are run only one per abend.
Select Task in the left pane of the Properties - Job Definition window. This displays the
Task page.

Task Page
Figure 111. Properties - Job Definition: Task Window.
The Task page is different for each task type. To complete the fields and select options on
this page:
Table 74. Task Types
For this task type ... Go to page ...
UNIX Script, NT Script, or Workstation Class Script 206
UNIX Command, NT Command, or Workstation Class Command 207
MPE Job File 207
MPE User Job 207
Extended Agent 207
SAP Job 208
UNIX Script, NT Script, or Workstation Class Script

Complete the Script field as follows:
Specify the name of the file the job runs. Enter the file name and any options and
arguments. For non-expanded databases, the field can contain up to 255 characters. For
For Windows NT jobs, include the file extensions. Universal Naming Convention (UNC)
names are permitted. Do not specify files on mapped drives.
If the file name contains spaces, enter the name in another file that does not have spaces in
its name and use the second file’s name in this field.
To include a parameter in the Script field, do the following:
206 Version 8.1

¶ Place the cursor in the Script field where you want to insert the parameter and click the
Add Parameter button.
¶ This displays the Find Parameters window.
¶ Enter a parameter name in the Find field. The name can contain wildcard characters.
v Click Apply to insert the parameter name in the Script field of the Properties - Job
Definition window and keep the Find Parameters window open.
v Click OK or double-click the parameter in the list to insert the parameter name in
the Script field of the Properties - Job Definition window and close the Find
Parameters window.
17. Managing Jobs

v Click Cancel to close the Find Parameters window without inserting a parameter
name.
A parameter can be used for all or part of the field and multiple parameters are permitted.
UNIX Command, NT Command, or Workstation Class Command

In the Command field, specify the name of the command the job runs. Enter the command
name and any options and arguments. For non-expanded databases, the field can contain up
to 255 characters. For expanded databases, it can contain up to 4095 characters.
Commands are run directly and the jobmanrc standard configuration script is not run.
To include a parameter in the Command field, do the following:

¶ Place the cursor in the Command field where you want to insert the parameter and
click Add Parameter .
¶ Enter a parameter name in the Find field. The name can contain wildcard characters.
v Click OK or double-click the parameter in the list to insert the parameter name in
the Command field of the Properties - Job Definition window and close the Find
Parameters window.
v Click Apply to insert the parameter name in the Command field of the Properties -
Job Definition window and keep the Find Parameters window open.
v Click Cancel to close the Find Parameters window without inserting a parameter
name.
MPE Job File

Complete the Job File field by specifying the name of the MPE file the job runs. For
example, JFILE4.JCL.CORP.
MPE User Job

Complete the User Job field by specifying the name from the JOB card of the MPE job. If
the scheduler job name does not match the MPE job card name or you want to use skeleton
jobs, click the override userjob checkbox and enter the name or wildcard. For example,
$USERJOB=UJOB1 or $USERJOB=UJ@.
Extended Agent
Refer to the specific user guide for the Extended Agent you are working with for more
information.

SAP Job
Refer to the Tivoli Workload Scheduler SAP/R3 Extended Agent User Guide for information
about defining the task.

¶ Click OK to close the Properties - Job Definition window and save the new job in the
database.
¶ Click Cancel to close the Properties - Job Definition window without saving the job in
the database.
Displaying a List of Job Definitions

To display a list of jobs in the database:
1. In the tree view of the Job Scheduling Console, expand the scheduler engine button.
2. Expand the branches until you see the button for the job list you want to run. See
“Creating a List of Jobs” on page 191 for information about creating job lists.
3. Select the job list button.
4. Click the Load List button on the toolbar or right-click on the job list button and select
Load List from the pop-up menu.
The list results are displayed in the right pane of the Job Scheduling Console.
Figure 112. Job Definition List Window
Table 75 describes the columns in the window.

Table 75. Job Definition List Window
Name The name of the job.
Workstation The name of the workstation on which the job runs.
208 Version 8.1

Table 75. Job Definition List Window (continued)
Task Type The task type of the job:
UNIX Script
Specifies that the job is an executable file on a UNIX
computer.
UNIX Command
Specifies that the job is a UNIX command.
NT Script
Specifies that the job is an executable file on a Windows NT
17. Managing Jobs

computer.
NT Command
Specifies that the job is a Windows NT command.
Workstation Class Script
Specifies that the job is an executable file on a specific class
of workstations.
Workstation Class Command
Specifies that the job is a command on a specific class of
workstations.
Extended Agent
Specifies that the job is an Extended Agent job. Refer to the
specific user guide for the Extended Agent you are using for
more information.
MPE Job File
Specifies that the job is an executable file on an MPE
computer.
MPE User Job
Specifies that the job is streamed by an MPE user and is
managed by Workload Scheduler.
SAP Job
Specifies that the job is an SAP job. You must install the
Workload Scheduler Extended Agent for SAP software to use
SAP jobs.
Creator The name of the user who created the job in the database.
Last Runtime The duration in minutes of the last run of the job.
Displaying a Job Definition

To display a job in the database:
1. Run a list of jobs that contains the job you want to display. See “Displaying a List of
Job Definitions” on page 208 for more information.
2. In the list results, double-click the job you want to display or right-click on the job and
select Properties from the pop-up menu.
This displays the job in the Properties - Job Definition window. For information about
the Properties - Job Definition window, see “Creating a Job Definition” on page 201.
3. Click OK or on Cancel to close the Properties - Job Definition window.
Displaying Job Definition Details

To display job details in the database:

1. Run a list of jobs that contains the job you want to display. See “Displaying a List of
2. In the list results, right-click the job you want to display and select Job Details from the
pop-up menu.
This displays the Details for Job window.
Figure 113. Details for Job Window
Table 76 describes the contents of this window.

Table 76. Details for Job Window
Job Information Job’s logon information:
Logon Displays the user logon for the job.
Description Displays the description of the job.
Script File Displays the name of the job’s script file.
Recovery Information Job’s recovery information:
Option Displays the job’s recovery option. It can be
Stop, Continue, or Rerun.
Job Displays the name of the job’s recovery job.
Prompt Displays the job’s recovery prompt.
Job Run Summary Information about the job from the most recent production plan:
Total Runs Displays the total number of times the job has
run.
Aborted Runs Displays the total number of abended runs of the
job.
Successful Runs
Displays the total number of successful runs of
the job.
Total CpuTime Displays the total CPU time of the job.
Total Elapsed Time
Displays the total elapsed time of the job.
Normal Elapsed Time
Displays the elapsed time for previous runs of the
job.
210 Version 8.1

Table 76. Details for Job Window (continued)
Run Time History Job’s run time history for the last run, the minimum run, and the
maximum run:
Run Date Displays the date and time of the run.
CpuTime The the CPU time of the run.
Elapsed Time Displays the elapsed time of the run.
3. Click OK to close the window.
17. Managing Jobs

Modifying a Job Definition
To modify a job:
1. Run a list of jobs that contains the job you want to modify. See “Displaying a List of
2. In the list results, double-click the job you want to modify or right-click on the job and
choose Properties from the pop-up menu. The Properties - Job Definition window is
displayed.
Figure 114. Properties - Job Definition Window
3. Make your changes. For information about the window, see “Creating a Job Definition”
on page 201.

¶ Click OK to save the job in the database and close the window.
¶ Click Cancel to close the window without saving the job in the database.
Deleting Job Definitions

To delete jobs in the database:

1. Run a list of jobs that contains the job you want to delete. See “Displaying a List of Job
Definitions” on page 208 for more information.
2. In the list results:
¶ To delete one job, right-click the job.
¶ To delete multiple jobs in a range, hold down the Shift key, click the first and last
jobs in the range, then right-click one of the selected jobs.
¶ To delete multiple jobs that are not in a range, hold down the Ctrl key, click each
job, then right-click one of the selected jobs.
3. Select Delete from the pop-up menu. A confirmation message is displayed for each job.
4. Click OK to delete the job in the database or click Cancel to cancel the delete operation.
212 Version 8.1

18
Managing Job Streams
Job streams are created and modified using the Job Stream Editor and the Properties - Job
Stream window. The Job Stream Editor is used to work with the jobs and follows
dependencies between the jobs, as well as the run cycles of the job stream. The Properties -
Job Stream window is used to specify time restrictions, resource dependencies, file
dependencies, and prompt dependencies at the job stream level.
Using the Job Stream Editor

Use the Job Stream Editor to create and modify job streams in the database. Job stream

management functions are divided between three views:
¶ Graph
¶ Timeline
¶ Run Cycle
Each view contains a set of menu and toolbar functions.
Graph View
The Graph view provides a graphical display of the jobs in a job stream. Jobs and external
job dependencies are represented by buttons. Dependencies between jobs are represented as
arrows pointing to the successor jobs. Use this view to add and delete jobs and specify
dependencies between jobs.
Figure 115. Job Stream Editor Graph View

Table 77 describes the toolbar in the Graph view of the Job Stream Editor.
Table 77. Job Stream Editor Graph View Toolbar
This button ... Has this name ... And does this ...
Properties Displays the Job Stream Properties window.
Save Saves the job stream in the database.
Delete Deletes the selected job.
Undo Delete Undoes the previous Delete operation.
Copy Copies the selected job to the clipboard.
Paste Adds the job on the clipboard to the job stream.
Select Changes the mouse pointer to a selection arrow.
Add Job Definition Adds a job to the job stream. An button is added to
represent the job.
Add Dependency on Adds an button to represent an external job

External Job dependency.
Add Dependency on Adds an button to represent an external job stream

External Job Stream dependency.
Add Dependency on Adds an button to represent an internetwork

Internetwork dependency.
Add Link Adds a dependency between jobs in the job stream.
Graph Displays the Graph view.
Timeline Displays the Timeline view.
Run Cycle Displays the Run Cycle view.
Timeline View
The Timeline view provides a tabular and timeline display of the time restriction properties
of the job stream and its jobs. Use this view to display and adjust time restriction properties.
The window is divided into four panes. The job stream is displayed in the upper pane and
its jobs are displayed in the lower pane. Use the borders and the arrows on the borders to
adjust the sizes of the panes. Use the arrows at the top of the timeline pane to move the
view in one hour and one day increments.
214 Version 8.1

Time intervals are shown in the right pane. A dark blue bar represents the time restrictions
for a job or job stream. A light blue bar represents the expected duration, based on past run
times. A black segment at the end of a timeline represents the deadline time. Where the
duration of the job exceeds the deadline time, the blue bar becomes red. The left pane lists
the start, deadline, and duration times for each timeline shown in the right pane.
Dragging a line, or the end of a line, adjusts the start and deadline times of the job stream
or a job. Double-clicking the job or job stream name opens time properties windows. You
can edit the time properties of the job or job stream from these windows.

Figure 116. Job Stream Editor Timeline View
Table 78 describes the toolbar in the Timeline view of the Job Stream Editor.
Table 78. Job Stream Editor Timeline View Toolbar
Move Job Up Move the job up one step in the job stream.
Move Job down Move the job down one step in the job stream.
Go to Day Moves the timeline display to a day offset from

the schedule date of the plan (Day 0).
Go to First Moves the timeline display to the start time and

day offset of the job stream or its earliest job,
whichever is the first to occur.

Table 78. Job Stream Editor Timeline View Toolbar (continued)
Run Cycle View

The Run Cycle view shows the run cycles of the job stream in a calendar format. Use this
view to add and modify the run cycles of the job stream.
The window is divided into two panes. The left pane lists the types of run cycles defined for
the job stream and the associated freeday rule. The right pane displays a calendar showing
included or excluded days as defined in the selected run cycle. Use the border and the
arrows on the border to adjust the pane size.
Use the tabs above the calendar to select the Monthly or Yearly view and use the arrows
above and below the calendar to change the month or year of the calendar.
Figure 117. Job Stream Editor Run Cycle View
Table 79 describes the toolbar in the Run Cycle view of the Job Stream Editor.
Table 79. Job Stream Editor Run Cycles View Toolbar
Select a Run Cycle Changes the mouse pointer to a selection arrow.
Delete Deletes the selected run cycle.
Simple Run-Cycle Adds a run cycle of days marked on a monthly or
yearly basis.
Weekly Run-Cycle Adds a run cycle of days selected on a weekly
basis.
Calendar Run-Cycle Adds a run cycle of days based on a previously
defined calendar.
216 Version 8.1

Table 79. Job Stream Editor Run Cycles View Toolbar (continued)
Creating a Job Stream

You create job streams in the database using the Job Stream Editor. To create a new job
stream, follow these steps:
1. In the tree view of the Job Scheduling Console, click the scheduler engine button.
2. Click New Job Stream on the toolbar or right-click on the scheduler engine button and
select New Job Stream from the pop-up menu.
This displays the Job Stream Editor and the Job Stream Properties window.
Specifying Job Stream Properties
Job stream properties are specified in the Job Stream Properties window of the Job Stream
Editor. There are five groups of job stream properties:

Table 80. Job Stream Properties Groups
This group ... Is described on page ...
General 218
Time Restrictions 220
Resources 222
Files 223
Prompts 224
The Job Stream Properties window opens automatically when you create a new job stream.
If the window is not displayed, select Properties from the File menu of the Job Stream
Editor.
To specify job stream properties, click Generalin the left pane of the Job Stream Properties
window. The General page is displayed.

General Page
Figure 118. Properties - Job Stream Properties General Page
Table 81. Job Stream Properties General Information
Name The name of the job stream. The name must start with a letter, and
can contain alphanumeric characters and dashes. For non-expanded
databases, it can contain up to eight characters. For expanded
databases, it can contain up to 16 characters. The name of a job
stream cannot be changed once is has been saved. However, you can
use the create another command to save the job stream with another
name.
Workstation The name of the workstation or workstation class on which the job
stream is launched. You can type a name directly or you can click
the Find button and select a workstation or workstation class from a
list. If you specify a workstation class, it must match the workstation
class of any jobs or resources used in the job stream. For information
about using the Find button, refer to “Finding Objects” on page 199.
Description A description of the job stream.
218 Version 8.1

Table 81. Job Stream Properties General Information (continued)
Priority The priority of the job stream. Select a priority value from the
drop-down list or click of the following buttons:
Hold
Sets the priority to 0.
High
Sets the priority to 100.
Go Sets the priority to 101.
Possible priority values are 0 through 101, where 101 is the highest
priority. A priority value of zero prevents the job stream from
launching. In the case of High and Go, all jobs in the job stream are
given the priority. High and Go jobs are launched as soon as their
dependencies are satisfied, overriding the workstation job limit, but
not overriding the job stream job limit or the workstation job fence.
Limit The number of jobs that can be running at the same time in the
schedule. Select a job limit value from the drop-down list. Possible
values are 0 through 1024. If you specify a job limit of 0, no jobs
are launched in the job stream.
Options Check any of the following options that apply:

On Request
Check this to specify that the job stream is selected for running
by request. If you select On Request and specify run cycles for
the job stream, the On request flag is ignored and the job stream
will run according to the run cycle. Normally, these job stream
must be submitted into the plan by the user or specifically
requested when schedulr is run. For more information, refer to
the Reference Guide.
Carry Forward
Check this to specify that the job stream is eligible to be carried
forward to the next day production plan if it is not completed
before the end of the current day production day. Job streams
that are carried forward retain the carryforward option, and
therefore, can be carried forward again. You can control the
number of days a job stream is carried forward by specifying a
deadline time (UNTIL keyword) plus x number of days.
Is Monitored Job Stream
Check this to specify that the entire job stream, and every job
that it contains, must be monitored by Tivoli Business Systems
Manager (TBSM) when it runs.
Contains Monitored Job
This read-only item indicates whether any of the jobs in this job
stream will be monitored by Tivoli Business Systems Manager
(TBSM) when they run. Value is Yes if at least one of the jobs
in the job stream have the Is Monitored Job check box selected
in their Properties window.

Table 81. Job Stream Properties General Information (continued)
Free Days Calendar Specify the name of the calendar that lists the non-workdays for your
company, such as holidays and closing days, when you may not want
the job stream to run. The calendar of freedays is used during the
definition of the run cycles for the job stream. It is associated with
the Free day rule, where you tell Workload Scheduler how to handle
a job stream if the schedule falls on a freeday. See “Managing
Calendars” on page 266 for details on creating freeday calendars. Do
one of the following:
¶ Click Use Default to instruct the scheduler to use the default
freedays calendar (usually named Holidays) that is displayed in
the Calendar Name field. When you select this button, all the
remaining items in this group become unavailable.
¶ Click Specify Calendar to instruct the scheduler to use a
different freedays calendar than the default and enter a calendar
in the Calendar Name field. Click the ellipsis to open the Find
Calendars window if you need to search amongst existing
calendars. Select the Saturday and/or Sunday check boxes if
you want these days to be counted as freedays in the calendar
you just specified.
When you have finished, click Time Restrictions in the left pane of the Job Stream
Properties window. The Time Restrictions page is displayed.
Figure 119. Properties - Job Stream Time Restrictions Page.
220 Version 8.1

Table 82. Job Stream Time Restrictions Information
Start The earliest time the job stream will be launched. The job stream will not
be launched before this time. Make your selections as follows:
Specify time
Specify this option to enable the entry of a start time.
At Specify a start time in the following format:
hh:mm am|pm
For example, 11:30 am or 4:25 pm.
Delay for
Specify the number of days to offset the start time from the day the
job stream is selected for inclusion in the production plan.
Deadline The latest time the job stream will be launched. The job stream will not
be launched after this time. Make your selections as follows:
Specify time
Specify this option to enable the entry of a deadline time.
At Specify a deadline time in the following format:

hh:mm am|pm
Note: The Deadline time must be later than the Start Time.
Delay for
Specify the number of days to offset the deadline time from the day
the job stream is selected for inclusion in the production plan.
Time Zone The time zone in which the job stream runs. All time values specified are
in this time zone. Select a time zone from the drop-down list. For
information about the time zone feature, see “Enabling Time Zones in the
Workload Scheduler” on page 385. If a time zone is not specified for the
job stream, all time values specified in the Time Restrictions properties
window are in the time zone of the workstation on which the job stream
is launched.
Note: Time Restrictions can also be set in the Timeline view of the Job Stream Editor. See
“Specifying Time Restrictions in the Timeline View” on page 244 for more
information.
When you have finished, click Resources in the left pane of the Job Stream Properties
window. The Resources page is displayed.

Resources Page
Figure 120. Properties - Job Stream Resources Page
To add a resource dependency for the job stream:

1. Click the Add Row button . This creates a new row in the list of resource dependencies.
2. Double-click in the text box in the Resources column and click Find to locate and insert
a resource name. For information about using the Find window, see “Finding Objects”
on page 199.
3. Double-click in the text box in the Quantity column and enter the number of resource
units required by the job stream. The default is one. Resources can be defined with up to
1024 units, but they can only be allocated in increments of 32. For example, to allocate
1024 units of a resource to a job stream or job you would need to create 32 entries for
the resource with 32 units each.
To remove a resource dependency for the job stream, select the resource row in the list and
click Delete from Table.
When you have finished, click Files in the left pane of the Job Stream Properties window.
The Files page is displayed.
222 Version 8.1

Files Page

Figure 121. Properties - Job Stream Files Page
To add a file dependency for the job stream:

1. Click the Add Row button . This creates a new row in the list of file dependencies.
2. Double-click in the text box in the Workstation column and click Find to locate and
insert the name of a workstation or workstation class. For information about using the
Find window, see “Finding Objects” on page 199.
3. Double-click in the text box in the Filename column and type a file name. Alternatively,
click Find to locate and insert a file name.
4. Double-click in the text box in the Qualifiers column and enter the test conditions for
the file dependency. On UNIX, the valid qualifiers are the same as UNIX test
command conditions. For more information, refer to your UNIX system documentation.
On Windows NT, only the following qualifiers are valid:
-d %p
True if the file exists and is a directory.
-e %p
True if the file exists.
-f %p
True if the file exists and is a regular file.
-r %p
True if the file exists and is readable.
-s %p
True if the file exists and it’s size is greater than zero.
-w %p
True if the file exists and is writable.
Notes:
a. On both UNIX and Windows NT, the expression %p inserts the file name.

b. Entering notempty is the same as entering -s %p. If no qualifier is specified, the
default is -f %p.
To remove a file dependency for the job stream, select the file row in the list and click the
Delete from Table button.
When you have finished, click Prompts in the left pane of the Job Stream Properties
window. The Prompts page is displayed.
Prompts Page
Figure 122. Properties - Job Stream Prompts Window
For an ad hoc prompt dependency, select Ad Hoc Prompt from the drop-down list. For a
predefined prompt dependency, select Predefined Prompt from the drop-down list.
To add a prompt dependency for the job stream:

1. Click the Add Row button (+). This creates a new row in the list of prompt
dependencies.
2. For a predefined prompt, double-click in the text box in the Name column and click
Find to locate and insert the name of a prompt. For information about using the Find
window, see “Finding Objects” on page 199.
3. For an ad hoc prompt, double-click in the text box in the Text column and type in the
text of the prompt. The default behavior of a prompt is to display a message and wait for
a reply. If the string begins with a colon (:), the message is displayed but no reply is
necessary. If the string begins with an exclamation mark (!), the message is not displayed
but it requires a reply. You can include backslash n (\n) within the text for new lines.
You can include one or more scheduler parameters as part or all of the text string. To use
a parameter, place its name between carets (^).
224 Version 8.1

To remove a prompt dependency for the job stream, select the prompt row in the list and
click Delete from Table (X).

¶ Click OK to keep the properties you have selected and close the Job Stream Properties
window.
¶ Click Cancel to ignore the properties you have selected and close the Job Stream
Properties window.
Adding External Dependencies for a Job Stream
Job streams can be dependent on the successful running of other job streams, jobs in other
job streams, and jobs in other Workload Scheduler networks (internetwork jobs). These
external dependencies are also called predecessors.
To add external dependencies for a job stream, open the job stream in the Job Stream Editor
and select External Dependencies from the File menu. The Job Stream External
Dependencies window is displayed.

Figure 123. Job Stream External Dependencies Window
By clicking on the drop-down menu, you can add:

¶ External job stream dependencies
¶ Internetwork dependencies
¶ External job dependencies
Figure 124. External Dependencies Menu

Adding an External Job Stream Dependency
To add an external job stream dependency:
1. Select External Job Stream from the drop-down menu at the top of the window.
2. Click the Add Row button.
3. Double-click in the Job Stream Name column of the new row.
4. Click the Find (...) button in the Job Stream Name column and use the Find Job
Stream window to select a job stream. For information about using the Find window, see

¶ Click OK to add the dependency and close the window
¶ Click Cancel to close the window without adding the dependency.
Adding an Internetwork Dependency

To add an internetwork dependency:
1. Select Internetwork from the drop-down menu at the top of the window.
2. Click the Add Row button (+).
3. Double-click in the Network Agent column of the new row.
4. Click the Find (...) button in the Network Agent column and use the Find Workstation
window to select the name of the network agent. Internetwork dependencies require that
a network agent is configured to communicate with the external scheduler network. For
information about configuring a network agent, refer to the Tivoli Workload Scheduler:
Reference Guide.
5. Double-click in the Dependency column of the new row and enter either a freeform
dependency, or the job or job stream predecessor in the form
workstation#jobstream.job.

Adding an External Job Dependency

To add an external job dependency:
1. Select External Job from the drop-down menu at the top of the window.
2. Click the Add Row button (+).
3. Double-click in the Job Name column of the new row.
4. Click the Find (...) button in the Job Name column and use the Find Job window to
select a job. For information about using the Find window, see “Finding Objects” on
page 199.

226 Version 8.1

Deleting External Dependencies from a Job Stream
Job streams can be dependent on the successful running of other job streams, jobs in other
job streams, and jobs in other Workload Scheduler networks (internetwork jobs). These
external dependencies are also called predecessors.
To delete external dependencies for a job stream:

1. Open the job stream in the Job Stream Editor.
2. Select External Dependencies from the File menu. This displays the Job Stream
External Dependencies window.
3. Select External Job Stream, Internetwork, or External Job from the drop-down menu.
4. Click the row of the dependency in the list you want to delete and click on the Delete
Row button (×).

¶ Click OK to delete the dependency and close the window
¶ Click Cancel to close the window without deleting the dependency.
Adding a Job to a Job Stream

A job definition is a description of work to be performed on a workstation. Jobs are
scheduled for running by adding them to job streams. You add jobs in a job stream using the
Graph view of the Job Stream Editor. See “Graph View” on page 213 for more information.
To add a job to a job stream:

1. To open the Graph view, right-click a job stream and select Open from the pop-up
menu.
2. In the Graph view, click the Add Job Definition button in the toolbar.
3. Move the mouse pointer to the position you want to place the new job in the Graph view
and left-click. The Properties - Job window is displayed. When you have completed the
job properties, a new job button is added in the Graph view.
Specifying Job Properties

The Properties - Job window opens automatically when you add a new job to a job stream.
If the window is not displayed, right-click a job in the Graph view of the Job Stream Editor
and select Properties from the pop-up menu.
There are five pages of job properties in the Properties - Job window:
¶ General
¶ Time Restrictions
¶ Resources
¶ Files
¶ Prompts
By default, the Properties - Job General page is displayed first.

General Page
Figure 125. Properties - Job General Page
Table 83. Properties - Job General Information
Name The name of the job. Click the Find button to choose the job. See
“Finding Objects” on page 199 for more information.
Workstation Name The workstation this job is defined to run on. If this workstation is
deleted, the task type for the job is unknown and must be specified before
you can save the job again.
Priority The priority of the job. Select a priority value from the drop-down list or
click of the following buttons:
Hold Sets the priority to zero.
High Sets the priority to 100.
priority. A priority value of zero prevents the job from launching.
Description A description of the job.
Requires Confirmation Select this box to indicate that job completion must be confirmed by the
operator. When a job with requires confirmation enabled completes, it
remains in the internal status PEND until confirmation is received. If
confirmation is received before the job completes, its internal status is
either SUCCP or ABENDP and other job and job stream successors are
not released.
Is Monitored Job Mark this check box to specify that the running of this job must be
monitored by Tivoli Business Systems Manager.
Select Time Restrictions in the left pane of the Properties - Job window. The Restrictions page
is displayed.
228 Version 8.1

Figure 126. Properties - Job Time Restrictions Page
Table 84. Properties - Job Time Restrictions Information

Start time The earliest time the job will be launched. The job will not be launched
before this time. Make your selections as follows:
Specify time
Select this option to enable the entry of a start time.
At Enter a start time in the following format:
hh:mm am|pm
Delay for
Enter the number of days to offset the start time from the day the job
is selected for inclusion in the production plan.
Deadline Specifies the latest time the job will be launched. The job will not be
launched after this time. Make your selections as follows:
Specify time
Select this option to enable the entry of a deadline time.
At Enter a deadline time in the following format:
hh:mm am|pm
Note: The Deadline time must be later than the Start Time.
Delay for
Enter the number of days to offset the deadline time from the day the
job is selected for inclusion in the production plan.
Time Zone The time zone in which the job runs. All time values specified in the Time
Restrictions view of the Properties - Job window are in this time zone.
Select a time zone from the drop-down list. For information about the
time zone feature, see “Enabling Time Zones in the Workload Scheduler”
on page 385. If a time zone is not specified for the job, all time values
specified in the Properties - Job Time Restrictions page are in the time
zone of the workstation on which the job is launched.

Table 84. Properties - Job Time Restrictions Information (continued)
Repeat Range The repetition rate of the job. The job is launched multiple times at this
rate.
Hours
Specify the hours that a job repeats.
Minutes
Specify the minutes that the job repeats.
If you cancel a repetitive job, it will not be launched again. If you rerun a
repetitive job, the next iteration of the job is run immediately. If you rerun
a repetitive job that had been cancelled, the repetition rate is reinstalled. If
a repetitive job abends, the repetitions continue following the optional
recovery action.
Est. Duration The estimated duration of the job if the job has run before.
Normal Elapsed Time
Displays the average time this job requires to run, based on previous
runs.
Note: Time Restrictions can also be set in the Job Stream Editor Timeline view. For more
information, see “Timeline View” on page 214.
Select Resources in the left pane of the Properties - Job window. The Resources page is
displayed.
Resources Page
Figure 127. Properties - Job Resources Page
To add a resource dependency for the job:

1. Click the Add Row button. This creates a new row in the list of resource dependencies.
2. Double-click in the text box in the Resources column and click the Find (...) button to
locate and insert a resource name. For information about using the Find window, see
3. Double-click in the text box in the Quantity column and enter the number of resource units
required by the job.
230 Version 8.1

To remove a resource dependency for the job, select the resource row in the list and click the
Select Files in the left pane of the Properties - Job window. The Files page is displayed.
Files Page

Figure 128. Properties - Job Files Page
To add a file dependency for the job:

1. Click the Add Row button. This creates a new row in the list of file dependencies.
2. Double-click in the text box in the Workstation column and enter a workstation or
workstation class name. Alternatively, click the Find button to locate and insert the name of
a workstation or workstation class.
3. Double-click in the text box in the Filename column and enter a file name. Alternatively,
click the Find button to locate and insert a file name
4. Double-click in the text box in the Qualifiers column and enter the test conditions for the
file dependency. On UNIX, the valid qualifiers are the same as UNIX test command
conditions. For more information, refer to your UNIX system documentation.
-d %p True if the file exists and is a directory.
-e %p True if the file exists.
-f %p True if the file exists and is a regular file.
-r %p True if the file exists and is readable.
-s %p True if the file exists and it’s size is greater than zero.
-w %p True if the file exists and is writable.
On both UNIX and Windows NT, the expression %p inserts the file name.
Entering notempty is the same as entering -s %p. If no qualifier is specified, the default is
-f %p.

To remove a file dependency for the job, select the file row in the list and click the Delete from
Table button.
Select Prompts in the left pane of the Properties - Job window. The Prompts page is displayed.
Prompts Page
Figure 129. Properties - Job Prompts Page
For an ad hoc prompt dependency, select Ad Hoc Prompt from the drop-down list. For a
predefined prompt dependency, select Predefined Prompt from the drop-down list.
To add a prompt dependency for the job, do the following:

1. Click the Add Row (+) button. This creates a new row in the list of prompt dependencies.
2. For a predefined prompt, double-click in the text box in the Name column and click the
Find (...) button to locate and insert the name of a prompt. For information about using the
Find window, see “Finding Objects” on page 199.
3. For an ad hoc prompt, double-click in the text box in the Text column and enter the text of
the prompt.
The default behavior of a prompt is to display a message and wait for a reply. If the string
begins with a colon (:), the message is displayed but no reply is necessary. If the string
begins with an exclamation mark (!), the message is not displayed but it requires a reply.
You can include backslash n (\n) within the text for new lines.
You can include one or more scheduler parameters as part or all of the text string. To use a
parameter, place its name between carets (^).
To remove a prompt dependency for the job, select the prompt row in the list and click the

¶ Click OK to keep the properties you have selected and close the window. If you are adding
a new job, a job button is added in the Graph view.
¶ Click Cancel to close the window without saving the properties you have selected.
Copying and Pasting Jobs
Within the Job Stream Editor you can copy and paste job and job stream buttons to create
dependencies:
232 Version 8.1

¶ You can copy a job stream from a job stream list and paste it into the Graph view of the
Job Stream Editor. Then, using the Add Link button, you can create a dependency
between this job stream and any jobs in the Job Stream Editor.
¶ You can open multiple job streams in separate Job Stream Editors and copy and paste
jobs between the job streams.
¶ You can copy a job within the Job Stream Editor and clone its dependencies to another
job.
Cloning the Job Dependencies
This procedure is used to clone the dependencies of a job to a new job within the Graph
view of the Job Stream Editor.
To clone the dependencies of a job:

1. Right-click the job button and select Copy from the pop-up menu. Alternatively, select
the job button and click the Copy button in the toolbar or select Copy from the Edit
menu. This copies the job to the clipboard.
2. Click the Paste button in the toolbar or select Paste from the Edit menu. This displays
the Properties - Job window for the copied job.

3. Use the find tool to find and select a new job to add to the job stream. The job name is
added to the Properties - Job General page.
4. When you click OK in the Properties - Job window, a new button is added for the job in
the Graph view of the Job Stream Editor. This job has the same dependencies as the
copied job.
5. When you have finished in the Job Stream Editor, save the job stream and close the Job
Stream Editor. For more information see “Saving a Job Stream in the Database” on
page 247 and “Closing the Job Stream Editor” on page 247.
Adding an Internetwork Dependency to a Job Stream
An internetwork dependency is a dependency on a job that runs in another Workload
Scheduler network. Internetwork dependencies require a network agent workstation to
communicate with the external scheduler network. For more information about configuring a
network agent, refer to the Tivoli Workload Scheduler Reference Guide.
Add internetwork dependencies to a job stream to create predecessors for the jobs in the job
stream you are editing. A predecessor must complete successfully before the successor job is
launched.
You add internetwork dependencies in a job stream using the Graph view of the Job Stream
Editor. See “Graph View” on page 213 for more information.

To add an internetwork dependency:
menu.
2. In the Graph view, click the Add Dependency on Internetwork button in the toolbar.
3. Move the mouse pointer to the position you want to place the new internetwork
dependency in the Graph view and left-click. The Internetwork Dependency window is
displayed.
4. Click the Find (...) button and use the Find Workstation window to select the name of
the network agent.
5. In theDependency field, specify either the freeform dependency, or the job or job stream
predecessor in the format workstation#jobstream.job. The maximum length of this
field is:
¶ 120 for freeform characters
¶ 16 for the workstation
¶ 16 for the job stream
¶ 40 for the job

¶ Click OK to close the window. If you are adding a new internetwork dependency, a new
internetwork dependency button is added in the Graph view.
For information about using an internetwork dependency as a predecessor, see “Creating

Dependencies Between Jobs in a Job Stream” on page 236.
Adding an External Job Stream to a Job Stream
An external job stream is any job stream other than the one you are editing. Add external
job streams to a job stream to create predecessors for the jobs in the job stream you are
editing. A predecessor must complete successfully before the successor job is launched.
You add external job streams in a job stream using the Graph view of the Job Stream Editor.
For more information, see “Graph View” on page 213.
To add an external job stream:

menu.
2. In the Graph view, click the Add Dependency on External Job Stream button in the
toolbar.
3. Move the mouse pointer to the position you want to place the new external job stream in
the Graph view and left-click. The External Job Stream Dependency window is
displayed.
234 Version 8.1

Figure 130. External Job Stream Dependency Window
4. Click the Find (...) button next to the Workstation field to locate and insert the name of
the workstation on which the job stream runs.
5. Click Show Job Streams to list the job streams that run on the workstation.
6. Select a job stream in the list.

¶ Click OK to close the window. A job stream button is added in the Graph view.
For information about using an external job stream as a predecessor, see “Creating
Dependencies Between Jobs in a Job Stream” on page 236.
Adding an External Job to a Job Stream
An external job is a job that runs in a job stream other than the one you are editing. Add
external jobs to a job stream to create predecessors for the jobs in the job stream you are
editing. A predecessor must complete successfully before the successor job is launched.
You add external jobs in a job stream using the Graph view of the Job Stream Editor. For
more information, see “Graph View” on page 213.
To add an external job:

menu.
2. In the Graph view, click the Add Dependency on External Job button in the toolbar.
3. Move the mouse pointer to the position you want to place the new external job in the
Graph view and left-click. The External Job Dependency window is displayed.

Figure 131. External Job Dependency Window
4. Click the Find (...) button next to the Job Stream Name field to locate and insert the
name of the job stream in which the job runs. For information about using the Find
window, see “Finding Objects” on page 199.
5. Click Show Jobs to list the jobs in the selected job stream that run on the selected
workstation.
6. Select a job in the list.

¶ Click OK to close the window. A job button is added in the Graph view.
¶ Click Cancel to close the window without saving the properties you selected.
For information about using an external job as a predecessor, see “Creating Dependencies
Between Jobs in a Job Stream”.
Creating Dependencies Between Jobs in a Job Stream
You can add dependencies between jobs to specify the order in which they run. A job that
depends on the successful completion of another job is called a successor and the job or job
stream that it depends on is called a predecessor.
You add dependencies between jobs in the Graph view of the Job Stream Editor. For more
information, see “Graph View” on page 213. The dependencies are represented by arrows.
To add a dependency between jobs:

menu.
2. In the Graph view, click the Add Link button in the toolbar.
3. Click the predecessor job or job stream and drag it to the successor job. When you
release the mouse button, an arrow is drawn from the predecessor to the successor.
236 Version 8.1

Figure 132. Job Stream Editor Window Graph View
Notes:
1. Internetwork dependencies, external jobs, and external job streams cannot be successors.
2. Internetwork dependencies, external jobs, and external job streams that are not linked are

not saved when the Job Stream Editor is closed.
To remove a dependency between jobs, select the arrow between the predecessor and the
successor , then right-click the arrow and select Delete from the pop-up menu.
When you are finished in the Job Stream Editor, refer to “Saving a Job Stream in the
Database” on page 247.
Specifying Run Cycles for a Job Stream

Run cycles specify when a job stream in the database is to run in the plan. Combinations of
run cycles are used to include and exclude certain dates. There are three types of run cycle:
¶ Simple Run Cycles
Based on specific calendar dates.
¶ Weekly Run Cycles
Based on days of the week.
¶ Calendar Run Cycles
Based on predefined calendars. For details about creating calendars, see “Managing
Calendars” on page 266.
You specify run cycles for a job stream using the Run Cycle view of the Job Stream Editor.
To display the Run Cycle view, select Run Cycle from the View menu in the Job Stream
Editor or click the Run Cycle button in the toolbar. For more information, see “Run Cycle
View” on page 216.
Inclusionary or Exclusionary Run Cycles
When you define a run cycle, you must specify if it designates the days when the job stream
is to run (inclusionary) or when the job stream is not to run (exclusionary).
The days you mark in an inclusive run cycle are displayed as Days Included in the list
of run cycles applied to the job stream.

The days you mark in an exclusive run cycle are displayed as Days Excluded in the list
of run cycles applied to the job stream. Excluded days always take precedence over
included days.
For each job stream, you can define as many inclusive and exclusive run cycles as you
want.
Rule for Freedays
This rule is based on the definition of freedays. Freedays are non-workdays, such as
holidays or closing days, and can be defined in one or more specific calendars. Freedays
calendars can in other terms be considered the list of non-workdays when there is no activity
in your enterprise. For details, see “Freedays Calendars” on page 267.
Based on a freedays calendar, you can specify a rule when you define the run cycle of a job
stream. The rule determines what action Workload Scheduler must take when the schedule of
a job stream falls on a freeday. If the schedule date falls on a freeday, the scheduler can do
¶ Run the job stream
¶ Not run the job stream
¶ Run the job stream on the closest workday before the freeday
¶ Run the job stream on the closest workday after the freeday
If no freeday rule is specified, the scheduler proceeds by default and runs the job stream
even if the selected run date is a freeday.
Workload Scheduler does not reschedule the same job stream more than once on a given
production day if its run date was moved because of a freeday rule application.
Colored Bars on Dates
As you include and exclude dates, colored bars are displayed across the dates. The bars have
the following meanings:
Table 85. Colored Bars on Dates
This bar ... Specifies ...
Blue An included date.
Red An excluded date.
White A non-workday.
White/Blue An included non-workday.
White/Red An excluded non-workday.
Note: Dates defined in the Holidays calendar are shown as non-workdays. For more
information, see “The Holidays Calendar” on page 266.
238 Version 8.1

Specifying Simple Run Cycles
You specify run cycles using the Job Stream Editor. To do this:
1. Right-click a job stream and select Open from the pop-up menu. The Job Stream Editor
is displayed
2. Click the Run Cycle button in the toolbar.
3. In the Run Cycle view, click the Simple Run Cycle button. The Simple Run Cycle
General page is displayed.

Figure 133. Simple Run Cycle General Page
4. In the Inclusive/Exclusive Run Cycle box:

¶ Select Inclusive to specify that the job stream must run in the dates defined on the
Rule page.
¶ Select Exclusive to specify that the job stream must not run in the dates defined on
the Rule page.
5. Click the arrow in the Rule for Freedays list box and select one of:
Select nearest workday before freeday
If the scheduled date falls on a freeday, run the job stream on the preceding
workday.
Select nearest workday after freeday
If the scheduled date falls on a freeday, run the job stream on the following
workday.
If freeday, do not select
If the scheduled date falls on a freeday, do not run the job stream.
None
Follow no rule. Run the job stream regardless of whether the schedule falls on a
freeday or on a workday.
6. Select Rule in the left pane of the Simple Run Cycle window. The Rule page is
displayed.

Figure 134. Simple Run Cycle Rule Page
7. Select the Monthly or Yearly tab to display the corresponding view. Use the arrow
buttons in the upper and lower bars of the selected view to move to the desired month
and year.
8. Click the dates in the calendar to add them to the run cycle. Click on the same date a
second time to remove it from the run cycle.

¶ Click OK to close the window and add the run cycle to the job stream.
¶ Click Cancel to close the window without adding the run cycle to the job stream.
Specifying Weekly Run Cycles
To specify a weekly run cycle for a job stream:
is displayed
3. In the Run Cycle view, click the Weekly Run Cycle button. The Weekly Run Cycle
240 Version 8.1

Figure 135. Weekly Run Cycle General Page
4. In the Inclusive/Exclusive Run Cycle box:

¶ Select Inclusive to specify that the job stream must run in the dates defined n the
Rule page.
¶ Select Exclusive to specify that the job stream must not run in the dates defined in
the Rule page.

workday.
workday.
None
6. Click Rule to display the Rule page which is shown below
Figure 136. Weekly Run Cycle Rule Page

7. Select the days by name to add them to the run cycle. In addition to single days, you can
also select:
Weekdays
Specifies every day of the week except Saturday and Sunday.
Freedays
Specifies the days defined either in the freedays calendar or in the Holidays
calendar, depending on which one you specified in the properties window of the job
stream.
Workdays
Specifies every day of the week except Saturday, Sunday, and the days defined
either in the freedays calendar or in the Holidays calendar, depending on which one
you specified in the properties window of the job stream.
Everyday
Specifies every day of the week.

Specifying Calendar Run Cycles
To specify a calendar run cycle for a job stream:
is displayed
3. In the Run Cycle, click the Calendar Run Cycle button. The Calendar Run Cycle
Figure 137. Calendar Run Cycle General Page
4. In the Inclusive/Exclusive Run Cycle box

¶ Select Inclusive to specify that the job stream must run in the dates defined n the
Rule page.
¶ Select Exclusive to specify that the job stream must not run in the dates defined in
the Rule page.
242 Version 8.1

workday.
workday.
None
6. Click Rule in the left pane of the Calendar Run Cycle window. The Calendar Run Cycle
Rule page is displayed.

Figure 138. Calendar Run Cycle Rule Page
7. Enter the name of the calendar in the Name field or click the Find (...) button to find a
calendar. For more information, see “Finding Objects” on page 199.
8. In the Offset group, you can specify an offset from the dates defined in the calendar. For
example, if a calendar date is 3/13/2001, an offset of +2 Days results in an effective date
of 3/15/2001.
To specify an offset:
a. Select + for a positive offset or - for a negative offset from the drop-down menu.
b. In the Offset field, enter the number of days (between 0 and 9999).
c. From the drop-down menu, select one of:
Days Specifies calendar days with no exceptions.
Workdays
Specifies calendar days except Saturday, Sunday, and the days defined either
in the freedays calendar or in the Holidays calendar, depending on which one
you specified in the properties window of the job stream.
Weekdays
Specifies calendar days except Saturday and Sunday.


Modifying Run Cycles for a Job Stream
To modify the run cycles for a job stream:
2. Click the Run Cycle view button. The Run Cycle page is displayed.
3. In the Run Cycles Name column, double click the run cycle you want to modify.
¶ If this is a simple run cycle:
A window is displayed showing the days selected by that run cycle. Modify the days
selected and click OK to save your changes.
¶ If this is a weekly run cycle:
A window is displayed showing the days selected by that run cycle. Modify the days
selected and click OK to save your changes.
¶ If this is a calendar run cycle:
A window is displayed showing the name of the calendar you selected and specified
offset. Modify the selected calendar or the offset and click OK to save your changes.

¶ Click OK to close the window and save the changes to the job stream.
¶ Click Cancel to close the window without saving the changes to the job stream.
Deleting Run Cycles from a Job Stream
To delete a run cycle from a job stream:
2. Click the Run Cycle view button. The Run Cycle page is displayed.
3. In the Run Cycles Name column, select the run cycle you want to delete from the job
stream.
4. Click Delete. The run cycle is deleted from the job stream. If the run cycle was a
calendar it is deleted from this job stream, but it is not deleted from the database and can
still be used by other job streams.

¶ Click OK to close the window and save the changes to the job stream.
¶ Click Cancel to close the window without saving the changes to the job stream.
Specifying Time Restrictions in the Timeline View

You can display and specify the time restrictions for a job stream and its jobs using the
Timeline view of the Job Stream Editor. For information about the Timeline view refer to
“Timeline View” on page 214.
Specifying Time Restrictions for a Job Stream
To specify time restrictions for the job stream in the Timeline view of the Job Stream Editor,
select Timeline from the View menu in the Job Stream Editor or click the Timeline button
in the toolbar.
244 Version 8.1

Using the Timeline
To adjust the time restrictions using the timeline, do any of the following:
¶ Drag the left side of the timeline to adjust the start time.
¶ Drag the right side of the timeline to adjust the deadline time.
¶ Drag the center of the timeline to change both the start and the deadline time.
Using a Window
To adjust the time restrictions using a window, either double-click the job stream row in the
tabular pane or right-click the row and select Properties from the pop-up menu. A properties
Table 86. Properties Information
Start The earliest time the job stream will be launched. The job stream will
not be launched before this time.
Specify time

hh:mm am|pm
Delay for
Enter the number of days to offset the start time from the day the
job stream is selected for inclusion in the production plan.
Deadline The latest time the job stream will be launched. The job stream will
not be launched after this time.
Specify time
hh:mm am|pm
Note: The deadline time must be later than the Start Time.
Delay for
Enter the number of days to offset the deadline time from the day
the job stream is selected for inclusion in the production plan.

¶ Click OK to close the window and save the time restrictions.
¶ Click Cancel to close the window without saving the time restrictions.
Note: Time Restrictions can also be set in the Time Restrictions view of the Properties - Job
window. For more information, see “Specifying Job Stream Properties” on page 217.
Specifying Time Restrictions for a Job
To specify time restrictions for a job in the Timeline view of the Job Stream Editor, either
select Timeline from the View menu in the Job Stream Editor or click the Timeline button
in the toolbar.

Using the Timeline
To adjust the time restrictions using the timeline, do any of the following:
¶ Drag the left side of the timeline to adjust the start time.
¶ Drag the right side of the timeline to adjust the deadline time.
¶ Drag the center of the timeline to change both the start and the deadline time.
Using a Window
To adjust the time restrictions using a window, double-click the job row in the tabular pane
or right-click the row and select Properties from the pop-up menu. A properties window is
displayed
Table 87. Properties Information
Start The earliest time the job will be launched. The job will not be
launched before this time.
Specify time
hh:mm am|pm
Delay for
Enter the number of days to offset the start time from the day the
job is selected for inclusion in the production plan.
Deadline The latest time the job will be launched. The job will not be launched
after this time.
Specify time
hh:mm am|pm
Note: The deadline time must be later than the Start Time.
Delay for
Enter the number of days to offset the deadline time from the day
the job is selected for inclusion in the production plan.
Time Zone The time zone for this job. For information about the time zone
feature, see “Enabling Time Zones in the Workload Scheduler” on
page 385.
Repeat Range The repetition rate of the job. The job is launched multiple times at
this rate.
Hours
Specify the hours that a job repeats.
Minutes
Specify the minutes that the job repeats.

¶ Click OK to close the window and save the time restrictions.
246 Version 8.1

¶ Click Cancel to close the window without saving the time restrictions.
Note: Time restrictions can also be set in the Time Restrictions view of the Properties - Job
window. See “Specifying Job Properties” on page 227 for more information.
Saving a Job Stream in the Database

To save a job stream in the database from the Job Stream Editor, click on the Save button in
the toolbar or select Save from the File menu.
Closing the Job Stream Editor

To close the Job Stream Editor, click the Close button in the window title bar or select
Close from the File menu.
If you have not saved your job stream changes, a warning messages is displayed. Do one of
the following:
¶ Click Yes to save the job stream in the database before closing the Job Stream Editor.
¶ Click No to close the Job Stream Editor without saving the job stream in the database.

¶ Click Cancel to return to the Job Stream Editor without saving the job stream in the
database.
Displaying a List of Job Streams

To display a list of job streams in the database:
2. Expand the branches below the scheduler until you see the button for the job stream list
you want to run. For information about creating job stream lists, see “Creating a List of
Job Streams” on page 190.
3. Select the job stream list button.
4. Right-click the job stream list button and select Load List from the pop-up menu. The
list results are displayed in the right pane of the Job Scheduling view.
Figure 139. Job Streams List Window

Table 88 describes the column headings.
Table 88. Job Streams List Columns
Job Stream The name of the job stream.
Workstation The name of the workstation on which the job stream runs.
Status The current JSS status of the job stream.
Internal Status The Workload Scheduler internal status for the job stream instance.
Information Information about the job stream status. Can be:
In Order
Carried Forward
Carry
Deadline time has passed
Released from dependencies
Canceled
Cancel Pend.
Priority The priority of the job stream.
Num Jobs The number of jobs in the job stream.
OK Jobs The number of jobs that ran successfully.
Limit The number of jobs in the job stream that can run concurrently.
Original Job Stream The original name of the job stream, if it has been resubmitted or
carried over.
Scheduled Start The scheduled start time of the job stream.
Actual Start The time the job stream actually started.
Est. Duration The estimated duration of the job stream, based on previous times
the job stream ran.
Actual Duration The actual duration of the job stream.
Deadline Time The time after which the job stream cannot run.
Job stream Dep. The number of job stream dependencies on the job stream. The
dependency can be a predecessor or successor.
Job Dep. The number of job dependencies on the job stream. The
dependency can be a predecessor or successor.
Inet Dep. The number of internetwork predecessors to the job stream.
File Dep. The number of file dependencies on the job stream.
Prompt Dep. The number of prompt dependencies on the job stream.
Resource Dep. The number of resource dependencies on the job stream.
Is Monitored Job Stream Whether or not the job stream, and all the jobs it contains, is to be
monitored by Tivoli Business Systems Manager.
When you right-click a job stream instance in the list, a pop-up menu is displayed. This is
described in “Managing Job Stream Instances in the Plan” on page 316.
Displaying a Job Stream

To display a job stream in the database:
1. Run a list of job streams that contains the job stream you want to display. For more
information, see “Displaying a List of Job Streams” on page 247.
248 Version 8.1

2. In the list results, either double-click the job stream you want to display, or right-click
the job stream and select Properties from the pop-up menu.
The job stream is displayed in the Job Stream Editor. For information about the Job
Stream Editor, see “Creating a Job Stream” on page 217.
3. Click OK or on Cancel to close the Job Stream Editor.
Modifying a Job Stream

To modify a job stream in the database:
1. Run a list of job streams that contains the job stream you want to modify. For more
information, see “Displaying a List of Job Streams” on page 247.
2. In the list results, right-click the job stream and select Properties from the pop-up menu.
The Properties - Job Stream window is displayed.
3. Make your changes in the Job Stream Editor. For more information, see “Specifying Job
Stream Properties” on page 217.
Table 89 shows where to find information about modifying a job stream.

Table 89. Modifying Objects in a Job Stream

To modify these objects ... See ...
Jobs “Modifying a Job in a Job Stream” and “Deleting a Job in
a Job Stream”.
Internetwork dependencies “Modifying an Internetwork Dependency in a Job Stream”
and “Deleting an Internetwork Dependency in a Job
Stream” on page 250.
External job streams “Modifying an External Job Stream in a Job Stream” on
page 250 and “Deleting an External Job Stream in a Job
Stream” on page 250.
External jobs “Modifying an External Job in a Job Stream” on page 250
and “Deleting Job Streams” on page 250.
When you are finished modifying the job stream, save the job stream in the database and
close the Job Stream Editor. For more information, see “Saving a Job Stream in the
Database” on page 247 and “Closing the Job Stream Editor” on page 247.
Modifying a Job in a Job Stream
To modify a job in a job stream, right-click the job button in the Graph view and select
Properties from the pop-up menu. For information about job properties, see “Specifying Job
Properties” on page 227.
Deleting a Job in a Job Stream
To delete a job in a job stream, right-click the job button in the Graph view and select
Modifying an Internetwork Dependency in a Job Stream
To modify an internetwork dependency in a job stream, right-click its button in the Graph
view and select Properties from the pop-up menu. For information about internetwork
dependency properties, see “Adding an Internetwork Dependency to a Job Stream” on
page 233.

Deleting an Internetwork Dependency in a Job Stream
To delete an internetwork dependency in a job stream, right-click its button in the Graph
view and select Delete from the pop-up menu.
Modifying an External Job Stream in a Job Stream
To modify an external job stream in a job stream, right-click its button in the Graph view
and select Edit , then External Job Stream from the pop-up menu. The job stream is
displayed in the Job Stream Editor. For information about the Job Stream Editor, see “Using
the Job Stream Editor” on page 213 and “Creating a Job Stream” on page 217.
Deleting an External Job Stream in a Job Stream
To delete an external job stream in a job stream, right-click its button in the Graph view and
select Delete from the pop-up menu.
Modifying an External Job in a Job Stream
To modify an external job in a job stream:
1. Right-click its button in the Graph view and select Edit, then External Job Stream
from the pop-up menu. The job stream is displayed in the Job Stream Editor. For
information about the Job Stream Editor, see “Using the Job Stream Editor” on page 213
and “Creating a Job Stream” on page 217.
2. To edit the job, right-click the job button in the Graph view and select Properties from
the pop-up menu. For information about job properties, see “Specifying Job Properties”
on page 227.
Deleting an External Job in a Job Stream
To delete an external job in a job stream, right-click its button in the Graph view and select
Deleting Job Streams

To delete job streams in the database, run a list of job streams that contains the job stream
you want to delete. For more information, see “Displaying a List of Job Streams” on
page 247.
To delete ... Do this ...

One job stream Right-click the job stream and select Delete from the pop-up menu
Multiple job streams in a range Hold down the Shift key, click the first and last job streams in the
range, then right-click on one of the selected job streams and select
Delete from the pop-up menu
Multiple job streams that are not Hold down the Ctrl key, click each job stream, then right-click one
in a range of the selected job streams and select Delete from the pop-up
menu
A message is displayed for each job stream asking for confirmation.
Click OK to delete the job stream in the database or click Cancel to cancel the delete
operation.
250 Version 8.1

19. Managing
Workstations
19
Managing Workstations and Workstation
Classes
Managing Workstations
A workstation is usually an individual computer, on which jobs and job streams are run. A
workstation definition is required for every computer that runs jobs in the Workload
Scheduler network.
Primarily workstation definitions refer to physical workstations. However, in the case of

extended agents, the workstations are logical definitions that must be hosted by a physical
workstation.
There are several types of workstations in a Workload Scheduler Network:

¶ Master domain manager
¶ Domain manager
¶ Backup domain manager
¶ Fault-tolerant agent
¶ Standard agent
¶ Extended agent
¶ Network agent
Creating a Workstation
You create workstations in the database using the Properties - Workstation in Database
window. To create a new workstation, follow the steps below. See also “Creating a
Workstation by Copying Another Workstation” on page 257. For information about creating
extended agent workstations, see the user manual for the specific extended agent.
In the tree view of the Job Scheduling Console, right-click the scheduler engine button and
select New Workstation from the pop-up menu. The Properties - Workstation in Database

Figure 140. Properties - Workstation in Database Window
Table 90. Properties - Workstation in Database Information
Workstation name The name of the workstation. The name must start with a letter and can
Note: Workstation names must be unique, and cannot be the same as
workstation class and domain names.
Node The host name or the IP address of the workstation. Fully-qualified
domain names are accepted.
TCP Port The Netman TCP port number that Workload Scheduler uses for
communications on the workstation. The default is 31111. The port
number of Netman on a workstation is defined by the localopts file in the
parameter nm port.
Operating System The operating system of the workstation. Select one of:
UNIX
Windows NT
MPE/V
MPE/IX
Other
Domain The name of the Workload Scheduler domain of the workstation. The
name must start with a letter and can contain alphanumeric characters,
dashes, and underscores. For non-expanded databases, it can contain up to
eight characters. For expanded databases, it can contain up to 16
characters.
Note: Domain names must be unique, and cannot be the same as
workstation and workstation class names. The default for fault-tolerant and
standard agents is the master domain, usually named MASTERDM. The
default for a domain manager is the domain in which it is defined as the
manager. The default for an extended agent is the domain of its host.
252 Version 8.1

19. Managing
Workstations
Table 90. Properties - Workstation in Database Information (continued)
Time Zone The time zone of the workstation. Choose a time zone name from the
drop-down list. For a description of time zone names, refer to the Tivoli
Workload Scheduler Reference Guide. To ensure the accuracy of
scheduling times, this time zone must be the same as the computer’s
operating system time zone.
Description A description of the workstation. The description can contain up to 40
characters.
Workstation Type The type of workstation. Select one of the following from the drop-down
list:
Fault-tolerant Agent
Select this type for an agent workstation that is capable of launching
its jobs and resolving local dependencies without a domain manager.
Select this type for fault-tolerant agents, domain managers, and
backup domain managers.
Extended Agent
Select this type for an agent workstation that launches jobs only
under the direction of its host. Extended agents can be used to
interface Workload Scheduler with non-Tivoli systems and
applications. For more information refer the user manual for the
specific extended agent.
Standard Agent
Select this type for an agent workstation that launches jobs only
under the direction of its domain manager.
Auto Link Whether to open the link between workstations at startup. For
fault-tolerant and standard agents, select this option to have the domain
manager open the link to the agent when the domain manager is started.
For a domain manager, select this option to have its agents open links to
the domain manager when they are started.
Auto Link is useful primarily during the startup sequence at the

beginning of each day. At that time, a new production plan is created and
compiled on the master domain manager, and all workstations are stopped
and restarted. For each agent that has Auto Link selected, the domain
manager automatically sends a copy of the new production plan and starts
the agent. If Auto Link is also selected for the domain manager, the
agent, in turn, opens a link back to the domain manager. If Auto Link is
not selected for an agent, it is initialized when you run a link action on
the agent’s domain manager or the master domain manager.
Full Status Whether the agent is updated with full or partial status. This is for
fault-tolerant agents only. When Full Status is selected, the agent is
updated about the status of jobs and job streams running on all other
workstations in its domain and subordinate domains.
If Full Status is not selected, the agent is informed only about the status
of jobs and job streams on other workstations that affect its own jobs and
job streams. This can improve performance by reducing network activity.
To keep an agent’s production plan at the same level of detail as its

domain manager, select Full Status and Resolve Dependencies. Always
select these options for backup domain managers.
Ignore Select this so that the scheduler will ignore this workstation. This can be
used to define workstations before they are actually installed.

Table 90. Properties - Workstation in Database Information (continued)
Resolve Dependencies Specify whether an agent will track all dependencies or only its own. This
is for fault-tolerant agents only. When Resolve Dependencies is selected,
the agent tracks dependencies for all jobs and job streams, including those
running on other workstations. Note that Full Status must also be selected
so that the agent is informed about activity on other workstations. If
Resolve Dependencies is not selected, the agent tracks dependencies for
its own jobs and job streams only. This reduces processing overhead.
To keep an agent’s production plan at the same level of detail as its

domain manager, select Full Status and Resolve Dependencies. Always
select these options for backup domain managers.
Server Specify a Mailman server on the domain manager to handle
communications with the agent. This is for fault-tolerant and standard
agents only. Do not use this option for domain managers. Using servers
can reduce the time required to initialize agents and improve the
timeliness of messages.
To specify a server, select a letter or a number (A-Z and 0-9) from the
drop-down list. The IDs are unique to each domain manager, so you can
use the same IDs in other domains without conflict. If more than 36
server IDs are required in a domain, consider dividing it into two or more
domains.
If a server ID is not specified, communications with the agent are handled

by the main Mailman process on the domain manager.
When a domain manager starts up, it creates a separate server for each
unique server ID. If the same ID is used for multiple agents, a single
server is created to handle their communications. As a guide, extra servers
should be defined to prevent a single server from handling more than
eight agents.
Access Method An access method for extended agents and network agents. This must be
the name of a method file that resides in the TWShome/methods directory
on the agent’s host workstation. For a local UNIX extended agent, the
method name is unixlocl. For a remote UNIX extended agent the method
name is unixrsh. For Network agents, the method name is netmth. For
more information about extended agents, refer to the individual extended
agent user’s guides. For more information about network agents, refer to
the Tivoli Workload Scheduler Reference Guide.
Host The name of the agent’s host workstation. This is required for extended
agents. The host is the workstation with which the extended agent
communicates and where its access method resides. The host for an
extended agent must be a Master, Domain Manager, or FTA. The host for
an extended agent can be specified as $MASTER. This assigns the host as
the Master Domain Manager, and is useful if you need to switch masters
in the domain. The extended agent will automatically connect to the new
manager.
Note: The host option is no longer required for Standard agents. The host workstation for
standard agents is now defaulted to the domain manager.
254 Version 8.1

When you have finished in the Properties - Workstation in Database window, do one of the
19. Managing
Workstations
following:
¶ Click the OK button to save the workstation in the database and close the window.
¶ Click the Cancel button to close window without saving the workstation in the database.
Displaying a List of Workstations
To display a list of workstations in the database:
2. Expand the branches below the scheduler until you see the button for the workstation list
you want to run. For information about creating workstation lists, see “Creating a List of
Workstations” on page 192.
3. Select the workstation list button.
4. Right-click the workstation list button and select Load List from the pop-up menu. The
list results are displayed in the right pane of the Job Scheduling view.
Figure 141. Workstation List Window
Table 91 describes the column headings in the workstation display.

Table 91. Workstation List Window Columns
Name The name of the workstation.
Type The type of workstation. This is one of:
Fault-tolerant Agent
Standard Agent
Extended Agent
OS The type of operating system for the workstation. This is one of:
UNIX
Windows NT
MPE/IX
MPE/V
Other

Table 91. Workstation List Window Columns (continued)
Domain The name of the domain in which the workstation is a member.
Time Zone The time zone of the workstation, if one is defined
Creator The name of the user who created the workstation in the database
Last Updated The date the workstation was last updated in the database.
Displaying a Workstation
To display a workstation in the database:
1. Run a list of workstations that contains the workstation you want to display. See
“Displaying a List of Workstations” on page 255 for more information.
2. In the list results, double-click the workstation you want to display or right-click the
workstation and select Properties from the pop-up menu.
This opens the workstation in the Properties - Workstation in Database window. For
information about this window, see “Creating a Workstation” on page 251.
3. Click OK or on Cancel to close the window.
Modifying a Workstation
To modify a workstation in the database:
2. In the list results, double-click the workstation you want to modify or right-click the
workstation and select Properties from the pop-up menu.
The Properties - Workstation in Database window is displayed.
3. Make your changes in the Properties - Workstation in Database window. For information
about this window, see “Creating a Workstation” on page 251.
4. When you have finished:
¶ Click OK to save the workstation in the database and close the window.
¶ Click Cancel button to close the Properties - Workstation in Database window
without saving the workstation in the database.
Deleting Workstations
To delete workstations in the database:
1. Run a list of workstations that contains the workstation you want to delete. See
“Creating a Workstation” on page 251 for more information.
2. In the list results, do one of the following:
¶ To delete one workstation, right-click the workstation.
¶ To delete multiple workstations in a range, hold down the Shift key, click the first
and last workstations in the range, then right-click one of the selected workstations.
¶ To delete multiple workstations that are not in a range, hold down the Ctrl key, click
each workstation, then right-click one of the selected workstations.
3. Choose Delete from the pop-up menu. A confirmation message is displayed for each
workstation.
256 Version 8.1

4. Click OK to delete the workstation in the database or click Cancel to cancel the delete
19. Managing
Workstations
operation.
Creating a Workstation by Copying Another Workstation
To create a new workstation in the database using a copy of another workstation:
1. Run a list of workstations that contains the workstation you want to copy. See
2. In the list results, right-click the workstation you want to copy and select Create
another from the pop-up menu.
This displays a copy of the workstation in the Properties - Workstation in Database
window.
3. Change the name in the Workstation name text box to the name of the new
workstation.
4. Make other changes as needed to define the new workstation. For information about the
Properties - Workstation in Database window, see “Creating a Workstation” on page 251.
¶ Click OK to save the workstation in the database and close the window.
¶ Click Cancel to close the window without saving the workstation in the database.
Managing Workstation Classes

A workstation class is a group of workstations. Any number of workstations can be placed in
a class. Job streams and jobs can be assigned to run on a workstation class, making
replication across many workstations easy.
If a job stream is defined on a workstation class, each job added to the job stream must be
defined either on a single workstation or on the exact same workstation class that the job
stream was defined on.
Creating a Workstation Class
To create workstation classes in the database, you use the Properties - Workstation Class
window.
To create a new workstation class:

2. Right-click the scheduler engine button and select New Workstation Class from the
pop-up menu. The Properties - Workstation Class General window is displayed

General Page
Figure 142. Properties - Workstation Class General Page
1. In the Name text box, enter the name of the workstation class. The name must start with
a letter and can contain alphanumeric characters, dashes, and underscores. For
non-expanded databases, it can contain up to eight characters. For expanded databases, it
can contain up to 16 characters.
Note: Workstation class names must be unique and cannot be the same as workstation
and domain names.
2. Select Workstations in the left pane of the Properties - Workstation Class window. The
Workstations Page
Figure 143. Properties - Workstation Class Workstations Page
Table 92. Properties - Workstation Class Workstations Page

Add individual workstations to the click Find Workstations. For information about using the
class find facility, refer to “Finding Objects” on page 199.
Add all of the workstations in the click Add All Workstations.
database to the workstation class
Delete a workstation from the Select the workstation in the Workstation List and click
workstation class Delete from Table (X).
258 Version 8.1

¶ click OK to close the window and save the new workstation class in the database.
19. Managing
Workstations
¶ click Cancel to close the window without saving the workstation class in the database.
Displaying a List of Workstation Classes
To display a list of workstation classes in the database:
1. In the tree view of the Job Scheduling Console, expand the scheduler button.
2. Expand the branches below the scheduler until you see the button for the workstation
class list you want to run. See “Creating a List of Workstation Classes” on page 193 for
information about creating workstation class lists.
3. Select the workstation class list button.
4. Right-click the workstation class list button and select Load List from the pop-up menu.
Figure 144. Workstation Class List Window
Table 93 describes the of the workstation class list.

Table 93. Workstation Class List Window
Name The name of the workstation class.
Creator The name of the user who created the workstation class in the
database.
Last Updated The date the workstation class was last updated in the database.
Displaying a Workstation Class

To display a workstation class in the database:
1. Run a list of workstation classes that contains the workstation class you want to display.
See “Displaying a List of Workstation Classes” for more information.
2. In the list results, double-click the workstation class you want to display or right-click
the workstation class and select Properties from the pop-up menu.
The Properties - Workstation Class window is displayed. For information about this
window, see “Creating a Workstation Class” on page 257.
3. click OK or on Cancel to close the window.

Modifying a Workstation Class
To modify a workstation class in the database:
1. Run a list of workstation classes that contains the workstation class you want to modify.
See “Displaying a List of Workstation Classes” on page 259 for more information.
2. In the list results, double-click the workstation class you want to modify or right-click
the workstation class and select Properties from the pop-up menu.
The Properties - Workstation Class window is displayed.
3. Make your changes in the window. For information about the Properties - Workstation
Class window, see “Creating a Workstation Class” on page 257.
¶ click OK to save the workstation class in the database and close the window.
¶ click Cancel to close the window without saving the workstation class in the
database.
Deleting Workstation Classes
To delete workstation classes in the database:
1. Run a list of workstation classes that contains the workstation class you want to delete.
See “Displaying a List of Workstation Classes” on page 259 for more information.
¶ To delete one workstation class, right-click the workstation class.
¶ To delete multiple workstation classes in a range, hold down the Shift key, click the
first and last workstation classes in the range, then right-click one of the selected
workstation classes.
¶ To delete multiple workstation classes that are not in a range, hold down the Ctrl
key, click each workstation class, then right-click one of the selected workstation
classes.
3. Select Delete from the pop-up menu. A message is displayed for each workstation class
asking for confirmation.
4. click OK to delete the workstation class in the database or click Cancel to cancel the
delete operation.
260 Version 8.1

20
Managing Domains, Users, and Calendars
20. Managing Domains,

Users, and Calendars
Managing Domains
A domain is a named group of Workload Scheduler workstations, consisting of one or more
workstations and a domain manager acting as the management hub. All domains have a
parent domain, except for the master domain.
Creating a Domain
To create domains in the database, you use the Properties - Domain window.
To do this, in the tree view of the Job Scheduling Console, right-click the scheduler engine
button and select New Domain from the pop-up menu. The Properties - Domain window is
displayed.
Figure 145. Properties - Domain Window
Use the information in Table 94 to complete the text boxes.

Table 94. Properties - Domain Window
Domain Name The name of the domain. The name must start with a letter and can
Note: Domain names must be unique and cannot be the same as
workstation and workstation class names.
Description A description of the domain.
Parent Domain The name of the parent domain to which the domain manager is
linked. The default is the master domain. For information about using
the Find button, refer to “Finding Objects” on page 199.

Table 94. Properties - Domain Window (continued)
Domain Manager The name of the workstation that is the domain manager. The domain
manager must be a fault-tolerant agent with Full Status and Resolve
Dependencies selected.
Note: When creating a new domain, you can specify a domain
manager workstation that does not yet exist. For information about
using the Find button, refer to “Finding Objects” on page 199.

¶ Click OK to close the window and save the new domain in the database.
¶ Click Cancel to close the window without saving the domain in the database.
Displaying a List of Domains
To display a list of domains in the database:
2. Expand the branches below the scheduler until you see the button for the domain list you
want to run. See “Creating a List of Domains” on page 196 for information about
creating domain lists.
3. Select the domain list button.
4. Click Load List in the toolbar or right-click on the domain list button and select Load
List from the pop-up menu.
The list results are displayed in the right pane of the Job Scheduling Console. The
following are descriptions of the column headings.
Table 95 describes the columns of the domain list.

Table 95. Domain List Columns
Name The name of the domain.
Parent Domain The name of the domain above this domain in the hierarchy.
Domain Manager The name of the workstation that is the manager of this domain.
Creator The name of the user who created the domain in the database.
Last Updated The date the domain was last updated in the database.
Displaying a Domain
To display a domain in the databases:
1. Run a list of domains that contains the domain you want to display. See “Displaying a
List of Domains” for more information.
2. In the list results, double-click the domain you want to display or right-click the domain
This opens the domain in the Properties - Domain window. For information about this
window, see “Creating a Domain” on page 261.
262 Version 8.1

Modifying a Domain in the Database
To modify a domain in the database, follow these steps:
1. Run a list of domains that contains the domain you want to modify. See “Displaying a
List of Domains” on page 262 for more information.
2. In the list results, double-click the domain you want to modify or right-click the domain
This opens the domain in the Properties - Domain window.
3. Make your changes in the window. For more information, see “Creating a Domain” on

page 261.
¶ Click OK to save the domain in the database and close the Properties - Domain
window.
¶ Click Cancel to close the Properties - Domain window without saving the domain in
the database.
Deleting Domains in the Database
To delete domains in the database, follow these steps:
1. Run a list of domains that contains the domain you want to delete. See “Displaying a
List of Domains” on page 262 for more information.
¶ To delete one domain, right-click the domain.
¶ To delete multiple domains in a range, hold down the Shift key, click the first and
last domains in the range, then right-click on one of the selected domains.
¶ To delete multiple domains that are not in a range, hold down the Ctrl key, click
each domain, then right-click one of the selected domains.
3. Select Delete from the pop-up menu. A confirmation message is displayed for each
domain.
4. Click OK to delete the domain in the database or click Cancel to cancel the delete
operation.
Managing Users
The users for whom Workload Scheduler will launch jobs must be defined in the database.
This is required for Windows NT users only.
Creating a User
To create users in the database, you use the Properties - NT User window. To do this, in the
tree view of the Job Scheduling Console, right-click the scheduler engine button and select
New User from the pop-up menu. The Properties - NT User window is displayed

Figure 146. Properties - NT User Window
Use the information in Table 96 to complete the fields in the window.

Table 96. Properties - NT User Window
User Name The Windows NT user name. The name can contain up to 47 characters.
Notes:
1. Windows NT user names are case-sensitive.
2. A user must be able to log on to the workstation on which Workload
Scheduler will launch jobs, and have the right to Log on as batch.
3. If the name is not unique in Windows NT, it is considered to be a
local user, a domain user, or a trusted domain user, in that order.
NT Domain The Windows NT domain of this user. This field is optional. If the
name is not fully qualified (that is, no Windows NT domain is entered)
or is not unique in Windows NT, it is considered to be a local user, a
domain user, or a trusted domain user, in that order.
NT Workstation The name of the Workload Scheduler workstation on which the user is
allowed to launch jobs. For information about using the Find button,
refer to “Finding Objects” on page 199. The default is all workstations.
Set Password New Password
A new user password as defined on the Windows NT computer.
Confirmation
The user password again for confirmation.

¶ Click OK to close the window and save the new user in the database.
¶ Click Cancel to close the window without saving the user in the database.
Displaying a List of Users
To display a list of users in the database, expand the branches below the scheduler until you
see the button for the user list you want to display. Right-click the user list button and select
Load List from the pop-up menu. The list results are displayed in the right pane of the Job
Scheduling view.
264 Version 8.1

Figure 147. Users List Window
Table 97 describes the columns of the window.

Table 97. Users List Window
NT Domain\User The Windows NT domain and the name of the user.
NT Workstation The name of the workstation on which the user will launch jobs.
Displaying a User
To display a user in the database:
1. Run a list of users that contains the user you want to display. See “Displaying a List of
Users” on page 264 for more information.
2. In the list results, double-click the user you want to display or right-click on the user and
select Open from the pop-up menu.
This opens the user in the Properties - NT User window. For information about the
Properties - NT User window, see “Creating a User” on page 263.
Modifying a User
To modify a user in the database:
1. Run a list of users that contains the user you want to modify. See “Displaying a List of
2. In the list results, double-click the user you want to modify or right-click on the user and
select Open from the pop-up menu.
This opens the user in the Properties - NT User window.
3. Make your changes. For information about the Properties - NT User window, see
“Creating a User” on page 263.
¶ Click OK to save the user in the database and close the window.
¶ Click Cancel to close the window without saving the user in the database.

Deleting Users
To delete users in the database:
1. Run a list of users that contains the user you want to delete. See “Displaying a List of
¶ To delete one user, right-click the user.
¶ To delete multiple users in a range, hold down the Shift key, click the first and last
users in the range, then right-click on one of the selected users.
¶ To delete multiple users that are not in a range, hold down the Ctrl key, click each
user, then right-click one of the selected users.
3. Select Delete from the pop-up menu. A confirmation message is displayed for each user.
4. Click OK to delete the user in the database or click Cancel to cancel the delete
operation.
Changing User Passwords
To change a user password:
1. From the main console, click the connector in the left pane.
2. Click Selected from the menu.
3. Click Change Password.
4. Click the search button to specify a name in the User Name text box.
5. Enter the password in the New Password text box.
6. Re-enter the password in the Confirmation text box.
7. Click OK.
Managing Calendars
A calendar is a list of scheduling dates defined in the scheduler database. Assigning a
calendar run cycle to a job stream causes that job stream to be run on the days specified in
the calendar. Since a calendar is defined to the scheduler database, it can be assigned to
multiple job streams.
You can create as many calendars as required to meet your scheduling needs. For example:
Table 98. Example Calendars
This calendar ... Could contain ...
PAYDAYS A list of pay dates
MONTHEND A list of month ending dates
HOLIDAYS A list of your company’s holidays
The Holidays Calendar

The HOLIDAYS calendar is used to determine non-workdays for the purpose of defining
run cycles for your job streams. It also affects the definition of the workdays keyword in the
following terms:
workdays=everyday except saturday, sunday and all the dates appearing in the HOLIDAYS calendar
266 Version 8.1

You should create a HOLIDAYS calendar with the dates of your holidays.
Freedays Calendars
A freeday must be intended as a non-workday, when no scheduling activity is to take place.
Freedays calendars extend the role of the HOLIDAYS calendar, as they provide additional
flexibility in defining workdays. When defining a job stream, if you decide to use a freedays
calendar instead of HOLIDAYS, then the definition of workdays becomes:
workdays=everyday except saturday, sunday and all the dates appearing in the specified freedays calendar
If you decide to use your own freedays calendar for a particular job stream, the redefined

meaning of workdays, as implied by the freedays calendar, is limited to that particular job
stream. A possible scenario is to define more than one freedays calendar to use in your
scheduling activity, particularly in the case your enterprise has different international
locations, to respond to different non-workdays requirements.
When you do not specify a freedays calendar for the job stream, then HOLIDAYS is used,
if available.
Creating a Calendar in the Database
To create calendars in the database, you use the Properties - Calendar window. To do this, :
1. In the tree view of the Job Scheduling Console, right-click the scheduler button and
select New Calendar from the pop-up menu. The Properties - Calendar window is
displayed.
Figure 148. Properties - Calendar Window
2. In the Name field, specify the name of the calendar. The name must start with a letter
and can contain alphanumeric characters, dashes, and underscores. The name can
contain up to eight characters.
Note: You cannot use Workload Scheduler keywords (for example, freedays and
schedule).
3. In the Description field, enter a description of the calendar.
4. Click Define Calendar to add dates to the calendar. The Monthly Yearly Calendar
window is displayed, as shown in the next figure.

Figure 149. Monthly Yearly Calendar Window
5. Select Monthly or Yearly in the left pane of the window to view a monthly or yearly
calendar. Use the arrow buttons above and below the calendar to change the month and
year.
6. To add a specific date to the calendar, click the date in the calendar view.
7. To add a specific day of the month, select Day of Month from the Select menu. The
Day of Month window is displayed.
Figure 150. Day of Month Window
8. To add a day of the month by number, select the day number in the Day drop-down
list. To add the last day of the month, select the Last Day of Month option.
9. Select start and end dates for the calendar by selecting the month and year from the
Start and End drop-down lists. The days you specified are selected for every month in
this range.
10. Click OK to close the Day of Month window and select the dates. Click Cancel to
close the window without selecting the dates.
11. Click OK to close the Monthly Yearly Calendar window and add the dates to the
calendar. Click Cancel to close the window without adding the dates to the calendar.
¶ Click OK to close the Properties - Calendar window and save the new calendar in
the database.
¶ Click Cancel to close the window without saving the calendar in the database.
268 Version 8.1

Displaying a List of Calendars
To display a list of calendars in the database:
1. In the tree view of the Job Scheduling Console, expand the scheduler tree until you see
the button for the calendar list you want to run.
2. Right-click the calendar list button and select Load List from the pop-up menu. The list
results are displayed in the right pane of the Job Scheduling Console.
Viewing Calendar Properties

To display a calendar in the database:

1. Run a list of calendars that contains the calendar you want to display. See “Displaying a
List of Calendars” for more information.
2. Right-click the calendar and select Properties from the pop-up menu.
The Properties - Calendar window is displayed. For information about this window, see
“Creating a Calendar in the Database” on page 267.

¶ Click OK to save the calendar in the database and close the window.
Modifying a Calendar in the Database
To modify a calendar in the database:
1. Run a list of calendars that contains the calendar you want to modify. See “Displaying a
2. Right-click the calendar and select Properties from the pop-up menu. The Properties -
Calendar window is displayed.
3. Make your changes. For information about this window, see “Creating a Calendar in the
Database” on page 267.

¶ Click OK to save the calendar in the database and close the window.
Deleting Calendars
To delete calendars in the database:
1. Run a list of calendars that contains the calendar you want to delete. See “Displaying a
¶ To delete one calendar, right-click the calendar.
¶ To delete multiple calendars in a range, hold down the Shift key, click the first and
last calendars in the range, then right-click on one of the selected calendars.
¶ To delete multiple calendars that are not in a range, hold down the Ctrl key, click
each calendar, then right-click one of the selected calendars.
calendar.

4. Click OK to delete the calendar in the database or click Cancel to cancel the delete
operation.
270 Version 8.1

21
Managing Resources, Prompts, and
Parameters
Managing Resources
Resources represent any type of resources on your system such as tape drives,
communication lines, databases, or printers, that are needed to run a job. Resources can be
physical or logical. After defining a resource in the Workload Scheduler database, it can be
used as a dependency for jobs and job streams that run on the workstation or workstation
class for which the resource is defined.
Prompts, and Parameters

21. Managing Resources,
For example, you can define a resource called TAPES with a value of 2 and define jobs that
require both tape drives as a dependency. Jobs with this dependency cannot run concurrently,
because each time a job is run the TAPES resource is in use.
Creating a Resource
To create resources in the database, you use the Properties - Resource in Database
window.
To create a new resource:

2. Click the New Resource button in the toolbar or right-click the scheduler button and
select New Resource from the pop-up menu. The Properties - Resource in Database
Figure 151. Properties - Resource in Database Window
Use the information in Table 99 to complete the window.

Table 99. Properties - Resource in Database Window Information
Name The name of the resource. The name must start with a letter and can
contain alphanumeric characters, dashes, and underscores. The name
can contain up to eight characters.

Table 99. Properties - Resource in Database Window Information (continued)
Description A description of the resource.
Quantity The number of available resource units. Values can be 0 through
1024.
Workstation Specify the name of the workstation or workstation class on which
the resource is used. You can type a name directly or you can click
Find and select a workstation or workstation class from a list. For
information about using the Find button, refer to “Finding Objects”
on page 199.

¶ Click OK to close the window and save the new resource in the database.
¶ Click Cancel to close the window without saving the resource in the database.
Displaying a List of Resources
To display a list of resources in the database:
2. Expand the branches below the scheduler until you see the button for the resource list
you want to run. See “Creating a List of Resources” on page 193 for information about
creating resource lists.
3. Right-click the resource list button and select Load List from the pop-up menu. The list
Figure 152. Resource List Window
4. In the Workstation field, enter the name of the workstation or workstation class on
which the resource is used.
5. In the Resource field, enter the name of the resource.
6. In the Quantity field, enter the number of available resource units.
Displaying a Resource
To display a resource in the database:
272 Version 8.1

1. Run a list of resources that contains the resource you want to display. See “Displaying a
List of Resources” on page 272 for more information.
2. In the list results, double-click the resource you want to display or right-click the
resource and select Properties from the pop-up menu.
This opens the resource in the Properties - Resource In Database window. For
information about this window, see “Creating a Resource” on page 271.
Modifying a Resource
To modify a resource in the database:
1. Run a list of resources that contains the resource you want to modify. See “Displaying a
2. In the list results, double-click the resource you want to modify or right-click the
resource and select Open from the pop-up menu.
This opens the resource in the Properties - Resource In Database window.
3. Make your changes. For information about this window, see “Creating a Resource” on
page 271.

¶ Click OK to save the resource in the database and close the window.
¶ Click Cancel to close the window without saving the resource in the database.
Deleting Resources
To delete resources in the database:
1. Run a list of resources that contains the resource you want to delete. See “Displaying a
¶ To delete one resource, right-click the resource.
¶ To delete multiple resources in a range, hold down the Shift key, click the first and
last resources in the range, then right-click on one of the selected resources.
¶ To delete multiple resources that are not in a range, hold down the Ctrl key, click
each resource, then right-click one of the selected resources.
3. Select the Delete command from the pop-up menu. A confirmation message is displayed
for each resource.
4. Click OK to delete the resource in the database or click Cancel to cancel the delete
operation.
Creating a Resource by Copying Another Resource
To create a new resource in the database using a copy of another resource:
1. Run a list of resources that contains the resource you want to copy. See “Displaying a
2. In the list results, right-click the resource you want to copy and select Create another
This displays a copy of the resource in the Properties - Resource In Database window.
3. In the Name text box, change the name to the name of the new resource.

4. Change the other text boxes as needed to define the new resource. For information about
this window, see “Creating a Resource” on page 271.
¶ Click OK to save the resource in the database and close the window.
¶ Click Cancel to close the Properties - Resource In Database window without saving
the resource in the database.
Managing Prompts in the Database

Prompts can be used as dependencies for jobs and job streams. A prompt must be answered
affirmatively for the dependent job or job stream to launch. For example, you can issue a
prompt to make sure that a printer is online before a job that prints a report runs.
There are two types of prompt:

Ad hoc prompt
This is defined within the properties of a job or job stream and is unique to that job
or job stream.
Predefined prompt
This is defined in the Workload Scheduler database and can be used by any job or
job stream.
Creating a Prompt
To create prompts in the database, you use the Properties - Prompt window.
To create a new prompt:

1. In the tree view of the Job Scheduling Console, right-click the scheduler button and
select New Prompt from the pop-up menu. The Properties - Prompt window is
displayed.
Figure 153. Properties - Prompt Window
2. In the Name field, enter the name of the prompt. The name must start with a letter and
can contain alphanumeric characters, dashes, and underscores. The name can contain up
to eight characters.
3. In the Text field, enter the text of a prompt.
The default behavior of a prompt is to display a message and wait for a reply. If the
string begins with a colon (:), the message is displayed but no reply is necessary. If the
string begins with an exclamation mark (!), the message is not displayed but it requires a
reply. You can include backslash n (\n) within the text to create a new line.
¶ Click OK to close the window and save the new prompt in the database.
¶ Click Cancel to close the window without saving the prompt in the database.
274 Version 8.1

Displaying a List of Prompts
To display a list of prompts in the database:
1. In the tree view of the Job Scheduling Console, expand the scheduler tree.
2. Right-click the prompt list button and select Load List from the pop-up menu. The list

Figure 154. Prompts List Window
The Name and Text columns specify the name and text content of the prompts.
Displaying a Prompt
To display a prompt in the database:
1. Run a list of prompts that contains the prompt you want to display. See “Displaying a
List of Prompts” for more information.
2. In the list results, double-click the prompt you want to display or right-click the prompt
and select Open from the pop-up menu.
This opens the prompt in the Properties - Prompt window. For information about this
window, see “Creating a Prompt” on page 274.
Modifying a Prompt in the Database
To modify a prompt in the database:
1. Run a list of prompts that contains the prompt you want to modify. See “Displaying a
List of Prompts” for more information.
2. In the list results, double-click the prompt you want to modify or right-click the prompt
and select Open from the pop-up menu.
This opens the prompt in the Properties - Prompt window.
3. Make your changes. For information about this window, see “Creating a Prompt” on
page 274.
¶ Click OK to save the prompt in the database and close the window.
¶ Click Cancel to close the window without saving the prompt in the database.

Deleting Prompts
To delete prompts in the database:
1. Run a list of prompts that contains the prompt you want to delete. See “Displaying a List
of Prompts” on page 275 for more information.
¶ To delete one prompt, right-click the prompt.
¶ To delete multiple prompts in a range, hold down the Shift key, click the first and
last prompts in the range, then right-click on one of the selected prompts.
¶ To delete multiple prompts that are not in a range, hold down the Ctrl key, click
each prompt, then right-click one of the selected prompts.
prompt.
4. Click OK to delete the prompt in the database or click Cancel to cancel the delete
operation.
Managing Parameters
Parameters are useful to substitute values into your jobs and job streams. Since parameters
are stored in the Workload Scheduler database, all jobs and job streams that use the
particular parameter are updated automatically when the value changes. For scheduling, a
parameter can be used as a substitute for all or part of:
¶ File dependency path names
¶ Text for prompts
¶ Logon, command, and script file names
When using a parameter in a job script, the value is substituted at run time. In this case, the
parameter must be defined on the workstation where it will be used. Parameters cannot be
used when scripting Extended Agent jobs.
Note: Be careful when renaming a parameter because it might be part of a dependency for a
job scheduler object in the database. If this is the case, and you rename it, any action
you perform that refers to the old name will return an error.
Creating a Parameter
To create parameters in the database , you use the Properties - Parameter window.
To create a new parameter:

1. In the Job scheduling Console, right-click the scheduler engine button and select New
Parameter from the pop-up menu. The Properties - Parameter window is displayed.
2.
276 Version 8.1

Figure 155. Properties - Parameter Window
3. In the Name field, enter the name of the parameter. The name must start with a letter
and can contain alphanumeric characters, dashes, and underscores. The name can contain
up to eight characters.
4. In the Value field, enter the value assigned to the parameter. Do not include the names
of other parameters.
5.

¶ Click OK to close the window and save the new parameter in the database.
¶ Click Cancel to close the window without saving the parameter in the database.

Displaying a List of Parameters
To display a list of parameters in the database:
1. In the tree view of the Job Scheduling Console, expand the scheduler tree.
2. Right-click the parameter list button and select Load List from the pop-up menu. The
list results are displayed in the right pane of the Job Scheduling Console.
Figure 156. Parameter List Window
The Name and Value columns show the names and values of the parameters.
Displaying a Parameter
To display a parameter in the database, follow these steps:
1. Run a list of parameters that contains the parameter you want to display. See “Displaying
a List of Parameters” for more information.
2. In the list results, double-click the parameter you want to display or right-click the
parameter and select Open from the pop-up menu.

This opens the parameter in the Properties - Parameter window. For information about
this window, see “Creating a Parameter” on page 276.
Modifying a Parameter in the Database
To modify a parameter in the database:
1. Run a list of parameters that contains the parameter you want to modify. See “Displaying
a List of Parameters” on page 277 for more information.
2. In the list results, double-click the parameter you want to modify or right-click the
parameter and select Open from the pop-up menu.
This opens the parameter in the Properties - Parameter window.
3. Make your changes. For information about this window, see “Creating a Parameter” on
page 276.
¶ Click OK to save the parameter in the database and close the window.
¶ Click Cancel to close the window without saving the parameter in the database.
Deleting Parameters
To delete parameters in the database:
1. Run a list of parameters that contains the parameter you want to delete. See “Displaying
a List of Parameters” on page 277 for more information.
¶ To delete one parameter, right-click the parameter.
¶ To delete multiple parameters in a range, hold down the Shift key, click the first and
last parameters in the range, then right-click one of the selected parameters.
¶ To delete multiple parameters that are not in a range, hold down the Ctrl key, click
each parameter, then right-click one of the selected parameters.
3. Choose Delete from the pop-up menu. A confirmation message is displayed for each
parameter.
4. Click OK to delete the parameter in the database or click Cancel to cancel the delete
operation.
278 Version 8.1

22. Plan Tasks
22
Plan Tasks
Using Plan Lists
Plan lists display objects in the Workload Scheduler plan. When you create a list, you give it
a name and specify filtering criteria. When you run a list, it displays a filtered list of objects
in the plan. Each list you create is represented by an button in the tree view of the Job
Scheduling Console.
You can create groups to organize your lists. After installation there are a default set of basic
plan lists in a group named Default Plan Lists.
Creating a Group for Plan Lists
To create a group for plan lists:
1. In the Job Scheduling view, expand the scheduler engine button.
2. From the scheduler branch, highlight the group you want to contain this list.
3. Click Create a Group of Lists in the toolbar or right-click the scheduler engine button
and select Create Group from the pop-up menu.
Lists in the toolbar or right-click the existing group button and select Create Group
4. In the Name field, enter the name of the list group. The name can contain up to 40
characters, starting with a letter.
5. Click OK to close the window and save the new group.
Creating a Plan List of Workstations
To create a plan list that displays workstations:

3. Click List Workstations in Plan in the toolbar or right-click the scheduler engine button
or group button and select Create Plan List , then Workstation from the pop-up menu.
The Properties - Plan Workstation List window is displayed.
Figure 158. Properties - Plan Workstation List Window
4. In the Name field, enter a name for the list.

5. To have the list results refreshed automatically, select Periodic Refresh and specify a
refresh interval in seconds in the Period (secs) text box.
6. To filter the list results, specify a workstation name in the Workstation Name text box
and a scheduler domain name in the Domain Name text box. The workstation and
domain names can contain wildcard characters. Leaving the text box blank results in an
unfiltered list.

¶ Click OK to save the list and close the window. The list button is added to the group
you selected.
Creating a Plan List of Domain Status
To create a plan list to display domains:
3. Right-click the scheduler engine button or group button and select Create Plan List,
then Domain Statusfrom the pop-up menu.
The Properties - Domain Status List window is displayed.
Figure 159. Properties - Domains Status List Window
4. In the Name field, enter a name for the list
280 Version 8.1

22. Plan Tasks
5. If you want the list results refreshed automatically, select Periodic Refresh and specify a
refresh interval in seconds in the Period (secs) text box.
6. To filter the list results, specify a domain name in the Domain Name text box. The
domain name can contain wildcard characters. Leaving the text box blank results in an
unfiltered list.

you selected.
Creating a Plan List of Job Stream Instances
To create a plan list of job stream instances:
3. Click List Job Stream Instances in the toolbar or right-click the scheduler button and
select Create Plan List, then Job Stream Instance from the pop-up menu.
The Properties - Job Stream Instance List General page is displayed.
General Page
Figure 160. Properties - Job Stream Instance List General Page
Use the information in Table 100 to create the list and filter the results.
Table 100. Properties - Job Stream Instance List General Information
Name A name for the list.

Table 100. Properties - Job Stream Instance List General Information (continued)
Period Refresh Options Select the Periodic Refresh check box if you want the list results
refreshed automatically and specify a refresh interval in seconds in the
Period (secs) text box.
Filter Criteria Job Stream
Specify a job stream name.
Workstation Name
Specify a workstation name.
Status
To use the Job Scheduling Console status to filter job stream
instances, select this option and select the status type from the
drop-down list.
Internal Status
To use Workload Scheduler internal status to filter job stream
instances, select this option and select the status type from the
drop-down list.
Priority
Use the From and To text boxes to specify a priority range of
job streams to display. Only job streams with priorities within the
range are displayed. Possible priority values are 0 through 101,
where 101 is the highest priority. Click Hold to select priority 0,
High to select priority 100, or Go to select priority 101.
Figure 161. Properties - Job Stream Instance List Time Restrictions Page
282 Version 8.1

22. Plan Tasks
Use the information in Table 101 to complete this window.
Table 101. Properties - Job Stream Instance List Time Restrictions Information
Start Time A range for the start date and time of the job stream instances you
want to display.
From Date
Use the Date and Time text boxes to specify the beginning of
a range of time. Only job streams that start running within this
range are displayed.
To Date
Use the Date and Time text boxes to specify the end of a
range of time. Only job streams that start running within this
Finish Time Specify a range for the finish date and time of the job stream
instances you want to display.
From Date
a range of time. Only job streams that finish running within
this range are displayed.
To Date
range of time. Only job streams that finish running within this
Select Dependencies in the left pane. The Dependencies page is displayed.
Dependencies Page
Figure 162. Properties - Job Stream Instance List Dependencies Page

Use this window to define a list of jobs from the plan based on dependency types. Only job
stream instances with the specified dependencies are displayed. Note that all the fields in
this window act as filters, so that all fields specified must be valid for a job stream to be
chosen for display.
For example, to display all job streams with a file dependency, enter an asterisk (*) in the
File Dependency / File Name field.
To display all job streams with both a file and a prompt dependency, enter an asterisk (*) in
the File Dependency / File Name field and in the Prompt Dependency / Prompt Name
field.
Note: In this case, only job streams with both a file and a prompt dependency are
displayed. Job Streams with only prompt dependencies or only file dependencies are
not displayed.
Use the information in Table 102 to define the list of jobs from the plan.
Table 102. Properties - Job Stream Instance List Dependency Information
Job/Job Stream Dependency The name of a job or job stream dependency.
In the Workstation field, specify the name of a workstation.
In the Job Stream field, specify the name of a job stream.
In the Job field, specify the name of a job.
Resource Dependency The name of a resource dependency.
In the Resource field, specify the name of a resource.
File Dependency The name of a file dependency.
In the File Name field, specify the name of a file.
Prompt Dependency The name of a prompt dependency.
In the Name field, specify the name of a prompt.
In the Prompt Number field, specify the number of a prompt.

you selected.
Creating a Plan List of Job Instances
To create a plan list to display job instances:
3. Click the List Job Instances button on the toolbar. Alternatively, you can right-click the
scheduler engine button or group button and select Create Plan List, then Job Instance
The Properties - Job Instance List General page is displayed.
284 Version 8.1

22. Plan Tasks
General Page
Figure 163. Properties - Job Instance List General Page
Use the information in Table 103 to create the list and filter the results.
Table 103. Properties - Job Instance List General Information
Period Refresh Options Select the Periodic Refresh check box if you want the list results
refreshed automatically and specify a refresh interval in seconds in the
Period (secs) text box.

Table 103. Properties - Job Instance List General Information (continued)
Filter Criteria Job Name
Specify a job name.
Job Stream
Specify a job stream.
Workstation (Job Stream)
Specify a workstation name.
Login
Specify a login name.
Status
To use Job Scheduling Console status to filter job instances,
select this option and select the status type from the drop-down
list.
Internal Status
To use Workload Scheduler internal status to filter job instances,
select this option and select the status type from the drop-down
list.
Recovery Options
Select a job recovery option using the option buttons. Valid
options are Stop, Continue, Rerun, and None.
Priority
Use the From and To text boxes to specify a priority range of
job instances to display. Only jobs with priorities within the
range are displayed. Possible priority values are 0 through 101,
where 101 is the highest priority. Click Hold to select priority 0,
High to select priority 100, or Go to select priority 101.
Select Time Restrictions in the left pane. The Restrictions page is displayed.
286 Version 8.1

22. Plan Tasks
Figure 164. Properties - Job Instance List Time Restrictions Page

Table 104. Properties - Job Instance List Time Restrictions Information
Start Time A range for the start date and time of the job instances you want to
display.
From Date
Use the Date and Time text boxes to specify the beginning of a
range of time. Only jobs that start running within this range are
displayed.
To Date
Use the Date and Time text boxes to specify the end of a range
of time. Only jobs that start running within this range are
displayed.
Finish Time Specify a range for the finish date and time of the job instances you
want to display.
From Date
a range of time. Only jobs that finish running within this range
are displayed.
To Date
range of time. Only job streams that finish running within this
Select Dependencies in the left pane. The Dependencies page is displayed.

Dependencies Page
Figure 165. Properties - Job Instance List Dependencies Window
Use this window to define a list of jobs from the plan based on dependency types. Only job
instances with the specified dependencies are displayed. Note that all the fields in this
window act as filters, so that all fields specified must be valid for a job stream to be chosen
for display.
For example, to display all jobs with a file dependency, enter an asterisk (*) in the File
Dependency / File Name field.
To display all jobs with both a file and a prompt dependency, enter an asterisk (*) in the
File Dependency / File Name field and in the Prompt Dependency / Prompt Name field.
Note: In this case, only jobs with both a file and a prompt dependency are displayed. Job
instances with only prompt dependencies or only file dependencies are not displayed.
Use the information in Table 105 to define the list of jobs from the plan.
Table 105. Properties - Job Instance List Dependency Information
Job/Job Stream Dependency The name of a job or job stream dependency.
In the Job Stream field, specify the name of a job stream.
In the Job field, specify the name of a job.
Resource Dependency The name of a resource dependency.
In the Resource field, specify the name of a resource.
288 Version 8.1

22. Plan Tasks
Table 105. Properties - Job Instance List Dependency Information (continued)
File Dependency The name of a file dependency.
In the File Name field, specify the name of a file.
Prompt Dependency The name of a prompt dependency.
In the Name field, specify the name of a prompt.
In the Prompt Number field, specify the number of a prompt.

you selected.
Creating a Plan List of Resources
To create a plan list to display resources:
3. Click List Resources in Plan on the toolbar. Alternatively, you can right-click the
scheduler engine button or group button and select Create Plan List, then Resource
from the pop-up menu. The Properties - Plan Resource List window is displayed.
Figure 166. Properties - Plan Resource List Window

Table 106. Properties - Plan Resource List Information
Periodic Refresh Options Select Periodic Refresh if you want the list results refreshed
automatically and specify a refresh interval in seconds in the Period
(secs) field.
Filter Criteria In the Resource Name field, specify a resource name.
In the Workstation Name field, specify a workstation name.
The resource name and workstation name can contain wildcard
characters. Leaving the text box blank results in an unfiltered list.

you selected.
Creating a Plan List of Prompts
To create a plan list to display prompts:
then Prompt Status from the pop-up menu. The Properties - Prompt Status List window
is displayed.
Figure 167. Properties - Prompt Status List Window

Table 107. Properties - Prompt Status List Information
Periodic Refresh Options Select Periodic Refresh if you want the list results refreshed
automatically and specify a refresh interval in seconds in the Period
(secs) field.
290 Version 8.1

22. Plan Tasks
Table 107. Properties - Prompt Status List Information (continued)
Filter Criteria Prompt Name
To filter the list results, specify a prompt name in the Prompt
Name field. The prompt name can contain wildcard characters.
Leaving the text box blank results in an unfiltered list
Status
To filter the list using prompt status, use the Status check boxes to
select the status values. The status values are:
Asked
The prompt has been asked, but not answered.
Not Asked
The prompt has not been asked.
Answered Yes
The prompt has been answered with a “yes” response.
Answered No
The prompt has been answered with a “no” response.
If no status values are selected, prompts with all status values are
displayed.

you selected.
Creating a Plan List of Files
To create a plan list to display files:
then File Status from the pop-up menu. The Properties - File Status List window is
displayed.
Figure 168. Properties - File Status List window.
4. Type a name for the list in the Name field.


6. To filter the list results, enter a file name in the Filename field and a workstation name
in the Workstation Name field. The file name and workstation name can contain
wildcards. Leaving the field blank results in an unfiltered list.

you selected.
Modifying the Properties of a Plan List
To modify the properties of a plan list:
2. Select the list button you want to modify.
3. Right-click the list button and select Properties from the pop-up menu. This displays the
properties window for the list.
4. Make your modification in the properties window.

Deleting a Plan List
To delete a plan list:
2. Select the list button you want to delete.
3. Right-click the list button and select Delete from the pop-up menu. In the confirmation
window, click Yes to delete the list or Cancel to cancel the delete operation.
Detaching a Plan List Display
Detaching a list frees the right-window of the Job Scheduling Console to display other
objects. You can detach multiple lists to display several objects simultaneously. In Workload
Scheduler you can have up to seven detached windows at a time.
To detach a plan list display:

2. Select the list button you want to view in a detached window.
3. Right-click the list button and select Detach View from the pop-up menu. This displays
the separate window for the list display.
292 Version 8.1

22. Plan Tasks
Finding Objects in the Plan
Find tools are provided in the Job Scheduling Console to help you find objects in the plan.
The availability of the Find tool is shown by an ellipsis (...) located next to the text box
where you type an object name. In the following example of the Submit Job into Plan
window, the Job Name field provides a Find button (...).
Figure 169. Example of a Find Button
Clicking on the ellipsis opens a Find window.
Figure 170. Example Find Window
To use the Find window:

1. Type a search character string in the available fields. The search character string can
contain wildcard characters. Leaving the text box blank results in an unfiltered list.
2. Select other filter criteria using option buttons and check boxes.
3. Click Start. The results of the search are listed in the lower part of the Find window.
The Stop button is displayed while the list is being generated. Selecting Stop stops the
search. Any objects that have been found by the system until the Stop is clicked are
displayed.
4. Select an object in the list and do one of the following:
¶ Click Apply button to insert the name of the object in the text box on the parent
window. The Find window remains open to let you to select other objects from the
list.
¶ Double-click the object in the list or click OK to insert the name of the object in the
field in the parent window and close the Find window.

Managing Job Instances in the Plan
A job is a unit of work that is part of a job stream processed at a workstation. A job usually
refers to a command or script file. Job definitions in Workload Scheduler include all
necessary workstation and path locations, command names, file names, login IDs, user
permissions, priority levels, and recovery options necessary to successfully run a command
or script file with no manual intervention.
Table 108 shows the commands that you can issue against a job instance in the plan.
Table 108. Job Instance Commands
Use this command ... To do this ...
Properties View or modify the properties of a job instance. This includes viewing,
adding, modifying, or deleting the dependencies and time restrictions
on the job instance.
Dependencies View, add, modify, or delete the predecessors of a job instance.
Hold Set a job instance priority to 0, the internal status to HOLD, and the
Job Schedule Console status to HELD.
Release Counteracts the Hold command. The Release command reverts a job
instance priority to what it was before the Hold command ran.
Browse Job Log Opens a read-only view of the job instance log.
Rerun Rerun a job instance.
Cancel Job Cancels the planned running of a job instance.
Kill Stops a job instance.
Confirm Forces the status of a job instance to SUCC or ABEND.
Release All Dependencies Releases all dependencies to this job instance.
Get Job Output View the STDLIST of a job instance that has completed running.
Displaying a List of Jobs in the Plan

To display a list of jobs in the plan:
1. In the Job Scheduling view, expand the scheduler button.
2. Expand the branches below the scheduler until you see the button for the job instance
list you want to run.
3. Right-click the job instance list button and select Load List from the pop-up menu. The
The toolbar in the job instance view contains two special buttons.
This button ... Is called ... And does this ...
Moves the timeline display to the date you select on the

Go to popup calendar.
Moves the timeline display to the start time and day

Go to First offset of the earliest job instance.
List View of Job Instances

The List view provides a tabular display of job instances.
294 Version 8.1

22. Plan Tasks
Figure 171. Job Instance List View Window
Table 109 describes the column headings in the table part of the List view.
Table 109. Job Instance List View Columns
Job Name The name of the job instance.
Job Number For UNIX and MPE, this displays the process identification number
(PAID) of the job instance. For Windows NT, the job number is an
incremental number from the value found in the file nxtjobno in
TWShome.
Workstation (Job) The name of the workstation on which the job instance runs.
Job Stream The name of the job stream instance that owns this job instance.
Workstation (Job Stream) The name of the workstation on which the job stream instance runs.
Status The Job Scheduling Console status of the job instance. For more
information on job or job stream status refer to “Status Description and
Mapping” on page 387.
Internal Status The Workload Scheduler internal status of the job instance. For more
Information Additional information about the job instance.
Run Options The run options of the job instance.
Priority The priority of the job instance. The priority can be from 0 to 101. A
priority of 0 stops the job instance from running.
Every Frequency The repeat rate for this job instance, in hours and minutes.
Start Time The date, time and time zone when this job instance is scheduled to
start running.
Est. Duration The estimated run time of the job instance.
Actual Time The actual start time of the job instance.
Elapse Time The actual duration of the job instance.
Deadline Time The date, time and time zone after which the job instance cannot begin
running.
Job Stream Dep. The number of job stream dependencies for each job instance.
Job Dep. The number of job dependencies for each job instance.

Table 109. Job Instance List View Columns (continued)
Inet Dep. The number of internetwork predecessors to this job.
File Dep. The number of file dependencies for each job instance.
Prompt Dep. The number of prompt dependencies for each job instance.
Resource Dep. The number of resource dependencies for each job instance.
Timeline View of Job Instances

The Timeline view provides a table and a timeline display of job instances. Use the borders
and the arrows on the borders to adjust the sizes of the windows. Use the arrows at the top
of the timeline window to move the view in one hour and one day increments.
In the timeline window, the dark blue line represents the window of time a job instance can
start. A black bar at the end of the blue line represents the deadline time (UNTIL keyword).
The actual start time of the job instance is displayed by a black dot. A light blue bar within
the dark blue line represents the actual duration of the job instance. The start time, deadline
time, and duration time are also listed in the tabular window.
Figure 172. Job Instance List: Timeline View window.
Table 110 describes the column headings in the table part of the Timeline view.
Table 110. Job Instance Timeline View Columns
Name The name of the job instance.
Status The status of the job instance. For more information on job or job
stream status refer to “Status Description and Mapping” on page 387.
Started The actual start date and time of the job instance.
Runtime The actual duration of the job instance.
Start at The date and time of the planned start time for the job instance.
Duration The estimated duration time of the job instance.
Deadline The date and time of the deadline for the job instance.
296 Version 8.1

22. Plan Tasks
Modifying the Properties of a Job Instance
To display the properties of a job instance in the plan:
1. Right-click the job instance list button and select Load List from the pop-up menu. The
2. In the list results, right-click a job instance and select Properties from the pop-up menu.
In this particular example, the job is a Windows NT script. The window that is displayed
is therefore the Properties - Job NT Script window, showing the General page.
General Page
Figure 173. Properties - NT Script Instance General Page

Table 111. Properties - NT Script Instance General Information
This area ... Specifies ...
Job Name The name of the job instance.
Job Number The number of times this job instance has been run in the production
plan.
Workstation (Job) The name of the workstation on which the job instance is launched.
Job Stream The name of the job stream this job instance belongs to.
Workstation (Job Stream) The name of the workstation on which the job stream instance is
launched.
Login The user ID of the person running the job instance.
Priority The priority of the job instance. To change the priority, select a value
from the drop-down list or click Hold to select priority 0, High to
select priority 100, or Go to select priority 101. Possible priority values
are 0 through 101, where 101 is the highest priority. A priority value of
zero prevents the job instance from launching.

Table 111. Properties - NT Script Instance General Information (continued)
Status The Job Scheduling Console status of the job instance. For more
Internal Status The Workload Scheduler internal status of the job instance. For more
Information Additional information about the job instance.
Rerun Status Whether this job instance has been rerun.
Is Interactive Whether this job instance is an interactive job. This information appears
only for Windows NT jobs.
Requires Confirmation This job instance will not be run in the plan until user intervention is
used to submit it.
Actuals The actual start time and duration of the job instance, if it has
completed running.
Start Time
The actual start time of the job instance.
Duration
The actual duration of the job instance.
Recovery Options These fields display any automatic recovery action to be taken if the job
instance ends with a status of ABEND.
Stop, Continue, or Rerun
Specifies what action to take if this job instance ends with a status
of ABEND (the job instance ends with an error).
Job Name
Specifies the name of an error recovery job that will run if the
current job instance ends with a status of ABEND.
Workstation
Specifies the name of the workstation that owns the recovery job.
Message
Specifies the message text that displays if the job instance ends
with a status of ABEND.
Select Task in the left pane of the Properties - NT Script Instance window. The Task page is
displayed.
298 Version 8.1

22. Plan Tasks
Task Page
Figure 174. Properties - NT Script Instance Task Page
Note: The fields in this window change according to the type of job instance displayed.
Table 112. Properties - NT Script Instance Task Information
Task Type The task type of the job instance.
UNIX Script Information about the UNIX script file:
Script Displays the path and filename of the UNIX script.
UNIX Command Information about the UNIX command:
Command Displays the path and filename of the UNIX
command.
NT Script Information about the Windows NT script file:
Script Displays the path and filename of the Windows NT
script.
NT Command Information about the Windows NT command:
Command Displays the path and filename of the Windows NT
command.
MPE Job File Displays information about the MPE Job File:
Job File Displays the filename, group, and account for this
MPE job file.
MPE User Job Displays information about the MPE User Job:
User Job Displays the filename, group, and account for this
MPE User Job.
Extended Agent Task Displays information about the extended agent task:
Task Displays the filename or command for this extended
agent task.

Table 112. Properties - NT Script Instance Task Information (continued)
Workstation Class Script Displays information about the Workstation Class script file:
Script Displays the path and filename of the Workstation
Class script.
Workstation Class Displays information about the Workstation Class command:
Command Script Displays the path and filename of the Workstation
Class command.
SAP Job Displays information about the SAP task:
R/3 Job Identity
Use these fields to identify the R/3 job.
Job Name The R/3 job name.
Job ID This field is filled in when you submit the job to the
R/3 system.
Disable BDC Wait
Indicates if BDC Wait option for the job is disabled
Debug Options Indicates if additional debut information is included in
the job’s stdlist file.
Trace Indicates if a trace file dev_rfc is created in the
Workload Scheduler home directory.
Select Time Restrictions in the left pane of the Properties - Job Instance window. The Time
Restrictions page is displayed.
Figure 175. Properties - NT Script Instance Time Restrictions Page
300 Version 8.1

22. Plan Tasks
Table 113. Properties - NT Script Instance Time Restrictions Information
Start The earliest time the job instance will be launched. The job instance
will not be launched before this time. To change the time, make your
selections as follows:
Specify date and time
Select this option so you can specify a start date and a start
time.
Date Enter the start date or click the calendar button and select a
date from the drop-down calendar.
Time Enter a start time in the following format:
hh:mm am|pm
Deadline Specifies the latest time the job instance will be launched. The job
instance will not be launched after this time. To change the time,
make your selections as follows:
Select this option so you can specify a deadline date and
time.
Date Specify the deadline date or click the calendar button and
select a date from the drop-down calendar.
Time Specify a deadline time in the following format:
hh:mm am|pm
Time Zone Select a time zone from the drop-down list. The start time and
deadline time are in this time zone. If a time zone is not specified for
the job instance, all time values are in the time zone of the
workstation on which the job instance is launched. Note that the time
zone option must be activated in the global options file for this field
to be active.
Repeat Range Specifies the repeat rate of a job instance. Using the Repeat Range
field with the Start and Deadline times allows you to run a job
instance, for example, every 15 minutes from 1:00 pm to 5:00 pm.
Hours Enter the rate in hours that this job instance will
repeat.
Minutes Enter the rate in minutes that this job instance will
repeat.
Select Files in the left pane of the Properties - Job Instance window. The Files page is
displayed.

Files Page
Figure 176. Properties - NT Script Instance Files Page

Table 114. Properties - NT Script Instance Files Information
Filename The path and name of the file.
Workstation The workstation on which the file resides.
Release Status The status of the file dependency. The possible values are:
Not Released
The job instance is not released from the file dependency.
Released
The job instance is released from the file dependency.
To release the job instance from the file dependency, click in the
Status column and select Released from the drop-down menu.
Qualifiers The test conditions for the file dependency.
Internal Status The internal status of the file dependency. The possible values are:
Not Checked
The file dependency has not been checked.
Checking
The file dependency is being checked.
Exists
The file dependency is satisfied.
Does Not Exist
The file dependency is not satisfied.
To add a file dependency for the job instance:

1. Click the Add Row (+) button. This creates a new row in the list of file dependencies.
302 Version 8.1

22. Plan Tasks
2. Double-click the text box in the Filename column and type in a file name.
3. Double-click the text box in the Workstation column and click the ellipsis (...) to locate
and insert the name of the workstation on which the file exists or will be created.
4. Double-click the text box in the Qualifiers column and specify the test conditions for
the file dependency. On UNIX, the valid qualifiers are the same as UNIX test command
-s %p True if the file exists and its size is greater than zero.
On both UNIX and Windows NT, the expression %p inserts the file name.
Entering notempty is the same as entering -s %p. If no qualifier is specified, the default
is -f %p.
To remove a file dependency for the job instance, select the file row in the list and click the
Delete from Table (X) button.
Select Prompts in the left pane of the Properties - NT Script Instance window. The Prompts
page is displayed.

Prompts Page
Figure 177. Properties - NT Script Instance Prompts Page
To display ad hoc prompt dependencies, select Ad Hoc Prompt from the drop-down list in
the toolbar.
To display predefined prompt dependencies, select Predefined Prompt from the drop-down
list in the toolbar.

Table 115. Properties - NT Script Instance Prompts Information
Name The name of the prompt. Used for predefined prompts only.
Message Text The text of the prompt message.
Workstation The workstation that displays the prompt message text. For ad hoc
prompts only.
Number The number of the prompt dependency.
Release Status The release status of the prompt dependency. The possible values are:
Not Released
The job instance is not released from the prompt dependency.
Released
The job instance is released from the prompt dependency.
To release the job instance from the prompt dependency, click in the
304 Version 8.1

22. Plan Tasks
Table 115. Properties - NT Script Instance Prompts Information (continued)
Internal Status The internal status of the prompt dependency. The possible values are:
Not Asked
Asked
The prompt has been asked, but no response has been received.
Answered Yes
The prompt has been answered affirmatively and the job instance
dependency is released.
Answered No
The prompt has been answered negatively and the job instance
dependency is not released.
Reply The reply to the prompt dependency. To reply to the prompt, click in
this column and select Yes or No from the drop-down menu.
To add a prompt dependency for the job instance:

1. Click the Add Row (+) button. This creates a new row in the list of prompt
dependencies.
2. For a predefined prompt, double-click the text box in the Name column and click the
ellipsis (...) to locate and insert the name of a prompt.
3. For an ad hoc prompt, double-click in the text box in the Message Text column and type
in the text of the prompt.
The default behavior of a prompt is to display a message and wait for a reply. If the
string begins with a colon (:), the message is displayed but no reply is necessary. If the
string begins with an exclamation mark (!), the message is not displayed but it requires a
reply.
You can include backslash n (\n) within the text for new lines. You can also include one
or more Workload Scheduler parameters as part or all of the text string. To use a
To remove a prompt dependency for the job instance, select the prompt row in the list and
click the Delete from Table (X) button.
Select Resources in the left pane of the Properties - NT Script Instance window. The
Resources page is displayed.

Resources Page
Figure 178. Properties - NT Script Instance Resources Page

Table 116. Properties - NT Script Instance Resources Information
Resource The name of the resource.
Workstation The workstation on which the resource resides.
Quantity The number of units of a resource are needed by the job instance to
satisfy the dependency.
Available The number of units of the resource that are currently available.
Release Status The status of the resource dependency. The possible values are:
Not Released
The job instance is not released from the resource dependency.
Released
The job instance is released from the resource dependency.
To release the job instance from the resource dependency, click in the
To add a resource dependency for the job instance:

1. Click the Add Row (+) button. This creates a new row in the list of resource
dependencies.
2. In the Workstation column, click the ellipsis (...) to locate and insert the name of a
workstation.
3. Double-click in the text box in the Resource column and click Find to locate and insert
a resource name.
306 Version 8.1

22. Plan Tasks
4. Double-click in the text box in the Quantity column and specify the number of resource
units required by the job instance. The default is one.
To delete a resource dependency for the job instance, select the resource row in the list and
click the Delete from Table button.

¶ Click Apply to save the changes you made to the properties and leave the window open.
¶ Click OK to save the changes you made to the properties and close the window.
¶ Click Cancel to ignore any changes you made to the properties and close the window.
Displaying Dependencies of a Job Instance
To display the dependencies of a job instance, in a list, right-click the job instance you want
to display and select Dependencies from the pop-up menu. The Dependencies - Job Instance
You can display three types of dependency:

¶ Predecessors
¶ Internetwork predecessors
¶ Successors
Figure 179. Dependencies - NT Script Instance Successors Page
Predecessors Page
Table 117 describes the columns in the Predecessors page.
Table 117. Predecessors Page
Job Stream The name of a predecessor job stream instance or the job stream that
owns the predecessor job.
Job The name of a predecessor job instance.
Workstation The workstation of the predecessor job or job stream.

Table 117. Predecessors Page (continued)
Release Status The status of the predecessor dependency. The possible values are:
Released
The job instance is released from the predecessor dependency.
Not Released
The job instance is not released from the predecessor dependency.
To release the job instance from the predecessor dependency, click in
the Status column and select Released from the drop-down menu.
Internal Status The Workload Scheduler internal status of the predecessor job or job
stream instance. For more information about job or job stream status,
see “Status Description and Mapping” on page 387.
Internetwork Predecessors Page

Table 118 describes the columns in the Internetwork Predecessors page.
Table 118. Internetwork Predecessors Page
Network Agent The network agent workstation to which the predecessor belongs.
Dependency A freeform dependency or the job / job stream predecessor in the
format workstation#jobstream.job. The maximum length of this
field is 120 for freeform characters or 16 for workstation, 16 for the
job stream, and 40 for the job.
Release Status The release status of the internetwork predecessors. The possible states
are Released or Not Released.
stream.
Successors Page
Table 119 describes the columns in the Successors page.
Table 119. Successors Page
Workstation The workstation to which the successor belongs.
Job Stream The job stream to which the successor belongs.
Job The name of the successor job.
Release Status The release status of the Internetwork predecessors. The possible states
are Released or Not Released.
Internal Status The Workload Scheduler internal status of the successor job.

¶ Click Apply to save your changes in the plan and leave the window open.
¶ Click OK to save your changes in the plan and close the window.
Adding Predecessors to a Job Instance
To add a predecessor job or job stream to a job instance:
1.
308 Version 8.1

22. Plan Tasks
Display the predecessors of the job instance.
2. Click the Add Row button. This creates a new row in the list of predecessors.
3.
a. To specify a predecessor job instance, double-click in the text box in the Job column
and open a Find window to find the name of a predecessor job instance.
b. To specify a predecessor job stream instance, double-click in the text box in the Job
Stream column and open a Find window to find the name of a predecessor job
stream instance.

Deleting Predecessors from a Job Instance
To delete a predecessor job or job stream from a job instance:
1. Display the predecessors of the job instance. For information, see “Displaying
Dependencies of a Job Instance” on page 307.
2. Select the predecessor row in the list and click Delete from Table (X).

Displaying Successors of a Job Instance
To display the successors of a job instance in the plan:
1. Run a list of job instances that contains the job you want to display. See “Displaying a
List of Jobs in the Plan” on page 294 for more information.
2. In the list results, right-click the job instance you want to display and select
Dependencies from the pop-up menu.
The Dependencies - Job Instance window is displayed.
3. To display successor jobs and job streams, click Successors in the left pane.
For descriptions of the column headings in the Successors view, refer to “Deleting
Predecessors from a Job Instance”.

Holding a Job Instance
Changing a job instance to Hold sets the priority of the job instance to 0. Use the Release
command to change the priority back to its original level at the start of day.
Holding a Single Job Instance

To change a single job instance to Hold:
1. Run a list of job instances that contains the job instance you want to modify. See
“Displaying a List of Jobs in the Plan” on page 294 for more information.

2. Select All Scheduled Jobs List View.
3. Right-click the job instance you want to hold. To select more than one job instance, do
¶ To select a range of job instances in the list, hold down the shift key and left-click
the first and last job instances in the range. Right-click on one of the selected jobs to
open the popup menu.
¶ To select multiple job instances, hold down the control key and left-click on each job
instance. Right-click one of the selected job instances to open the popup menu.
4. Select Hold from the pop-up menu and click Yes in the confirmation window.
Holding All Job Instances

To hold all jobs in a group of job instances:
1. Run the list of job instances.
2. Select All Scheduled Jobs Timeline View.
3. Right-click the arrow next to the job instance group.
4. Click Hold All.
Releasing a Job Instance
The Release command reverses the Hold command. The Release command sets the priority
of a job back to the original setting at the start of the processing day. Do not confuse this
command with Release All Dependencies. It has no effect on job dependencies.
Releasing a Single Job Instance

To change a single job instance to Release:
2. Select All Scheduled Jobs List View.
3. Right-click the job instance you want release. To select more than one job instance, do
the first and last job instances in the range. Right-click on one of the selected job
instances to open the pop-up menu.
instance. Right-click one of the selected job instances to open the pop-up menu.
4. Select Release from the pop-up menu and click Yes in the confirmation window.
Releasing All Job Instances

To release all jobs in a group of job instances:
1. Run the list of job instances.
2. Select All Scheduled Jobs Timeline View.
3. Right-click the arrow next to the job instance group.
4. Click Release All.
310 Version 8.1

22. Plan Tasks
To show the predecessors of a job instance or its successors, right-click a job instance and
select Impact View from the pop-up menu, then either Predecessors or Successors. The
Impact View window is displayed.
Radial
Left
Right
Up
Down
Displaying Dependencies
To display a dependency of a job instance, right-click the job instance and select
Dependencies from the pop-up menu. Any dependent job instances are displayed.
Only the first level of dependent job instances is displayed. If you want to display more than
one level of dependency, you must right-click each dependent job instance in turn, selecting
Dependencies from the pop-up menu each time.
Note: If you display dependencies for more than one job, then refresh the display, only the
first level of dependent job instances is displayed.

Set as Root
At any time, you can reset the display using one particular job instance as the starting, or
root, job instance. To do this, right-click the job instance you want to use as the root job
instance and select Set As Root from the pop-up menu. The display is refreshed, showing
the selected job instance as the root instance.
To reset the display in a separate window, right-click the job instance you want to use as the
root job instance and select Set As Root In New Frame from the pop-up menu.
Browsing the Job Log
A job instance log file is created for each job instance launched by Workload Scheduler. Log
files contain header and trailer banners, echoed commands, and errors and warnings. These
files can be used to troubleshoot problems when jobs run.
To view the job instance log:

1. Run a list of job instances that contains the job instance you want to rerun. See
2. In the list results, right-click the job instance you want to rerun.
3. Select Browse Job Log from the pop-up menu. The job instance log file window is
displayed.
Figure 181. Job instance Log File Window
4. When you have finished, click Cancel to close the window.
312 Version 8.1

22. Plan Tasks
Rerunning a Job Instance
Note: You cannot rerun multiple job instances simultaneously.
To rerun a job instance:

1. Run a list of job instances that contains the job instance you want to rerun. See
2. In the list results, right-click the job instance you want to rerun.
3. Select Rerun from the pop-up menu. The Rerun Job window is displayed.
Figure 182. Rerun Job Window
4. To rerun the job directly, click OK. Otherwise, add any additional options.

Table 121. Rerun Job Window Information
Step The step from which you would like to rerun this job. The new job
instance will assume the name specified here.
From The job from which you want the job to run.
Workstation Name The workstation to run the job.
The following fields are only valid when using the From option:
Start Time The start date and time for the job.
Specify Date and Time
Select this checkbox to specify a start date and time for the job.
Date
Specify a start date for the job.
Time
Specify a start time for the job.
Time Zone A time zone for the job. The time zone option must be enabled for this
field to be active.

Table 121. Rerun Job Window Information (continued)
Priority The priority of the submitted job. To change the priority, enter a value
in the field or select one of:
Hold Sets the priority to 0. This job will not run until the priority is
raised.
Default
Sets the priority to the default priority of the selected job.
priority. A priority value of zero prevents the ad hoc job from launching.

Canceling a Job Instance
Canceling a job instance in the plan prevents the job from running. A canceled job instance
can be submitted anytime during the production cycle using an alias name. For more
information, see “Submitting a Job into the Plan” on page 336.
To cancel a job instance:

2. In the list results, right-click the job instance you want cancel. To select more than one
job instance, do one of the following:
the first and last job instances in the range. Right-click on one of the selected jobs to
3. Select Cancel Job from the pop-up menu and click Yes in the confirmation window.
Killing a Job Instance
Killing a job instance can only be done for UNIX command and UNIX script jobs. You
cannot kill Windows NT job instances.
To kill a UNIX job instance:

1. Run a list of job instances that contains the job instance you want to kill. See
2. In the list results, right-click the job instance you want kill. To select more than one job
instance, do one of the following:
the first and last job instances in the range. Right-click on one of the selected job to
open the pop-up menu.
314 Version 8.1

22. Plan Tasks
3. Select Kill from the pop-up menu and select Yes in the confirmation box. This kills a
currently running UNIX job.
Confirming a Job Instance SUCC or ABEND
Confirming a job instance status as SUCC or ABEND allows you to force the job instance
into a state where either its successors can continue processing or job recovery options are
started.
To confirm a job instance status to SUCC or ABEND:

1. Run a list of job instances that contains the job instance you want to confirm. See
2. In the list results, right-click the job instance you want to confirm. To select more than
one job instance, do one of the following:
the first and last job instances in the range. Right-click on the selected job instance
to open the pop-up menu.
3. Select Confirm, then SUCC or Confirm, then ABEND from the pop-up menu.
4. Select Yes in the confirmation box. This forces the status of the selected job instances to
SUCC or ABEND.
Releasing a Job Instance from Dependencies
Releasing a job instance from its dependencies removes dependencies on the following:
¶ Scheduled start time
¶ Predecessor jobs and job streams
¶ File dependencies
¶ Prompt dependencies
¶ Resource dependencies
To release a job instance from its dependencies:

1. Run a list of job instances that contains the job instance you want to release. See
2. In the list results, right-click the job instance you want release. To select more than one
job instance, do one of the following:
the first and last job instances in the range. Right-click on the selected job instance
to open the popup menu.
3. Select Release All Dependencies from the pop-up menu and click Yes in the
confirmation window. This allows the job instance to run unless there are other higher
priority jobs waiting to run, or if the job instance priority is below the fence for the
workstation.

Managing Job Stream Instances in the Plan
A job stream is a sequence of jobs, including the resources, prompts, parameters, and
workstations that support them, and scheduling information. The dependency of one job on
the completion of another determines the sequence of the jobs. The scheduling information,
such as the use of run cycles, calendars, and time restrictions, determines when and how
often the job stream instance is run.
Table 122describes the commands that you can use on a job stream instance in the plan.
Table 122. Job Stream Instance Commands
Use this command ... To do this ...
Open Opens the job stream instance in the Job Stream Instance Editor.
Properties View or modify the properties of a job stream instance. This includes
viewing, adding, modifying, or deleting the dependencies and time
restrictions on the job stream instance.
Dependencies View, add, modify, or delete the predecessors of a job stream instance.
Hold Sets a job stream instance priority to 0, the internal status to hold, and
the Job Schedule Console status to held.
Release Counteracts the Hold command. The Release command reverts a job
stream instance priority to what it was before the Hold command ran.
Impact View View the predecessors and successors of job stream instance.
Cancel Cancels the planned running of a job stream instance.
Limit View or modify the job limit of a job stream instance. This is the
number of jobs that can run concurrently in the job stream instance.
Priority View or modify the priority of a job stream instance.
Release All Dependencies Releases all dependencies to this job stream instance.
Re-submit Re-submits the job stream instance under an alias name.
Submit Submits a predefined or ad hoc job into the plan as part of the selected
job stream instance. See “Submitting Jobs and Job Streams into the
Plan” on page 335.
Select for Monitoring Specify that the running of this job is to monitored by Tivoli Business
Systems Manager.
Deselect for Monitoring Specify that the running of this job is no longer to be monitored by
Tivoli Business Systems Manager.
Displaying a List of Job Streams in the Plan

To display a list of job stream instances in the plan:
1. In the Job Scheduling view, expand the scheduler button.
2. Expand the branches below the scheduler button until you see the button for the job
stream instance list you want to run.
3. Right-click the job stream instance list button and select Load List from the pop-up
menu. The list results are displayed in the right pane of the Job Scheduling Console.
316 Version 8.1

22. Plan Tasks
Timeline View of Job Stream Instances
The Timeline view provides a table and timeline display of job stream instances in the plan.
Use the borders and the arrows on the borders to adjust the sizes of the windows. Use the
arrows at the top of the timeline window to move the view in one hour and one day
increments.
In the timeline window, the dark blue line represents the window of time a job stream
instance can start. A black bar at the end of the blue line represents the deadline time
(UNTIL keyword). The actual start time of the job stream instance is displayed by a black
dot. A light blue bar within the dark blue line represents the actual duration of the job
stream. The start time, deadline time, and duration time are also listed in the tabular window.
Figure 183. Job Stream Instances Timeline View Window
The toolbar in the job stream instance Timeline view contains two special buttons:
This button ... Is called ... And does this ...

Go to Moves the timeline display to the date you select on the
popup calendar.
Go to First Moves the timeline display to the start time and day offset
of the earliest job stream instance.

Table 123. Job Stream Instances Timeline View Window
Name The name of the job stream instance.
Status The status of the job stream instance. For more information on job or
job stream instance status refer to “Status Description and Mapping” on
page 387.
Started The actual start date and time of the job stream instance.
Runtime Displays the actual duration of the job stream instance.
Start at The date and time of the planned start time for the job stream instance.
Duration The estimated duration time of the job stream instance.
Deadline The date and time of the deadline for the job stream instance.

List View of Job Stream Instances
The List view provides a table display of job stream instances.
Figure 184. Job Stream Instances List View Window

Table 124. Job Stream Instances List View Window
Job Stream The name of the job stream instance.
Workstation The name of the workstation on which the job stream instance runs.
Status The Job Scheduling Console status of the job stream instance. For
more information on job or job stream instance status refer to “Status
Description and Mapping” on page 387.
Internal Status The Workload Scheduler internal status of the job stream instance. For
more information on job or job stream status refer to “Status
Information Additional information about the job stream instance.
Priority The priority of the job stream instance.
Num Jobs The total number of jobs in the job stream instance.
OK Jobs The number of jobs that have completed successfully in the job stream
instance
Limit The job limit of the job stream instance.
Original Job Stream The original name of the job stream instance, for job stream instances
that were submitted with an alias name.
Scheduled Start The date and time the job stream instance is scheduled to start running.
Actual Start The date and time the job stream instance started running.
Est. Duration The expected duration time of the job stream instance.
Actual Duration The actual duration time of the job stream instance.
Deadline Time The date and time of the job stream instance deadline.
Job Stream Dep. The number of predecessor job streams for the job stream instance. An
button indicates the lowest status of the predecessors.
Job Dep. The number of predecessor jobs of the job stream instance. An button
indicates the lowest status of the predecessors.
318 Version 8.1

22. Plan Tasks
Table 124. Job Stream Instances List View Window (continued)
Inet Dep. The number of internetwork predecessors to this job stream.
File Dep. The number of file dependencies of the job stream instance. An button
indicates the lowest status of the dependencies.
Prompt Dep. The number of prompt dependencies of the job stream instance. An
button indicates the lowest status of the dependencies.
Resource Dep. The number of resource dependencies of the job stream instance. An
button indicates the lowest status of the dependencies.
Displaying and Changing the Properties of a Job Stream Instance

To display the properties of a job stream instance in the plan:
1. Run a list of job stream instances that contains the job stream you want to display.
2. In the list results, double-click the job stream instance you want to display or right-click
the job stream instance and select Properties from the pop-up menu. The Properties -
Job Stream Instance General page is displayed.
General Page
Figure 185. Properties - Job Stream Instance General Page

Table 125. Properties - Job Stream Instance General Information
Name The name of the job stream instance.
Original Name The original name of a job stream instance that was submitted with an
alias name.

Table 125. Properties - Job Stream Instance General Information (continued)
Workstation Name The name of the workstation on which the job stream instance is
launched.
Workstation Class Name The name of the workstation class on which the job stream instance is
launched.
Priority The priority of the job stream instance. To change the priority, select a
value from the drop-down list or click Hold to select priority 0, High
to select priority 100, or Go to select priority 101. Possible priority
values are 0 through 101, where 101 is the highest priority. A priority
value of zero prevents the job stream instance from launching.
Limit The number of jobs that can be running at the same time in the
schedule. To change the job limit, select a value from the drop-down
list. Possible values are 0 through 1024. If you specify a job limit of 0,
no jobs within the job stream instance are launched.
Status The status of the job stream instance. For more information on job or
job stream status refer to “Status Description and Mapping” on
page 387.
Internal Status The Workload Scheduler internal status of the job stream instance. For
more information on job or job stream status refer to “Status
Information Additional information about the job stream instance.
Production Date The current date of the production cycle.
Carry Forward Indicates this job stream instance is carried forward to the next
processing day if it does not complete before the end of the current
production day.
Job Information Information about the job instances in the job stream instance.
Number Of Jobs
The total number of job instances.
Number of Jobs Not Run
The number of job instances that have not run.
Number Of Jobs Abended
The number of job instances that have abended.
Number of Successful Jobs
The number of job instances that have run successfully.
Number Of Executing Jobs
The number of job instances that are running.
Number of Failed Jobs
The number of job instances that have failed to run.
Time Information Information about the timing of the job stream instance.
Start Time
The time and day the job stream instance started running.
Runtime
The duration of the job stream instance.
Est. Duration
Specifies the estimated duration of the job stream instance.
320 Version 8.1

22. Plan Tasks
Figure 186. Properties - Job Stream Instance Time Restrictions Page

Table 126. Properties - Job Stream Instance Time Restrictions Information
Start The earliest time the job stream instance will be launched. The job
stream instance will not be launched before this time. To change the
time, make your selections as follows:
Date Specify the start date or click the calendar button and select a
Time Specify a start time in the following format:
hh:mm am|pm
Deadline The latest time the job stream instance will be launched. The job
stream instance will not be launched after this time. To change the
time, make your selections as follows:
Date Specify the deadline date or click the calendar button and select
a date from the drop-down calendar.
Time Specify a deadline time in the following format:
hh:mm am|pm

Table 126. Properties - Job Stream Instance Time Restrictions
Information (continued)
Time Zone Select a time zone from the drop-down list. The start time and deadline
time are in this time zone. If a time zone is not specified for the job
stream instance, all time values are in the time zone of the workstation
on which the job instance is launched.
Note: The time zone option must be activated in the global options
file for this field to be active
Select Files in the left pane. The Files page is displayed.
Files Page
Figure 187. Properties - Job Stream Instance Files Page

Table 127. Properties - Job Stream Instance Files Information
Filename The name of the file.
Release Status The status of the file dependency. The possible values are:
Not Released
The job stream instance is not released from the file dependency.
Released
The job stream instance is released from the file dependency.
To release the job instance from the file dependency, click in the
322 Version 8.1

22. Plan Tasks
Table 127. Properties - Job Stream Instance Files Information (continued)
Not Checked
Checking
Exists
Does Not Exist
Adding a File Dependency

To add a file dependency for the job stream instance:
2. Double-click in the text box in the Filename column and type in a file name.
3. Double-click in the text box in the Workstation column and open a Find window to
locate and insert the name of the workstation on which the file exists or will be created.
4. Double-click in the text box in the Qualifiers column and specify the test conditions for
On both UNIX and Windows NT, the expression %p, inserts the file name.
Entering notempty is the same as entering -s %p. If no qualifier is specified, the default
is -f %p.
Removing a File Dependency

To remove a file dependency for the job stream instance, select the file row in the list and
Select Prompts in the left pane. The Prompts page is displayed.

Prompts Page
Figure 188. Properties - Job Stream Instance Prompts Page
Select the type of prompt you want to display, ad hoc or predefined.

To display ad hoc prompt dependencies, select Ad Hoc Prompt from the drop-down list
in the toolbar.
To display predefined prompt dependencies, select Predefined Prompt from the
drop-down list in the toolbar.

Table 128. Properties - Job Stream Instance Prompts Information
Name The name of the prompt. This column is for predefined prompts only.
Workstation The workstation that will display the prompt message. This is for ad
hoc prompts only.
Number The number of the prompt dependency.
Status The status of the prompt dependency. The possible values are:
Not Released
The job stream instance is not released from the prompt
dependency.
Released
The job stream instance is released from the prompt dependency.
To release the job instance from the prompt dependency, click in the
324 Version 8.1

22. Plan Tasks
Table 128. Properties - Job Stream Instance Prompts Information (continued)
Not Asked
Asked
The has been asked, but no response has been received.
Answered Yes
The prompt has been answered affirmatively and the job stream
instance dependency is released.
Answered No
The prompt has been answered negatively and the job stream
instance dependency is not released.
Adding a Prompt Dependency

To add a prompt dependency for the job stream instance:
1. Click the Add Row button. This creates a new row in the list of prompt dependencies.
2. For a predefined prompt, double-click in the text box in the Name column and use the
Find tool to locate and insert the name of a prompt.
in the text of the prompt. The default behavior of a prompt is to display a message and
wait for a reply.
If the string begins with a colon (:), the message is displayed but no reply is necessary.
If the string begins with an exclamation mark (!), the message is not displayed but it
requires a reply. You can include backslash n (\n) within the text for new lines. You can
also include one or more Workload Scheduler parameters as part or all of the text string.
To use a parameter, place its name between carets (^).
Removing a Prompt Dependency

To remove a prompt dependency for the job stream instance, select the prompt row in the
list and click the Delete from Table button.

Resources Page
Figure 189. Properties - Job Stream Instance Resources Page

Table 129. Properties - Job Stream Instance Resources Window
Quantity The number of units of the resource that are needed by the job stream
instance to satisfy the dependency.
Release Status The status of the resource dependency. The possible values are:
Not Released
The job stream instance is not released from the resource
dependency.
Released
The job stream instance is released from the resource dependency.
To release the job instance from the resource dependency, click in the
Adding a Resource Dependency

To add a resource dependency for the job stream instance:
2. In the Workstation column, open a Find window to add the name of a workstation.
3. Double-click in the text box in the Resource column and open a Find window to add a
resource name.
units required by the job stream instance. The default is one.
326 Version 8.1

22. Plan Tasks
Deleting a Resource Dependency
To delete a resource dependency for the job stream instance, select the resource row in the

¶ Click Apply to save the changes you made to the properties and leave the window open.
¶ Click OK to save the changes you made to the properties and close the window.
Displaying Dependencies of a Job Stream Instance
To display the dependencies of a job stream instance, in a list, right-click the job stream
instance you want to display and select Dependencies from the pop-up menu. The
Dependencies - Job Stream Instance window is displayed.
You can display three types of dependency:

¶ Predecessors
¶ Internetwork predecessors
¶ Successors
The following figure shows the Predecessors page.
Figure 190. Dependencies Predecessors Page

Table 130. Dependencies - Job Stream Instance Predecessor Window
Job Stream The name of a predecessor job stream instance.
Job Specifies the name of a predecessor job instance.
Workstation Specifies the workstation of the predecessor job or job stream instance.
Release Status Specifies the status of the predecessor dependency. The possible values
are:
Released
The job stream instance is released from the predecessor
dependency.
Not Released
The job stream instance is not released from the predecessor
dependency.
To release the job stream instance from the predecessor dependency,
click in the Release Status column and select Released from the
drop-down menu.

Table 130. Dependencies - Job Stream Instance Predecessor Window (continued)
Internal Status Specifies the Workload Scheduler internal status of the predecessor job
or job stream instance. For more information on job or job stream
status refer to “Status Description and Mapping” on page 387.

Adding Predecessors to a Job Stream Instance
To add a predecessor job or job stream to a job stream instance:
1. Display the predecessors of the job stream instance. For information, see “Displaying
Dependencies of a Job Stream Instance” on page 327.
2. Click Add Row (+). This creates a new row in the list of predecessors.
3. To specify a predecessor job stream instance, double-click in the text box in the Job
Stream column and click Find to locate and insert the name of the predecessor job
stream instance.
4. To specify a predecessor job instance, double-click in the text box in the Job column
and click Find to locate and insert the name of a predecessor job instance.

Deleting Predecessors from a Job Stream Instance
To delete a predecessor job or job stream from a job stream instance:
1. Display the predecessors of the job stream instance. For information, see “Displaying
2. Select the predecessor row in the list and click the Delete from Table (X) button.

Displaying Successors of a Job Stream Instance
To display the successors of a job stream instance in the plan:
1. Run a list of job stream instances that contains the job stream you want to modify.
2. In the list results, right-click the job stream instance you want to display and select
Dependencies... from the pop-up menu.
The Dependencies - Job Stream Instance window is displayed.
3. To display successor jobs and job streams, click Successors in the left window.
For descriptions of the column headings in the Successors view, refer to “Displaying
328 Version 8.1

22. Plan Tasks
Holding a Job Stream Instance
Changing a job stream instance to Hold sets the priority of the job instance to zero. Use the
Release command to change the priority back to its original level at the start of the
processing day.
To change a job stream instance to Hold:

1. Run a list of job stream instances that contains the job stream instance you want to
modify. See “Displaying a List of Job Streams in the Plan” on page 316 for more
information.
2. Select the All Scheduled Job Streams List view.
3. Right-click the job stream instance you want to hold. To select more than one job stream
instance, do one of the following:
¶ To select a range of job stream instances in the list, hold down the shift key and
left-click the first and last job stream instances in the range. Right-click one of the
selected job stream instances to open the popup menu.
¶ To select multiple job stream instances, hold down the control key and left-click
each job stream instance. Right-click one of the selected job stream instances to open
the popup menu.
4. Select Hold from the pop-up menu and click Yes in the confirmation window.
Releasing a Job Stream Instance
The Release command is used to cancel the Hold command. The Release command sets the
priority back to the original setting at the start of the processing day. Do not confuse this
command with the Release All Dependencies command. This command has no effect on job
stream instance dependencies.
To change a job stream instance to Release:

information.
2. Select the All Scheduled Job Streams List view.
3. In the list results, right-click the job stream instance you want to release. To select more
than one job stream instance, do one of the following:
selected job stream instance to open the popup menu.
the popup menu.
4. Select Release from the pop-up menu and click Yes in the confirmation window.

To show the predecessors of a job instance or its successors, right-click a job stream
instance and select Impact View from the pop-up menu, then either Predecessors or
Successors. The Impact View window is displayed.
Radial
Left
Right
Up
Down
Canceling a Job Stream Instance

Canceling a job stream instance in the plan prevents the job stream instance from running. A
canceled job stream instance can be re-submitted using an alias name. For more information,
see “Re-submitting a Job Stream Instance” on page 333.
To cancel a job stream instance:

information.
2. In the list results, right-click the job stream instance you want cancel. To select more
330 Version 8.1

22. Plan Tasks

the popup menu.
3. Select Cancel from the pop-up menu and click Yes in the confirmation window.
Changing the Job Limit of a Job Stream Instance
To change the job limit of a job stream instance in the plan:
modify.
2. In the list results, right-click the job stream instance you want modify. To select more
selected job stream to open the popup menu.
the popup menu.
3. Select Limit from the pop-up menu.
The Change Limit - Job Stream Instance window is displayed.
Figure 192. Change Limit - Job Stream Instance Window
4. Specify a new job limit in the New Limit field.

¶ Click OK button to save the new job limit in the plan and close the window.
¶ Click Cancel button to close the window without saving the new job limit.
Changing the Priority of a Job Stream Instance
To change the priority of a job stream instance in the plan:
information.
2. In the list results, right-click the job stream instance you want modify or, to select more

the popup menu.
3. Select Priority from the pop-up menu.
The Change Priority - Job Stream Instance window is displayed.
Figure 193. Change Priority - Job Stream Instance Window
4. Select a new priority value from the drop-down list or click of the following buttons:
Table 132. Job Stream Instance Priorities
This button ... Sets the priority to ...
Hold 0
High 100
Go 101
Default Original value (see note)
Note: If a single job stream instance is selected, Default sets the priority to the original
value of the job stream instance at the start of the processing day. If multiple job
stream instances are selected, the priority of each job stream instance is set back
to what it was at start of the processing day.

¶ Click OK to save the new priority in the plan and close the window.
¶ Click Cancel to close the window without saving the new priority.
Releasing a Job Stream Instance from Dependencies
Releasing a job stream instance from its dependencies removes dependencies on the
following objects:
¶ Scheduled start time
¶ Predecessor jobs and job streams
¶ Resources
¶ Files
¶ Prompts
To release a job stream instance from its dependencies:

1. In a list, right-click the job stream instance you want release. To select more than one
job stream instance, do one of the following:
332 Version 8.1

22. Plan Tasks

selected job stream to open the popup menu.
the popup menu.
2. Select Release All Dependencies from the pop-up menu and click Yes in the
confirmation window.
This permits the job stream to run unless there are other prerequisites. For more information,
see:
¶ “Displaying and Changing the Properties of a Job Stream Instance” on page 319.
¶ “Changing the Job Limit of a Job Stream Instance” on page 331.
¶ “Changing the Priority of a Job Stream Instance” on page 331.
Re-submitting a Job Stream Instance
When you re-submit a job stream instance, a new job stream instance is created in the plan.
The new job stream instance is given an alias name.
To re-submit a job stream instance in the plan:

re-submit. See “Displaying a List of Job Streams in the Plan” on page 316 for more
information.
2. In the list results, right-click the job stream instance you want re-submit.
3. Select Re-Submit from the pop-up menu. The Re-Submit Job Stream Instance window is
displayed.
Figure 194. Re-Submit Job Stream Instance Window
4. Specify an alias name for the re-submitted job stream instance in the Alias field. If you
do not specify an alias, a name is generated by Workload Scheduler. For unexpanded
mode, Workload Scheduler starts with the first two characters of the original job stream
instance name followed by six random numbers. For expanded mode, the scheduler starts
with the first six characters of the original job stream instance name followed by ten
random numbers.
5. When you are finished:
¶ Click OK to re-submit the job stream instance and close the window.
¶ Click Cancel to close the window without re-submitting the job stream instance.
6. To change the properties of the re-submitted job stream, click Properties.... For
information about job stream instance properties, see “Displaying and Changing the
Properties of a Job Stream Instance” on page 319.

7. To change the predecessors for the re-submitted job stream, see “Adding Predecessors to
a Job Stream Instance” on page 328 and “Deleting Predecessors from a Job Stream
Instance” on page 328.
Submitting Jobs
For information about submitting jobs, see “Submitting Jobs and Job Streams into the Plan”
on page 335.
Monitoring Jobs
To select a job a job stream instance to be monitored by Tivoli Business Systems Manager,
right-click a job stream instance and select Select for Monitoring.
To deselect a job a job stream instance from monitoring by Tivoli Business Systems
Manager, right-click the job stream instance and select Deselect for Monitoring.
334 Version 8.1

22. Plan Tasks
Submitting Jobs and Job Streams into the Plan
This section provides information for submitting jobs and job streams into the plan for
impromptu processing. You can submit jobs and job streams that have been previously
defined to the database into the plan for impromptu processing. If the job or job stream is
already in the plan and you would like to schedule it again, you can submit it with an alias.
You can also submit ad hoc jobs to the plan. These are jobs that have not been defined in
the database. These jobs are created and submitted into the plan, but are never saved in the
database.
Submitting a Job Stream into the Plan
To submit a job stream that already exists in the database into the plan:
2. Right-click the scheduler engine button and select Submit then Job Stream from the
pop-up menu.
The Submit Job Stream into Plan window is displayed.
Figure 195. Submit Job Stream into Plan Window
3. Use the information in Table 133 to complete the fields in this window.
Table 133. Submit Job Stream into Plan Window
In this field ... Do this ...
Job Stream click the ellipsis to open a Find Job Stream window. This field is
completed automatically when you select a job stream using the
Find Job Stream window.
Workstation name This field is completed automatically when you select a job stream
using the Find Job Stream window.
Alias Specify an alias name for the submitted job stream instance. An
alias name is needed only if the plan contains a job stream instance
of the same name. If an alias name is necessary, and you do not
specify an alias, a name is generated by Workload Scheduler that
starts with the first two characters of the original job stream name
followed by six random characters.
4. To modify the properties of the submitted job stream, click Properties. For information
about job stream properties, see “Displaying and Changing the Properties of a Job
Stream Instance” on page 319.

¶ Click OK to submit the job stream and close the window.
¶ Click Cancel to close the window without submitting the job stream.

Submitting a Job into the Plan
To submit a job that is defined in the database into a job stream instance, you can use the
job stream instance popup menu or the Workload Scheduler engine popup menu.
If you submit the job from the scheduler engine pop-up menu, the job is submitted through a
default job stream instance named JOBS (see “Using a Default Job Stream”).
If you submit the job from the pop-up menu of a specific job stream instance, the job is
submitted through that specific job stream instance (see “Using a Specific Job Stream” on
page 337).
Using a Default Job Stream

To submit a job through a default job stream instance provided by Workload Scheduler:
1. In the Job Scheduling view, right-click the scheduler engine button to display the Submit
commands.
2. Select Submit then Job from the pop-up menu.
The Submit Job into Plan window is displayed.
Figure 196. Submit Job into Plan Window - Default Job Stream
3. Use the information in Table 134 to complete this window.

Table 134. Submit Job into Plan Window
Job Specifies the job to submit.
Name The name of the job that you want to submit to the
plan. If you need to, click the ellipsis (...) to display
a Find Job window where you can search for and
select a job to submit into the plan.
Workstation The name of the workstation on which the job
instance runs. This field is completed automatically
when you select a job using the Find Job window.
336 Version 8.1

22. Plan Tasks
Table 134. Submit Job into Plan Window (continued)
Into Specifies the job stream through which the job is submitted.
Job Stream Displays the name of the default job stream, JOBS,
provided by Workload Scheduler. You cannot
modify this.
Workstation Displays the name of the workstation on which the
job stream instance runs. You can specify a
different workstation. Click the ellipsis (...) to
display a Find Workstation Instance window if you
want to find a list of available workstations.
Alias An alias name for the submitted job. An alias is needed only if JOBS
contains another job of the same name. An error message is
displayed if JOBS already has a job instance of the same name.

¶ If you want to view or modify the properties of the job, click on Properties. See
“Viewing or Modifying the Properties of the Job to Submit” on page 338 for details.
¶ If you want to submit the job and close the window, click OK.
Using a Specific Job Stream

To submit a job through a job stream instance that you select, in a list, right-click a job
stream instance and select Submit, then Job from the pop-up men. The Submit Job into
Plan window is displayed.
Figure 197. Submit Job into Plan Window

Table 135. Submit Job into Plan Window - Specific Job stream
Job Specifies the job to submit.
Name Write the name of the job that you want to submit to
the plan. If you need to, click the ellipsis (...) to
display a Find Job window where you can search for
and select a job to submit into the plan.
Workstation Write the name of the workstation on which the job
instance runs. This field is completed automatically
when you select a job using the Find Job window.

Table 135. Submit Job into Plan Window - Specific Job stream (continued)
Into Displays read-only information about the job stream instance through
which you are submitting the job:
Job Stream The name of your selected job stream instance.
Workstation The name of the workstation that owns your selected
job stream instance.
Alias An alias name for the submitted job. An alias is needed only if the job
stream through which the job is submitted contains another job of the
same name. An error message is displayed if you submit a job to a job
stream instance that already has a job instance of the same name.

¶ If you want to view or modify the properties of the job, click on Properties. See
“Viewing or Modifying the Properties of the Job to Submit” for details.
¶ If you want to submit the job and close the window, click OK.
Viewing or Modifying the Properties of the Job to Submit
To view or modify the properties of a job, before submitting it into the plan, click
Properties in the Submit Job into Plan window. The Properties - Job Instance General page
is displayed.
General Page
Figure 198. Properties - Job Instance General Page
338 Version 8.1

22. Plan Tasks
Table 136. Properties - Job Instance General Window
Job Displays information about the submitted job.
Name The name of the submitted job.
Workstation The name of the workstation of the job.
Into Displays information about the job stream into which the job is
submitted.
Job Stream The name of the job stream into which the job is
submitted.
Workstation The name of the workstation of the job stream.
Task Type The task type of the submitted job.
Alias The alias of the submitted job, if defined.
raised.
Default
priority. A priority value of zero prevents the ad hoc job from
launching.

Table 136. Properties - Job Instance General Window (continued)
Recovery Options Displays information about the recovery options of the submitted job.
Action The recovery action for the submitted job. It can be
Stop, Continue, or Rerun.
Message The text of a recovery prompt. The text can contain
up to 64 characters. The default behavior of a prompt
is to display a message and wait for a reply. If the
string begins with a colon (:), the message is
displayed but no reply is necessary. If the string
begins with an exclamation mark (!), the message is
not displayed but it requires a reply.
Job
The name of a recovery job to run if the parent job
ABENDs. To change the name, click Find and select
a job from a list. Recovery jobs are run only once for
each ABENDed instance of the parent job.
Workstation The name of the workstation on which the recovery
job runs. The name is entered automatically when
you select a recovery job.
Not all jobs are eligible to have recovery jobs run on
a different workstation. Follow these guidelines:
¶ If either workstation is an extended agent, it must
be hosted by a domain manager or a fault-tolerant
agent that runs in Full Status mode.
¶ The recovery job’s workstation must be in the
same domain as the parent job’s workstation.
¶ If the recovery job’s workstation is a
fault-tolerant agent, it must run in Full Status
mode.
Requires Confirmation Select this option to indicate that job completion must be confirmed by
the operator.
Select Task in the left pane of the window. The Task page is displayed.
340 Version 8.1

22. Plan Tasks
Task Page
Figure 199. Properties - Job Instance Task Page
The Task page is different for each type of job and operating system. These fields display
the task type, path, and the command or script file referenced by the job. These fields are
read only.
Select Time Restrictions in the left pane of the window. The Time Restrictions page.
Figure 200. Properties - Job Instance Time Restrictions Page

Table 137
Table 137. Properties - Job Instance Time Restrictions Window
Start The earliest time the job will be launched. The job will not be
launched before this time. To change the time:
Date
Specify a start date or click the calendar button and select a date
from the drop-down calendar.
Time
Specify a start time in the following format:
hh:mm am|pm
Deadline The latest time the job will be launched. The job will not be launched
after this time. To change the time:
Date
Specify the deadline date or click the calendar button and select a
Time
Specify a deadline time in the following format:
hh:mm am|pm
Time Zone If the Time Zone option is enabled, specify the time zone in which the
job runs. The start time and deadline time are in this time zone. For
more information about the time zone feature, see “Enabling Time
Zones in the Workload Scheduler” on page 385.
Repeat Range The repetition rate of the job. The job is launched multiple times at
this rate. Make your selections as follows:
Hours
The value can be 00 to 23.
Minutes
The value can be 00 to 59.
Select Files in the left pane of the window. The Files page is displayed
342 Version 8.1

22. Plan Tasks
Files Page
Figure 201. Properties - Job Instance Files Page

Table 138. Properties - Job Instance Files Window
Release Status The status of the file dependency. This field is read-only for submitted
jobs. The possible values are:
Not Released
The job stream instance is not released from the file
dependency.
Released
The job stream instance is released from the file dependency.
Not Checked
Checking
Exists
Does Not Exist

To add a file dependency for the job:
3. Double-click in the text box in the Workstation column and open a Find window to find
the name of the workstation on which the file exists or will be created.
Notes:
a. On both UNIX and Windows NT, the expression %p inserts the file name.
b. Entering notempty is the same as entering -s %p.
c. If no qualifier is specified, the default is -f %p.

To remove a file dependency for the job, select the file row in the list and click the Delete
from Table button.
Select Prompts in the left pane of the window. The Prompts page is displayed.
344 Version 8.1

22. Plan Tasks
Prompts Page
Figure 202. Properties - Job Instance Prompts Page
Displaying Ad Hoc Prompt Dependencies

To display ad hoc prompt dependencies, select Ad Hoc Prompt from the drop-down list in
the toolbar.

Table 139. Ad Hoc Prompt Dependencies
Workstation The workstation that displays the prompt message text.
Number The internal Workload Scheduler ID number of the prompt dependency.
Release Status The status of the prompt dependency. This field is read-only for
submitted jobs. The possible values are:
Not Released
Released
Not Asked
Asked
The prompt has been asked, but no response has been received.
Yes The prompt has been answered affirmatively and the job
No The prompt has been answered negatively and the job dependency
is not released.
Reply The reply to the prompt dependency.

Displaying Predefined Prompt Dependencies

Table 140. Predefined Prompt Dependencies
Name The name of the prompt.
Release Status The status of the prompt dependency. This field is read-only for
Not Released
Released
Not Asked
Asked
is not released.

To add a prompt dependency for the job instance:
Find to locate and insert the name of a prompt.
wait for a reply.
If the string begins with a colon (:), the message is displayed but no reply is necessary.
If the string begins with an exclamation mark (!), the message is not displayed but it
requires a reply. You can include backslash n (\n) within the text for new lines. You can
include one or more Workload Scheduler parameters as part or all of the text string. To
use a parameter, place its name between carets (^).

To remove a prompt dependency for the job, select the prompt row in the list and click the
Select Resources in the left pane of the window. The Resources page is displayed.
346 Version 8.1

22. Plan Tasks
Resources Page
Figure 203. Properties - Job Instance Resources Page

Table 141. Properties - Job Instance Resources Window
Quantity The number of units of the resource that are needed by the job to
satisfy the dependency.
Release Status The status of the resource dependency. This field is read-only for
Not Released
Released

To add a resource dependency for the job instance:
2. Double-click in the text box in the Workstation column and click Find to locate and
insert the name of a workstation.
3. Double-click in the text box in the Name column and click Find to locate and insert a
resource name.
units required by the job instance. The default is one.

To delete a resource dependency for the job instance, select the resource row in the list and
Select Predecessors in the left pane of the window. The Predecessors page is displayed.
Predecessors Page
Figure 204. Properties - Job Instance Predecessors Page

Table 142. Properties - Job Instance Predecessors Window
Job Stream The name of the predecessor job stream.
Job The name of job in the predecessor job stream.
Workstation The name of the predecessor job stream’s workstation.
Release Status The status of the predecessor job or job stream.
stream. For more information on job or job stream status refer to
“Status Description and Mapping” on page 387.
Adding a Predecessor
To add a predecessor for the job instance:
2. To specify a predecessor job stream, double-click in the text box in the Job Stream
column and click Find to locate and insert the name of a job stream.
3. To specify a predecessor job, double-click in the text box in the Job column and click
Find to locate and insert a resource name.
348 Version 8.1

22. Plan Tasks
Deleting a Predecessor
To delete a predecessor for the job instance, select the predecessor row in the list and click
the Delete from Table button.

¶ Click OK to submit the job and close the window.
¶ Click Cancel to close the window without submitting the job.
Submitting an Ad Hoc Job into the Plan
To submit an ad hoc job (a job that is not defined in the database) into a job stream
instance, you use the scheduler engine pop-up menu.
To submit a job that is defined in the database into a job stream instance, you use the job
stream instance popup menu or the scheduler engine popup menu.
To submit an ad hoc job into a job stream instance:

1. In a list, right-click a job stream instance and select Submit, then Ad Hoc from the
pop-up menu. The Submit Ad Hoc Job into Plan window is displayed.
Figure 205. Submit Ad Hoc Job into Plan Window
2. In the Task Type field, select the task type of the ad hoc job.
3. Click OK to specify the properties of this submitted ad hoc job.
The Properties - Job Instance General page is displayed.

General Page
Figure 206. Properties - Job Instance General Page

Table 143. Properties - Job Instance General Window
Job Displays information about the ad hoc job.
Alias
Specify an alias name for the ad hoc job, if necessary.
Workstation
Specify the name of the workstation of the ad hoc job.
Into Displays information about the job stream into which the ad hoc job is
submitted.
Job Stream
Specify the name of the job stream for the ad hoc job. The
workstation for this job stream instance is only displayed when
the Submit > Ad Hoc command was invoked from the Job
Stream Instance list. For the JOBS job stream, the Properties -
Job Instance window job instance will be submitted into the
JOBS job stream on the workstation for the job specified in the
field above.
Task Type The task type of the submitted ad hoc job.
Login The UNIX or Windows NT user ID that launches the ad hoc job.
350 Version 8.1

22. Plan Tasks
Table 143. Properties - Job Instance General Window (continued)
raised.
Default
priority. A priority value of zero prevents the ad hoc job from
launching.
Is Interactive Specify whether this is an interactive job or not. Interactive jobs are for
Windows NT only.
Recovery Options Displays information about the recovery options of the submitted ad
hoc job.
Action
Displays the recovery action for the submitted ad hoc job. It can
be Stop, Continue, or Rerun.
Message
Specify the text of a recovery prompt. The text can contain up to
64 characters. The default behavior of a prompt is to display a
message and wait for a reply. If the string begins with a colon (:),
the message is displayed but no reply is necessary. If the string
begins with an exclamation mark (!), the message is not displayed
but it requires a reply.
Job
Displays the name of a recovery job to run if the parent job
abends. To change the name, click the Find button and select a job
from a list. Recovery jobs are run only once for each abended
instance of the parent ad hoc job.
Workstation
Displays the name of the workstation on which the recovery job
runs. The name is entered automatically when you select a
recovery job.
Not all jobs are eligible to have recovery jobs run on a different
workstation. Follow these guidelines:
¶ If either workstation is an extended agent, it must be hosted
by a domain manager or a fault-tolerant agent that runs in
Full Status mode.
¶ The recovery job’s workstation must be in the same domain as
the parent job’s workstation.
¶ If the recovery job’s workstation is a fault-tolerant agent, it
must run in Full Status mode.
Requires Confirmation Select this option to indicate that ad hoc job completion must be
confirmed by the operator.
Select Task in the left pane of the window. The Task page is displayed.

Task Page
Figure 207. Properties - Job Instance Task Page
The Task view is different for each task type. To complete the fields and select options on
this page:
Table 144. Task Types
For this task type ... Go to page ...
UNIX Script and NT Script 352
UNIX Command and NT Command 353
MPE Job File 353
MPE User Job 353
Extended Agent 353
SAP Job 353
UNIX Script and NT Script

Complete the Script field as follows:
Specify the name of the file the ad hoc job runs. Enter the file name and any options and
arguments. For non-expanded databases, the field can contain up to 255 characters. For
For Windows NT ad hoc jobs, include the file extensions. Universal Naming Convention
(UNC) names are permitted. Do not specify files on mapped drives.
If spaces or special characters are included, other than slashes (/) and backslashes (\), the
entire string must be enclosed in quotes (″).
If the file name contains spaces, specify the name in another file that does not have spaces
in its name and use the second file’s name in this field.
352 Version 8.1

22. Plan Tasks
To include a parameter in the Script field:
¶ Place the cursor in the Script field where you want to insert the parameter and click
Add Parameter.
¶ The Find Parameters window is displayed.
¶ Specify a parameter name in the Find field. The name can contain wildcard characters.
¶ Select a parameter name in the list click OK.
UNIX Command and NT Command

In the Command field, specify the name of the command the ad hoc job runs. Specify the
command name and any options and arguments. For non-expanded databases, the field can
contain up to 255 characters. For expanded databases, it can contain up to 4095 characters.
Commands are run directly and the jobmanrc standard configuration script is not run.
To include a parameter in the Command field:

¶ Place the cursor in the Command field where you want to insert the parameter and
click Add Parameter.
¶ The Find Parameters window is displayed.
¶ Specify a parameter name in the Find field. The name can contain wildcard characters.
¶ Select a parameter name in the list click OK.
MPE Job File

Complete the Job File field by specifying the name of the MPE file the ad hoc job runs.
For example, JFILE4.JCL.CORP.
MPE User Job

Complete the User Job field by specifying the name from the JOB card of the MPE job.
For example, $userjob=UJOB5.
Extended Agent
In the Task field, enter the XAgent script path or file name or the XAgent command for this
job.
Click Add Parameter to add a predefined parameter to the task specification
SAP Job
For task type SAP Job, refer to the Tivoli Workload Scheduler Extended Agent for SAP/R3
User’s Guide for information about defining the task.
Select Time Restrictions in the left pane of the window. The Time Restrictions page is
displayed.

Figure 208. Properties - Job Instance Time Restrictions Page

Table 145. Properties - Job Instance Time Restrictions Window
Start The earliest time the ad hoc job will be launched. The ad hoc job will
not be launched before this time. To change the time:
Date
Specify the start date or click the calendar button and select a date
from the drop-down calendar.
Time
Specify a start time in the following format:
hh:mm am|pm
Deadline The latest time the ad hoc job will be launched. The ad hoc job will not
be launched after this time. To change the time:
Date
Specify the deadline date or click the calendar button and select a
Time
Specify a deadline time in the following format:
hh:mm am|pm
354 Version 8.1

22. Plan Tasks
Table 145. Properties - Job Instance Time Restrictions Window (continued)
Time Zone If the Time Zone option is enabled, specify the time zone in which the
ad hoc job runs. The start time and deadline time are in this time zone.
For more information about the time zone feature, refer to “Enabling
Time Zones in the Workload Scheduler” on page 385.
Repeat Range The repetition rate of the ad hoc job. The ad hoc job is launched
multiple times at this rate. To make your selections:
Hours
Specify the hours. The value can be 00 to 23.
Minutes
Specify the minutes. The value can be 00 to 59.
Select Files in the left pane of the window. The Files page is displayed.
Files Page
Figure 209. Properties - Job Instance Files Page

Table 146. Properties - Job Instance Files Window

Table 146. Properties - Job Instance Files Window (continued)
Release Status The status of the file dependency. This field is read-only for submitted
job instances. The possible values are:
Not Released
The ad hoc job is not released from the file dependency.
Released
The ad hoc job is released from the file dependency.
Not Checked
Checking
Exists
Does Not Exist

To add a file dependency for the ad hoc job:
3. Double-click in the text box in the Workstation column and click Find to add the name
of the workstation on which the file exists or will be created.
Notes:
a. On both UNIX and Windows NT, the expression %p, inserts the file name.
b. Entering notempty is the same as entering -s %p.
c. If no qualifier is specified, the default is -f %p.

To remove a file dependency for the ad hoc job, select the file row in the list and click the
Select Prompts in the left pane of the window. The Prompts page is displayed.
356 Version 8.1

22. Plan Tasks
Prompts Page
Figure 210. Properties - Job Instance Prompts Page
Displaying Ad Hoc Prompt Dependencies

Ad hoc prompt dependencies are displayed by default when the Prompts page is displayed.

Table 147. Ad Hoc Prompt Dependencies
Workstation The workstation that displays the prompt message text.
Release Status The status of the prompt dependency. This field is read only for
submitted job instances. The possible values are:
Not Released
The ad hoc job instance is not released from the prompt
dependency.
Released
The ad hoc job instance is released from the prompt dependency.
Not Asked
Asked
Yes The prompt has been answered affirmatively and the ad hoc job
No The prompt has been answered negatively and the ad hoc job
dependency is not released.
Reply The reply to the prompt dependency. This field is read-only for
submitted job instances.

Displaying Predefined Prompt Dependencies

Table 148. Predefined Prompt Dependencies
Name The name of the prompt.
Release Status The status of the prompt dependency. This field is read only for
Not Released
The ad hoc job instance is not released from the prompt
dependency.
Released
The ad hoc job instance is released from the prompt dependency.
Not Asked
Asked
is not released.
Reply The reply to the prompt dependency. This field is read only for
submitted job instances.

To add a prompt dependency for the ad hoc job instance:
Find to locate and insert the name of a prompt.
wait for a reply. If the string begins with a colon (:), the message is displayed but no
reply is necessary. If the string begins with an exclamation mark (!), the message is not
displayed but it requires a reply.
You can include backslash n (\n) within the text for new lines. You can also include one
or more Workload Scheduler parameters as part or all of the text string. To use a

To remove a prompt dependency for the ad hoc job, select the prompt row in the list and
Select Resources in the left pane of the window. The Resources page is displayed
358 Version 8.1

22. Plan Tasks
Resources Page
Figure 211. Properties - Job Instance Resources Page

Table 149. Properties - Job Instance Resources Window
Quantity The number of units of the resource that are needed by the ad hoc job
to satisfy the dependency.
Release Status The status of the resource dependency. This field is read-only for
Not Released
Released

To add a resource dependency for the ad hoc job instance:
2. Double-click in the text box in the Workstation column and click Find to add the name
of a workstation.
3. Double-click in the text box in the Name column and click Find to add a resource
name.
units required by the ad hoc job instance. The default is one.

To delete a resource dependency for the ad hoc job instance, select the resource row in the
Select Predecessors in the left pane of the window. The Predecessors page is displayed.
Predecessors Page
Figure 212. Properties - Job Instance Predecessors Page

Table 150. Properties - Job Instance Predecessors Information
Job Stream The name of the predecessor job stream.
Job The name of job in the predecessor job stream.
Workstation The name of the predecessor job stream’s workstation.
Release Status The status of the predecessor job or job stream.
stream. For more information on job or job stream status refer to
“Status Description and Mapping” on page 387.
Adding a Predecessor
To add a predecessor for the ad hoc job instance:
2. To specify a predecessor job stream, double-click in the text box in the Job Stream
column and click Find to locate and insert the name of a job stream.
3. To specify a predecessor job, double-click in the text box in the Job column and click
Find to locate and insert a resource name.
360 Version 8.1

22. Plan Tasks
Deleting a Predecessor
To delete a predecessor for the ad hoc job instance, select the predecessor row in the list and

¶ Click OK to submit the ad hoc job and close the window.
¶ Click Cancel to close the window without submitting the ad hoc job.
Managing Workstations in the Plan

The plan contains a list of all workstations that are going to be used in that days processing.
You can perform the following actions on a workstation in the plan:
¶ Display a list of workstations in the plan. This list contains a number of fields with
information about the workstation status.
¶ Change the job limit of a workstation instance
¶ Change the job fence of a workstation instance
¶ Start, stop, link, and unlink a workstation
Displaying a List of Workstations in the Plan
To display a list of workstations in the plan:
2. Expand the Default Plan lists group.
3. Right-click on the Status of All Workstations button and select Load List from the
pop-up menu.
Figure 213. Workstation Status List Window

Table 151. Workstation Status List Window
This column ... Shows ...
Name The workstation instance name.

Table 151. Workstation Status List Window (continued)
This column ... Shows ...
Jobman Running Whether or not the jobbing process on the workstation is running.
Link Status The current link status of the workstation. A workstation can either be
LINKED or UNLINKED.
Limit The total number of jobs that can be run concurrently on this
workstation.
Fence The job fence for this workstation. The job fence is the priority a job
must exceed to run on this workstation. Setting the fence to 40, for
example, prevents jobs with priorities of 40 or less from being
launched. Valid values are from 0 to 101.
Node The type of workstation and the type operating system of the
workstation in the following format:
os_wkstat
where os is one of the following:

WNT Windows NT.
UNX UNIX.
MPV MPE/V.
MPX MPE/IX.
Other Other workstation OS.
and where wkstat is one of the following:
FTA Fault-tolerant agent
Master Master
Manager Domain manager
S-Agent Standard agent
X-Agent Extended agent
Time Zone The time zone of the workstation.
Node Port The port address of the workstation.
CPU Type The scheduler workstation type. Valid values are MASTER, FTA,
SAGENT or XAGENT.
Host The scheduler physical workstation that is hosting this workstation
definition. This is only valid for Extended Agents and Network agents.
Run The run number of the production plan of the workstation. This is used
synchronize the workstations in a scheduler network.
Start Time The date and time the batchman process was started on the
workstation.
Jobman Init Whether or not the jobman process on the workstation has completed
its startup initialization. The value can be either YES or NO.
Method The method name, if this workstation is an extended agent or network
agent workstation.
Domain The name of the Workload Scheduler domain of the workstation.
Version The version of Workload Scheduler installed on this workstation.
Node Information Operating system information about the workstation.
Node Name The node name of the workstation
Displaying a Workstation Instance

To display a workstation instance in the plan:
362 Version 8.1

22. Plan Tasks
“Displaying a List of Workstations in the Plan” on page 361 for more information.
2. In the list results, right-click a workstation and select Properties from the pop-up menu.
The Properties - Workstation in Plan window is displayed.
Figure 214. Properties - Workstation in Plan Window
For descriptions of the field values, see “Displaying a List of Workstations in the Plan”
on page 361.
3. You can change the Limit and Fence values by entering new values in the fields. For
more information, see “Changing the Job Limit of a Workstation in the Plan” and
“Changing the Job Fence of a Workstation in the Plan” on page 364.

¶ Click Cancel to close the window without saving your changes.
Changing the Job Limit of a Workstation in the Plan
To change the job limit of a workstation instance in the plan:
1. Run a list of workstations in the plan that contains the workstation you want to modify.
2. In the list results, right-click the workstation you want to modify or, to select more than
one workstation, do one of the following:
¶ To select a range of workstations in the list, hold down the shift key and left-click
the first and last workstations in the range. Right-click on one of the selected
workstations to open the popup menu.
¶ To select multiple workstations, hold down the control key and left-click on each
workstation. Right-click one of the selected workstations to open the popup menu.
3. Select Limit from the pop-up menu.

The Change Limit - Workstation window is displayed.
Figure 215. Change Limit - Workstation Window
4. Specify a new job limit in the New Limit field.

¶ Click OK to save the new job limit in the plan and close the window.
¶ Click Cancel to close the window without saving the new job limit.
Changing the Job Fence of a Workstation in the Plan
To change the job fence of a workstation instance in the plan:
1. Run a list of workstation instances that contains the workstation you want to modify.
2. In the list results, right-click the workstation you want to modify, or, to select more than
one workstation, do one of the following:
¶ To select a range of workstations in the list, hold down the shift key and left-click
the first and last workstations in the range. Right-click on one of the selected
workstations to open the popup menu.
¶ To select multiple workstations, hold down the control key and left-click on each
workstation. Right-click each of the selected workstations to open the popup menu.
3. Select Fence from the pop-up menu. The Change Fence - Workstation window is
displayed.
Figure 216. Change Fence - Workstation Window
4. Specify a new job fence or click of the following buttons:

Hold None Sets the fence to 0.
Hold All Sets the fence to 101.
When you have finished.

¶ Click OK to save the new job fence in the plan and close the window.
¶ Click Cancel to close the window without saving the new job fence.
Starting a Workstation Instance
To start Workload Scheduler running on a workstation instance, in a list of workstations,
right-click the workstation you want to start and select Start from the pop-up menu.
Note: To start all the workstations in a domain, refer to “Starting the Workstations in a
Domain” on page 366.
364 Version 8.1

22. Plan Tasks
Missing or Incorrect Components
Occasionally, when you start a workstation, an error message might be displayed
because of a missing or incorrect components file entry. This is because either the
location for the components file is not the default and the variable
$UNISON_COMPONENT_FILE is not set, or the entry in the
/usr/unison/component file is incorrect (location incorrect).
To fix the problem, create a copy of the components file in the

/usr/unison/components directory. If one already exists, modify the contents to
match what is installed. Make sure you specify the path name of the home directory of
the installed user. If your home directory is linked to another file system, make sure
both references are listed in the file.
Stopping a Workstation Instance

To stop Workload Scheduler running on a workstation instance, in a list of workstations,
right-click the workstation you want to stop and select Stop from the pop-up menu.
Note: To stop all of the workstations in a domain, refer to “Stopping the Workstations in a
Domain” on page 366.
Linking a Workstation Instance
To link a workstation instance, right-click the workstation you want to stop and select Link
Unlinking a Workstation Instance
To unlink a workstation instance, right-click the workstation you want to stop and select
Unlink from the pop-up menu.
Note: To unlink all of the workstations in a domain, refer to “Unlinking the Workstations in
a Domain” on page 366.
Managing Domains in the Plan

You can perform the following actions on domains in the plan:
¶ Display a list of domains. This list contains a number of fields with information about
the domain status.
¶ Start, stop, and link a workstation in a domain.
¶ Change the domain manager workstation in a domain.
Displaying a List of Domains in the Plan
To display a list of domains in the plan, follow these steps:
2. Expand the Default Plan Lists group.
3. Select a Status of All Domains list button.
4. Click Load List on the toolbar or right-click the domain list button and select Load List

The list results are displayed in the right pane of the Job Scheduling Console. Table 152
describes the column headings in the domain display.
Table 152. List of Domains in the Plan
Name The name of the domain.
Domain Manager The name of the domain manager workstation.
Domain Parent The name of the parent domain.
Starting the Workstations in a Domain

To start Workload Scheduler running on all of the workstations in a domain:
1. Run a list of domains that contains the domain you want to start. See “Displaying a List
of Domains in the Plan” on page 365 for more information.
2. In the list results, right-click the domain you want to start.
3. Select Start Workstations from the pop-up menu.
Note: To start individual workstations, see “Starting a Workstation Instance” on page 364.
Stopping the Workstations in a Domain
To stop Workload Scheduler running on all of the workstations in a domain:
1. Run a list of domains that contains the domain you want to stop. See “Displaying a List
2. In the list results, right-click the domain you want to stop.
3. Select Stop Workstations from the pop-up menu.
Note: To stop individual workstations, see “Stopping a Workstation Instance” on page 365.
Linking the Workstations in a Domain
To link all of the workstations in a domain:
1. Run a list of domains that contains the domain you want to link. See “Displaying a List
2. In the list results, right-click the domain you want to link.
3. Select Link Workstations from the pop-up menu.
Note: To link individual workstations, see “Linking a Workstation Instance” on page 365.
Unlinking the Workstations in a Domain
To unlink all of the workstations in a domain:
1. Run a list of domains that contains the domain you want to unlink. See “Displaying a
List of Domains in the Plan” on page 365 for more information.
2. In the list results, right-click the domain you want to unlink.
3. Select Unlink Workstations from the pop-up menu.
Note: To unlink individual workstations, see “Unlinking a Workstation Instance” on

page 365.
366 Version 8.1

22. Plan Tasks
Switching the Domain Manager in a Domain
When switching domain managers to a backup domain manager, ensure the new domain
manager is a fault-tolerant agent with Full Status and Resolve Dependencies selected.
To switch the domain manager to a different workstation in a domain:

1. Run a list of domains that contains the domain you want to switch. See “Displaying a
List of Domains in the Plan” on page 365 for more information.
2. In the list results, right-click the domain and select Switch Manager... from the pop-up
menu. This displays the Select Domain Manager window.
Figure 217. Switch Manager - Domain Window
3. Click Find and use the Find window to select the name of the new domain manager
workstation. The new domain manager must be a member of the domain and it must be
a fault-tolerant agent with Full Status and Resolve Dependencies selected.

¶ Click OK to switch to the new domain manager and close the window.
¶ Click Cancel to close the window without switching the domain manager.
Managing File Dependencies in the Plan

A file dependency is when a job or job stream needs to verify the existence of one or more
files before it can run.
Displaying File Dependencies Status
To display a list of file dependencies in the plan:
3. Select the Status of All Files list button.
4. Expand the branches below the scheduler until you see the button for the file list you
want to run. See “Creating a Plan List of Files” on page 291 for information about
creating file lists.
Select the file list button.
5. Click Load List on the toolbar or right-click on the file list button and select Load List

Figure 218. Status of All Files List Window
Table 153 describes the column headings in the file display.

Table 153. Status of All Files List Window
Full Path Name The path and name of the file.
Workstation The name of the workstation that owns the file.
Qualifiers Any qualifiers used with this file dependency.
Status The status of the file as one of the following:
Not Checked
Not yet checked or the file was available and used to
satisfy a job or job stream dependency.
Checking
File availability is being checked.
Exists
The file exists and is available.
Does Not Exist
The file does not exist or is not available.
Managing Prompt Dependencies in the Plan

A prompt dependency is when a job or job stream needs to wait for an affirmative response
to a prompt before it can run.
Displaying Prompt Dependencies Status
To display a list of prompt dependencies in the plan:
3. Select the Status of All Prompts list button.
4. Click Load List on the toolbar or right-click on the prompt list button and select Load
368 Version 8.1

22. Plan Tasks
Table 154 describes the contents of the columns in the prompt display.
Table 154. Prompt Dependencies Status
Name The name of a predefined prompt or the number of an ad hoc prompt.
Workstation The name of the workstation.
Dependency The jobs or job stream names that are dependent on this prompt.
Release Status The status of the prompt. This is one of:
ASKED The prompt has been issued, but no response has
been received.
NOT ASKED The prompt has not been issued.
YES The prompt has been issued and a YES response has
been received.
NO The prompt has been issued and a NO response has
been received.
Number The internal ID of the prompt.
Type The prompt type. This is one of:
Ad Hoc The prompt is locally defined in a job or job stream.
Predefined The prompt has a name and is defined in the
database.
Recovery The prompt is locally defined in a job as a recovery
option.
Message Text The text of the prompt.
Replying to a Prompt Dependency

To reply to a prompt dependency:
1. Run a list of prompt dependencies that contains the prompt you want to modify. See
“Displaying Prompt Dependencies Status” on page 368 for more information.
2. In the list results, right-click the prompt dependency you want to reply to or, to select
more than one prompt dependency, do one of the following:
¶ To select multiple prompt dependencies from the list, hold down the shift key and
left-click the first and last prompt dependencies in the range. Right-click one of the
selected prompt dependencies to open the popup menu.
¶ To select multiple prompt dependencies, hold down the control key and left-click
each prompt dependency. Right-click one of the selected prompt dependencies to
3. Select Reply then Yes, or Reply then No from the pop-up menu.
Managing Resource Dependencies in the Plan

Resources represent any type of resources on your system such as tape drives,
communication lines, databases, or printers, that are needed to run a job. Resources can be
physical or logical. After defining a resource in the Workload Scheduler database, it can be
used as a dependency for jobs and job streams that run on the workstation or workstation
class for which the resource is defined.
Displaying Resource Dependencies Status
To display a list of resource dependencies in the plan:

2. Expand the branches below the scheduler until you see the button for the resource list
you want to run. See “Creating a Plan List of Resources” on page 289 for information
about creating resource lists.
3. Select the resource list button.
4. Click Load List on the toolbar or right-click on the resource list button and select Load
Table 155 describes the contents of the columns in the resource display.
Table 155. Resource Dependencies Status
Name The name of the resource.
Workstation The name of the workstation.
Status The status of the resource. This is one of:
Available The resource has units available.
Not Available The resource has no units available.
Unknown The status of the resource is unknown.
Quantity Defined The total number of units defined for the resource.
Quantity Available The number resource units that are not in use.
In Use The number of resource units that are currently in use.
Holders The names of job and job stream instances that require units of the
resource and the number of units required.
Displaying the Properties of a Resource Dependency

To display a resource dependency in the plan:
1. In a list of resource dependencies, right-click the resource and choose Properties from
the pop-up menu. The Properties - Resource in Plan window is displayed.
2. In this window, you can change the total number of defined units of the resource. To do
this, specify a new value in the Quantity Defined field.

¶ Click Cancel to close the window without saving your changes.
Changing the Number of Units of a Resource Dependency
To change the total number of defined units of a resource dependency:
1. Run a list of resource dependencies that contains the resource you want to modify. See
“Displaying Resource Dependencies Status” on page 369 for more information.
2. In the list results, right-click the resource you want to modify.
3. Select Change Units from the pop-up menu. The Change Units - Resource in Plan
4. Specify a new value in the Quantity Defined text box.
370 Version 8.1

¶ Click OK to save the new units in the plan and close the window.
22. Plan Tasks

¶ Click Cancel to close the window without saving the new units.
Setting an Alternate Plan

You can use the Set alternate plan function to set an old plan so that all the lists at plan
level refer to the selected plan. You can browse all objects in the alternate plan, such as jobs
and job streams, but you cannot modify them.
To select a different plan to use:

¶ In the Job Scheduling view, right-click the scheduler button and select Set alternate
plan from the pop-up menu. The Set Alternate Plan Files window is displayed.
Figure 219. Set Alternate Plan Files Window
Table 156 describes the columns in this window.

Table 156. Set Alternate Plan Files Window
This column ... Specifies this ...
Schedule Date The date the file was scheduled to run.
Actual Date The date the file began running.
Log Date The date the file was logged.
Start Time The time file began running.
Run Number The run number assigned to the file by Workload Scheduler. This is
used for internal network synchronization.
Log Number The log number indicating the chronological order of the log files.
Size The size of the log file, in records.
Filename The name of the file assigned by the scheduler.

¶ Select the plan you want to use.
¶ Click OK. You return to the Job Scheduling view.
372 Version 8.1

IV — Appendixes

374 Version 8.1
A
Using Common Lists
If your Job Scheduling view includes multiple scheduling engines, you can list job stream
instances and job instances for more than one engine at a time. This also applies if you have
a mixed environment of Workload Scheduler for z/OS and Workload Scheduler engines.
In the Job Scheduling view, the Common Default Plan Lists group appears at the bottom of
the job scheduling tree. The group provides two predefined lists, one for job instances and
one for job stream instances. Unlike similar lists for specific engines, these lists display all
the job and job stream instances that exist in all the engines to which the Job Scheduling
Console is connected. The group always appears in the Job Scheduling tree, regardless of the
number of connections that you might have.
Like all default lists, the two common plan lists are defined with no filters. If you want to,
you can create additional common plan lists that use particular filters, such as a particular
status or a subset of all the engines. However, common plan lists are limited to job and job
stream instances. Common plan lists provide fewer details about the job and job stream
instances than engine-specific plan lists. If you are connected to a single engine, or if you
want to see more information about the instances of a specific engine, you should use the
plan lists for that engine.
This chapter describes how to:

¶ Create a common list of job instances
A. Using Common Lists

¶ Create a common list of job stream instances
¶ Modify a common list
¶ Display a common list created previously
¶ Delete a common list

Creating a Common List of Job Instances
Listing All Job Instances
To list all the job instances existing in all the scheduling engines:
1. In the Job Scheduling view, double-click Common Default Plan Lists.
2. Double-click All Scheduled Jobs. The All Scheduled Jobs list is displayed in the right
pane of the Job Scheduling view.
Using Filter Criteria
To create a list of job instances with different filter criteria, in the Job Scheduling view,
select Common Default Plan Lists and click the List Job Instances button. The Properties
- Job Instance Common List window is displayed.
Figure 220. Properties - Job Instance Common List Window
376 Version 8.1

Table 157. Properties - Job Instance List Information
Name Name for the list.
Apply defaults
To use the default specified in the Settings page of the
Scheduler Properties window.
Filter Criteria
Job stream name Lists all the job instances that are in the job stream with this name
or namestring.
Job identifier Lists all the job instances that have this identifier. You cannot use
wildcard characters with this filter.
Priority Lists all the job instances that have the priority level you select in
From and To. The Workload Scheduler for z/OS priority is 1–10
and the Workload Scheduler priority is 0–101.
Status Lists all the job instances with any of the following Job Scheduling
Console status codes that you specify in the drop-down list:
¶ Waiting
¶ Ready
¶ Running
¶ Successful

¶ Error
¶ Canceled
¶ Interrupted
¶ Undecided
Engine Lists all the connected engines. Select the engines for which you
want to display the job instances.
—EITHER—
Click Apply to display the list results immediately, then click OK to close the window.
—OR—
Click OK to close the window. The new list definition is added to the Common Default
Plan Lists group in the Job Scheduling view. Right-click the list in the Job Scheduling
view and select Open. The list results are displayed in the right hand pane.
Note: To display the list at a later date, double-click it in the scheduling tree.

Creating a Common List of Job Stream Instances
Listing All Job Stream Instances
To list all the job stream instances existing in all the scheduling engines:
1. In the Job Scheduling view, double-click Common Default Plan Lists.
2. Double-click All Scheduled Job Streams. The All Scheduled Job Streams list is
displayed in the right pane of the Job Scheduling view.
Using Filter Criteria
To create a list of job stream instances with different filter criteria, in the Job Scheduling
view, select Common Default Plan Lists and click the List Job Stream Instances button.
The Properties - Job Stream Instance Common List window is displayed.
Figure 221. Properties - Job Stream Instance Common List Window
378 Version 8.1

Table 158. Properties - Job Stream Instance List Information
Name Name for the list.
Apply defaults
To use the default specified in the Settings page of the
Scheduler Properties window.
Filter Criteria
Job stream name Lists all the job stream instances that are in the job stream with this
name or namestring.
Job identifier Lists all the job stream instances that have this identifier. You
cannot use wildcard characters with this filter.
Priority Lists all the job stream instances that have the priority level you
select in From and To. The Workload Scheduler for z/OS priority is
1–10 and the Workload Scheduler priority is 0–101.
Status Lists all the job stream instances with any of the following Job
Scheduling Console status codes that you specify in the drop-down
list:
¶ Waiting
¶ Ready
¶ Running

¶ Successful
¶ Error
¶ Canceled
¶ Interrupted
¶ Undecided
Engine Lists all the connected engines. Select the engines for which you
want to display the job stream instances.
—EITHER—
—OR—
Note: To display the list at a later date, double-click it in the scheduling tree.

Displaying a Common List
To display a common list that you have already created:
1. In the Job Scheduling view, double-click Common Default Plan Lists. The common
lists are displayed under this group.
2. Double-click the list you want to display. The results are displayed in the right hand
pane of the Job Scheduling view.
Modifying a Common List

To modify a common list:
The properties window of the list is displayed.
3. Make the changes you want.
—EITHER—
—OR—
Deleting a Common List

To delete a common list from the Common Default Plan Lists group:
2. Right-click the list you want to delete and select Delete from the pop-up menu.
The list is deleted from the Common Default Plan Lists group.
380 Version 8.1

B
Setting Traces for the Job Scheduling
Console
This appendix explains how to set tracing facilities for the Job Scheduling Console.
You can set the tracing facility by customizing the TRACELEVEL and TRACEDATA
variables. These variables are located in the following files:
Table 159. Trace Variable Location by Operating System
For this operating system ... The file is ...
Microsoft Windows NT, 2000 ..\bin\java\NTconsole.bat
Microsoft Windows 98, ME ..\bin\java\console.bat
AIX ../bin/java/AIXconsole.sh
HP-UX ../bin/java/HPconsole.sh
SUN Solaris ../bin/java/SUNconsole.sh
Linux ../bin/java/LINUXconsole.sh
To customize either variable, open the file in editing mode and set the variable to a value
ranging from 0 to 3. Values enable you to tune the tracing facilities to report the type and
detail of data that best fits your needs.

B. Setting Traces for the
TRACELEVEL enables you to choose what type of program information flow the tracing
facility must record, so that you can check for program correctness in terms of sequences of
instructions. The following table displays what each value does:
TRACELEVEL Value Action

0 Only errors and warnings are recorded.
1 Errors, warnings, and info/debug lines are recorded.
2 Errors, warnings, and method entry/exit are recorded.
3 Errors, warnings, info/debug lines, and method entry/exit are recorded
(maximum trace level).
TRACEDATA enables you to choose what type of data flow the tracing facility must record.
You can set it to record the contents of the Job Scheduling Console beans or the data
structures exchanged between the Job Scheduling Console and the Workload Scheduler for
z/OS Connector. The following table displays what each values does:
TRACEDATA Value Action

0 No data is traced.

TRACEDATA Value Action
1 Data structures from/to the scheduler Connector are recorded.
2 The internal values of the Job Scheduling Console beans are recorded.
3 Both data structures and bean internal values are recorded (maximum
trace level).
The various combinations of values for TRACELEVEL and TRACEDATA give you the
maximum flexibility in terms of information provided by the log file. However, it is
important to point out that the combination of values of 2 or greater for TRACELEVEL and
of 1 or greater for TRACEDATA can be quite heavy for system performance: they can slow
program operation and generate very big log files.
Tracking of error conditions is active by default (TRACELEVEL is already set to 0). You
can also set TRACELEVEL to -1 to force the tracing facility not to create a log file at all.
The log file is named JSCONSOLE.LOG and is placed in the DAT subdirectory of the
directory hosting the Job Scheduling Console files.
By default, the maximum size of JSCONSOLE.LOG can be 3 MB. When this limit is
reached, the tracing facility creates an additional log file. The tracing facility can create up
to ten log files for a total of 30 MB. You can, however, change this by using the advanced
customization options described in the next section.
Using the Log File Advanced Customization Options

These options enable you to customize the log file produced by the tracing facilities. They
are listed under a section named [trace] inside of the JSS.INI file in the \dat\.tmeconsole
subdirectory of the directory hosting the Job Scheduling Console files. The options, and their
default values, are listed in JSS.INI as shown below:
[trace]
traceFileMaxLen=3000000
traceFileMaxNum=10
printTimeDate=true
printMillisecond=false
printThreadID=false
printComponent=false
printType=true
where:
traceFileMaxLen
Defines the maximum size, in bytes, that the log file can be. When the file reaches this
size, it is renamed and a new log file is created. The value is an integer of your choice.
traceFileMaxNum
Defines the maximum number of log files that can be present on disk during each
instance of the Job Scheduling Console. When this number is exceeded, the older files
are replaced first. This includes only the files created during the current session of the
Job Scheduling Console. You have to manually delete the files stored during previous
sessions. The value is an integer of your choice.
printTimeDate
Specifies if the trace calls write date and time information in the log file. The value can
be True or False.
382 Version 8.1

printMilllisecond
Specifies if the trace calls write timestamp information, in milliseconds, in the log file.
The value can be True or False.
printThreadID
Specifies if the trace calls write an identifier for the current thread in the log file. The
value can be True or False.
printComponent
Specifies if the trace calls write the name of the source component in the log file. The
value can be True or False.
printType
Specifies if the trace calls write the message type (error, warning or information) in the
log file. The value can be True or False.
traceFileMaxLen and traceFileMaxNum
Use to decide how much disk space you want to allocate to the tracing facility. They
enable you to achieve a correct trade-off between disk space occupancy and debug data
availability.
Use the other options to determine what type of information you want included in the trace
file.

B. Setting Traces for the

384 Version 8.1
C
Enabling Time Zones in the Workload
Scheduler
Enabling time zones in Tivoli Workload Scheduler enables you to manage your workload on
a global level. Time zone implementation also allows for easy scheduling across multiple
time zone and for jobs that need to run in the ″dead zone.″ The dead zone is the gap
between the Workload Scheduler start of day time on the master and the time on the
fault-tolerant agent in another time zone. For example, if an eastern master with a Workload
Scheduler start of day of 6 AM initializes a western agent with a 3-hour time zone
difference, the dead zone for this fault-tolerant agent is between the hours of 3 AM and 6
AM. Previously, special handling was required to run jobs in this time period. Now when
specifying a time zone with the start time on a job or job stream, Workload Scheduler runs
them as expected. For example, consider the following two job streams for a PST
fault-tolerant agent with an EST master:
Schedule PST_SCHEDULE1 Schedule PST_SCHEDULE2
On SU, weekdays except FR on weekdays
CARRYFORWARD AT 0330 TZ PST
AT 0330 :
: joba
job1 jobb
job2 END
C. Enabling Time Zones in

the Workload Scheduler
END
Job stream PST_SCHEDULE1 is not time zone enabled. To get this job stream to run every
weekday morning, you must schedule it to run Sunday through Thursday, and you must
specify ″carryforward″. Without carryforward, the jobs would never run, since the
fault-tolerant agent would be initialized at 0300 every morning (assuming an EST master
with a Workload Scheduler start of day of 0600). Job stream PST_SCHEDULE2 is time
zone enabled. When the EST master initializes the PST fault-tolerant agent at 0300, it starts
the job stream the same day at 0330.
Time zone enabling also has an effect on eastern fault-tolerant agents when scheduling from
western masters. For example, consider the following two job streams for an EST
fault-tolerant agent and a PST master with an 0600 start of day.

Schedule EST_SCHEDULE1 Schedule EST_SCHEDULE2
On SU, weekdays except FR On SU, weekdays except FR
AT 0800 + 1 DAY AT 0800 TZ EST
CARRYFORWARD :
: joba
job1 jobb
job2 END
END
Job stream EST_SCHEDULE1 is not time zone enabled. For this job stream to run every
weekday morning, you must schedule it to run Sunday through Thursday. Specify
carryforward and +1DAY for the AT time. Carryforward is needed for the +1DAY
specification. Without the +1DAY specification, the job stream would launch immediately
after initialization from the western master at 0900. Job stream EST_SCHEDULE2 is time
zone enabled. When the eastern fault-tolerant agent is initialized at 0900, it runs the job
stream at 0800 the next day.
Once enabled, time zones can be specified in the Job Scheduling Console or composer for
start and deadline times within jobs and job streams. For conman, the following commands
now accept time zone parameters where AT or UNTIL times are used:
¶ submit job
¶ submit docommand
¶ submit file
¶ submit schedule
¶ addep schedule
¶ addep job
¶ addep schedule
¶ addep job
¶ ″rurun job; from″ option
Enabling the Time Zone Feature

The time zone feature is enabled by an entry in the globalopts file and by specifying a time
zone in the master workstation definition, as follows:
timezone enable = yes|no
Time zones are disabled by default on installation or update of the product. If the timezone
enable entry is missing from the globalopts file, time zones are disabled.
386 Version 8.1

D
Status Description and Mapping
This Appendix provides information about job and job stream status for the Job Scheduling
Console and Workload Scheduler.
For information about job and job stream status for Workload Scheduler for z/OS, refer to
Tivoli Workload Scheduler for z/OS Controlling and Monitoring the Workload.
Status Overview
There are two types of status:
Job Scheduling Console status
This is a subset of internal status and is common for both Workload Scheduler and
Workload Scheduler for z/OS.
Internal Status
This refers to the Workload Scheduler internal or engine status for the job or job
stream. The internal status messages are unique to the scheduler.
Job Status
This section describes the job status for both Job Scheduling Console and Workload
Scheduler internal status.
D. Status Description and

Job Scheduling Console Job Status
Below are listed possible job states and descriptions:
Mapping
Table 160. Job Scheduling Console Job States
This job status ... Means that ...
WAITING The job stream instance is waiting for its dependencies to be resolved.
READY The dependencies of the job stream instance have been resolved and
the job stream instance is ready to run.
RUNNING The job stream instance is running.
SUCCESSFUL The job stream instance completed successfully.
ERROR The job stream instance has stopped running with an error.
CANCELED The job stream instance was canceled.
HELD The job stream instance was interrupted.
UNDECIDED The job stream status is currently being checked.
BLOCKED The job stream instance was blocked due to unfulfilled dependencies.

Workload Scheduler Internal Job Status
Below are listed possible job states and descriptions:
Table 161. Workload Scheduler Internal Job States
ABEND The job terminated with a non-zero exit code.
ABENP An ABEND confirmation was received, but the job is not completed.
ADD The job is being submitted.
DONE The job completed in an unknown state.
ERROR For internetwork dependencies only, an error occurred while checking
for the remote status.
EXEC The job is running.
EXTRN For internetwork dependencies only, the status is unknown. An error
occurred, a rerun action was just performed on the job in the external
job stream, or the remote job or job stream does not exist.
FAIL Unable to launch the job.
FENCE The job’s priority is below the fence.
HOLD The job is awaiting dependency resolution.
INTRO The job is introduced for launching by the system.
PEND The job completed, and is awaiting confirmation.
READY The job is ready to launch, and all dependencies are resolved.
SCHED The job’s at time has not arrived.
SUCC The job completed with an exit code of zero.
SUCCP A SUCC confirmation was received, but the job is not completed.
SUSP The job was suspended by a breakjob command. (MPE only)
WAIT The job is in the wait state. (Extended agent and MPE only)
WAITD The job is in the wait state, and is deferred. (MPE only)
Job Stream Status

This section describes the job stream status for both Job Scheduling Console and Workload
Scheduler internal status.
Job Scheduling Console Job Stream Status
Below are listed possible job stream states and descriptions:
Table 162. Job Scheduling Console Job Stream States
WAITING The job stream instance is waiting for its dependencies to be resolved.
READY The dependencies of the job stream instance have been resolved and
the job stream instance is ready to run.
RUNNING The job stream instance is running.
SUCCESSFUL The job stream instance completed successfully.
ERROR The job stream instance has stopped running with an error.
CANCELED The job stream instance was canceled.
388 Version 8.1

Table 162. Job Scheduling Console Job Stream States (continued)
HELD The job stream instance was interrupted.
UNDECIDED The job stream status is currently being checked.
BLOCKED The job stream instance was blocked due to unfulfilled dependencies.
Workload Scheduler Internal Job Stream Status

Below are listed possible job stream states and descriptions:
Table 163. Workload Scheduler Internal Job Stream States
READY The dependencies for the job stream have been met but the time
restrictions for the job stream have not.
HOLD The job stream instance is awaiting dependency resolution.
CANCEL PEND The job stream instance is pending cancelation. Cancelation is deferred
until all of the dependencies, including an at time, are resolved.
EXEC The job stream instance is running.
STUCK Job stream instance ion was interrupted. No jobs are launched without
operator intervention.
ABEND The job stream instance terminated with a non-zero exit code.
SUCC The job stream instance completed successfully.
CANCEL The job stream instance was canceled.
ADD The job stream instance was added with operator intervention.
EXTRN The job stream instance is in a remote Workload Scheduler network
and its status is unknown. An error occurred, a Rerun action was
performed on the EXTERNAL job stream, or the INET job or job
stream does not exist.
ERROR This is for Internetwork job streams and specifies that an error
D. Status Description and

occurred while checking for the remote status.
Mapping
Status Mapping
This section provides a table of how Job Scheduling Console status maps to Workload
Scheduler internal status for jobs and job streams.
Job Status Mapping
Table 164 describes how Job Scheduling Console status correlates to Workload Scheduler
internal status for jobs.
Table 164. Job Status Mapping
This console status ... Maps to this Workload Scheduler internal status ...
WAITING ADD, PEND, WAIT, WAITD, INTRO, HOLD
READY READY
RUNNING EXEC, SUCCP, ABENP
SUCCESSFUL SUCC
ERROR ABEND, FAIL

Table 164. Job Status Mapping (continued)
CANCELED Status of the job when it was canceled. Canceled flag is set.
HELD Priority = 0, WAITING, READY
UNDECIDED ERROR, EXTRN
BLOCKED SUSP
Job Stream Status Mapping

Table 165 describes how Job Scheduling Console status correlates to Workload Scheduler
internal status for job streams.
Table 165. Job Stream Status Mapping
WAITING ADD, PEND, WAIT, WAITD, INTRO, HOLD
READY READY
RUNNING EXEC
SUCCESSFUL SUCC
ERROR ABEND, FAIL
CANCELED CANCEL, HOLD, CANCEL P
HELD HOLD
UNDECIDED EXTRN, ERROR
BLOCKED STUCK
390 Version 8.1

E
Job Scheduling Console Messages
Job Scheduling console message numbers have a GJS prefix and are followed by a letter
indicating the type of message:
E Error
I Information
W Warning
The list below includes all the messages displayed by the base Job Scheduling console.
GJS0000E There was an unidentified problem when connecting
GJS0001E Cannot load job stream list
GJS0002E Cannot load plan view
GJS0003E Cannot load resource list
GJS0004E Cannot load resource plan view
GJS0005E Cannot load workstation list
GJS0006E Cannot open job stream instance
GJS0007E Cannot update job stream
E. Job Scheduling Console

GJS0008E Cannot open the Job Stream Editor
GJS0009E Cannot open the Job Stream Instance Editor
Messages
GJS0010E Cannot open the Resource Editor
GJS0012E Cannot load the job stream
GJS0013E Cannot load the definition of resource availability
GJS0014E Cannot load the job stream instance
GJS0015E Cannot save the job stream
GJS0016E Cannot save the resource
GJS0017E Cannot add this dependency
GJS0027E Cannot save the workstation
GJS0028E Class Cast Exception
GJS0029E There is a problem with your job scheduling engine
GJS0030E Cannot close the window
GJS0031E Cannot add Job Dependency

GJS0032E Cannot process OK request
GJS0033E Cannot change the job
GJS0034E Cannot add the new job
GJS0035E Cannot modify the instance
GJS0036E Cannot delete the instance
GJS0037E Cannot hold the instance
GJS0038E Cannot release the instance
GJS0039E Cannot delete the object
GJS0040E Cannot undelete the object
GJS0041E Cannot modify the status in the database
GJS0042E Cannot remove the job
GJS0043E Cannot remove the job dependency
GJS0044E Cannot remove the dependency
GJS0045E Cannot remove the external dependency
GJS0046E Cannot perform the action on the selected objects
GJS0047E Cannot perform the job stream operation
GJS0048E Cannot perform the action on the selected object
GJS0049E Cannot perform the action on the selected objects
GJS0050E Cannot update the instance from services
GJS0051E Cannot perform the action specified on the selected object
GJS0052E Cannot perform the action specified on the selected objects
GJS0060E Cannot delete the selected workstations
GJS0061E Cannot add schedule specifications
GJS0062E Cannot create another run cycle
GJS0063E Cannot perform this action
GJS0064E Cannot interrupt the operation
GJS0065E Cannot delete the resource
GJS0066E Cannot delete the selected resources
GJS0067E Cannot get the resource header
GJS0068E Cannot open the resource
GJS0069E Cannot save resource dependency changes
GJS0070E Cannot add scheduling specifications
392 Version 8.1

GJS0071E Cannot add scheduling specifications
GJS0072E Cannot process the OK request
GJS0073E You are renaming a resource
GJS0074W You are renaming a workstation
GJS0075E Cannot open the resource
GJS0076E Cannot open the workstation
GJS0077E This object is currently locked because it is being updated by another user. It
will be displayed in read-only mode until the user releases it. Try again later.
GJS0078E Error logging in to the TMR host
GJS0079E Cannot link to the connector
GJS0080E Cannot detach the view
GJS0081E Cannot save the job stream
GJS0082E Cannot paste the external dependency
GJS0083E Cannot find the objects you are searching
GJS0086E You are renaming a job stream
GJS0087E Selected engine not available
GJS0088E Cannot attach the view
GJS0089E Cannot load workstation plan view
GJS0090E Cannot load the Job output
GJS0091E Cannot load the Job output
E. Job Scheduling Console

Messages Originated by Workload Scheduler for z/OS
Messages
All Job Scheduling Console messages that contain the GJSQ prefix refer to Workload
Scheduler for z/OS error conditions. The explanation of each message displays a specific
Workload Scheduler for z/OS message. These messages are identified by the EQQ prefix.
For information about these messages, refer to the Tivoli Workload Scheduler for z/OS
Messages and Codes book.

394 Version 8.1
Glossary
A
Actual start time
The time, as logged, at which the job or job stream instance started.In the timeline, the actual start time is
represented by a black bar running down the center of the navy blue activity bar. See also earliest start time and
planned start time.
C
Calendar
A definition of workdays, free days, and holidays. The scheduler uses the calendar combined with run cycles to
determine on which days to run the job stream. In the GUI, you can assign a calendar to a job stream; however,
you must use the ISPF panes to create or modify calendars in the database.
D
Database
A collection of data that is fundamental to a system. The database for each engine contains calendars, JCL
variable tables, job streams, operator instructions, periods, resources, and workstations. In the Job Scheduling
Console, you can define and modify job streams, resources, and workstations. This information is stored in the
database of the engine and is used to generate instances for the plan.
Deadline
The time by which the job or job stream must be completed. The deadline is your estimate, based on your
experience in running the job or job stream. In the timeline, the deadline is represented by the black border at the
right end of the navy blue activity bar.
Dependency
A relationship between two jobs in which the first job must be completed before the second can begin. When you
create a job stream in the database, you define the dependencies between jobs
DLF
Data Lookaside Facility. The z/OS component that manages Hiperbatch objects.
Duration
The time you expect the job to take to complete. In the Timeline view of jobs in the database, the duration is
represented by a light blue bar at the center of the activity bar or by a light blue diamond.
Glossary
E
Earliest start time
The time before which the job or job stream cannot start. The earliest start time is your estimate, based on your
experience in running the job or job stream. The job or job stream can, however, start after the time you specify
as long as all other dependencies are satisfied. In the timeline, the start time is represented by the beginning (left
edge) of the navy blue activity bar. For job instances, the start time that the scheduler calculates is represented by
a light blue bar. See also actual start time and planned start time.
Exclusionary run cycle

A run cycle that specifies when a job stream must not run.
External job
A job from one job stream that is a predecessor for a job in another job stream. An external job is represented by
a place holder button in the Graph view of the job stream. When you delete an external job either from the
database or the plan, the job stream that includes it as a predecessor skips it as if it did not exist, and the
scheduler logs the error.

F
Fault-tolerant workstation
The CPU that runs a job stream that is scheduled in the plan.
Free day rule

Determines how to calculate free days when scheduling the job stream. The following are free day rules: Count
workdays only. Count workdays and free days alike. Schedule on the last workday before free day. Schedule on
the next workday after free day. Do not schedule if free days.
H
Hiperbatch
The z/OS facility that stores VSAM and QSAM data in Hiperspace for access by multiple jobs. The facility can
significantly reduce the run time of certain batch streams that access VSAM and QSAM.
J
Job
A unit of work in a job stream that is processed at a workstation. It usually includes all necessary computer
programs, linkages, files, and instructions to the operating system. When you create a job in the database, you
also define its dependencies on predecessor jobs and its time restrictions, such as the estimated start time and
deadline. The type of job determines the type of target workstation on which it can run: JCL jobs consist of JCL
statements and run on computer workstations. Started task jobs start or stop started tasks and run on computer
workstations. Printer jobs print the output of a predecessor job and run on printer workstations. General jobs
include activities other than printing and processing, such as manual activities and run on general workstations.
Setup jobs require preparation of a set of JCL statements for a JCL or started task job and run on general
workstations. Write-to-operator (WTO) jobs consist of an operator instruction displayed on the system console
and run on general workstations. Fault tolerant workstation jobs are used to run jobs from Tivoli Workload
Scheduler. They require fault tolerant workstations. Fault tolerant workstation jobs can have neither a general job
as a predecessor nor a printer job as a successor. See also job instance.
Job instance
A job scheduled for a specific run date in the plan. See also job.
Job scheduling object

A generic term that includes jobs, job streams, resources, and workstations.
Job status
See status
Job stream
A sequence of jobs, including the resources and workstations that support them, and scheduling information. The
dependency of one job on the completion of another determines the sequence of the jobs. The scheduling
information, such as run cycles and a calendar, determines when and how often the job stream is run. See also
job stream instance.
Job stream instance

A job stream that is scheduled for a specific run date in the plan. See also job stream.
Job stream template

An entity that contains scheduling information, such as a calendar, a free day rule, and run cycles, that can be
inherited by all the job streams that have been created using the template. Unlike typical templates, job streams
created from a job stream template continue to be part of the template and any changes to the scheduling
information for the template are inherited by the job streams. Therefore, you do not define run cycles for job
streams created from a template.
396 Version 8.1

L
List
A list displays job scheduling objects. You must create separate lists for each job scheduling object. For each job
scheduling object, there are two types of lists: one of definitions in the database and another of instances in the
plan.
Logical resource
See resource.
P
Plan
A detailed plan of system activity that covers a period of at least one minute and not more than 21 days. It
typically covers one or two days. The plan encompasses all job and job stream instances and the resources and
workstations involved in running them. All job streams for which you have created run cycles are automatically
scheduled and included in the plan. Contrast with database.
Planned start time

The estimated start time, based on the duration of predecessors, that the scheduler makes for when the job
instance should start. See also actual start time and earliest start time
Predecessor
A job that must be completed before jobs that are dependent on it can begin. Contrast with successor.
R
Resource
Any type of limited resource, such as tape drives, communication lines, databases, or printers, that is needed to
run a job. You designate when a resource is available, in what quantities, and by which logical workstations the
resource can be used. This information helps determine when job stream instances are scheduled to run. In the
Job Scheduling Console, resources are also called logical resources.
Resource availability
Fixed times when the job can use a resource. You define conditions, similar to run cycles, that generate the
calendar days when a resource is available. You can also define conditions for when a resource is not available.
Run cycle
A specification of the days that a job stream is scheduled to run. It can be either rule-based or offset-based:
Rule-based: Includes a rule, such as, the first Friday of March or the second workday of the week Offset-based:
Includes a user-defined period and an offset, such as, the 3rd day in a 90-day period. See also exclusionary run
Glossary
cycle.
S
Status
The state of a job or job stream instance. It can be one of the following:
Arriving The instance is waiting for input to arrive (jobs only).
Canceled The instance has been deleted from the plan.
Error The instance has ended in error.
Interrupted The instance has been interrupted (jobs only).
Pending predecessor
The job stream instance is waiting for a predecessor to be completed (job streams only).
Ready The instance is ready to start. All predecessors are complete (jobs only).
Ready-nonreporting workstation
The job instance is ready to start. All predecessors, except a predecessor at a nonreporting
workstation, are complete (jobs only).
Running The job has started.
Successful The instance has been completed successfully.
Undecided The status of the instance is not known.
Waiting The instance is waiting for a predecessor job to end.

Successor
A job that cannot start until all of the jobs on which it has a dependency are completed. Contrast with
predecessor.
V
Valid from, to dates
The interval for which a job stream is available for scheduling and can be run. The first and last date that a run
cycle is in effect.
W
Workstation
The logical machine on which a job runs. When you create a job, you identify at least one workstation on which
it will run. There are three types of workstations: Computer, Printer, General.
WTO
Write-to-operator. See also job.
398 Version 8.1

Index
A changing the job limit

add link between jobs 236 job stream instance 331
adding a job to a job stream 227 workstation 363
adding dependencies between jobs 236 changing the priority
adding file dependencies job instance 297
job 231 job stream instance 331
job instance 302 closing the job stream editor 247
job stream instance 322 complete 57, 63
adding predecessors confirming a job instance 315
job instance 308 connected workstations 73
job stream instance 328 connector
adding prompt dependencies prerequisites 13, 17, 25
job 232 control on servers 58
job instance 304 creating a calendar 267
job stream instance 324 creating a domain 261
adding resource dependencies creating a group of lists 279
job 230 creating a parameter 276
job instance 306 creating a prompt 274
job stream instance 326 creating a resource 271
adding run cycles 237 creating a user 263
adding time restrictions creating run cycles 237
job 229 Customer Support xxxii
job instance 300
job stream instance 321
adhoc job 349
allocation options 175
Authority group 81, 111 D
data lookaside facility 71
date 63, 73, 76
deadline 88
deleting a calendar 269
B deleting a domain 263
backup domain manager, requirements 367 deleting a parameter 278
books deleting a prompt 276
feedback xxix deleting a resource 273
Index
online xxix deleting a run cycle 244
ordering xxix deleting a user 266
deleting predecessors
job instance 309
dependency filter window
job stream instance 284, 288
C directory names, notation xxxiii
calendar 63, 73, 81, 111
displaying predecessors
creating 267
job instance 307
database list 269
deleting 269
displaying successors
modify 269
job instance 309
view properties 269
calendar run cycle 242
DLF attribute 75, 76, 175
cancelling a job instance 314
domain
cancelling a job stream instance 330
creating 261
changing number of resource units 370
database list 262
changing the job fence, workstation 364
deleting 263

domain (continued) I
modify 263 internetwork dependency
starting the workstations 366 adding to a job 233
view properties 262 adding to a job stream 226
view status 365 interrupted 58
dumpsec 31 Is available 63, 71, 73
duration 57, 59 ISPF 57
E J
e-mail contact xxxi JCL 58, 111
earliest start time 88 job definition
enabling the time zone feature 386 adding to a job stream 227
environment variables, notation xxxiii properties 227
exclusive 71, 175 job fence, changing 364
external dependencies job instance
deleting 227 adding predecessors 308
external job 92 cancelling 314
adding to a job stream 226, 235 confirm 315
external job stream deleting predecessors 309
adding to a job stream 226, 234 displaying successors 309
holding 309
killing 314
modifying 297
predecessors 307
F release all dependencies 315
feedback about publications xxxi releasing 310
file dependency rerun 313
adding to a job 231 submitting into the plan 336
status 367 job instance properties
find calendar window 81 files 302
find workstations 63 prompts 304
finding objects in the plan 293 resources 306
follows dependency 236 time restrictions 300
freedays 81 job instances 55, 119, 123, 137, 175
from time 63, 73 job limit, changing for a workstation 363
job properties
files 231
prompts 232
resource 230
G time restrictions 229
globalopts file Job Scheduling view 75, 110, 175
time zone feature 386 job stream
graph view 113 adding run cycles 237
saving 247
submit into plan 335
job stream editor 113
job stream instance
H cancelling 330
hiperbatch 71, 75, 175 commands 316
holding a job instance 309 hold 316
holding a job stream instance 329 holding 329
holidays calendar 266 job limit 331
list view 318
modifying 319
plan list 316
priority 331
release 316
release all dependencies 316, 332
400 Version 8.1

job stream instance (continued) modifying resource dependencies
releasing 329 job instance 306
resubmit 316 job stream instance 326
resubmitting 333 modifying time restrictions
timeline view 317 job instance 300
job stream instance properties job stream instance 321
files 322
general 319
predecessors 327
prompt 324
resource 326 N
time restrictions 321 notation
job stream instances 119, 127 environment variables xxxiii
path names xxxiii
typeface xxxiii
K
killing a job instance 314
O
occurrence 119
online publications xxx
operations 57, 58
L ordering publications xxxi
linking a workstation 365
linking workstations, domain 366
list view 138
job instance 294
job stream instance 318 P
listing domains in the plan 280 parallel server 58
listing file dependencies in the plan 291 parameter
listing job instances in the plan 284, 294 creating 276
listing job streams in the plan 281 database list 277
listing parameters in the database 277 deleting 278
listing prompts in the database 275 modifying 278
listing prompts in the plan 290 properties 277
listing resources in the database 272 path names, notation xxxiii
listing resources in the plan 289 plan 59, 119
listing workstations in the plan 279, 361 plan list
deleting 292
detaching 292
Index
modifying 292
plan lists 279
M planning on servers 58
manuals predecessor job 59
feedback xxix priority 81
online xxix prompt
ordering xxix creating 274
modifying a domain 263 deleting 276
modifying a job instance 297 listing 275
modifying a parameter 278 modifying 275
modifying a prompt 275 properties 275
modifying a resource 273 replying 369
modifying a run cycle 244 status 368
modifying a user 265 publications
modifying file dependencies feedback xxix
job instance 302 online xxix
job stream instance 322 ordering xxix
modifying prompt dependencies
job instance 304

Q submitting a job into the plan 336
quantity 63, 71, 73 submitting a job stream into the plan 335
submitting an adhoc job into the plan 349
switch manager command 367
switching domain managers 367
R
ready 57, 58
release all dependencies
job instance 315 T
job stream instance 332 target workstation 83
releasing a job instance 310 task name 111
releasing a job stream instance 329 TCP/IP 59
replying to a prompt 369 tempsec 31
reporting attributes 66, 83, 163 time restrictions 88
rerunning a job instance 313 job 245
resource job stream 244
adding to a job 230 timeline view
changing units 370 job instance 296
creating 271 job stream instance 317
database list 272 Timeline view 104, 138
deleting 273 Tivoli Customer Support xxxii
modifying 273 to time 63, 73
properties 272 transport time 59
status 369 treat input as 75, 175
viewing plan properties 370
Resource Description database 175
resubmit a job stream instance 333
run cycle
adding to a job stream 237 U
calendar 242 unlinking a workstation 365
deleting 244 unlinking workstations, domain 366
modifying 244 user
simple 239 creating 263
weekly 240 deleting 266
listing 264
modifying 265
using plan lists 279
S
saving a job stream 247
scheduling 55, 58, 75, 175
search tool 73 V
security 31 variables, notation for xxxiii
setting priority viewing calendars in the database 269
job instance 297 viewing domain status 365
job stream instance 316 viewing domains in the database 262
shared 71, 175 viewing parameter properties 277
simple run cycle 239 viewing prompt properties 275
special resources 69 viewing prompt status 368
specifying job properties 227 viewing resource properties 272
start time 88, 144 viewing resource properties in the plan 370
started 57, 58, 59, 71 viewing resource status 369
starting a workstation 364 viewing the properties of a domain 262
starting workstations, domain 366 viewing the status of a workstation 362
status viewing users in the database 264
workstation 362
status of job stream 111
stopping a workstation 365
stopping workstations, domain 366
402 Version 8.1

W
waiting 175
weekly run cycle 240
wildcard characters 175
wmaeutil 32
workdays 81
workstation
linking 365
properties 362
starting 364
stopping 365
unlinking 365
workstation resources 55, 63
workstation type 58
wuninst 16
Index

404 Version 8.1
Program Number: 5697-WSZ
Printed in Denmark by IBM Danmark A/S
SH19-4552-00

Tivoli Guide

Enviado por

Dados do documento

Descrição original:

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Tivoli Guide

Enviado por

Direitos autorais:

Formatos disponíveis

Tivoli® Workload Scheduler

Job Scheduling Console

ISO 9001 Certification

Part I. Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Chapter 2. Installing Tivoli Job Scheduling Services . . . . . . . . . . . . . . . . . . . . 13

Tivoli Job Scheduling Console User’s Guide iii

Chapter 3. Installing the Tivoli Workload Scheduler for z/OS

Chapter 4. Installing the Tivoli Workload Scheduler Connector . . . . . . . . . 25

Chapter 5. Installing the Tivoli Job Scheduling Console. . . . . . . . . . . . . . . . . 33

Chapter 6. Working with the Job Scheduling Console . . . . . . . . . . . . . . . . . . . 41

Chapter 7. Managing Workstations in the Database . . . . . . . . . . . . . . . . . . . . . 55

Tivoli Job Scheduling Console User’s Guide v

Chapter 8. Managing Resources in the Database . . . . . . . . . . . . . . . . . . . . . . . . 69

Chapter 9. Creating Job Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Chapter 10. Listing and Modifying Job Streams . . . . . . . . . . . . . . . . . . . . . . . . 109

Chapter 11. Listing Job Stream and Job Instances . . . . . . . . . . . . . . . . . . . . . 119

Chapter 12. Managing Job Streams. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127

Chapter 13. Managing Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

Tivoli Job Scheduling Console User’s Guide vii

Chapter 14. Managing Workstations in the Plan . . . . . . . . . . . . . . . . . . . . . . . . 161

Chapter 15. Managing Resources in the Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

viii Version 8.1

Chapter 16. Managing Database Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

Chapter 17. Managing Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Tivoli Job Scheduling Console User’s Guide ix

Chapter 19. Managing Workstations and Workstation Classes . . . . . . . . 251

Chapter 20. Managing Domains, Users, and Calendars . . . . . . . . . . . . . . . . 261

Tivoli Job Scheduling Console User’s Guide xi

Chapter 21. Managing Resources, Prompts, and Parameters . . . . . . . . . . 271

Chapter 22. Plan Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

xii Version 8.1

Tivoli Job Scheduling Console User’s Guide xiii

Part IV. Appendixes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373

Appendix B. Setting Traces for the Job Scheduling Console . . . . . . . . . . 381

xiv Version 8.1

Appendix E. Job Scheduling Console Messages . . . . . . . . . . . . . . . . . . . . . . . 391

Tivoli Job Scheduling Console User’s Guide xv

Tivoli Job Scheduling Console User’s Guide xvii

xviii Version 8.1

Tivoli Job Scheduling Console User’s Guide xix

Tivoli Job Scheduling Console User’s Guide xxi

Tivoli Job Scheduling Console User’s Guide xxiii

xxiv Version 8.1

Tivoli Job Scheduling Console User’s Guide xxv

xxvi Version 8.1

Who Should Read This Guide

What This Guide Contains

Part I. Getting started

Part I contains the following chapters:

Tivoli Job Scheduling Console User’s Guide xxvii

Part II contains the following chapters:

Part III contains the following chapters:

xxviii Version 8.1

Part IV. Appendixes

Part IV contains the following Appendixes:

The Tivoli Workload Scheduler libraries comprise:

Tivoli Job Scheduling Console User’s Guide xxix

Tivoli Workload Scheduler

Accessing Publications Online

xxx Version 8.1

Updates to books between releases are provided in softcopy only.

You can also order by telephone by calling one of these numbers:

You can use LookAt on the Internet at: