Upload
lamkiet
View
252
Download
4
Embed Size (px)
Citation preview
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
Version
8.2
(Maintenance
Release
April
2004)
SC32-1266-01
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
Version
8.2
(Maintenance
Release
April
2004)
SC32-1266-01
Note
Before
using
this
information
and
the
product
it
supports,
read
the
information
in
Notices
on
page
245.
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
.
.
.
.
.
.
.
. xi
What
This
Manual
Contains
.
.
.
.
.
.
.
.
. xii
Publications
.
.
.
.
.
.
.
.
.
.
.
.
.
. xii
Publications
for
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. xii
Publications
for
Tivoli
Workload
Scheduler
.
. xiii
Using
LookAt
to
Look
Up
Message
Explanations
xiv
Accessing
Publications
Online
.
.
.
.
.
.
. xiv
Softcopy
Collection
Kit
.
.
.
.
.
.
.
.
. xiv
Ordering
Publications
.
.
.
.
.
.
.
.
.
. xv
Providing
Feedback
about
Publications
.
.
.
. xv
Accessibility
.
.
.
.
.
.
.
.
.
.
.
.
.
. xv
Contacting
IBM
Software
Support
.
.
.
.
.
.
. xv
Conventions
Used
in
This
Manual
.
.
.
.
.
. xvi
Part
1.
Programming
Interfaces
.
.
. 1
Chapter
1.
The
Program
Interface
(PIF)
. 3
Program
Interface
Samples
.
.
.
.
.
.
.
.
. 3
Related
Tools
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
Batch
Command
Interface
Tool
.
.
.
.
.
.
. 3
Tivoli
Workload
Scheduler
for
z/OS
Control
Language
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
Communicating
with
EQQYCOM
.
.
.
.
.
.
. 4
Required
Datasets
.
.
.
.
.
.
.
.
.
.
.
. 5
Optional
Dataset
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Error
Messages
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Parameter
Overview
.
.
.
.
.
.
.
.
.
.
.
. 6
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 7
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 7
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 8
Argument
Names
and
Values
.
.
.
.
.
.
.
. 8
Communication
Block
.
.
.
.
.
.
.
.
.
. 9
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 9
Sequence
of
Requests
.
.
.
.
.
.
.
.
.
.
. 9
Data
Area
Description
and
Format
.
.
.
.
.
.
. 10
Header
Format
.
.
.
.
.
.
.
.
.
.
.
. 10
Data
Record
Format
.
.
.
.
.
.
.
.
.
. 11
Date
Considerations
.
.
.
.
.
.
.
.
.
.
. 11
Internal
Date
Representation
.
.
.
.
.
.
.
. 11
Date
Arguments
in
PIF
Applications
.
.
.
.
. 12
Updating
Application
Description
Run
Cycles
with
PIF
.
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Security
Considerations
.
.
.
.
.
.
.
.
.
. 13
Overview
of
Request
Types
.
.
.
.
.
.
.
.
. 14
DELETE
Request
.
.
.
.
.
.
.
.
.
.
.
. 15
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 15
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 15
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 16
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 16
Communication
Block
Address
.
.
.
.
.
.
. 20
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 20
EXECUTE
Request
.
.
.
.
.
.
.
.
.
.
.
. 20
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 21
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Communication
Block
Address
.
.
.
.
.
.
. 21
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
INIT
Request
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 21
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Communication
Block
Address
.
.
.
.
.
.
. 22
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 22
INSERT
Request
.
.
.
.
.
.
.
.
.
.
.
.
. 23
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 24
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 24
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 24
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 24
Communication
Block
Address
.
.
.
.
.
.
. 29
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 29
LIST
Request
.
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 30
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 30
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 31
Communication
Block
Address
.
.
.
.
.
.
. 38
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 38
MODIFY
Request
.
.
.
.
.
.
.
.
.
.
.
. 38
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 38
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 38
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 38
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 39
Communication
Block
Address
.
.
.
.
.
.
. 43
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 43
OPTIONS
Request
.
.
.
.
.
.
.
.
.
.
.
. 43
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 44
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 44
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 44
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 45
Communication
Block
Address
.
.
.
.
.
.
. 47
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 47
REPLACE
Request
.
.
.
.
.
.
.
.
.
.
.
. 48
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 48
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 48
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 48
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 49
Communication
Block
Address
.
.
.
.
.
.
. 49
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 49
RESET
Request
.
.
.
.
.
.
.
.
.
.
.
.
. 49
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 49
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 49
Copyright
IBM
Corp.
1991,
2004
iii
||
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Communication
Block
Address
.
.
.
.
.
.
. 50
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 50
SELECT
Request
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 50
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 50
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 51
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 52
Communication
Block
Address
.
.
.
.
.
.
. 58
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 58
TERM
Request
.
.
.
.
.
.
.
.
.
.
.
.
. 58
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 59
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 59
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 59
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 59
Communication
Block
Address
.
.
.
.
.
.
. 59
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 59
JCL
Preparation
Using
PIF
.
.
.
.
.
.
.
.
. 59
Substituting
Variables
.
.
.
.
.
.
.
.
.
. 59
Simulating
Variable
Substitution
.
.
.
.
.
. 60
Chapter
2.
The
Application
Programming
Interface
(API)
.
.
.
.
. 63
Communicating
with
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 63
CPI-C
Support
Provided
by
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
.
.
.
.
.
. 64
API
Buffer
Layouts
.
.
.
.
.
.
.
.
.
.
.
. 65
APPFixed
Section
.
.
.
.
.
.
.
.
.
. 66
APPOBJObject
Section
.
.
.
.
.
.
.
.
. 68
APPSELSelection
Section
.
.
.
.
.
.
.
. 70
APPVALSelection
Value
Section
.
.
.
.
.
. 71
APPFLDField
Section
.
.
.
.
.
.
.
.
. 72
APPDATData
Section
.
.
.
.
.
.
.
.
. 73
Specifying
Object
Names
.
.
.
.
.
.
.
.
.
. 73
Selecting
Object
Instances
.
.
.
.
.
.
.
.
.
. 74
Specifying
Key
Types
.
.
.
.
.
.
.
.
.
. 74
Specifying
Selection
Criteria
.
.
.
.
.
.
.
. 75
Broadcasting
events
.
.
.
.
.
.
.
.
.
. 75
Selecting
Object
Fields
to
Update
or
Retrieve
.
.
. 76
Return
Codes
and
Reason
Codes
Generated
by
Tivoli
Workload
Scheduler
for
z/OS
.
.
.
.
.
. 76
Return
Codes
and
Reason
Codes
Generated
in
the
Fixed
Section
(APP)
.
.
.
.
.
.
.
.
. 76
Return
Codes
and
Reason
Codes
Generated
in
the
Object
Section
(APPOBJ)
.
.
.
.
.
.
.
. 77
Security
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 77
APPC
and
RACF
.
.
.
.
.
.
.
.
.
.
. 77
Tivoli
Workload
Scheduler
for
z/OS
and
RACF
78
Part
2.
Programming
Tools
.
.
.
.
. 81
Chapter
3.
Batch
Command
Interface
Tool
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 83
Online
Tools
.
.
.
.
.
.
.
.
.
.
.
.
.
. 83
The
Batch
Command
Interface
.
.
.
.
.
.
.
. 83
Input
to
Batch
Command
Interface
.
.
.
.
. 83
BCIT
Output
.
.
.
.
.
.
.
.
.
.
.
.
. 85
Instructions
.
.
.
.
.
.
.
.
.
.
.
.
. 86
Chapter
4.
Control
Language
(OCL)
113
What
You
Can
Do
Using
OCL
.
.
.
.
.
.
.
. 113
Advantages
of
OCL
.
.
.
.
.
.
.
.
.
.
. 113
Summary
of
OCL
Instructions
.
.
.
.
.
.
.
. 114
Customizing
OCL
.
.
.
.
.
.
.
.
.
.
.
. 116
Specifying
the
Initialization
Parameters
.
.
.
. 117
Example
1
.
.
.
.
.
.
.
.
.
.
.
.
. 118
Example
2
.
.
.
.
.
.
.
.
.
.
.
.
. 118
Example
3
.
.
.
.
.
.
.
.
.
.
.
.
. 119
Example
4
.
.
.
.
.
.
.
.
.
.
.
.
. 119
Obtaining
Access
Authorization
.
.
.
.
.
. 119
Logging
Executed
Instructions
.
.
.
.
.
.
. 120
Specifying
OCL
Instructions
.
.
.
.
.
.
. 120
Specifying
Input
Arrival
Dates
and
Times
.
.
. 121
Description
of
OCL
Instructions
.
.
.
.
.
. 124
Requirements
.
.
.
.
.
.
.
.
.
.
.
. 185
Sample
Job
and
Procedure
.
.
.
.
.
.
.
. 185
Messages
.
.
.
.
.
.
.
.
.
.
.
.
.
. 187
Part
3.
Appendixes
.
.
.
.
.
.
.
. 189
Appendix
A.
Program
Interface
Record
Format
.
.
.
.
.
.
.
.
.
.
. 191
TOD
Fields
.
.
.
.
.
.
.
.
.
.
.
.
.
. 191
Application
Description
(Resource
Codes
AD,
ADCOM)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 191
ADCOMCommon
Segment
.
.
.
.
.
.
. 192
ADDEPDependency
Segment
.
.
.
.
.
. 192
ADEXTExtended
Name
Segment
.
.
.
.
. 193
ADKEYKey
Segment
.
.
.
.
.
.
.
.
. 193
ADOPOperation
Segment
.
.
.
.
.
.
. 193
ADRUNRun
Cycle
Segment
.
.
.
.
.
.
. 194
ADSRSpecial
Resource
Segment
.
.
.
.
. 197
All
Workstations
Closed
(Resource
Code
AWSCL)
197
AWSCLAll
Workstations
Closed
Interval
Segment
.
.
.
.
.
.
.
.
.
.
.
.
.
. 197
Calendar
(Resource
Codes
CL,
CLCOM)
.
.
.
. 197
CLCOMCommon
Segment
.
.
.
.
.
.
. 198
CLSDSpecific
Date
Segment
.
.
.
.
.
.
. 198
CLWDWeekday
Segment
.
.
.
.
.
.
.
. 198
Current
Plan
Occurrence
(Resource
Code
CPOC)
199
CPOCCurrent
Plan
Occurrence
Segment
.
. 199
Current
Plan
Operation
(Resource
Codes
CPOP,
CPOPCOM)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 200
CPEXTOperation
Extended
Name
Segment
200
CPOPCommon
Segment
.
.
.
.
.
.
.
. 201
CPPREPredecessor
Segment
.
.
.
.
.
.
. 204
CPSUCSuccessor
Segment
.
.
.
.
.
.
. 204
CPSRSpecial
Resource
Segment
.
.
.
.
. 204
CPOPSRUSpecial
Resource
Usage
Segment
205
CPRECOperation
Recovery
Segment
.
.
.
. 206
Current
Plan
Status
(Resource
Code
CPST)
.
.
. 206
CPSTCommon
Segment
.
.
.
.
.
.
.
. 206
Current
Plan
Workstation
(Resource
Codes
CPWS,
CPWSCOM)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 207
CPWSCommon
Segment
.
.
.
.
.
.
.
. 207
CPIVLCurrent
Plan
Workstation
Open
Interval
Segment
.
.
.
.
.
.
.
.
.
.
. 208
Current
Plan
Special
Resource
(Resource
Codes
CSR,
CSRCOM)
.
.
.
.
.
.
.
.
.
.
.
. 209
iv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
CSRCOMCurrent
Plan
Resource
Common
Segment
.
.
.
.
.
.
.
.
.
.
.
.
.
. 209
CSRIVLCurrent
Plan
Special
Resource
Interval
Segment
.
.
.
.
.
.
.
.
.
.
.
.
.
. 210
CSRIWSCurrent
Plan
Resource
Interval
Connected
Workstation
.
.
.
.
.
.
.
. 211
CSRDWSCurrent
Plan
Resource
Default
Connected
Workstation
.
.
.
.
.
.
.
. 211
ETTEvent
Triggered
Tracking
Criteria
Segment
211
JCL
Setup
Variables
(Resource
Codes
JCLPREP,
JCLPREPA)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 212
JSVCCommon
Segment
.
.
.
.
.
.
.
. 212
JSVVVariable
Definition
Segment
.
.
.
.
. 212
JCL
Variable
Table
(Resource
Codes
JCLV,
JCLVCOM)
.
.
.
.
.
.
.
.
.
.
.
.
.
. 212
JCLVCCommon
Segment
.
.
.
.
.
.
.
. 213
JCLVVVariable
Definition
Segment
.
.
.
. 213
JCLVDDependency
Segment
.
.
.
.
.
. 214
Job
Control
Language
(Resource
Codes
JS,
JSCOM)
214
JSJob
Control
Language
Segment
.
.
.
.
. 214
Job
Log
(Resource
Code
JLCOM)
.
.
.
.
.
.
. 215
JLCOMCommon
Segment
.
.
.
.
.
.
. 215
Long-Term
Plan
Occurrence
(Resource
Codes
LTOC,
LTOCCOM)
.
.
.
.
.
.
.
.
.
.
. 215
LTOCCommon
Segment
.
.
.
.
.
.
.
. 215
LTOPOperation
Segment
.
.
.
.
.
.
.
. 216
LTPREPredecessor
Segment
.
.
.
.
.
.
. 217
LTSUCSuccessor
Segment
.
.
.
.
.
.
. 217
Operator
Instruction
(Resource
Codes
OI,
OICOM)
217
OIOperator
instruction
Segment
.
.
.
.
. 217
Period
(Resource
Codes
PR,
PRCOM)
.
.
.
.
. 218
PRPeriod
Segment
.
.
.
.
.
.
.
.
.
. 218
Special
Resource
(Resource
Codes
SR,
SRCOM)
219
Workstation
Description
(Resource
Codes
WS,
WSCOM)
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 221
WSCOMCommon
Segment
.
.
.
.
.
.
. 221
WSIVLOpen
Interval
Segment
.
.
.
.
.
. 222
WSSDSpecific
Date
Segment
.
.
.
.
.
. 222
WSWDWeekday
Segment
.
.
.
.
.
.
. 223
WSAMWorkstation
Access
Method
Segment
223
Appendix
B.
API
Object
Fields
.
.
.
. 225
Current
Plan
Status
Object
.
.
.
.
.
.
.
.
. 225
Current
Plan
Operation
Object
.
.
.
.
.
.
. 226
Current
Plan
Special
Resource
Object
.
.
.
.
. 231
Current
Plan
Workstation
Object
.
.
.
.
.
.
. 232
Current
Plan
Open
Interval
Object
.
.
.
.
.
. 233
Current
Plan
Operation
Event
Object
.
.
.
.
. 234
Current
Plan
OPINFO
Event
object
.
.
.
.
.
. 236
Current
Plan
Special
Resource
Event
Object
.
.
. 237
Current
Plan
Backup
Event
Object
.
.
.
.
.
. 238
Current
Plan
Workstation
Event
Object
.
.
.
.
. 238
Appendix
C.
Sample
Library
(SEQQSAMP)
.
.
.
.
.
.
.
.
.
.
. 241
Tivoli
Workload
Scheduler
for
z/OS
Application
Programming
Interface
.
.
.
.
.
.
.
.
.
. 241
API
Buffer
Examples
.
.
.
.
.
.
.
.
.
. 241
Tivoli
Workload
Scheduler
for
z/OS
Program
Interface
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 242
JS
Dataset
Maintenance
.
.
.
.
.
.
.
.
. 242
JCL
Variable
Substitution
.
.
.
.
.
.
.
. 242
Current
Plan
and
LTP
Actions
.
.
.
.
.
.
. 243
Other
PIF
Samples
.
.
.
.
.
.
.
.
.
. 243
Notices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 245
Trademarks
.
.
.
.
.
.
.
.
.
.
.
.
.
. 246
Glossary
.
.
.
.
.
.
.
.
.
.
.
.
. 247
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 259
Contents
v
vi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
Figures
1.
Program
Interface
Parameters
.
.
.
.
.
.
. 7
2.
Program
Interface
Arguments
in
TSO
Command
Notation
.
.
.
.
.
.
.
.
.
.
.
.
.
. 8
3.
Program
Interface
Data
Area
Example
.
.
.
. 11
4.
Example
of
Arguments
for
Processing
a
List
52
5.
Example
of
a
Send
Buffer
Layout
for
a
GET
Request
.
.
.
.
.
.
.
.
.
.
.
.
.
. 66
6.
Application
Flow
Example
.
.
.
.
.
.
. 118
Copyright
IBM
Corp.
1991,
2004
vii
viii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
Tables
1.
Comparison
of
Date
Representations
.
.
.
. 12
2.
Access
Authority
for
Program
Interface
Requests
.
.
.
.
.
.
.
.
.
.
.
.
. 13
3.
Program
Interface
Resources
and
the
Corresponding
Tivoli
Workload
Scheduler
for
z/OS
Fixed
Resources
Used
for
Checking
Authorization
.
.
.
.
.
.
.
.
.
.
.
. 13
4.
Records
Using
a
Common
Segment
.
.
.
. 14
5.
Delete
AD
Arguments
.
.
.
.
.
.
.
.
. 16
6.
Delete
AWSCL
Arguments
.
.
.
.
.
.
. 17
7.
Delete
CL
Arguments
.
.
.
.
.
.
.
.
. 17
8.
Delete
CPOC
Arguments
.
.
.
.
.
.
.
. 17
9.
Delete
CPOP
Arguments
.
.
.
.
.
.
.
. 17
10.
Delete
CPPRE
Arguments
.
.
.
.
.
.
.
. 17
11.
Delete
CPSUC
Arguments
.
.
.
.
.
.
.
. 17
12.
Delete
CPSR
Arguments
.
.
.
.
.
.
.
. 18
13.
Delete
ETT
Arguments
.
.
.
.
.
.
.
.
. 18
14.
Delete
IVL
Arguments
.
.
.
.
.
.
.
.
. 18
15.
Delete
JCLV
Arguments
.
.
.
.
.
.
.
. 18
16.
Delete
JL
Arguments
.
.
.
.
.
.
.
.
. 18
17.
Delete
JS,
JSCOM
Arguments
.
.
.
.
.
. 19
18.
Delete
LTOC
Arguments
.
.
.
.
.
.
.
. 19
19.
Delete
LTPRE
Arguments
.
.
.
.
.
.
.
. 19
20.
Delete
OI
Arguments
.
.
.
.
.
.
.
.
. 19
21.
Delete
PR
Arguments
.
.
.
.
.
.
.
.
. 20
22.
Delete
SR
Arguments
.
.
.
.
.
.
.
.
. 20
23.
Delete
WS
Arguments
.
.
.
.
.
.
.
.
. 20
24.
Insert
CPOC
Arguments
.
.
.
.
.
.
.
. 25
25.
Insert
CPOP
Arguments
.
.
.
.
.
.
.
. 26
26.
Insert
CPPRE
Arguments
.
.
.
.
.
.
.
. 27
27.
Insert
CPSR
Arguments
.
.
.
.
.
.
.
. 27
28.
Insert
CPSUC
Arguments
.
.
.
.
.
.
.
. 28
29.
Insert
IVL
Arguments
.
.
.
.
.
.
.
.
. 28
30.
Insert
JCLPREP
Arguments
.
.
.
.
.
.
. 28
31.
Insert
JCLV
Arguments
.
.
.
.
.
.
.
.
. 28
32.
Insert
LTOC
Arguments
.
.
.
.
.
.
.
. 29
33.
Insert
LTPRE
Arguments
.
.
.
.
.
.
.
. 29
34.
List
ADCOM
and
ADKEY
Arguments
.
.
.
. 33
35.
List
AWSCL
Arguments
.
.
.
.
.
.
.
. 33
36.
List
CLCOM
Arguments
.
.
.
.
.
.
.
. 34
37.
List
CPOC
Arguments
.
.
.
.
.
.
.
.
. 34
38.
List
CPOPCOM
Arguments
.
.
.
.
.
.
. 34
39.
List
CPOPSRU
Arguments
.
.
.
.
.
.
. 35
40.
List
CPWSCOM
Arguments
.
.
.
.
.
.
. 35
41.
List
CSRCOM
Arguments
.
.
.
.
.
.
.
. 36
42.
List
ETT
Arguments
.
.
.
.
.
.
.
.
.
. 36
43.
List
JCLVCOM
Arguments
.
.
.
.
.
.
. 36
44.
List
JLCOM
Arguments
.
.
.
.
.
.
.
. 36
45.
List
JSCOM
Arguments
.
.
.
.
.
.
.
. 36
46.
List
LTOCCOM
Arguments
.
.
.
.
.
.
. 37
47.
List
OICOM
Arguments
.
.
.
.
.
.
.
. 37
48.
List
PRCOM
Arguments
.
.
.
.
.
.
.
. 37
49.
List
SRCOM
Arguments
.
.
.
.
.
.
.
. 37
50.
List
WSCOM
Arguments
.
.
.
.
.
.
.
. 37
51.
Modify
CPEXT
Arguments
.
.
.
.
.
.
. 39
52.
Modify
CPOC
Arguments
.
.
.
.
.
.
.
. 39
53.
Modify
CPOP
Arguments
.
.
.
.
.
.
.
. 40
54.
Modify
CPWS
Arguments
.
.
.
.
.
.
.
. 41
55.
Modify
CSR
Arguments
.
.
.
.
.
.
.
. 42
56.
Modify
IVL
Arguments
.
.
.
.
.
.
.
. 42
57.
Modify
LTOC
Arguments
.
.
.
.
.
.
.
. 43
58.
Replace
AD
Arguments
.
.
.
.
.
.
.
. 49
59.
Select
AD,
ADCOM
Arguments
.
.
.
.
.
. 53
60.
Select
AWSCL
Arguments
.
.
.
.
.
.
.
. 54
61.
Select
CL,
CLCOM
Arguments
.
.
.
.
.
. 54
62.
Select
CPOC
Arguments
.
.
.
.
.
.
.
. 54
63.
Select
CPOP,
CPOPCOM
Arguments
.
.
.
. 54
64.
Select
CPWS,
CPWSCOM
Arguments
.
.
.
. 55
65.
Select
CSR,
CSRCOM
Arguments
.
.
.
.
. 55
66.
Select
ETT
Arguments
.
.
.
.
.
.
.
.
. 55
67.
Select
JCLPREP
Arguments
.
.
.
.
.
.
. 56
68.
Select
JCLPREPA
Arguments
.
.
.
.
.
.
. 56
69.
Select
JCLV,
JCLVCOM
Arguments
.
.
.
.
. 56
70.
Select
JLCOM
Arguments
.
.
.
.
.
.
.
. 56
71.
Select
JS,
JSCOM
Arguments
.
.
.
.
.
.
. 57
72.
Select
LTOC,
LTOCCOM
Arguments
.
.
.
. 57
73.
Select
OI,
OICOM
Arguments
.
.
.
.
.
. 57
74.
Select
PR,
PRCOM
Arguments
.
.
.
.
.
. 57
75.
Select
SR,
SRCOM
Arguments
.
.
.
.
.
. 57
76.
Select
WS,
WSCOM
Arguments
.
.
.
.
.
. 58
77.
Contents
of
a
Send
Buffer
.
.
.
.
.
.
.
. 65
78.
App-Fixed
Section
.
.
.
.
.
.
.
.
.
. 66
79.
APPOBJ-Object
Section
.
.
.
.
.
.
.
.
. 68
80.
APPSEL-Selection
Section
.
.
.
.
.
.
.
. 71
81.
APPVAL-Selection
Value
Section
.
.
.
.
. 72
82.
APPFLD-Field
Section
.
.
.
.
.
.
.
.
. 72
83.
APPDAT-Data
Section
.
.
.
.
.
.
.
.
. 73
84.
API
Object
Names
.
.
.
.
.
.
.
.
.
. 73
85.
Operators
That
You
Can
Specify
in
the
APPSEL
Section
.
.
.
.
.
.
.
.
.
.
. 75
86.
Subresource
Protection
for
Requests
through
the
API
.
.
.
.
.
.
.
.
.
.
.
.
.
. 78
87.
Positional
parameters
that
can
be
passed
with
the
Batch
Command
Interface
.
.
.
.
.
. 83
88.
Access
Authorizations
.
.
.
.
.
.
.
.
. 119
89.
Input
Arrival
Date
and
Time
Keywords
121
90.
How
OCL
Uses
the
IADATE,
IATIME,
and
IA
Keywords
.
.
.
.
.
.
.
.
.
.
.
.
. 122
91.
Tivoli
Workload
Scheduler
for
z/OS-supplied
Variables
.
.
.
.
.
.
.
.
.
.
.
.
. 124
92.
Keywords
Used
in
the
Add
Instruction
124
93.
Keywords
used
in
the
Addop
Instruction
126
94.
Keywords
used
in
the
Addpred
Instruction
128
95.
Keywords
used
in
the
Addres
Instruction
130
96.
Keywords
used
in
the
Chgextname
Instructions
.
.
.
.
.
.
.
.
.
.
.
. 132
97.
Keywords
used
in
the
Chgjob
Instructions
134
98.
Keywords
used
in
the
Chkappl
Instruction
135
99.
Chkdate
Instruction
Variables
.
.
.
.
.
. 138
100.
Keywords
used
in
the
Compl
Instruction
146
101.
Keywords
used
in
the
Del
Instruction
147
102.
Keywords
used
in
the
Delpred
Instruction
149
Copyright
IBM
Corp.
1991,
2004
ix
103.
Keywords
used
in
the
Del
Instruction
151
104.
Keywords
used
in
the
Force
Instruction
153
105.
Keywords
used
in
the
Hold
Instruction
155
106.
Keywords
used
in
the
Init
Instruction
159
107.
Keywords
used
in
the
JSUACT
Instruction
160
108.
Keywords
used
in
the
Modop
Instructions
161
109.
Operations
Details
that
can
be
modified
162
110.
Keywords
used
in
the
Nop
Instruction
164
111.
Keywords
used
in
the
Opstat
Instruction
166
112.
Keywords
used
in
the
PROMPTN
Instruction
168
113.
Keywords
used
in
the
PROMPTY
Instruction
170
114.
Keyword
used
in
the
Release
Instruction
172
115.
Keywords
used
in
the
Relop
Instruction
174
116.
Keywords
used
in
the
Relsucc
Instruction
175
117.
Keywords
used
in
the
Srstat
Instruction
180
118.
Keywords
used
in
the
Unnop
Instruction
182
119.
Keywords
used
in
the
Wsstat
Instruction
184
120.
Clock
value
setting
at
the
start
of
different
years
.
.
.
.
.
.
.
.
.
.
.
.
.
. 191
121.
Clock
value
setting
at
different
time
interval
191
122.
ADCOM
Control
Block
.
.
.
.
.
.
.
. 192
123.
ADDEP
Control
Block
.
.
.
.
.
.
.
. 193
124.
ADEXT
Control
Block
.
.
.
.
.
.
.
.
. 193
125.
ADOP
Control
Block
.
.
.
.
.
.
.
.
. 193
126.
ADRUN
Control
Block
.
.
.
.
.
.
.
. 195
127.
Run
Cycle
Offsets
.
.
.
.
.
.
.
.
.
. 196
128.
Rule
Definition
.
.
.
.
.
.
.
.
.
.
. 196
129.
ADSR
Control
Block
.
.
.
.
.
.
.
.
. 197
130.
AWSCL
Control
Block
.
.
.
.
.
.
.
. 197
131.
CLCOM
Control
Block
.
.
.
.
.
.
.
. 198
132.
CLSD
Control
Block
.
.
.
.
.
.
.
.
. 198
133.
CLWD
Control
Block
.
.
.
.
.
.
.
.
. 199
134.
CPOC
Control
Block
.
.
.
.
.
.
.
.
. 199
135.
CPEXT
Control
Block
.
.
.
.
.
.
.
.
. 201
136.
CPOP
Control
Block
.
.
.
.
.
.
.
.
. 201
137.
CPPRE
Control
Block
.
.
.
.
.
.
.
.
. 204
138.
CPSUC
Control
Block
.
.
.
.
.
.
.
.
. 204
139.
CPSR
Control
Block
.
.
.
.
.
.
.
.
. 204
140.
CPOPSRU
Control
Block
.
.
.
.
.
.
.
. 205
141.
CPPRE
Control
Block
.
.
.
.
.
.
.
.
. 206
142.
CPST
Control
Block
.
.
.
.
.
.
.
.
. 207
143.
CPWS
Control
Block
.
.
.
.
.
.
.
.
. 207
144.
CPIVL
Control
Block
.
.
.
.
.
.
.
.
. 208
145.
CSRCOM
Control
Block
.
.
.
.
.
.
.
. 209
146.
CSRIVL
Control
Block
.
.
.
.
.
.
.
. 210
147.
CSRIWS
Control
Block
.
.
.
.
.
.
.
. 211
148.
CSRDWS
Control
Block
.
.
.
.
.
.
.
. 211
149.
ETT
Control
Block
.
.
.
.
.
.
.
.
.
. 211
150.
JSVC
Control
Block
.
.
.
.
.
.
.
.
. 212
151.
JSVV
Control
Block
.
.
.
.
.
.
.
.
. 212
152.
JCLVC
Control
Block
.
.
.
.
.
.
.
.
. 213
153.
JCLVV
Control
Block
.
.
.
.
.
.
.
.
. 213
154.
JCLVD
Control
Block
.
.
.
.
.
.
.
.
. 214
155.
JS
Control
Block
.
.
.
.
.
.
.
.
.
. 214
156.
JLCOM
Control
Block
.
.
.
.
.
.
.
.
. 215
157.
LTOC
Control
Block
.
.
.
.
.
.
.
.
. 216
158.
LTOP
Control
Block
.
.
.
.
.
.
.
.
. 216
159.
LTPRE
Control
Block
.
.
.
.
.
.
.
.
. 217
160.
LTSUC
Control
Block
.
.
.
.
.
.
.
.
. 217
161.
OI
Control
Block
.
.
.
.
.
.
.
.
.
. 218
162.
PR
Control
Block
.
.
.
.
.
.
.
.
.
. 218
163.
Period
Origin
Dates
.
.
.
.
.
.
.
.
. 219
164.
Period
Interval
End
Dates
.
.
.
.
.
.
. 219
165.
SRCOM
Control
Block
.
.
.
.
.
.
.
. 219
166.
SRIVL
Segment
.
.
.
.
.
.
.
.
.
.
. 220
167.
SRIWS
Segment
.
.
.
.
.
.
.
.
.
.
. 220
168.
SRDWS
Segment
.
.
.
.
.
.
.
.
.
. 221
169.
WSCOM
Control
Block
.
.
.
.
.
.
.
. 221
170.
WSIVL
Control
Block
.
.
.
.
.
.
.
.
. 222
171.
WSSD
Control
Block
.
.
.
.
.
.
.
.
. 222
172.
WSWD
Control
Block
.
.
.
.
.
.
.
.
. 223
173.
WSAM
Control
Block
.
.
.
.
.
.
.
.
. 223
174.
CP_STATUS
Object
Fields
.
.
.
.
.
.
. 225
175.
CP_OPERATION
Object
Fields
.
.
.
.
.
. 226
176.
CP_RESOURCE
Object
Fields
.
.
.
.
.
. 231
177.
CP_WORK_STATION
Object
Fields
.
.
.
. 232
178.
CP_OPEN_INTERVAL
Object
Fields
.
.
.
. 234
179.
CP_OPER_EVENT
Object
Fields
.
.
.
.
. 234
180.
CP_OPINFO_EVENT
Object
Fields
.
.
.
. 236
181.
CP_SR_EVENT
Object
Fields
.
.
.
.
.
. 237
182.
BACKUP_EVENT
Object
Fields
.
.
.
.
. 238
183.
CP_WS_EVENT
Object
Fields
.
.
.
.
.
. 238
184.
SEQQSAMP
Library
Members
for
Programming
Interfaces
and
the
API
.
.
.
. 241
x
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
||
Preface
This
manual
shows
you
how
to
use
the
programming
interfaces
to
IBM
Tivoli
Workload
Scheduler
for
z/OS
to
help
you
plan,
schedule,
and
monitor
work
in
the
production
department
of
your
computer
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
book,
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
SC32126600.
It
contains
updates
for
the
PQ81169
APAR.
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
for
users
who
write
application
programs
that
request
services
from
Tivoli
Operations
Planning
and
Control
(Tivoli
Workload
Scheduler
for
z/OS).
This
manual
documents
the
programming
interface
(PIF)
and
the
application
programming
interface
(API).
To
use
PIF
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
z/OS
and
OS/390
linkage
conventions
and
that
can
load
and
delete
an
assembler
program.
To
use
the
API,
you
require
a
knowledge
of
Advanced
Program-to-Program
Communication
(APPC).
You
must
be
able
to
write
application
transaction
programs
(ATPs)
that
use
the
services
of
APPC.
Because
the
API
is
implemented
using
a
subset
of
CPI-C
(Common
Programming
Interface
for
Communications)
verbs,
you
must
be
able
to
write
ATPs
that
use
CPI-C.
Copyright
IBM
Corp.
1991,
2004
xi
|
|||
|||
What
This
Manual
Contains
This
manual
contains
the
following
sections:
Part
1.
Programming
Interfaces
Part
1
contains
the
following
chapters:
v
Chapter
1,
The
Program
Interface
(PIF),
on
page
3
Describes
how
you
can
write
programs
to
issue
requests
to
the
Tivoli
Workload
Scheduler
for
z/OS
subsystem.
v
Chapter
2,
The
Application
Programming
Interface
(API),
on
page
63
Describes
the
Tivoli
Workload
Scheduler
for
z/OS
interface,
which
uses
the
services
of
Advanced
Program-to-Program
Communications
(APPC)
for
communications
between
your
application
transaction
programs
(ATPs)
and
Tivoli
Workload
Scheduler
for
z/OS.
Part
2.
Programming
Tools
Part
2
contains
the
following
chapters:
v
Chapter
3,
Batch
Command
Interface
Tool,
on
page
83
Describes
the
batch
command
interface
tool.
v
Chapter
4,
Control
Language
(OCL),
on
page
113
Describes
the
Tivoli
Workload
Scheduler
for
z/OS
Control
Language.
Part
3.
Appendixes
Part
3
contains
the
following
appendixes:
v
Appendix
A,
Program
Interface
Record
Format,
on
page
191
Describes
the
fields
of
the
data
records
as
handled
by
the
program
interface
communication
routine.
v
Appendix
B,
API
Object
Fields,
on
page
225
Describes
the
fields
of
the
application
programming
interface
(API)
objects.
v
Appendix
C,
Sample
Library
(SEQQSAMP),
on
page
241
Describes
the
members
of
the
sample
library,
SEQQSAMP,
that
help
you
use
programming
interfaces.
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
Tivoli
Workload
Scheduler
for
z/OS
The
following
documents
are
available
in
the
Tivoli
Workload
Scheduler
for
z/OS
library:
v
Customization
and
Tuning,
SC32-1265
Describes
how
to
customize
Tivoli
Workload
Scheduler
for
z/OS.
v
Installation
Guide,
SC32-1264
Describes
how
to
install
Tivoli
Workload
Scheduler
for
z/OS.
v
Diagnosis
Guide
and
Reference,
SC32-1261
xii
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
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
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
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
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
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
Preface
xiii
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
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
displayable
softcopy
form
in
the
following
collection
kits:
xiv
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/http://publib.boulder.ibm.com/tividd/td/tdprodlist.html
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.
For
additional
information,
see
the
Accessibility
Appendix
in
the
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
Preface
xv
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/supporthttp://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
xvi
IBM
Tivoli
Workload
Scheduler
for
z/OS
Programming
Interfaces
Part
1.
Programming
Interfaces
Chapter
1.
The
Program
Interface
(PIF)
.
.
.
.
. 3
Program
Interface
Samples
.
.
.
.
.
.
.
.
. 3
Related
Tools
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
Batch
Command
Interface
Tool
.
.
.
.
.
.
. 3
Tivoli
Workload
Scheduler
for
z/OS
Control
Language
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
Communicating
with
EQQYCOM
.
.
.
.
.
.
. 4
Required
Datasets
.
.
.
.
.
.
.
.
.
.
.
. 5
Optional
Dataset
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Error
Messages
.
.
.
.
.
.
.
.
.
.
.
.
. 5
Parameter
Overview
.
.
.
.
.
.
.
.
.
.
.
. 6
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 7
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 7
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 8
Argument
Names
and
Values
.
.
.
.
.
.
.
. 8
Communication
Block
.
.
.
.
.
.
.
.
.
. 9
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 9
Sequence
of
Requests
.
.
.
.
.
.
.
.
.
.
. 9
Data
Area
Description
and
Format
.
.
.
.
.
.
. 10
Header
Format
.
.
.
.
.
.
.
.
.
.
.
. 10
Data
Record
Format
.
.
.
.
.
.
.
.
.
. 11
Date
Considerations
.
.
.
.
.
.
.
.
.
.
. 11
Internal
Date
Representation
.
.
.
.
.
.
.
. 11
Date
Arguments
in
PIF
Applications
.
.
.
.
. 12
Updating
Application
Description
Run
Cycles
with
PIF
.
.
.
.
.
.
.
.
.
.
.
.
.
. 12
Security
Considerations
.
.
.
.
.
.
.
.
.
. 13
Overview
of
Request
Types
.
.
.
.
.
.
.
.
. 14
DELETE
Request
.
.
.
.
.
.
.
.
.
.
.
. 15
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 15
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 15
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 16
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 16
Delete
AD
Arguments
.
.
.
.
.
.
.
.
. 16
Delete
AWSCL
Arguments
.
.
.
.
.
.
. 17
Delete
CL
Arguments
.
.
.
.
.
.
.
.
. 17
Delete
CPOC
Arguments
.
.
.
.
.
.
.
. 17
Delete
CPOP
Arguments
.
.
.
.
.
.
.
. 17
Delete
CPPRE
Arguments
.
.
.
.
.
.
. 17
Delete
CPSUC
Arguments
.
.
.
.
.
.
. 17
Delete
CPSR
Arguments
.
.
.
.
.
.
.
. 18
Delete
ETT
Arguments
.
.
.
.
.
.
.
. 18
Delete
IVL
Arguments
.
.
.
.
.
.
.
.
. 18
Delete
JCLV
Arguments
.
.
.
.
.
.
.
. 18
Delete
JL
Arguments
.
.
.
.
.
.
.
.
. 18
Delete
JS
Arguments
.
.
.
.
.
.
.
.
. 19
Delete
LTOC
Arguments
.
.
.
.
.
.
.
. 19
Delete
LTPRE
Arguments
.
.
.
.
.
.
.
. 19
Delete
OI
Arguments
.
.
.
.
.
.
.
.
. 19
Delete
PR
Arguments
.
.
.
.
.
.
.
.
. 20
Delete
SR
Arguments
.
.
.
.
.
.
.
.
. 20
Delete
WS
Arguments
.
.
.
.
.
.
.
.
. 20
Communication
Block
Address
.
.
.
.
.
.
. 20
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 20
EXECUTE
Request
.
.
.
.
.
.
.
.
.
.
.
. 20
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 21
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Communication
Block
Address
.
.
.
.
.
.
. 21
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
INIT
Request
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Action
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Resource
Code
.
.
.
.
.
.
.
.
.
.
.
. 21
Data
Area
.
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Arguments
.
.
.
.
.
.
.
.
.
.
.
.
. 21
Communication
Block
Address
.
.
.
.
.
.
. 22
Return
Code
.
.
.
.
.
.
.
.
.
.
.
.
. 22
INSERT
Request
.
.
.
.
.
.
.
.