IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
Version
8.2
(Maintenance
Release
April
2004)
SC32-1265-01
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
Version
8.2
(Maintenance
Release
April
2004)
SC32-1265-01
Note
Before
using
this
information
and
the
product
it
supports,
read
the
information
in
Notices
on
page
365.
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
Preface
.
.
.
.
.
.
.
.
.
.
.
.
.
. vii
Maintenance
Release
.
.
.
.
.
.
.
.
.
.
. vii
Who
Should
Read
This
Manual
.
.
.
.
.
.
. vii
What
This
Manual
Contains
.
.
.
.
.
.
.
. viii
Publications
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
Publications
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
.
.
.
. ix
Publications
for
Tivoli
Workload
Scheduler
.
.
. x
Using
LookAt
to
Look
Up
Message
Explanations
xi
Accessing
Publications
Online
.
.
.
.
.
.
. xi
Softcopy
Collection
Kit
.
.
.
.
.
.
.
.
. xii
Ordering
Publications
.
.
.
.
.
.
.
.
.
. xii
Providing
Feedback
about
Publications
.
.
.
. xii
Accessibility
.
.
.
.
.
.
.
.
.
.
.
.
.
. xii
Contacting
IBM
Software
Support
.
.
.
.
.
. xiii
Conventions
Used
in
This
Manual
.
.
.
.
.
. xiii
What
Is
New
in
This
Version
.
.
.
.
.
.
.
. xiii
z/OS
Functions
.
.
.
.
.
.
.
.
.
.
.
. xiii
End-to-End
Functions
.
.
.
.
.
.
.
.
.
. xiv
Server
Connectivity
and
Sysplex
.
.
.
.
.
. xiv
How
to
Read
Syntax
Diagrams
.
.
.
.
.
.
.
. xv
Part
1.
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
. 1
Chapter
1.
Initialization
Statements-Reference
.
.
.
.
.
.
.
.
. 5
Specifying
the
Statements
.
.
.
.
.
.
.
.
.
. 5
Creating
the
Statements
.
.
.
.
.
.
.
.
.
. 5
Storing
the
Statements
.
.
.
.
.
.
.
.
.
. 6
Overriding
the
EQQPARM
Statements
.
.
.
.
. 6
Selecting
Statements
.
.
.
.
.
.
.
.
.
.
. 6
Chapter
2.
Identifying
Related
Initialization-Statement
Parameters
.
. 127
Configuration
.
.
.
.
.
.
.
.
.
.
.
.
. 128
Security
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 129
Generating
Audit
Information
(JT
Log
Data)
.
.
. 129
Determining
the
Success
or
Failure
of
a
Job
.
.
. 130
Recovery
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 131
Restart
and
Cleanup
.
.
.
.
.
.
.
.
.
. 131
Job
Log
Retrieval
.
.
.
.
.
.
.
.
.
.
. 132
Automatic
Job
Recovery
.
.
.
.
.
.
.
.
. 132
Workload
Restart
.
.
.
.
.
.
.
.
.
.
. 133
Performance
.
.
.
.
.
.
.
.
.
.
.
.
.
. 133
Reporting
.
.
.
.
.
.
.
.
.
.
.
.
.
. 134
RODM
Monitoring
.
.
.
.
.
.
.
.
.
.
. 135
Output
Processing
.
.
.
.
.
.
.
.
.
.
.
. 135
End-to-End
Scheduling
.
.
.
.
.
.
.
.
.
. 136
Network
Configuration
.
.
.
.
.
.
.
.
. 136
Job
Definitions
.
.
.
.
.
.
.
.
.
.
.
. 137
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
. 138
Chapter
3.
Customizing
the
End-to-end
Feature
.
.
.
.
.
.
.
.
. 139
Overview
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 139
The
End-to-end
Environment
.
.
.
.
.
.
.
. 139
Distributed
Agents
.
.
.
.
.
.
.
.
.
. 139
IBM
Tivoli
Workload
Scheduler
Domains
.
.
. 140
End-to-end
Scheduling
Architecture
.
.
.
.
. 140
Setting
the
Customization
Parameters
.
.
.
.
. 142
Step
1-
Customizing
the
PARMLIB
Members
142
Step
2
-
Customizing
the
Files
of
the
Work
Directory
.
.
.
.
.
.
.
.
.
.
.
.
.
. 143
Defining
Centralized
and
Non-Centralized
Scripts
144
Centralized
Scripts
.
.
.
.
.
.
.
.
.
. 144
Non-Centralized
Scripts
.
.
.
.
.
.
.
.
. 145
Configuring
the
SCRPTLIB
.
.
.
.
.
.
.
.
. 145
Specifying
the
Statements
.
.
.
.
.
.
.
. 146
VARSUB
.
.
.
.
.
.
.
.
.
.
.
.
.
. 147
JOBREC
.
.
.
.
.
.
.
.
.
.
.
.
.
. 148
RECOVERY
.
.
.
.
.
.
.
.
.
.
.
.
. 151
Configuring
for
Sysplex
.
.
.
.
.
.
.
.
.
. 154
Controlling
the
Distributed
Plan
.
.
.
.
.
.
. 154
Controlling
the
Plan
with
Conman
.
.
.
.
. 154
Controlling
the
Plan
with
the
Tivoli
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
. 155
Conventions
Used
for
the
End-to-end
Scheduling
Plan
.
.
.
.
.
.
.
.
.
.
. 156
Tracing
the
Additional
Processes
on
Open
Edition
157
Sizing
Event
Files
on
Open
Edition
.
.
.
.
.
. 157
Setting
the
Security
Features
.
.
.
.
.
.
.
. 159
Setting
Strong
Authentication
and
Encryption
159
Setting
for
Work
Across
Firewalls
.
.
.
.
. 163
Chapter
4.
Implementing
Security
.
.
. 165
Planning
Security
Implementation
.
.
.
.
.
. 165
How
IBM
Tivoli
Workload
Scheduler
for
z/OS
Verifies
Access
Authority
.
.
.
.
.
.
.
. 166
Identifying
Users
.
.
.
.
.
.
.
.
.
.
. 167
Establishing
Naming
Conventions
for
IBM
Tivoli
Workload
Scheduler
for
z/OS
Resources
. 168
Grouping
RACF
Users
and
Resources
.
.
.
. 168
General
Security
Considerations
.
.
.
.
.
. 169
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
. 169
Controlling
Access
to
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subsystem
.
.
.
.
.
. 170
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
Fixed
Resources
.
.
.
.
. 170
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subresources
.
.
.
.
.
. 171
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
from
APPC
.
.
.
.
.
. 173
Controlling
Access
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
Using
Tivoli
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
.
.
.
.
. 174
Controlling
Access
through
TSO
Commands
177
Copyright
IBM
Corp.
1991,
2004
iii
||
Functions
and
Data
that
You
Can
Protect
.
.
.
. 178
Access
Requirements
to
Fixed
Resources
for
Dialog
Users
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 181
Examples
of
Security
Strategies
.
.
.
.
.
.
. 185
A
Centralized
Security
Strategy
.
.
.
.
.
. 185
A
Decentralized
Security
Strategy
.
.
.
.
. 186
Chapter
5.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Exits
.
.
.
.
.
. 189
IBM
Tivoli
Workload
Scheduler
for
z/OS
User
Exits
Invocation
.
.
.
.
.
.
.
.
.
.
.
. 190
Start/Stop
Exit
(EQQUX000)
.
.
.
.
.
.
. 190
Job-Submit
Exit
(EQQUX001)
.
.
.
.
.
.
. 190
Job-Library-Read
Exit
(EQQUX002)
.
.
.
.
. 191
Application-Description-Feedback
Exit
(EQQUX003)
.
.
.
.
.
.
.
.
.
.
.
. 191
Event-Filtering
Exit
(EQQUX004)
.
.
.
.
.
. 191
SYSOUT
Archiving
Exit
(EQQUX005)
.
.
.
. 191
Incident-Record-Create
Exit
(EQQUX006)
.
.
. 191
Operation-Status-Change
Exit
(EQQUX007)
.
. 191
Operation-Initiation
Exit
(EQQUX009)
.
.
.
. 191
Job-Tracking
Log
Write
Exit
(EQQUX011)
.
.
. 191
JCL-Imbed
Exit
(on
FETCH
directive)
.
.
.
. 191
Variable-Substitution
Exit
(on
JCL
or
Job
Definition
Variable)
.
.
.
.
.
.
.
.
.
. 192
Automatic-Job-Recovery
Exit
(on
RECOVER
statement)
.
.
.
.
.
.
.
.
.
.
.
.
. 192
Daily-Planning-Report
Exit
(EQQDPUE1)
.
.
. 192
EQQDELDS/EQQCLEAN
Catalog
Exit
(EQQUXCAT)
.
.
.
.
.
.
.
.
.
.
.
. 192
EQQCLEAN
GDG
Resolution
Exit
(EQQUXGDG)
.
.
.
.
.
.
.
.
.
.
.
. 192
Application-Description-Validation
(EQQUXPIF)
192
IBM
Tivoli
Workload
Scheduler
for
z/OS
Start/Stop
Exit
(EQQUX000)
.
.
.
.
.
.
.
. 192
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 192
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 193
Job-Submit
Exit
(EQQUX001)
.
.
.
.
.
.
.
. 193
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 194
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 194
Job-Library-Read
Exit
(EQQUX002)
.
.
.
.
.
. 197
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 197
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 197
Application-description-feedback
Exit
(EQQUX003)
201
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 201
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 201
Event-filtering
Exit
(EQQUX004)
.
.
.
.
.
.
. 202
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 202
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 203
SYSOUT
Archiving
Exit
(EQQUX005)
.
.
.
.
. 204
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 204
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 204
Incident-record-create
Exit
(EQQUX006)
.
.
.
. 206
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 207
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 207
Operation-Status-Change
Exit
(EQQUX007)
.
.
. 209
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 209
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 210
Operation-initiation
Exit
(EQQUX009)
.
.
.
.
. 212
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 213
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 213
Job-tracking
Log
Write
Exit
(EQQUX011)
.
.
.
. 214
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 215
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 215
EQQDELDS/EQQCLEAN
Catalog-Exit
(EQQUXCAT)
.
.
.
.
.
.
.
.
.
.
.
.
. 216
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 216
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 216
EQQCLEAN
GDG
Resolution
Exit
(EQQUXGDG)
217
DDPROT/DSNPROT
Interactions
.
.
.
.
. 218
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 218
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 218
JCL-imbed
Exit
.
.
.
.
.
.
.
.
.
.
.
.
. 219
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 219
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 219
Variable-Substitution
Exit
(on
JCL
or
Job
Definition
Variable)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 221
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 221
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 221
Automatic-job-Recovery
Exit
.
.
.
.
.
.
.
. 223
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 223
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 224
Daily-planning-report
Exit
(EQQDPUE1)
.
.
.
. 225
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 225
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 225
Application-description-validation
Exit
(EQQUXPIF)
.
.
.
.
.
.
.
.
.
.
.
.
. 226
Installing
the
Exit
.
.
.
.
.
.
.
.
.
.
. 226
Interface
to
the
Exit
.
.
.
.
.
.
.
.
.
. 227
Chapter
6.
Open
Systems
Integration
229
Controlling
Heterogeneous
Systems
.
.
.
.
.
. 229
Setting
Up
the
Environment
.
.
.
.
.
.
. 230
Submitting
and
Tracking
the
Workload
.
.
.
. 230
An
Alternate
Method
for
Controlling
VM
Processing
.
.
.
.
.
.
.
.
.
.
.
.
.
. 231
Method
of
Use
.
.
.
.
.
.
.
.
.
.
.
. 232
Chapter
7.
Reporting
Events
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
. 235
Supplying
Event
Information
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
. 235
General
Information
about
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subroutines
.
.
.
.
.
. 236
Using
the
General
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subroutine
(EQQUSIN)
.
.
.
.
.
.
. 237
Invocation
Requirements
.
.
.
.
.
.
.
. 237
EQQUSIN
Parameters
.
.
.
.
.
.
.
.
. 237
Specifying
Selection
Criteria
.
.
.
.
.
.
. 242
Specifying
Object
Fields
to
Update
.
.
.
.
. 246
Return
Codes
and
Reason
Codes
Generated
by
EQQUSIN
.
.
.
.
.
.
.
.
.
.
.
.
. 250
Using
Individual
IBM
Tivoli
Workload
Scheduler
for
z/OS
Subroutines
.
.
.
.
.
.
.
.
.
.
. 251
Using
EQQUSINB
.
.
.
.
.
.
.
.
.
.
. 251
Using
EQQUSINO
.
.
.
.
.
.
.
.
.
.
. 251
Using
EQQUSINS
.
.
.
.
.
.
.
.
.
.
. 253
Using
EQQUSINT
.
.
.
.
.
.
.
.
.
.
. 254
Using
EQQUSINW
.
.
.
.
.
.
.
.
.
. 256
iv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
***
*
*
*
*
*
*
*
*
Chapter
8.
Using
the
Job
Completion
Checker
.
.
.
.
.
.
.
.
.
.
.
.
.
. 259
JCC
Message
Tables
.
.
.
.
.
.
.
.
.
.
. 259
Incident
Logging
Function
.
.
.
.
.
.
.
.
. 261
Defining
Message
Tables
using
EQQJCCT
.
.
. 262
Chapter
9.
Using
the
Data
Store
.
.
. 269
Overview
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 269
Prerequisites
.
.
.
.
.
.
.
.
.
.
.
.
.
. 271
Installing
the
Data
Store
.
.
.
.
.
.
.
.
.
. 271
Run
EQQJOBS
to
Create
Installation
Samples
.
.
. 271
Estimating
the
Size
of
Data
Store
VSAM
Data
Files
272
Data
Files
.
.
.
.
.
.
.
.
.
.
.
.
. 272
Primary
Index
.
.
.
.
.
.
.
.
.
.
.
. 273
Secondary
Index
.
.
.
.
.
.
.
.
.
.
. 273
Characteristics
of
the
Local
Data
Store
.
.
.
. 274
Allocate
Data
Store
VSAM
.
.
.
.
.
.
.
.
. 274
Data
Files
.
.
.
.
.
.
.
.
.
.
.
.
. 274
Primary
Index
.
.
.
.
.
.
.
.
.
.
.
. 274
Secondary
Index
.
.
.
.
.
.
.
.
.
.
. 275
Initialize
Data
Store
VSAM
Files
.
.
.
.
.
.
. 275
Data
Files
.
.
.
.
.
.
.
.
.
.
.
.
. 275
Primary
Index
.
.
.
.
.
.
.
.
.
.
.
. 275
Secondary
Index
.
.
.
.
.
.
.
.
.
.
. 276
Configuring
the
Data
Store
.
.
.
.
.
.
.
.
. 276
Data
Store
Initialization
Statements
.
.
.
.
. 276
Set
UP
Controller/Tracker
Initialization
Statements
.
.
.
.
.
.
.
.
.
.
.
.
. 277
Activating
the
Data
Store
.
.
.
.
.
.
.
.
. 277
Chapter
10.
Miscellaneous
Customization
.
.
.
.
.
.
.
.
.
.
. 279
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
Messages
.
.
.
.
.
.
.
.
.
.
.
.
. 279
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
Panels
.
.
.
.
.
.
.
.
.
.
.
.
.
. 281
Customizing
Ended-in-error-list
and
Ready-list
Default
Layouts
.
.
.
.
.
.
.
.
.
.
.
. 281
Invoking
Hiperbatch
Support
.
.
.
.
.
.
.
. 282
Customizing
GMT
Clock
.
.
.
.
.
.
.
.
. 282
Monitoring
Special
Resources
through
RODM
.
. 283
Creating
Case-Code-Definition
Modules
.
.
.
. 285
Invoking
the
dataset
Deletion
Utility
.
.
.
.
. 286
Part
2.
Data
Integrity
.
.
.
.
.
.
. 287
Chapter
11.
Backup
and
Recovery
of
datasets
.
.
.
.
.
.
.
.
.
.
.
.
. 289
Backup
Procedures
.
.
.
.
.
.
.
.
.
.
. 289
How
IBM
Tivoli
Workload
Scheduler
for
z/OS
Manages
Recovery
of
the
Current
Plan
.
.
.
.
. 290
Current-plan
Recovery
Principles
.
.
.
.
.
. 290
Current-plan
Recovery
Processing
.
.
.
.
. 292
Current-plan
Processing
at
IBM
Tivoli
Workload
Scheduler
for
z/OS
Startup
.
.
.
.
.
.
.
. 293
Avoiding
Corruption
of
the
Current
Plan
Backup
.
.
.
.
.
.
.
.
.
.
.
.
.
. 295
Restoring
a
Damaged
IBM
Tivoli
Workload
Scheduler
for
z/OS
File
from
Backup
.
.
.
.
. 295
Restoring
the
Workstation
Description
(WS)
dataset
.
.
.
.
.
.
.
.
.
.
.
.
.
. 295
Restoring
the
Application
Description
(AD)
dataset
.
.
.
.
.
.
.
.
.
.
.
.
.
. 296
Restoring
the
Operator
Instruction
(OI)
dataset
296
Restoring
the
Special
Resource
Description
(RD)
dataset
.
.
.
.
.
.
.
.
.
.
.
.
.
. 296
Restoring
the
Side
Information
(SI)
dataset
.
. 296
Restoring
the
Long-term
Plan
(LTP)
dataset
.
. 297
Restoring
the
JCL
Repository
(JS)
dataset
.
.
. 297
Re-creating
the
Current
plan
from
the
Long-term
Plan
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 297
Re-creating
the
Current
Plan
from
the
New-current-plan
and
the
JT
Archive
Log
.
.
.
. 298
Recovering
from
Errors
on
the
Job-Tracking
Log
299
Dual
JT
Log
dataset
Problems
.
.
.
.
.
.
.
. 299
Recovering
from
Errors
on
the
JT
Archive
Log
.
. 300
Recovering
from
Errors
on
the
Checkpoint
dataset
300
Recovering
from
Errors
on
Event
datasets
.
.
.
. 301
Recovering
from
Errors
on
a
Submit/Release
dataset
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 301
Recovering
from
Errors
on
the
Current-plan-extension
dataset
.
.
.
.
.
.
. 302
Automatic
Recovery
from
Controller
Failures
.
.
. 302
Notification
of
Controller
Failures
.
.
.
.
. 303
Re-creating
the
Symphony
file
from
the
Current
Plan
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 303
Chapter
12.
Cleanup
and
Recovery
of
Data
Store
datasets
.
.
.
.
.
.
.
.
. 305
Deleting
Data
from
the
Database
.
.
.
.
.
.
. 305
Exporting
Data
to
a
Backup
File
.
.
.
.
.
.
. 306
Importing
Data
from
a
Backup
File
.
.
.
.
.
. 306
Recovering
from
Failure
.
.
.
.
.
.
.
.
.
. 307
What
to
Do
when
Data
Files
Fill
Up
.
.
.
.
.
. 307
Cleanup
Subtask
.
.
.
.
.
.
.
.
.
.
.
. 308
Chapter
13.
Disaster
Recovery
Planning
.
.
.
.
.
.
.
.
.
.
.
.
. 309
Designing
your
IBM
Tivoli
Workload
Scheduler
for
z/OS
DRP
.
.
.
.
.
.
.
.
.
.
.
.
.
. 309
Secondary-center
Options
.
.
.
.
.
.
.
. 309
Standardizing
the
Environment
.
.
.
.
.
. 310
Implementing
your
IBM
Tivoli
Workload
Scheduler
for
z/OS
DRP
.
.
.
.
.
.
.
.
.
.
.
.
. 311
Recovery
to
Start-of-day
Processing
.
.
.
.
. 311
Recovery
to
a
Predefined
Recovery
Point
.
.
. 314
Recovery
to
Point-of-failure
.
.
.
.
.
.
. 316
Part
3.
Tuning
.
.
.
.
.
.
.
.
.
. 321
Chapter
14.
Analyzing
Performance
323
Setting
Performance
Objectives
.
.
.
.
.
.
. 323
Measuring
Performance
.
.
.
.
.
.
.
.
.
. 324
Performance
Reporter
for
MVS
and
Tivoli
Decision
Support
for
OS/390
.
.
.
.
.
.
. 324
RMF
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 325
ACF/VTAM
.
.
.
.
.
.
.
.
.
.
.
.
. 326
VSAM
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 327
Contents
v
IBM
Tivoli
Workload
Scheduler
for
z/OS
Performance
Data
.
.
.
.
.
.
.
.
.
.
. 327
Chapter
15.
Basic
Tuning
Activities
329
System
Resources
.
.
.
.
.
.
.
.
.
.
.
. 329
I/O
Activity
.
.
.
.
.
.
.
.
.
.
.
.
. 329
Processor
.
.
.
.
.
.
.
.
.
.
.
.
.
. 333
Processor
Storage
.
.
.
.
.
.
.
.
.
.
. 333
Indicators
for
Performance-related
Problems
.
.
. 334
Preventing
Bottlenecks
.
.
.
.
.
.
.
.
.
. 334
Chapter
16.
Tuning
the
Controller
and
the
Tracker
.
.
.
.
.
.
.
.
.
.
.
. 335
Tuning
the
Controller
.
.
.
.
.
.
.
.
.
.
. 335
Job
Submission
.
.
.
.
.
.
.
.
.
.
.
. 335
Job
Tracking
.
.
.
.
.
.
.
.
.
.
.
.
. 336
Dialog
Response
.
.
.
.
.
.
.
.
.
.
. 337
Background
Batch
Processing
.
.
.
.
.
.
.
. 338
Recognizing
the
Indicators
.
.
.
.
.
.
.
. 338
Recommendations
.
.
.
.
.
.
.
.
.
.
. 338
Tuning
the
Tracker
.
.
.
.
.
.
.
.
.
.
. 338
Event
Creation
and
Communication
.
.
.
.
. 339
Factors
Influencing
Performance
.
.
.
.
.
. 339
JCC
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 340
Restart
and
Cleanup
.
.
.
.
.
.
.
.
.
.
. 340
Part
4.
Appendixes
.
.
.
.
.
.
.
. 341
Appendix
A.
NetView
Generic-Alert
Vectors
.
.
.
.
.
.
.
.
.
.
.
.
.
. 343
Subsystem-failed
Alert
.
.
.
.
.
.
.
.
.
. 343
Subtask-failed
Alert
.
.
.
.
.
.
.
.
.
.
. 344
Operation-in-error
Alert
.
.
.
.
.
.
.
.
.
. 344
Late-operation
Alert
.
.
.
.
.
.
.
.
.
.
. 345
Long-duration
Alert
.
.
.
.
.
.
.
.
.
.
. 345
Queue-threshold-exceeded
Alert
.
.
.
.
.
.
. 346
Appendix
B.
IBM
Tivoli
Workload
Scheduler
for
z/OS
Macros
.
.
.
.
. 347
Appendix
C.
Sample
Library
(SEQQSAMP)
.
.
.
.
.
.
.
.
.
.
. 349
EQQUSIN
Samples
.
.
.
.
.
.
.
.
.
.
. 351
IBM
Tivoli
Workload
Scheduler
for
z/OS
Exits
.
. 351
Start
or
Stop
Exit
.
.
.
.
.
.
.
.
.
.
. 352
Job-submit
Exit
.
.
.
.
.
.
.
.
.
.
.
. 352
Job-library-read
Exit
.
.
.
.
.
.
.
.
.
. 352
Event-filtering
Exit
.
.
.
.
.
.
.
.
.
. 353
SYSOUT
Archiving
Exit
.
.
.
.
.
.
.
.
. 353
Incident-record-create
Exit
.
.
.
.
.
.
.
. 353
Operation-status-change
Exit
.
.
.
.
.
.
. 354
Operation-initiation
Exit
.
.
.
.
.
.
.
.
. 354
JCL-variable-substitution
Exit
.
.
.
.
.
.
. 354
Job-tracking
Log
Write
Exit
.
.
.
.
.
.
.
. 355
EQQDELDS/EQQCLEAN
Catalog-Exit
.
.
.
. 355
EQQCLEAN
GDG
Resolution
Exit
(EQQUXGDG)
.
.
.
.
.
.
.
.
.
.
.
. 355
Application-Description-Validation
Exit
.
.
.
. 355
Open
Systems
Integration
.
.
.
.
.
.
.
.
. 355
Tracker
for
VM
.
.
.
.
.
.
.
.
.
.
.
. 355
Tracker
for
OS/2
.
.
.
.
.
.
.
.
.
.
. 356
Tracker
for
AIX
.
.
.
.
.
.
.
.
.
.
.
. 357
IBM
Tivoli
Workload
Scheduler
for
z/OS
Audit
Package
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 358
Viewing
Output
from
the
Ended-in-error
List
.
.
. 360
NetView
Samples
.
.
.
.
.
.
.
.
.
.
.
. 361
Deadline
WTO
Message
.
.
.
.
.
.
.
.
. 361
Responding
to
WTO
Operations
.
.
.
.
.
. 361
Changing
Operation
Status
from
NetView
.
.
. 361
z/OS
Hiperbatch
Support
.
.
.
.
.
.
.
.
. 361
Deleting
datasets
Based
on
JCL
Disposition
and
Catalog
Status
.
.
.
.
.
.
.
.
.
.
.
.
. 362
Miscellaneous
Samples
.
.
.
.
.
.
.
.
.
. 362
MASS
Update
Samples
.
.
.
.
.
.
.
.
.
. 363
Notices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 365
Trademarks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 366
Glossary
.
.
.
.
.
.
.
.
.
.
.
.
. 367
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 379
vi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
*
*
*
Preface
This
manual
shows
you
how
to
customize,
or
tune
IBM
Tivoli
Workload
Scheduler
for
z/OS.
You
can
use
this
manual
for
reference
during
installation.
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
manual,
refers
to
Tivoli
Workload
Scheduler
for
z/OS.
The
term
DB2
,
when
used
in
this
manual,
refers
to
DATABASE
2
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.
Maintenance
Release
This
is
a
maintenance
refresh
of
the
corresponding
IBM
Tivoli
Workload
Scheduler
for
z/OS
Version
8.2
manual,
form
number
SC32126500.
It
contains
updates
for
the
following
APARS:
v
PQ75798
v
PQ77970
v
PQ78350
v
PQ79567
v
PQ79875
v
PQ80066
v
PQ80418
v
PQ81513
v
PQ81561
v
PQ82126
v
PQ82402
v
PQ82887
v
PQ84104
v
PQ84233
v
PQ84305
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.
Who
Should
Read
This
Manual
This
manual
is
intended
for
system
programmers,
security
administrators,
and
other
personnel
who
install,
customize,
or
tune
IBM
Tivoli
Workload
Scheduler
for
z/OS.
To
use
this
manual
effectively,
you
need
a
working
knowledge
of
z/OS
and
JES
concepts
and
facilities.
You
should
be
familiar
with
the
Interactive
System
Copyright
IBM
Corp.
1991,
2004
vii
|
|||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|||
Productivity
Facility
(ISPF),
the
Interactive
System
Productivity
Facility/Program
Development
Facility
(ISPF/PDF),
and
the
Time-Sharing
Option
(TSO).
A
good
working
knowledge
of
Virtual
Storage
Access
Method
(VSAM)
is
desirable
but
not
essential.
To
implement
security,
you
must
know
the
Resource
Access
Control
Facility
(RACF)
or
a
similar
product.
To
implement
IBM
Tivoli
Workload
Scheduler
for
z/OS
exits
or
subroutines,
you
must
know
job
control
language
(JCL)
and
have
a
good
working
knowledge
of
a
programming
language,
for
example,
assembler
or
PL/I.
You
can
use
programming
languages
that
support
OS/390
linkage
conventions
and
that
can
load
and
delete
an
assembler
program.
What
This
Manual
Contains
This
manual
contains
the
following
sections:
Part
1.
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
Part
1
contains
the
following
chapters:
v
Chapter
1,
Initialization
Statements-Reference,
on
page
5
Explains
how
you
specify
statements
and
describes
each
statement
in
detail.
v
Chapter
2,
Identifying
Related
Initialization-Statement
Parameters,
on
page
127
Helps
you
identify
different
statements
and
parameters
that
you
can
specify
to
implement
a
particular
function.
v
Chapter
3,
Customizing
the
End-to-end
Feature,
on
page
139
Explains
how
to
customize
your
environment
to
use
the
end-to-end
feature.
v
Chapter
4,
Implementing
Security,
on
page
165
Describes
procedures
for
maintaining
the
integrity
of
IBM
Tivoli
Workload
Scheduler
for
z/OS
user
data
and
applications.
Security
strategy
examples
are
included.
v
Chapter
5,
IBM
Tivoli
Workload
Scheduler
for
z/OS
Exits,
on
page
189
Describes
the
exits
that
can
be
called
by
a
tracker
and
a
controller.
Your
own
programs
can
use
the
information
passed
by
the
exits
to
perform
a
variety
of
functions.
v
Chapter
6,
Open
Systems
Integration,
on
page
229
Describes
how
you
can
use
IBM
Tivoli
Workload
Scheduler
for
z/OS
to
control
the
workload
in
operating
environments
that
do
not
support
a
tracker.
v
Chapter
7,
Reporting
Events
to
IBM
Tivoli
Workload
Scheduler
for
z/OS,
on
page
235
Describes
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
subroutines
that
you
can
invoke
to
report
events
that
cannot
be
detected
automatically
from
system
exits.
v
Chapter
8,
Using
the
Job
Completion
Checker,
on
page
259
Explains
how
you
can
scan
SYSOUT
to
determine
the
success
or
failure
of
a
job,
instead
of
using
only
completion
codes.
v
Chapter
9,
Using
the
Data
Store,
on
page
269
Explains
how
to
install
and
use
the
data
store.
v
Chapter
10,
Miscellaneous
Customization,
on
page
279
Describes
how
you
can
tailor
IBM
Tivoli
Workload
Scheduler
for
z/OS
by:
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
messages
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
panels
Customizing
ended-in-error-list
and
ready-list
layouts
viii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
Invoking
Hiperbatch
support
Creating
case-code-definition
modules
that
are
used
by
automatic
job
recovery.
Part
2.
Data
Integrity
Part
2
contains
the
following
chapters:
v
Chapter
11,
Backup
and
Recovery
of
datasets,
on
page
289
Describes
backup
procedures
and
how
you
restore
damaged
files.
v
Chapter
12,
Cleanup
and
Recovery
of
Data
Store
datasets,
on
page
305
Explains
how
you
can
clean
up
and
recover
the
data
store
datasets.
v
Chapter
13,
Disaster
Recovery
Planning,
on
page
309
Describes
how
you
can
implement
a
recovery
scenario
to
reduce
the
impact
of
a
major
disruption.
Part
3.
Tuning
Part
3
contains
the
following
chapters:
v
Chapter
14,
Analyzing
Performance,
on
page
323
Provides
a
general
introduction
to
performance
issues.
v
Chapter
15,
Basic
Tuning
Activities,
on
page
329
Describes
system
resources
used
by
IBM
Tivoli
Workload
Scheduler
for
z/OS
and
provides
information
to
help
you
perform
basic
tuning.
v
Chapter
16,
Tuning
the
Controller
and
the
Tracker,
on
page
335
Describes
how
you
can
tune
IBM
Tivoli
Workload
Scheduler
for
z/OS
to
correct
performance
problems.
Part
4.
Appendixes
Part
4
contains
the
following
appendixes:
v
Appendix
A,
NetView
Generic-Alert
Vectors,
on
page
343
Describes
the
format
of
the
generic
alerts
that
IBM
Tivoli
Workload
Scheduler
for
z/OS
sends
to
NetView.
v
Appendix
B,
IBM
Tivoli
Workload
Scheduler
for
z/OS
Macros,
on
page
347
Provides
a
list
of
IBM
Tivoli
Workload
Scheduler
for
z/OS
macros
that
are
programming
interfaces.
v
Appendix
C,
Sample
Library
(SEQQSAMP),
on
page
349
Describes
the
members
of
the
sample
library
that
help
you
customize
and
tune
IBM
Tivoli
Workload
Scheduler
for
z/OS.
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
Preface
ix
Describes
how
to
customize
IBM
Tivoli
Workload
Scheduler
for
z/OS.
v
Installation
Guide,
SC32-1264
Describes
how
to
install
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
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
Job
Scheduling
Console
Release
Notes,
SC32-1258
Provides
information
about
working
with
Tivoli
Workload
Scheduler,
regardless
of
platform,
from
a
common
GUI.
v
IBM
Tivoli
Job
Scheduling
Console
Users
Guide,
SC32-1257
Provides
information
about
working
with
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
Tivoli
Workload
Scheduler
The
following
manuals
are
available
in
the
Tivoli
Workload
Scheduler
library:
v
Tivoli
Workload
Scheduler
Planning
and
Installation
Guide,
SC32-1273
Describes
planning
and
installing
Tivoli
Workload
Scheduler.
v
Tivoli
Workload
Scheduler
Reference
Guide,
SC32-1274
Explains
the
Tivoli
Workload
Scheduler
command
line,
understanding
how
extended
and
network
agents
work,
and
integrating
Tivoli
Workload
Scheduler
with
NetView
and
with
Tivoli
Business
System
Manager.
v
Tivoli
Workload
Scheduler
Troubleshooting
and
Error
Messages,
SC32-1275
x
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
Interprets
Tivoli
Workload
Scheduler
error
messages,
and
provides
sources
of
information
that
will
help
you
in
solving
problems
with
Tivoli
Workload
Scheduler.
v
Tivoli
Workload
Scheduler
for
Applications
Users
Guide,
SC32-1278
Describes
installing,
using,
and
troubleshooting
for
the
Tivoli
Workload
Scheduler
extended
agents.
v
Tivoli
Workload
Scheduler
for
Applications
Release
Notes,
SC32-1279
Provides
last-minute
information
about
the
Tivoli
Workload
Scheduler
extended
agents.
v
Tivoli
Workload
Scheduler
AS/400
Limited
FTA
Users
Guide,
SC32-1280
Describes
installing,
configuring,
and
using
Tivoli
Workload
Scheduler
fault-tolerant
agents
on
AS/400.
v
Tivoli
Workload
Scheduler
Plus
Module
Users
Guide,
SC32-1276
Explains
setting
up
and
using
the
Tivoli
Workload
Scheduler
Plus
module.
v
Tivoli
Workload
Scheduler
Release
Notes,
SC32-1277
Explains
late-breaking
information
about
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)
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
IBM
Tivoli
Workload
Scheduler
for
z/OS
link
to
access
the
product
library.
Preface
xi
http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/http://publib.boulder.ibm.com/tividd/td/tdprodlist.html
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
displayable
softcopy
form
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
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/
Providing
Feedback
about
Publications
If
you
have
comments
or
suggestions
about
Tivoli
products
and
documentation,
complete
the
customer
feedback
survey
at
the
following
Web
site:
http://www.ibm.com/software/sysmgmt/products/support
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.
xii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
http://www.elink.ibmlink.ibm.com/public/applications/publications/cgibin/pbi.cgihttp://www.ibm.com/software/tivoli/order-lit/http://www.ibm.com/software/sysmgmt/products/support
For
additional
information,
see
the
Accessibility
Appendix
in
the
IBM
Tivoli
Workload
Scheduler
for
z/OS
Installation
Guide.
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
This
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
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
Italics
Application
What
Is
New
in
This
Version
The
following
sections
summarize
the
changes
in
this
version
of
Tivoli
Workload
Scheduler
for
z/OS.
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
Tivoli
Workload
Scheduler
for
z/OS.
v
You
can
turn
the
JESLOG
SPIN
option
on
or
off
using
the
SPIN
keyword
in
the
OPCOPTS
statement.
By
default
Tivoli
Workload
Scheduler
for
z/OS
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,
Tivoli
Workload
Scheduler
for
z/OS
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
Preface
xiii
http://techsupport.services.ibm.com/guides/handbook.html
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
16MB
to
2GB,
the
Tivoli
Workload
Scheduler
for
z/OS
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
dataset.
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.
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.
Tivoli
Workload
Scheduler
for
z/OS
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,
Writer,
and
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
and
Sysplex
v
The
server
can
use
APPC
and
TCP/IP
in
simultaneous
connections
with
the
Job
Scheduling
Console,
PIF,
ISPF
panels,
and
distributed
agents.
xiv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
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
manual,
syntax
is
described
in
diagrams
like
the
one
shown
here,
which
describes
the
SRSTAT
TSO
command:
SRSTAT
'
resource
name
'
OPCA
SUBSYS(
subsystem
name
)
MSTR
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
diagrams:
v
Required
items
appear
on
the
horizontal
line
(main
path):
STATEMENT
required
item
v
Optional
items
appear
below
the
main
path:
STATEMENT
optional
item
Preface
xv
v
An
arrow
returning
to
the
left
above
the
item
indicates
an
item
that
you
can
repeat.
If
a
separator
is
required
between
items,
it
is
shown
on
the
repeat
arrow.
STATEMENT
'
,
repeatable
item
v
If
you
can
choose
from
two
or
more
items,
they
appear
vertically
in
a
stack.
If
you
must
choose
one
of
the
items,
one
item
of
the
stack
appears
on
the
main
path:
STATEMENT
required
choice
1
required
choice
2
If
choosing
one
of
the
items
is
optional,
the
entire
stack
appears
below
the
main
path:
STATEMENT
optional
choice
1
optional
choice
2
A
repeat
arrow
above
a
stack
indicates
that
you
can
make
more
than
one
choice
from
the
stacked
items:
STATEMENT
'
,
optional
choice
1
optional
choice
2
optional
choice
3
STATEMENT
'
,
required
choice
1
required
choice
2
required
choice
3
v
Parameters
that
are
above
the
main
line
are
default
parameters:
STATEMENT
default
alternative
v
Keywords
appear
in
uppercase
(for
example,
STATEMENT).
v
Parentheses
and
commas
must
be
entered
as
part
of
the
command
syntax,
as
shown.
v
For
complex
commands,
the
item
attributes
might
not
fit
on
one
horizontal
line.
If
that
line
cannot
be
split,
the
attributes
appear
at
the
bottom
of
the
syntax
diagram:
xvi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
STATEMENT
required
choice
1
option
1
option
2
required
choice
2
required
choice
3
option
1
default
optional
choice
1(
alternative
)
option
2
default
optional
choice
2(
alternative
)
Preface
xvii
xviii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Customization
and
Tuning
Part
1.
Customizing
IBM
Tivoli
Workload
Scheduler
for
z/OS
Chapter
1.
Initialization
Statements-Reference
.
. 5
Specifying
the
Statements
.
.
.
.
.
.
.
.
.
. 5
Creating
the
Statements
.
.
.
.
.
.
.
.
.
. 5
Storing
the
Statements
.
.
.
.
.
.
.
.
.
. 6
Overriding
the
EQQPARM
Statements
.
.
.
.
. 6
Selecting
Statements
.
.
.
.
.
.
.
.
.
.
. 6
Initialization
Statements
.
.
.
.
.
.
.
. 6
End-to-end
Job
Definition
Statements
.
.
.
. 8
ALERTS
.
.
.
.
.
.
.
.
.
.
.
.
.
. 9
AROPTS
.
.
.
.
.
.
.
.
.
.
.
.
. 12
AUDIT
.
.
.
.
.
.
.
.
.
.
.
.
.
. 15
AUTHDEF
.
.
.
.
.
.
.
.
.
.
.
. 17
BATCHOPT
.
.
.
Top Related