View
240
Download
4
Category
Preview:
Citation preview
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
Version
8.2
(Maintenance
Release
April
2004)
SC32-1264-01
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
Version
8.2
(Maintenance
Release
April
2004)
SC32-1264-01
Note
Before
using
this
information
and
the
product
it
supports,
read
the
information
in
Notices
on
page
213.
Refreshed
Edition
(April
2004)
This
edition
applies
to
version
8,
release
2,
modification
0
of
IBM
Tivoli
Workload
Scheduler
for
z/OS
(program
number
5697-WSZ)
and
to
all
subsequent
releases
and
modifications
until
otherwise
indicated
in
new
editions.
Copyright
International
Business
Machines
Corporation
1991,
2004.
All
rights
reserved.
US
Government
Users
Restricted
Rights
Use,
duplication
or
disclosure
restricted
by
GSA
ADP
Schedule
Contract
with
IBM
Corp.
Contents
Figures
.
.
.
.
.
.
.
.
.
.
.
.
.
. vii
Tables
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
Preface
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xi
Maintenance
Release
.
.
.
.
.
.
.
.
.
.
. xi
Who
Should
Read
This
Manual
.
.
.
.
.
.
. xii
What
This
Manual
Contains
.
.
.
.
.
.
.
.
. xii
Publications
.
.
.
.
.
.
.
.
.
.
.
.
.
. xiii
Publications
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
.
.
.
. xiii
Publications
for
IBM
Tivoli
Workload
Scheduler
xiv
Using
LookAt
to
Look
up
Message
Explanations
xv
Accessing
Publications
Online
.
.
.
.
.
.
. xv
Softcopy
Collection
Kit
.
.
.
.
.
.
.
.
. xv
Ordering
Publications
.
.
.
.
.
.
.
.
.
. xvi
Accessibility
.
.
.
.
.
.
.
.
.
.
.
.
.
. xvi
Contacting
IBM
Software
Support
.
.
.
.
.
. xvi
Conventions
Used
in
This
Manual
.
.
.
.
.
. xvi
What
Is
New
in
This
Version
.
.
.
.
.
.
.
. xvii
z/OS
Functions
.
.
.
.
.
.
.
.
.
.
. xvii
End-to-End
Functions
.
.
.
.
.
.
.
.
. xvii
Server
Connectivity
.
.
.
.
.
.
.
.
.
. xviii
How
to
Read
Syntax
Diagrams
.
.
.
.
.
.
. xviii
Part
1.
Planning
.
.
.
.
.
.
.
.
.
. 1
Chapter
1.
Overview
.
.
.
.
.
.
.
.
. 3
Parts
and
Their
Relationships
.
.
.
.
.
.
.
.
. 3
Tracker
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
Controller
.
.
.
.
.
.
.
.
.
.
.
.
.
. 4
Server
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 4
Data
Store
.
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Configurations
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Controlling
System
.
.
.
.
.
.
.
.
.
. 5
Controlled
Systems
.
.
.
.
.
.
.
.
.
. 5
Integration
with
IBM
Tivoli
Workload
Scheduler
.
.
.
.
.
.
.
.
.
.
.
.
. 6
Subtasks
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 6
Relationship
between
the
Scheduler
and
z/OS
.
.
. 8
Using
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Program
Directory
.
.
.
.
.
.
.
.
.
.
.
. 9
Sample
Library
.
.
.
.
.
.
.
.
.
.
.
.
. 9
The
Installation
Process
.
.
.
.
.
.
.
.
.
.
. 9
Chapter
2.
Planning
Your
Configuration
11
Planning
Considerations
.
.
.
.
.
.
.
.
.
. 11
Trackers
.
.
.
.
.
.
.
.
.
.
.
.
.
. 11
Initialization
Statements
.
.
.
.
.
.
.
.
. 11
Communication
.
.
.
.
.
.
.
.
.
.
.
. 12
Ways
to
Connect
IBM
Tivoli
Workload
Scheduler
for
z/OS
Systems
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Shared
DASD
.
.
.
.
.
.
.
.
.
.
.
. 12
z/OS
Cross-System
Coupling
Facility
.
.
.
.
. 13
VTAM
(Network
Communication
Function)
.
. 13
TCP/IP
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 13
Workstation
Destination
.
.
.
.
.
.
.
.
.
. 13
Workload
Restart
.
.
.
.
.
.
.
.
.
.
.
. 14
JES
Considerations
.
.
.
.
.
.
.
.
.
.
.
. 14
Basic
Server
Configuration
Example
.
.
.
.
.
. 15
Basic
Configuration
Examples
.
.
.
.
.
.
.
. 16
DASD
Connected
.
.
.
.
.
.
.
.
.
.
. 17
VTAM
Connected
.
.
.
.
.
.
.
.
.
.
. 18
XCF
Connected
.
.
.
.
.
.
.
.
.
.
.
. 19
Tracker
and
Controller
in
a
Single
Address
Space
21
Basic
Data
Store
Configuration
Examples
.
.
.
. 22
SNA
Only
Connection
.
.
.
.
.
.
.
.
.
. 22
XCF
Only
Connection
.
.
.
.
.
.
.
.
.
. 24
Mixed
SNA
and
XCF
Connection
.
.
.
.
.
. 26
Part
2.
Installing
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
. 31
Chapter
3.
Planning
Your
Installation
33
Installation
Considerations
.
.
.
.
.
.
.
.
. 33
Configuring
for
Availability
.
.
.
.
.
.
.
. 33
Hot
Standby
.
.
.
.
.
.
.
.
.
.
.
.
. 33
Starting
an
Event
Writer
with
an
Event
Reader
Function
.
.
.
.
.
.
.
.
.
.
.
.
.
. 34
Using
a
Hierarchical
File
System
(HFS)
Cluster
34
Checklist
for
Installing
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
.
. 34
Chapter
4.
Installing
.
.
.
.
.
.
.
.
. 41
Step
1.
Loading
Tracker
Software
.
.
.
.
.
.
. 42
Step
2.
Loading
Controller
Software
.
.
.
.
.
. 43
Step
3.
Loading
National
Language
Support
Software
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 44
Step
4.
Using
the
EQQJOBS
Installation
Aid
.
.
. 44
Setting
Up
the
EQQJOBS
Installation
Aid
.
.
. 44
Creating
the
Sample
Job
JCL
.
.
.
.
.
.
.
. 45
Generating
Batch-Job
Skeletons
.
.
.
.
.
.
. 50
Generating
Data
Store
Samples
.
.
.
.
.
.
. 55
Step
5.
Adding
SMF
and
JES
Exits
for
Event
Tracking
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 58
SMF
Only
.
.
.
.
.
.
.
.
.
.
.
.
.
. 59
JES2
Only
.
.
.
.
.
.
.
.
.
.
.
.
.
. 60
JES3
Only
.
.
.
.
.
.
.
.
.
.
.
.
.
. 60
Step
6.
Updating
SYS1.PARMLIB
.
.
.
.
.
.
. 60
Defining
Subsystems
.
.
.
.
.
.
.
.
.
. 60
Calculating
MAXECSA
Values
.
.
.
.
.
. 61
Authorizing
the
Load-Module
Library
.
.
.
. 62
Updating
SMF
Parameters
.
.
.
.
.
.
.
. 63
Updating
z/OS
Dump
Options
.
.
.
.
.
.
. 64
Updating
the
z/OS
Link-Library
Definition
.
.
. 65
Updating
XCF
Initialization
Options
.
.
.
.
. 65
Modifying
TSO
Parameters
.
.
.
.
.
.
.
. 66
Performance
Considerations
.
.
.
.
.
.
.
. 67
Copyright
IBM
Corp.
1991,
2004
iii
||
|
|
Defining
the
DLF
Exit
for
Hiperbatch
Support
.
. 68
Starting
the
Product
Automatically
.
.
.
.
. 68
Updating
APPC
Options
.
.
.
.
.
.
.
.
. 68
Implementing
Support
for
Data
Set
Triggering
.
. 68
Step
7.
Setting
Up
the
RACF
Environment
.
.
.
. 69
Controlling
the
User
ID
of
the
Address
Space
.
. 69
Controlling
the
User
ID
of
Submitted
Jobs
.
.
. 70
Normal
Batch
Jobs
.
.
.
.
.
.
.
.
.
. 70
Batch
Jobs
.
.
.
.
.
.
.
.
.
.
.
.
. 70
Protecting
Data
Sets
.
.
.
.
.
.
.
.
.
. 70
Controlling
Access
to
Resources
.
.
.
.
.
. 71
Permitting
Access
to
the
Controller
through
the
API
.
.
.
.
.
.
.
.
.
.
.
.
.
. 73
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
Resources
when
Using
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 73
Permitting
Access
to
the
Controller
through
the
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
. 73
Authorizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
as
a
Job
Submitter
.
.
.
.
.
.
.
.
. 73
Authorizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
to
Issue
JES
Commands
.
.
.
.
.
.
. 74
Authorizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
Data
Store
to
Issue
JES
Commands
.
.
. 75
Step
8.
Allocating
Data
Sets
.
.
.
.
.
.
.
.
. 76
Allocating
the
VSAM
Data
Sets
.
.
.
.
.
.
. 78
Application
Description
Data
set
(EQQADDS)
81
Current
Plan
Data
sets
(EQQCPnDS)
.
.
.
. 81
Current
Plan
Backup
Copy
Dataset
to
Create
Symphony
(EQQSCPDS)
.
.
.
.
.
.
.
. 82
JCL
Repository
Data
sets
(EQQJSnDS)
.
.
. 82
Allocating
Restart
and
Clean
Up
VSAM
Data
Sets
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 82
Restart
and
Clean
Up
Data
Sets
(EQQPKIxx,
EQQSKIxx,
and
EQQSDFxx)
.
.
.
.
.
.
. 83
Allocating
Non-VSAM
Data
Sets
.
.
.
.
.
. 83
Internal
Reader
Data
Set
(EQQBRDS)
.
.
.
. 85
Checkpoint
Data
Set
(EQQCKPT)
.
.
.
.
. 85
Diagnostic
Data
Sets
(EQQDMSG,
EQQDUMP,
and
SYSMDUMP)
.
.
.
.
.
.
.
.
.
. 86
Event
Data
Set
(EQQEVDS
and
EQQEVDnn)
87
Job
Library
Data
Set
(EQQJBLIB)
.
.
.
.
. 88
Job-Completion-Checker
Data
Sets
.
.
.
.
. 88
Job-Tracking
Data
Sets
(EQQJTARC,
EQQJTnn,
EQQDLnn)
.
.
.
.
.
.
.
.
.
.
.
. 89
Message
Log
Data
Set
(EQQMLOG)
.
.
.
. 90
Parameter
Library
(EQQPARM)
.
.
.
.
. 91
PIF
Parameter
Data
Set
(EQQYPARM)
.
.
. 91
Automatic-Recovery-Procedure
Library
(EQQPRLIB)
.
.
.
.
.
.
.
.
.
.
.
. 91
End-to-end
Script
Library
(EQQSCLIB)
.
.
. 91
Started-Task-Submit
Data
Set
(EQQSTC)
.
.
. 92
Submit/Release
Data
Set
(EQQSUDS)
.
.
. 92
End-to-end
Centralized
Script
Data
Set
(EQQTWSCS)
.
.
.
.
.
.
.
.
.
.
.
. 92
End-to-end
Input
and
Output
Events
Data
Sets
(EQQTWSIN
and
EQQTWSOU)
.
.
.
. 93
Allocating
Data
Store
Data
Sets
.
.
.
.
.
.
. 94
Allocating
the
Files
and
Directories
.
.
.
.
. 94
Step
9.
Creating
JCL
Procedures
for
Address
Spaces
95
Implementing
Support
for
Started-Task
Operations
.
.
.
.
.
.
.
.
.
.
.
.
. 96
Required
Data
Sets
.
.
.
.
.
.
.
.
.
.
. 97
Optional
Data
Sets
.
.
.
.
.
.
.
.
.
.
. 98
Step
10.
Defining
the
Initialization
Statements
.
. 101
Step
11.
Creating
the
DB2
Database
.
.
.
.
.
. 101
Sample
to
Migrate
the
History
Database
.
.
. 101
Step
12.
Setting
Up
the
ISPF
Environment
.
.
.
. 102
Setting
Up
the
CLIST
Library
.
.
.
.
.
.
. 103
Setting
Up
the
ISPF
Tables
.
.
.
.
.
.
.
. 103
Setting
Up
the
Default
Dialogcontroller
Connection
Table
.
.
.
.
.
.
.
.
.
. 103
Setting
Up
List
Tables
and
Graphical
Attribute
Tables
.
.
.
.
.
.
.
.
.
. 104
Allocating
Dialog
Data
Sets
to
Your
TSO
Session
104
Invoking
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Dialog
.
.
.
.
.
.
.
.
.
.
.
.
. 105
Using
the
EQQOPCAC
Sample
CLIST
.
.
. 105
Modifying
an
Existing
ISPF
Selection
Menu
105
Selecting
the
Main
Menu
Directly
from
TSO
106
Using
the
ISPF
Select
Service
.
.
.
.
.
. 106
Step
13.
Using
XCF
for
Communication
.
.
.
. 106
XCF
Groups
.
.
.
.
.
.
.
.
.
.
.
.
. 107
XCF
Run-Time
Options
.
.
.
.
.
.
.
.
. 108
Initialization
Statements
Used
for
XCF
.
.
.
. 108
Step
14.
Activating
the
Network
Communication
Function
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 108
Adding
NCF
to
the
VTAM
Network
Definitions
109
Adding
NCF
Session
Parameters
.
.
.
.
.
. 110
COS
Table
.
.
.
.
.
.
.
.
.
.
.
. 111
Activating
Network
Resources
.
.
.
.
.
.
. 111
Diagnostic
Data
Set
.
.
.
.
.
.
.
.
.
. 111
Step
15.
Activating
Support
for
the
API
.
.
.
.
. 111
Defining
VTAM
Resources
.
.
.
.
.
.
.
. 112
Defining
a
Local
LU
.
.
.
.
.
.
.
.
. 112
Defining
Logon
Modes
.
.
.
.
.
.
.
. 112
Defining
Cross-Domain
Resources
.
.
.
. 113
Updating
APPC
Options
.
.
.
.
.
.
.
.
. 113
Activating
Support
for
APPC
.
.
.
.
.
.
. 114
Step
16.
Activating
Support
for
the
Product
Dialog
and
Programming
Interface
Using
the
Server
.
.
. 114
Defining
VTAM
Resources
for
the
Product
Dialog
and
Program
Interface
Using
the
Server
. 115
Defining
VTAM
Resources
for
the
Server
.
.
. 116
Defining
a
Local
LU
for
the
Server
.
.
.
. 116
Defining
Logon
Modes
for
the
Server
.
.
. 116
Updating
APPC
Options
for
the
Server
.
.
.
. 117
Defining
VTAM
Resources
in
a
Parallel
Sysplex
117
Starting
the
Server
.
.
.
.
.
.
.
.
.
.
. 118
Step
17.
Activating
Support
for
the
End-to-end
Feature
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 118
Activating
Server
Support
for
the
End-to-end
Feature
.
.
.
.
.
.
.
.
.
.
.
.
.
. 118
Step
18.
Activating
Support
for
the
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
.
.
. 119
Activating
Server
Support
for
the
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
.
. 119
Chapter
5.
Verifying
Your
Installation
121
Overview
of
Verification
.
.
.
.
.
.
.
.
.
. 121
iv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
|||
Verifying
Installation
of
a
Tracker
.
.
.
.
.
. 121
Ensuring
that
All
Installation
Tasks
Are
Complete
.
.
.
.
.
.
.
.
.
.
.
.
.
. 122
Checking
the
Message
Log
(EQQMLOG)
.
.
. 122
Verifying
Tracking
Events
.
.
.
.
.
.
.
. 123
The
Event
Writer
.
.
.
.
.
.
.
.
.
. 123
The
Event
Data
set
.
.
.
.
.
.
.
.
. 123
Performing
Problem
Determination
for
Tracking
Events
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 124
Verifying
Installation
of
a
Controller
and
Dialogs
127
Ensuring
that
All
Installation
Tasks
Are
Complete
.
.
.
.
.
.
.
.
.
.
.
.
.
. 127
Checking
the
Message
Log
(EQQMLOG)
.
.
. 127
Checking
the
Server
Message
Log
.
.
.
.
. 128
Checking
Dialog
Functions
.
.
.
.
.
.
.
. 128
Performing
Problem
Determination
.
.
.
.
. 129
Dialog
Problems
.
.
.
.
.
.
.
.
.
. 129
Authority
Problems
.
.
.
.
.
.
.
.
. 129
Verifying
Installation
of
a
Standby
Controller
.
.
. 130
Ensuring
that
All
Installation
Tasks
Are
Complete
.
.
.
.
.
.
.
.
.
.
.
.
.
. 130
Checking
the
Message
Log
(EQQMLOG)
.
.
. 130
Verifying
Installation
of
the
Restart
and
Cleanup
Function
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 131
Checking
the
Message
Log
(EQQMLOG)
.
.
. 132
Verifying
Configuration
.
.
.
.
.
.
.
.
.
. 133
Creating
Entries
in
the
Databases
.
.
.
.
.
. 133
Running
Batch
Jobs
.
.
.
.
.
.
.
.
.
. 133
Checking
the
Message
Logs
(EQQMLOG)
.
.
. 133
Controller
Message
Log
.
.
.
.
.
.
.
. 133
Tracker
Message
Log
.
.
.
.
.
.
.
.
. 141
Verifying
Workload
Submission
.
.
.
.
.
. 144
Controlling
System
.
.
.
.
.
.
.
.
. 144
Controlled
Systems
.
.
.
.
.
.
.
.
. 144
Verifying
Job
Submission
.
.
.
.
.
.
.
. 145
Verifying
Takeover
by
a
Standby
Controller
.
. 146
Part
3.
Migrating
.
.
.
.
.
.
.
.
. 147
Chapter
6.
Planning
for
Migration
.
.
. 149
Installation
Considerations
.
.
.
.
.
.
.
.
. 149
Customization
Considerations
.
.
.
.
.
.
.
. 149
Migration
Strategies
.
.
.
.
.
.
.
.
.
.
. 150
JES
and
SMF
Exits
.
.
.
.
.
.
.
.
.
.
. 150
Migrating
to
Existing
Subsystem
Definitions
.
. 150
Migrating
to
New
Subsystem
Definitions
.
.
. 151
Getting
the
Right
Software
Parts
.
.
.
.
.
. 151
Load
Modules
.
.
.
.
.
.
.
.
.
.
. 151
The
ISPF
environment
.
.
.
.
.
.
.
. 152
Migration
Overview
.
.
.
.
.
.
.
.
.
.
. 153
Migration
Overview
.
.
.
.
.
.
.
.
.
. 153
Establishing
the
Required
Environment
.
.
.
. 153
Program
Requirements
.
.
.
.
.
.
.
.
. 153
Installation
and
Verification
.
.
.
.
.
.
.
. 153
Parallel
Testing
.
.
.
.
.
.
.
.
.
.
.
.
. 154
Migrating
an
End-to-end
Network
.
.
.
.
.
. 155
Migrating
from
a
Tracker
Agent
to
a
Distributed
Agent
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 155
Using
the
Tracker
Jobs
Migration
Tool
.
.
.
. 156
Migrating
Backwards
.
.
.
.
.
.
.
.
.
. 157
Migrating
DB2
.
.
.
.
.
.
.
.
.
.
.
.
. 158
Running
on
Upgraded
Operating
Systems
.
.
.
. 158
Chapter
7.
Migration
Actions
.
.
.
.
. 159
Migrating
Data
Sets
.
.
.
.
.
.
.
.
.
.
. 159
EQQICTOP
VSAM
Data
Set
Conversion
Program
.
.
.
.
.
.
.
.
.
.
.
.
.
. 160
Data
Sets
that
You
Need
to
Convert
.
.
.
.
. 163
Data
Sets
that
Can
Be
Used
.
.
.
.
.
.
. 163
Empty
Data
Sets
.
.
.
.
.
.
.
.
.
.
. 163
Switching
into
Production
Mode
.
.
.
.
.
.
. 164
Closing
Down
Your
Production
System
.
.
.
. 164
Ensuring
that
LTP
and
NCP
Data
Sets
Are
Current
.
.
.
.
.
.
.
.
.
.
.
.
.
. 165
Converting
VSAM
Files
to
the
New
System
Format
.
.
.
.
.
.
.
.
.
.
.
.
.
. 165
Starting
the
New
System
.
.
.
.
.
.
.
. 166
Starting
the
New
System
in
a
Heavy
Workload
Environment
.
.
.
.
.
.
.
.
.
.
.
. 167
Validating
the
New
System
.
.
.
.
.
.
.
. 168
Performing
Fallback
.
.
.
.
.
.
.
.
.
.
. 168
Part
4.
Appendixes
.
.
.
.
.
.
.
. 171
Appendix
A.
Accessibility
.
.
.
.
.
. 173
Navigating
the
interface
using
the
keyboard
.
.
. 173
Magnifying
what
is
displayed
on
the
screen
.
.
. 173
Appendix
B.
Sample
Library
(SEQQSAMP)
.
.
.
.
.
.
.
.
.
.
. 175
Using
the
Visual
Age
Compiler
.
.
.
.
.
.
. 179
SMP/E
Samples
.
.
.
.
.
.
.
.
.
.
.
. 180
Environment
Setup
.
.
.
.
.
.
.
.
.
. 180
RECEIVE
Processing
.
.
.
.
.
.
.
.
.
. 180
APPLY
Processing
.
.
.
.
.
.
.
.
.
.
. 181
ACCEPT
Processing
.
.
.
.
.
.
.
.
.
. 182
SMF
Exits
.
.
.
.
.
.
.
.
.
.
.
.
.
. 182
Exit
Installation
.
.
.
.
.
.
.
.
.
.
.
. 183
Job
Step
Termination
Exit
.
.
.
.
.
.
.
. 183
Initialization
Exit
.
.
.
.
.
.
.
.
.
.
. 183
Record
Write
Exit
.
.
.
.
.
.
.
.
.
.
. 184
JES
Exits
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 184
Exit
Installation
.
.
.
.
.
.
.
.
.
.
.
. 184
JES2
JCT
I/O
Exit
.
.
.
.
.
.
.
.
.
.
. 184
JES3
OSE
Modification
Exit
.
.
.
.
.
.
.
. 185
JES3
Input
Service
Final-User
Exit
.
.
.
.
. 185
RACF
Samples
.
.
.
.
.
.
.
.
.
.
.
.
. 185
Class
Descriptor
Table
.
.
.
.
.
.
.
.
. 185
Router
Table
.
.
.
.
.
.
.
.
.
.
.
.
. 185
Sample
Library
(SEQQSAMP)
.
.
.
.
.
.
.
. 185
Appendix
C.
Configuration
Examples
187
The
Controlling
System
.
.
.
.
.
.
.
.
.
. 187
Automatic
Restart
Actions
.
.
.
.
.
.
.
.
. 187
Initialization
Statements
.
.
.
.
.
.
.
.
.
. 187
Multi-Access
Spool
Systems
Connected
via
Shared
DASD
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 187
Individual
Systems
Connected
via
Shared
DASD
190
A
z/OS
Sysplex
.
.
.
.
.
.
.
.
.
.
.
. 192
Contents
v
A
PLEX
Configuration
.
.
.
.
.
.
.
.
.
. 195
Controlling
a
z/OS
System
via
a
VTAM
Link
.
.
. 197
Controlling
a
JES2
MAS
System
via
a
VTAM
Link
198
Appendix
D.
Invoking
the
EQQEXIT
Macro
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 201
Invoking
EQQEXIT
in
SMF
Exits
.
.
.
.
.
.
. 201
Invoking
EQQEXIT
in
JES
Exits
.
.
.
.
.
.
. 201
Macro
Invocation
Syntax
for
EQQEXIT
.
.
.
. 203
Appendix
E.
Invoking
the
EQQLSENT
Macro
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 205
Invoking
EQQLSENT
to
Create
EQQDSLST
.
.
. 205
Macro
Invocation
Syntax
for
EQQLSENT
.
.
. 206
Appendix
F.
Hardware
and
Software
Requirements
.
.
.
.
.
.
.
.
.
.
. 209
Hardware
Requirements
.
.
.
.
.
.
.
.
.
. 209
Software
Requirements
and
Optional
Software
.
. 210
Controlling
System
.
.
.
.
.
.
.
.
.
. 210
Controlled
OS/390
Systems
.
.
.
.
.
.
. 210
Optional
Software
.
.
.
.
.
.
.
.
.
.
. 210
Related
Software
.
.
.
.
.
.
.
.
.
.
.
. 211
Software
Compatibility
.
.
.
.
.
.
.
.
.
. 211
Notices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 213
Trademarks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 214
Glossary
.
.
.
.
.
.
.
.
.
.
.
.
. 215
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 229
vi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
Figures
1.
A
Basic
Server
Configuration
Example
.
.
. 15
2.
A
z/OS
System
Connected
via
Shared
DASD
17
3.
A
z/OS
System
with
a
VTAM
Connection
19
4.
A
z/OS
System
with
an
XCF
Connection
20
5.
A
Tracker
and
Controller
Configured
in
a
Single
Address
Space
.
.
.
.
.
.
.
.
. 22
6.
Controller
and
Tracker
in
Same
Address
Space
with
Tracker
Connected
via
SNA.
.
.
.
.
. 23
7.
Controller,
Tracker,
and
Data
Store
Connected
via
XCF
.
.
.
.
.
.
.
.
.
.
.
.
.
. 25
8.
A
Mixed
SNA
and
XCF
Connection
.
.
.
. 27
9.
EQQJOBS0EQQJOBS
Application
Menu
45
10.
EQQJOBS3Create
Sample
Job
JCL
.
.
.
. 45
11.
EQQJOBS4Create
Sample
Job
JCL
.
.
.
. 46
12.
EQQJOBS8Create
Sample
Job
JCL
.
.
.
. 48
13.
EQQJOBS1Generate
IBM
Tivoli
Workload
Scheduler
for
z/OS
Batch-Job
Skeletons
.
.
. 51
14.
EQQJOBS2Generate
IBM
Tivoli
Workload
Scheduler
for
z/OS
Batch-Job
Skeletons
.
.
. 52
15.
EQQJOBSAGenerate
IBM
Tivoli
Workload
Scheduler
for
z/OS
Batch-Job
Skeletons
.
.
. 53
16.
EQQJOBS5Create
Data
Store
Samples
55
17.
EQQJOBS6Create
Data
Store
Samples
56
18.
EQQJOBS7Create
Data
Store
Samples
57
19.
Sample
Message
Log
for
a
Standby
controller
131
20.
Sample
Message
Log
for
a
Controller
137
21.
Sample
Message
Log
for
a
Tracker
.
.
.
. 143
22.
Two
z/OS
JES2
MAS
Complexes
Connected
via
Shared
DASD
.
.
.
.
.
.
.
.
.
. 188
23.
Individual
Systems
Connected
via
Shared
DASD
.
.
.
.
.
.
.
.
.
.
.
.
.
. 191
24.
A
z/OS
Sysplex
.
.
.
.
.
.
.
.
.
.
. 193
25.
An
IBM
Tivoli
Workload
Scheduler
for
z/OS
PLEX
Environment
.
.
.
.
.
.
.
.
. 196
26.
Controlling
an
z/OS
System
via
a
VTAM
Link
.
.
.
.
.
.
.
.
.
.
.
.
.
. 197
27.
Controlling
a
JES2
MAS
System
via
a
VTAM
Link
.
.
.
.
.
.
.
.
.
.
.
.
.
. 199
Copyright
IBM
Corp.
1991,
2004
vii
viii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
Tables
1.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subtasks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 6
2.
These
Stages
Summarize
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Process
.
.
.
.
.
.
.
.
.
.
.
.
.
. 10
3.
Example
EQQSERP
Members
for
Figure
1
16
4.
Example
EQQPARM
Members
for
Figure
2
18
5.
Example
EQQPARM
Members
for
Figure
3
on
page
19
.
.
.
.
.
.
.
.
.
.
.
.
.
. 19
6.
Example
EQQPARM
Members
for
Figure
4
on
page
20
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
7.
Example
EQQPARM
Members
for
Figure
5
on
page
22
.
.
.
.
.
.
.
.
.
.
.
.
.
. 22
8.
Example
Members
for
Figure
6
on
page
23
24
9.
Example
Members
for
Figure
7
on
page
25
26
10.
Example
Members
for
Figure
8
on
page
27
29
11.
Checklist
for
Installing
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
. 34
12.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Tasks
.
.
.
.
.
.
.
.
.
.
. 41
13.
Tracker
Libraries
Loaded
by
SMP/E
.
.
.
. 42
14.
controller
Libraries
Loaded
by
SMP/E
.
.
. 43
15.
NLS
Libraries
Loaded
by
SMP/E
.
.
.
.
. 44
16.
Sample
JCL
Generated
by
the
EQQJOBS
Dialog
.
.
.
.
.
.
.
.
.
.
.
.
.
. 49
17.
controller
Skeleton
JCL
Generated
by
the
EQQJOBS
Dialog
.
.
.
.
.
.
.
.
.
.
. 54
18.
Data
Store
Samples
Generated
by
the
EQQJOBS
Dialog
.
.
.
.
.
.
.
.
.
.
. 58
19.
Sample
Exits
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
. 59
20.
Examples
of
MAXECSA
Storage
Values
62
21.
Sample
Library
Members
for
Updating
RACF
Tables
.
.
.
.
.
.
.
.
.
.
.
.
.
. 72
22.
IBM
Tivoli
Workload
Scheduler
for
z/OS
VSAM
Data
sets
.
.
.
.
.
.
.
.
.
.
. 78
23.
Calculations
of
VSAM
Data
Set
Size
.
.
.
. 80
24.
Restart
and
Clean
Up
VSAM
data
sets
.
.
. 82
25.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Non-VSAM
Data
sets
.
.
.
.
.
.
.
.
. 83
26.
Data
Store
VSAM
data
sets
.
.
.
.
.
.
. 94
27.
Started
task
JCL
samples
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
address
spaces.
. 96
28.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Required
data
sets
.
.
.
.
.
.
.
.
.
. 97
29.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Optional
data
sets
.
.
.
.
.
.
.
.
.
. 99
30.
ISPF
and
IBM
Tivoli
Workload
Scheduler
for
z/OS
Dialog
Data
Sets
.
.
.
.
.
.
.
. 104
31.
Problem
Determination
for
Missing
Tracking
Events
.
.
.
.
.
.
.
.
.
.
.
.
.
. 124
32.
Recommended
PTFs
for
Previous
Versions
of
IBM
Tivoli
Workload
Scheduler
for
z/OS
for
JES2
EXIT7
.
.
.
.
.
.
.
.
.
.
.
. 150
33.
Data
Sets
that
You
Need
to
Convert
.
.
.
. 163
34.
Data
Sets
that
IBM
Tivoli
Workload
Scheduler
for
z/OS
Can
Use
.
.
.
.
.
.
.
.
.
. 163
35.
SEQQSAMP
Library
Members
.
.
.
.
.
. 175
36.
Example
EQQPARM
Members
for
the
Previous
Figure
.
.
.
.
.
.
.
.
.
.
. 189
37.
Example
EQQPARM
Members
for
the
Previous
Figure
.
.
.
.
.
.
.
.
.
.
. 191
38.
Example
EQQPARM
Members
for
Figure
24
on
page
193
.
.
.
.
.
.
.
.
.
.
.
. 194
39.
Example
EQQPARM
Members
for
the
Previous
Figure
.
.
.
.
.
.
.
.
.
.
. 196
40.
Example
EQQPARM
Members
for
Figure
17
198
41.
Example
EQQPARM
Members
for
Figure
18
200
Copyright
IBM
Corp.
1991,
2004
ix
x
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
Preface
Installation
Guide
describes
the
configuration
planning
and
installation
tasks
of
IBM
Tivoli
Workload
Scheduler
for
z/OS.
Installation
is
the
task
of
making
a
program
ready
to
do
useful
work.
This
task
includes
adding
the
materials
on
the
IBM
distribution
tape
to
your
system,
initializing
the
program,
and
applying
PTFs
to
the
program.
When
you
install
a
product,
you
are
carrying
out
decisions
you
made
in
the
planning
step.
Customization,
an
optional
step,
gives
you
the
opportunity
to
tailor
the
program
to
the
desired
behavior
or
special
needs
of
your
site.
Your
workload
can
run
on
various
platforms,
but
you
control
it
from
a
central
z/OS
system
that
runs
the
Tivoli
Workload
Scheduler
for
z/OS
controller.
The
term
the
scheduler,
when
used
in
this
book,
refers
to
Tivoli
Workload
Scheduler
for
z/OS.
The
term
DB2,
when
used
in
this
book,
also
applies
to
DATABASE2
and
DB2
Universal
Database.
The
term
z/OS
is
used
in
this
manual
to
mean
z/OS
and
OS/390
operating
systems.
Where
the
term
OS/390
appears,
the
related
information
applies
only
to
OS/390
operating
systems.
This
manual
complements
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Program
Directory
which
covers
adding
the
materials
on
the
IBM
distribution
tape
to
your
system.
The
Program
Directory
comes
with
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
installation
tape.
It
describes
all
of
the
installation
materials
and
gives
installation
instructions
specific
to
the
product
release
level
or
feature
number.
If
any
differences
exist
between
this
manual
and
the
Program
Directory
use
the
information
in
the
Program
Directory.
Maintenance
Release
This
is
a
maintenance
refresh
of
the
corresponding
IBM
Tivoli
Workload
Scheduler
for
z/OS
Version
8.2
manual,
form
number
SC32126400.
It
contains
updates
for
the
following
APARS:
v
PQ78043
v
PQ78350
v
PQ79246
v
PQ79567
v
PQ80229
v
PQ80811
v
PQ81700
Throughout
the
book,
the
changed
or
new
sections
are
marked
by
revision
bars.
If
your
version
of
the
product
has
not
been
fixed
for
a
particular
APAR,
refer
to
the
original
version
of
the
manual
for
the
corresponding
information.
Copyright
IBM
Corp.
1991,
2004
xi
|
|||
|
|
|
|
|
|
|
|||
Who
Should
Read
This
Manual
This
book
is
intended
for
system
programmers
who
are
responsible
for
software
on
an
z/OS
system
and
plan
on
installing
IBM
Tivoli
Workload
Scheduler
for
z/OS.
To
use
this
book
effectively,
you
must
be
familiar
with
the
following
topics:
v
Job
control
language
(JCL)
v
IBM
System
Modification
Program
Extended
(SMP/E)
v
z/OS
v
JES
concepts
and
facilities
v
Writing
small
code
fragments
in
the
Assembler
H
language
v
Interactive
System
Productivity
Facility
(ISPF)
v
Interactive
System
Productivity
Facility/Program
Development
Facility
(ISPF/PDF)
v
Time-Sharing
Option
(TSO)
v
Virtual
Storage
Access
Method
(VSAM)
(desirable
but
not
essential)
The
IBM
Tivoli
Workload
Scheduler
for
z/OS
Application
Programming
Interface
(API)
uses
advanced
program-to-program
communication
(APPC)
services.
Defining
and
configuring
the
conversation
partners
requires
some
knowledge
of
APPC
services.
What
This
Manual
Contains
This
manual
contains
the
following
sections:
Part
1,
Planning
This
part
contains
the
following
chapters:
v
Chapter
1,
Overview,
on
page
3
Describes
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
parts,
subtasks,
and
introduces
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
configuration
options.
v
Chapter
2,
Planning
Your
Configuration,
on
page
11
Describes
connections
between
IBM
Tivoli
Workload
Scheduler
for
z/OS
systems
and
provides
possible
configurations
to
consider
when
planning
your
installation.
Part
2,
Installing
Tivoli
Workload
Scheduler
for
z/OS
This
part
contains
the
following
chapters:
v
Chapter
3,
Planning
Your
Installation,
on
page
33
Offers
considerations
for
the
installation
process
and
provides
a
checklist
that
you
can
use
to
perform
the
installation.
v
Chapter
4,
Installing,
on
page
41
Guides
you,
step-by-step,
through
the
installation
process,
from
loading
software
to
verifying
that
the
product
has
been
installed
correctly.
v
Chapter
5,
Verifying
Your
Installation,
on
page
121
Contains
the
installation
verification
process.
Part
3,
Migrating
xii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
This
part
contains
the
following
chapters:
v
Chapter
6,
Planning
for
Migration,
on
page
149
Describes
planning
for
migration.
v
Chapter
7,
Migration
Actions,
on
page
159
Guides
you,
step-by-step,
through
the
conversion
process
to
Version
8.2
from
earlier
versions
and
releases
of
the
product.
Part
4.
Appendixes
This
part
contains
the
following
appendixes:
v
Appendix
A,
Accessibility,
on
page
173
Describes
the
features
that
make
the
product
and
the
documentation
accessible
to
users
with
physical
disabilities,
such
as
restricted
mobility
or
limited
vision.
v
Appendix
B,
Sample
Library
(SEQQSAMP),
on
page
175
Describes
the
members
of
the
sample
library.
v
Appendix
C,
Configuration
Examples,
on
page
187
Contains
complex
configuration
examples
for
multiple
systems
and
multiple
data
centers.
v
Appendix
D,
Invoking
the
EQQEXIT
Macro,
on
page
201
Describes
how
you
generate
event-tracking
code
using
the
event-tracking-exits
macro.
v
Appendix
E,
Invoking
the
EQQLSENT
Macro,
on
page
205
Describes
how
to
create
a
table
of
data
set
names
that
you
want
to
monitor
for
data
set
close.
v
Appendix
F,
Hardware
and
Software
Requirements,
on
page
209
Lists
the
hardware
and
software
prerequisites.
Publications
This
section
lists
publications
in
the
Tivoli
Workload
Scheduler
for
z/OS
library
and
any
other
related
documents.
It
also
describes
how
to
access
Tivoli
publications
online,
how
to
order
Tivoli
publications,
and
how
to
make
comments
on
Tivoli
publications.
Publications
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
The
following
documents
are
available
in
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
library:
v
Customization
and
Tuning,
SC32-1265
Describes
how
to
customize
IBM
Tivoli
Workload
Scheduler
for
z/OS.
v
Diagnosis
Guide
and
Reference,
SC32-1261
Provides
information
to
help
diagnose
and
correct
possible
problems
when
using
the
product.
v
General
Information,
SC32-1256
Describes
the
benefits
of
the
entire
IBM
Tivoli
Workload
Scheduler
suite.
v
Getting
Started,
SC32-1262
Describes
concepts
and
terminology
of
IBM
Tivoli
Workload
Scheduler
for
z/OS
and
provides
instructions
to
get
you
working
with
the
product
as
soon
as
possible.
v
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
Release
Notes,
SC32-1258
Preface
xiii
Provides
information
about
working
with
IBM
Tivoli
Workload
Scheduler,
regardless
of
platform,
from
a
common
GUI.
v
IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
Users
Guide,
SC32-1257
Provides
information
about
working
with
IBM
Tivoli
Workload
Scheduler,
regardless
of
platform,
from
a
common
GUI.
v
Licensed
Program
Specifications,
GI11-4208
Provides
planning
information
to
plan
about
IBM
Tivoli
Workload
Scheduler
for
z/OS.
v
Managing
the
Workload,
SC32-1263
Explains
how
to
plan
and
schedule
the
workload
and
how
to
control
and
monitor
the
current
plan.
v
Memo
to
Users,
GI11-4209
Provides
a
summary
of
changes
for
the
current
release
of
the
product.
v
Messages
and
Codes,
SC32-1267
Explains
messages
and
codes.
v
Program
Directory,
GI11-4203
Provided
with
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
installation
tape,
describes
all
of
the
installation
materials
and
gives
installation
instructions
specific
to
the
product
release
level
or
feature
number.
v
Programming
Interfaces,
SC32-1266
Provides
information
to
write
application
programs.
v
Quick
Reference,
SC32-1268
Provides
a
quick
and
easy
consultation
reference
to
operate
the
product.
Publications
for
IBM
Tivoli
Workload
Scheduler
The
following
manuals
are
available
in
the
IBM
Tivoli
Workload
Scheduler
library:
v
IBM
Tivoli
Workload
Scheduler
Planning
and
Installation
Guide,
SC32-1273
Describes
planning
and
installing
IBM
Tivoli
Workload
Scheduler.
v
IBM
Tivoli
Workload
Scheduler
Reference
Guide,
SC32-1274
Explains
the
IBM
Tivoli
Workload
Scheduler
command
line,
understanding
how
extended
and
network
agents
work,
and
integrating
IBM
Tivoli
Workload
Scheduler
with
NetView
and
with
IBM
Tivoli
Business
Systems
Manager.
v
IBM
Tivoli
Workload
Scheduler
Troubleshooting
and
Error
Messages,
SC32-1275
Interprets
IBM
Tivoli
Workload
Scheduler
error
messages,
and
provides
sources
of
information
that
will
help
you
in
solving
problems
with
IBM
Tivoli
Workload
Scheduler.
v
IBM
Tivoli
Workload
Scheduler
for
Applications
Users
Guide,
SC32-1278
Describes
installing,
using,
and
troubleshooting
for
the
IBM
Tivoli
Workload
Scheduler
extended
agents.
v
IBM
Tivoli
Workload
Scheduler
for
Applications
Release
Notes,
SC32-1279
Provides
last-minute
information
about
the
IBM
Tivoli
Workload
Scheduler
extended
agents.
v
IBM
Tivoli
Workload
Scheduler
Limited
Fault-tolerant
Agent
for
AS/400
Users
Guide,
SC32-1280
Describes
installing,
configuring,
and
using
IBM
Tivoli
Workload
Scheduler
fault-tolerant
agents
on
AS/400.
v
IBM
Tivoli
Workload
Scheduler
Plus
Module
Users
Guide,
SC32-1276
Explains
setting
up
and
using
the
IBM
Tivoli
Workload
Scheduler
Plus
module.
xiv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
v
IBM
Tivoli
Workload
Scheduler
Release
Notes,
SC32-1277
Explains
late-breaking
information
about
IBM
Tivoli
Workload
Scheduler.
Using
LookAt
to
Look
up
Message
Explanations
LookAt
is
an
online
facility
that
lets
you
look
up
explanations
for
most
messages
you
encounter,
as
well
as
for
some
system
abends
and
codes.
Using
LookAt
to
find
information
is
faster
than
a
conventional
search
because
in
most
cases
LookAt
goes
directly
to
the
message
explanation.
You
can
access
LookAt
from
the
Internet
at:
http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/
or
from
anywhere
in
z/OS
or
z/OS.e
where
you
can
access
a
TSO/E
command
line
(for
example,
TSO/E
prompt,
ISPF,
z/OS
UNIX
System
Services
running
OMVS).
The
LookAt
Web
site
also
features
a
mobile
edition
of
LookAt
for
devices
such
as
PCs,
Palm
OS,
or
Linux-based
handhelds.
So,
if
you
have
a
handheld
device
with
wireless
access
and
an
Internet
browser,
you
can
now
access
LookAt
message
information
from
almost
anywhere.
To
use
LookAt
as
a
TSO/E
command,
you
must
have
LookAt
installed
on
your
host
system.
You
can
obtain
the
LookAt
code
for
TSO/E
from
a
disk
on
your
SK3T-4270
Collection
Kit
or
from
the
LookAt
Web
sites
Download
link.
Accessing
Publications
Online
The
product
CD
contains
the
publications
that
are
in
the
product
library.
The
format
of
the
publications
is
PDF,
HTML,
or
both.
To
access
the
publications
using
a
Web
browser,
open
the
infocenter.html
file.
The
file
is
in
the
appropriate
publications
directory
on
the
product
CD.
IBM
posts
publications
for
this
and
all
other
Tivoli
products,
as
they
become
available
and
whenever
they
are
updated,
to
the
Tivoli
Software
Information
Center
Web
site.
The
Tivoli
Software
Information
Center
is
located
at
the
following
Web
address:
http://publib.boulder.ibm.com/tividd/td/tdprodlist.html
Click
the
Tivoli
Workload
Scheduler
for
z/OS
link
to
access
the
product
library.
Note:
If
you
documents
on
other
than
letter-sized
paper,
select
the
Fit
to
page
check
box
in
the
Adobe
Acrobat
dialog.
This
option
is
available
when
you
click
File
Print.
Fit
to
page
ensures
that
the
full
dimensions
of
a
letter-sized
page
on
the
paper
that
you
are
using.
Softcopy
Collection
Kit
All
the
books
in
the
library,
except
the
licensed
publications,
are
available
in
softcopy
in
the
following
collection
kits:
v
IBM
Online
Library
Omnibus
Edition
OS/390
Collection
Kit,
SK2T-6700.
v
IBM
Online
Library
z/OS
Software
Products
Collection
Kit,
SK2T-4270.
You
can
read
the
softcopy
books
on
CD-ROMs
using
these
IBM
licensed
programs:
v
Softcopy
Reader
v
BookManager
READ/2
v
BookManager
READ/DOS
v
BookManager
READ/6000
Preface
xv
http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/http://publib.boulder.ibm.com/tividd/td/tdprodlist.html
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
and
HTML
on
the
Web.
Ordering
Publications
You
can
order
many
Tivoli
publications
online
at
the
following
Web
site:
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgi
You
can
also
order
by
telephone
by
calling
one
of
these
numbers:
v
In
the
United
States:
800-879-2755
v
In
Canada:
800-426-4968
In
other
countries,
see
the
following
Web
site
for
a
list
of
telephone
numbers:
http://www.ibm.com/software/tivoli/order-lit/
Accessibility
Accessibility
features
help
users
with
a
physical
disability,
such
as
restricted
mobility
or
limited
vision,
to
use
software
products
successfully.
With
this
product,
you
can
use
assistive
technologies
to
hear
and
navigate
the
interface.
You
can
also
use
the
keyboard
instead
of
the
mouse
to
operate
all
features
of
the
graphical
user
interface.
For
additional
information,
see
Appendix
A,
Accessibility,
on
page
173.
Contacting
IBM
Software
Support
If
you
have
a
problem
with
any
Tivoli
product,
you
can
contact
IBM
Software
Support.
See
the
IBM
Software
Support
Guide
at
the
following
Web
site:
http://techsupport.services.ibm.com/guides/handbook.html
The
guide
provides
information
about
how
to
contact
IBM
Software
Support,
depending
on
the
severity
of
your
problem,
and
the
following
information:
v
Registration
and
eligibility
v
Telephone
numbers
and
addresses,
depending
on
the
country
in
which
you
are
located
v
Information
you
must
have
before
contacting
IBM
Software
Support
Conventions
Used
in
This
Manual
The
manual
uses
several
typeface
conventions
for
special
terms
and
actions.
Technical
changes
to
the
text
are
indicated
by
a
vertical
line
to
the
left
of
the
change.
These
conventions
have
the
following
meanings:
Information
type
Style
convention
Example
Commands
All
capital
letters
CREATE
xvi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://techsupport.services.ibm.com/guides/handbook.html
Information
type
Style
convention
Example
References
in
the
text
to
fields
on
panels
All
capital
letters
QUANTITY
Input
you
should
type
in
panel
fields
Monospace
MYAPPLICATION
First
time
new
term
introduced,
book
titles
Italics
Application
What
Is
New
in
This
Version
The
following
sections
summarize
the
changes
in
this
version
of
IBM
Tivoli
Workload
Scheduler.
z/OS
Functions
v
You
can
have
the
local
time
on
a
z/OS
system
change
automatically,
for
example,
for
daylight
savings
time,
without
having
to
stop
and
restart
IBM
Tivoli
Workload
Scheduler.
Note:
The
local
time
automatic
change
cannot
happen
when
Tivoli
Workload
Scheduler
for
z/OS
runs
in
a
Sysplex
environment
with
a
Sysplex
Timer
configured
with
ETRMODE
YES
and
ETRZONE
YES.
v
You
can
turn
the
JESLOG
SPIN
option
on
or
off
using
the
SPIN
keyword
in
the
OPCOPTS
statement.
By
default
IBM
Tivoli
Workload
Scheduler
adds
the
JESLOG=NOSPIN
parameter
to
the
JOB
card
when
the
following
conditions
both
occur:
You
submit
a
JCL
on
a
CPU
running
z/OS
Version
1.2
or
higher.
In
the
OPCOPTS
initialization
statement,
you
specify
data
store
or
job
completion
checker
activities.v
To
facilitate
migration
from
other
scheduling
products,
IBM
Tivoli
Workload
Scheduler
operations
now
accept
a
new
symbolic
name
that
can
be
up
to
54
characters
long.
This
operation
extended
name
enables
you
to
represent
the
job
with
something
other
than
the
operation
number.
You
can
specify
the
operation
extended
name
when
you
define
an
operation
in
the
database
or
when
you
copy
it
into
the
current
plan.
You
can
also
use
it
to
filter
queries
on
operations
in
the
database
and
current
plan.
v
You
can
use
a
mixed
connection
(SNA
and
XCF)
between
the
controller
and
allocated
data
stores.
v
A
new
exit
routine,
EQQUXPIF,
validates
changes
in
an
application
description
(AD)
made
using
the
programming
interface
(PIF),
batch
loader
(BL),
and
the
Job
Scheduling
Console
(JSC).
v
To
increase
the
virtual
storage
from
16
MB
to
2
GB,
the
IBM
Tivoli
Workload
Scheduler
components
have
been
changed
to
use
31-bit
addressing
mode
instead
of
24-bit.
End-to-End
Functions
v
For
fault-tolerant
workstations,
you
can
continue
to
use
centralized
scripts,
which
are
stored
in
the
JOBLIB
data
set.
With
centralized
scripts,
you
can
perform
variable
substitution,
automatic
recovery,
JCL
editing,
and
job
setup
(as
for
the
jobs
in
the
JOBLIB).
However,
this
implies
a
loss
of
fault
tolerance
and
requires
downloading
the
script
to
the
agent
every
time
the
job
is
submitted.
You
need
to
weigh
the
benefits
and
disadvantages
of
using
centralized
scripts.
Preface
xvii
|||
v
You
can
use
a
new
syntax
to
recover
non-centralized
jobs
on
distributed
agents
automatically
when
the
jobs
abend.
This
recovery
is
similar
to
the
recovery
in
the
distributed
environment.
v
You
can
use
variable
substitution
for
jobs
that
run
on
fault-tolerant
workstations
and
that
do
not
use
centralized
scripts.
IBM
Tivoli
Workload
Scheduler
supplied-variable
and
user-defined
variable
tables
are
supported.
v
You
can
enable
firewall
support
and
SSL
authentication
in
end-to-end
scheduling.
v
You
can
specify
a
success
condition
for
each
job
that
determines
whether
a
job
is
considered
successful
or
abended.
v
You
can
specify
or
modify
the
deadline
time
for
a
job
or
a
job
stream.
v
There
are
new
log
files
for
netman,
batchman,
mailman,
the
writer,
and
the
translator.
v
Multiple
domain
managers
can
be
connected
to
the
controller.
This
allows
greater
flexibility,
scalability,
and
improved
performance.
v
You
can
make
an
application
or
an
operation
dependent
on
the
existence
of
one
or
more
files
before
it
can
begin
execution.
v
You
can
activate
and
deactivate
the
submission
of
jobs
scheduled
in
an
end-to-end
environment.
v
You
can
enable
or
disable
the
auditing
trail
of
a
plan.
v
You
can
change
the
status
of
distributed
agents
and
switch
their
domain
manager.
v
You
can
refresh
the
content
of
the
work
directory.
v
You
can
use
the
ISPF
panels
to
produce
an
APAR
tape
that
collects
end-to-end
data.
v
You
can
use
the
Job
Migration
Tool
to
migrate
from
tracker
agents
to
distributed
agents.
Server
Connectivity
v
The
server
can
use
APPC
and
TCP/IP
in
simultaneous
connections
with
the
Job
Scheduling
Console,
PIF,
ISPF
panels,
and
distributed
agents.
v
When
an
application
is
moved
to
another
system
in
a
sysplex
environment,
for
example,
for
maintenance
of
the
current
system
or
for
a
failure,
the
application
can
be
reached
under
the
same
virtual
IP
address.
Using
a
dynamic
virtual
IP
address
makes
the
end-to-end
configuration
more
flexible,
because
your
application
is
independent
of
the
TCP/IP
stack
within
the
sysplex.
How
to
Read
Syntax
Diagrams
Throughout
this
book,
syntax
is
described
in
diagrams
like
the
one
shown
here,
which
describes
the
SRSTAT
TSO
command:
SRSTAT
'
resource
name
'
OPCA
SUBSYS(
subsystem
name
)
MSTR
xviii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide
KEEP
AVAIL(
RESET
)
NO
YES
KEEP
DEVIATION(
amount
)
RESET
KEEP
QUANTITY(
amount
)
RESET
YES
CREATE(
NO
)
0
TRACE(
trace
level
)
The
symbols
have
these
meanings:
The
statement
begins
here.
The
statement
is
continued
on
the
next
line.
The
statement
is
continued
from
a
previous
line.
The
statement
ends
here.
Read
the
syntax
diagrams
from
left
to
right
and
from
top
to
bottom,
following
the
path
of
the
line.
These
are
the
conventions
used
in
the
Recommended