Tivoli
®IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
User’s
Guide
FeatureLevel1.3(RevisedDecember2004)
SC32-1257-02
Tivoli
®IBM
Tivoli
Workload
Scheduler
Job
Scheduling
Console
User’s
Guide
FeatureLevel1.3(RevisedDecember2004)
SC32-1257-02
Note
Beforeusingthisinformationandtheproductitsupports,readtheinformationin“Notices”onpage333.
ThirdEdition(December2004)
Thiseditionappliestofeaturelevel1.3ofIBMTivoliWorkloadSchedulerJobSchedulingConsole(programnumber 5697-WSZ)andtoallsubsequentreleasesandmodificationsuntilotherwiseindicatedinneweditions.
Contents
List
of
figures
.
.
.
.
.
.
.
.
.
.
.
. ix
List
of
tables
.
.
.
.
.
.
.
.
.
.
.
. xi
About
this
guide
.
.
.
.
.
.
.
.
.
. xiii
Whatisnewinthisguide . . . xiii
Whoshouldreadthisguide . . . xiv
Whatthisguidecontains. . . xv
Publications . . . xviii
TivoliWorkloadSchedulerlibrary . . . xviii
Relatedpublications . . . xxi
Accessingpublicationsonline . . . xxii
Orderingpublications . . . xxii
Accessibility . . . xxiii
Tivolitechnicaltraining. . . xxiii
Supportinformation. . . xxiii
Conventionsusedinthisguide . . . xxiii
Typefaceconventions . . . xxiii
Operatingsystem-dependentvariablesand paths . . . xxiv
Commandsyntax. . . xxiv
Part
1.
Introduction
.
.
.
.
.
.
.
.
. 1
Chapter
1.
Job
Scheduling
Console
overview
.
.
.
.
.
.
.
.
.
.
.
.
.
. 3
TivoliWorkloadSchedulerarchitecture . . . 3
Components . . . 3
Topology . . . 4
Connection . . . 6
Part
2.
Planning,
installation
and
upgrade
.
.
.
.
.
.
.
.
.
.
.
.
.
. 9
Chapter
2.
Planning
and
installing
the
Job
Scheduling
Console
.
.
.
.
.
.
. 11
Planninginstallation . . . 11
Installationmethods . . . 12
Installingusingtheinstallationwizard . . . 12
Runningtheinstallationwizard . . . 12
Performingasilentinstallation . . . 13
InstallingusingSoftwareDistribution . . . 13
Installingfromthecommandline . . . 14
InstallingtheJavaVirtualMachine . . . 15
Chapter
3.
Planning
and
installing
the
z/OS
connector
.
.
.
.
.
.
.
.
.
.
. 17
Planningconnectorinstallations . . . 17
Installationmethods . . . 17
InstallingfromtheTivoliDesktop . . . 18
InstallingJobSchedulingServicesfromtheTivoli Desktop . . . 18
InstallingtheconnectorfromtheTivoliDesktop 18 Installingusingtheinstallationwizard . . . 19
Performingasilentinstallation . . . 20
Installingfromthecommandline . . . 20
InstallingJobSchedulingServicesfromthe commandline . . . 20
Installingtheconnectorfromthecommandline 21 Customizingtheconnector . . . 21
Authorizationrolesrequiredforinstances . . . 21
Managingz/OSconnectorinstanceswith wopcconn . . . 22
Managingdistributedconnectorinstanceswith wtwsconn . . . 23
Installationscenarios . . . 23
Usefulframeworkcommands . . . 24
Chapter
4.
Upgrading
the
z/OS
connector
.
.
.
.
.
.
.
.
.
.
.
.
. 27
Upgradingusingtheinstallationwizard. . . 27
Upgradescenarios . . . 28
UpgradingusingtheTivoliDesktop . . . 29
Upgradingusingthecommandline . . . 29
Chapter
5.
Installing
new
languages
on
an
existing
installation
.
.
.
.
.
.
.
. 31
Installingnewlanguagesusingtheinstallation wizard . . . 31
Chapter
6.
Uninstalling
the
components
33
SettingtheTivoliEnvironment . . . 33UninstallingtheJobSchedulingConsole. . . 33
UninstallingtheJobSchedulingConsoleusing theSoftwareDistributionCLI . . . 33
UninstallingtheJobSchedulingServices. . . 34
Uninstallingtheconnectors . . . 34
Part
3.
Console
overview
.
.
.
.
.
. 37
Chapter
7.
Job
Scheduling
Console
object
descriptions
.
.
.
.
.
.
.
.
. 39
Commonobjects. . . 39
Distributedenginespecificobjects. . . 39
Lists. . . 40
Database . . . 40
Plan . . . 40
Chapter
8.
Job
Scheduling
Console
quick
start
guide
.
.
.
.
.
.
.
.
.
. 41
Tasktypes. . . 41
Definitiontasks . . . 41
Managementtasks . . . 41
Taskflows. . . 41
Definitiontaskflows . . . 41
Managementtaskflows . . . 42
Taskmapping . . . 44
Terminologymapping . . . 45
Chapter
9.
Starting
the
Job
Scheduling
Console
.
.
.
.
.
.
.
.
.
.
.
.
.
. 47
JobSchedulingConsoleinterfacedescription . . . 48
JobSchedulingConsolemainwindow . . . . 48
Standardfunctionality. . . 49
Part
4.
Defining
objects
.
.
.
.
.
. 51
Chapter
10.
Creating
workstations
.
.
. 53
Creatingaz/OSworkstation . . . 53
Generaltab . . . 54
Resourcestab. . . 56
OpenTimeIntervalstab . . . 57
Creatingadistributedworkstation. . . 59
Chapter
11.
Creating
Windows
users
65
CreatingaWindowsuser. . . 65Chapter
12.
Creating
parameters
.
.
. 67
Creatingaparameter . . . 67
Chapter
13.
Creating
prompts
.
.
.
.
. 69
Creatingaprompt . . . 69
Chapter
14.
Creating
calendars
.
.
.
. 71
TheHolidayscalendar. . . 71
Thefreedayscalendar . . . 71
Creatingacalendar. . . 72
Chapter
15.
Creating
domains
.
.
.
.
. 75
Creatingadomain . . . 75
Chapter
16.
Creating
workstation
classes
.
.
.
.
.
.
.
.
.
.
.
.
.
. 77
Creatingaworkstationclass. . . 77
Generaltab . . . 77
Workstationstab. . . 77
Chapter
17.
Creating
distributed
job
definitions
.
.
.
.
.
.
.
.
.
.
.
.
. 79
Creatingajobdefinition . . . 79
Generaltab . . . 80
Tasktab . . . 83
Chapter
18.
Creating
job
streams
.
.
. 85
Creatingajobstreamforaz/OSengine. . . 85
Creatingajobforz/OSjobstreams . . . 87
Creatingdependenciesbetweenjobs . . . 92
Schedulingjobstreams . . . 93
Savingajobstream . . . 101
Creatingadistributedjobstream. . . 101
Generaltab . . . 102
Resourcestab . . . 104
Filestab . . . 105
Promptstab . . . 105
Addingexternaldependenciestoajobstream 106 Addingajobtoajobstream . . . 107
Copyingandpastingjobs . . . 110
Cloningjobdependencies . . . 111
Addinganinternetworkdependencytoajob stream. . . 111
Addinganexternaljobstreamtoajobstream 112 Addinganexternaljobtoajobstream . . . . 113
Creatingdependenciesbetweenjobsinajob stream. . . 114
Specifyingruncyclesforajobstream . . . . 115
SpecifyingtimerestrictionsintheTimelineView 120
Chapter
19.
Creating
resources
.
.
.
. 123
Creatingaz/OSresource . . . 123
Resourcetab. . . 123
DefaultWorkstationstab . . . 125
AvailabilityIntervalstab. . . 125
Creatingadistributedresource . . . 126
Chapter
20.
Creating
objects
using
Create
Another
.
.
.
.
.
.
.
.
.
.
. 127
Chapter
21.
Creating
lists
.
.
.
.
.
. 129
Creatingdatabaselists . . . 129
Creatingalistofjobstreams . . . 131
Creatingalistofworkstations. . . 133
Creatingalistofresources . . . 134
Creatingalistofjobdefinitions . . . 135
Creatingalistofworkstationclasses . . . . 136
Creatingalistofprompts . . . 136
Creatingalistofparameters . . . 137
CreatingalistofWindowsusers . . . 137
Creatingalistofdomains . . . 138
Creatingalistofcalendars . . . 138
Creatingplanlists. . . 139
Creatingajobstreaminstancelistfor distributedengines . . . 139
Creatingajobstreaminstancelistforz/OS engines . . . 141
Creatingajobinstancelistfordistributed engines . . . 143
Creatingjobinstancelistforz/OSengines . . 146
Creatingalistofworkstations. . . 148
Creatingalistofresources . . . 148
Creatingalistoffiles. . . 148
Creatingalistofprompts . . . 149
Creatingalistofdomainstates . . . 149
Creatingagroupoflists. . . 150
Creatingdefaultcommonplanlists . . . 150
Creatingacommonlistofjobstreaminstances 150 Creatingacommonlistofjobinstances . . . 151
Settinglistproperties. . . 151
Chapter
22.
Working
with
object
lists
155
Displayingalistofobjects . . . 155
Detachingalistdisplay . . . 156
Modifyingalist . . . 156
Deletingalist . . . 157
Chapter
23.
Managing
workstations
159
Viewingandmodifyingworkstationproperties . . 159Deletingworkstations . . . 159
Chapter
24.
Managing
job
streams
161
Editingjobstreamsusingthejobstreameditor . . 161Deletingexternaldependenciesfromajob stream. . . 161
Modifyingajobinajobstream . . . 161
Deletingajobinajobstream . . . 162
Modifyinganinternetworkdependencyinajob stream. . . 162
Deletinganinternetworkdependencyinajob stream. . . 162
Modifyinganexternaljobstream. . . 162
Deletinganexternaljobstreaminajobstream 162 Modifyinganexternaljobinajobstream . . . 162
Deletinganexternaljobinajobstream . . . 162
Modifyingruncyclesforajobstream . . . . 162
Deletingruncyclesfromajobstream . . . . 163
Modifyingz/OSjobstreams . . . 163
Addingandmodifyingjobsanddependencies inthegraphview . . . 163
Addingandmodifyingruncycles . . . 164
Viewingandmodifyingtimerestrictions . . . 165
Usingthecopyfunctiontoaddanexternaljob 165 CheckingtimerestrictionsintheTimelineView 165 Activitybars . . . 166
Tableframe . . . 166
Timerestrictions . . . 167
Othertasks . . . 167
Deletingjobstreams . . . 168
Chapter
25.
Managing
resources
.
.
. 169
Displayingresourceproperties . . . 169
Modifyingaresource. . . 169
Deletingaresource . . . 169
Chapter
26.
Managing
job
definitions
171
Displayingajobdefinition . . . 171Displayingjobdefinitiondetails . . . 171
Modifyingajobdefinition . . . 172
Deletingjobdefinitions . . . 172
Usingexistingdefinitionstocreateotherjob definitions . . . 172
Chapter
27.
Managing
workstation
classes
.
.
.
.
.
.
.
.
.
.
.
.
.
. 175
Displayingandmodifyingworkstationclass properties . . . 175
Deletingworkstationclasses . . . 175
Chapter
28.
Managing
domains
.
.
.
. 177
Displayingandmodifyingdomainproperties . . 177
Deletingdomainsinthedatabase . . . 177
Chapter
29.
Managing
Windows
users
179
DisplayingandmodifyingWindowsuser properties . . . 179ChangingWindowsuserpasswords. . . 179
DeletingWindowsusers. . . 179
Chapter
30.
Managing
calendars
.
.
. 181
Displayingandmodifyingcalendarproperties . . 181
Deletingcalendars. . . 181
Chapter
31.
Managing
prompts
.
.
.
. 183
Displayingandmodifyingpromptproperties. . . 183
Deletingprompts . . . 183
Chapter
32.
Managing
parameters
.
. 185
Displayingandmodifyingparameterproperties 185 Deletingparameters . . . 185
Part
6.
Managing
plans
.
.
.
.
.
. 187
Chapter
33.
Managing
z/OS
plans
.
.
. 189
Managingjobstreaminstancesintheplan . . . 189
Jobstreaminstancelists . . . 189
Submitajobstream . . . 190
Browsingandmodifyingjobstreaminstances 191 ChangingtimerestrictionsintheTimelineView 192 Managingjobinstancesintheplan . . . 195
Jobinstancelists . . . 195
Browsingandmodifyingjobinstances . . . . 196
Showingpredecessorsandsuccessors . . . . 203
Browsingthejoblog . . . 204
Removingajobinstancefromtheplan. . . . 204
Restoringajobinstancetotheplan . . . 205
Runningajobinstanceimmediately. . . 205
Changingthestatusofajobinstance . . . . 205
EditingJCL . . . 205
Viewingoperatorinstructions . . . 205
Modifyingjobsetup . . . 205
Restartandcleanup . . . 206
Recoveryinformation. . . 206
Managingz/OSworkstationsintheplan . . . . 206
Displayingworkstations. . . 207
Browsingandmodifyingworkstations . . . . 207
Linkingfault-tolerantworkstations . . . 209
Changingworkstationstatusandrerouting scheduledjobinstances . . . 210
Displayingthejobinstancesscheduledona workstationbystatus. . . 210
Modifyingthejobinstancesscheduledona workstation . . . 211
Managingresourcesintheplan . . . 212
Displayingresources . . . 213
Browsingandmodifyingresources . . . 213
Displayingthejobinstancesassociatedwitha resource . . . 215
Modifyingjobinstancesassociatedwitha
resource . . . 216
Chapter
34.
Managing
distributed
plans
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 217
Managingjobstreaminstancesintheplan . . . 217
Displayingandchangingthepropertiesofajob streaminstance. . . 218
Displayingandchangingthedependenciesofa jobstreaminstance . . . 224
InternetworkPredecessorstab. . . 224
Successorstab . . . 225
Addingpredecessorstoajobstreaminstance 225 Deletingpredecessorsfromajobstream instance . . . 225
Holdingajobstreaminstance . . . 226
Releasingajobstreaminstance . . . 226
Showingpredecessorsandsuccessors . . . . 226
Cancelingajobstreaminstance . . . 227
Changingthejoblimitofajobstreaminstance 227 Changingthepriorityofajobstreaminstance 227 Releasingajobstreaminstancefrom dependencies . . . 228
Resubmittingajobstreaminstance . . . 228
Submittingjobs. . . 229
Monitoringjobs . . . 229
Managingjobinstancesintheplan . . . 229
Modifyingthepropertiesofajobinstance. . . 230
Modifyingdependenciesofajobinstance . . . 236
Holdingajobinstance . . . 238
Releasingajobinstance . . . 238
Showingpredecessorsandsuccessors . . . . 239
Browsingthejoblog . . . 240
Rerunningajobinstance . . . 240
Cancelingajobinstance. . . 241
Killingajobinstance . . . 241
ConfirmingajobinstanceSUCCorABEND . . 242
Releasingajobinstancefromdependencies . . 242
Submittingjobsandjobstreamsintotheplan . . 243
Submittingajobstreamintotheplan . . . . 243
Submittingajobintotheplan. . . 243
Viewingormodifyingthepropertiesofthejob tosubmit. . . 245
Submittinganadhocjobintotheplan . . . . 251
Managingworkstationsintheplan . . . 259
Displayingthestatusofworkstationsinthe plan . . . 259
Displayingaworkstationinstance . . . 261
Changingthejoblimitofaworkstationinthe plan . . . 261
Changingthejobfenceofaworkstationinthe plan . . . 262
Startingaworkstationinstance . . . 262
Stoppingaworkstationinstance . . . 262
Linkingaworkstationinstance . . . 262
Unlinkingaworkstationinstance. . . 262
Managingdomainsintheplan . . . 262
Startingtheworkstationsinadomain . . . . 263
Stoppingtheworkstationsinadomain. . . . 263
Switchingthedomainmanagerinadomain . . 263
Managingfiledependenciesintheplan . . . . 264
Displayingfiledependenciesstatus . . . 264
Managingpromptdependenciesintheplan . . . 264
Displayingpromptdependenciesstatus . . . 264
Replyingtoapromptdependency . . . 265
Managingresourcedependenciesintheplan. . . 265
Displayingresourcedependenciesstatus . . . 265
Displayingthepropertiesofaresource dependency . . . 266
Changingthenumberofunitsofaresource dependency . . . 266
Settinganalternateplan. . . 266
Part
7.
Troubleshooting
.
.
.
.
.
. 269
Chapter
35.
Setting
traces
for
the
Job
Scheduling
Console
.
.
.
.
.
.
.
. 271
Chapter
36.
Troubleshooting
.
.
.
.
. 273
Installation . . . 273
JobSchedulingConsoleinstallationlog. . . . 273
Connectorinstallationlog . . . 273
General . . . 273
Repairingtheinstallation . . . 276
Chapter
37.
Job
Scheduling
Console
messages
.
.
.
.
.
.
.
.
.
.
.
.
. 279
Appendix
A.
Accessibility
.
.
.
.
.
. 321
Navigatingtheinterfaceusingthekeyboard . . . 321
Magnifyingwhatisdisplayedonthescreen . . . 321
Appendix
B.
Setting
Security
.
.
.
.
. 323
Settingsecureauthenticationandencryption . . . 323
ConfiguringtheJobSchedulingConsoletowork acrossafirewall . . . 323
Usefulframeworkcommands . . . 324
Appendix
C.
Status
description
and
mapping
.
.
.
.
.
.
.
.
.
.
.
.
. 325
Appendix
D.
Support
information
.
.
. 329
Searchingknowledgebases. . . 329
Searchtheinformationcenteronyourlocal systemornetwork. . . 329
SearchtheinformationcenterattheIBM supportWebsite . . . 329
SearchtheInternet . . . 329
Obtainingfixes. . . 330
ContactingIBMsoftwaresupport. . . 330
Determinethebusinessimpactofyourproblem 331 Describeyourproblemandgatherbackground information . . . 331
SubmityourproblemtoIBMSoftwareSupport 331
Notices
.
.
.
.
.
.
.
.
.
.
.
.
.
. 333
Glossary
.
.
.
.
.
.
.
.
.
.
.
.
. 337
Index
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 341
List
of
figures
1. Structuralchangestothetaskchapters xiv
2. Singletiertopology . . . 4
3. Multi–tiertopology . . . 5
4. End-to-endtopologywithJobScheduling Console . . . 6
5. JobSchedulingConsoleconnection . . . 7
6. Definitiontaskflows . . . 42
7. Managementtaskflows . . . 43
8. Examplerule . . . 97
9. Example1:Rule-basedruncycle . . . 98
10. Example2:ExclusionaryRunCycle . . . . 98
11. Example3:Exclusionaryruncycledefined 99 12. Example1:Offset-basedruncycle . . . . 100
13. Example2:Offset-basedruncycledefined 100 14. ExamplePropertiespanelfordistributed engines . . . 130
15. ExamplePropertiespanelforz/OSEngines 131 16. TimelineView-LeftPane . . . 193
17. TimelineView-RightPane . . . 193
18. Connectingacrossafirewall . . . 324
List
of
tables
1. Commandsyntax . . . xxiv
2. JobSchedulingConsoleprerequisite components . . . 11
3. Installationparameter . . . 14
4. Operatingsystemvariables . . . 14
5. SettingtheTivoliEnvironment . . . 17
6. Authorizationroles . . . 21
7. Installationscenarios . . . 24
8. Usefulframeworkcommands . . . 24
9. UpgradingtoIBMTivoliWorkloadScheduler forz/OSconnectorversion1.3 . . . 28
10. StartingtheuninstallprogramfortheJob SchedulingConsole . . . 33
11. z/OSanddistributedtaskmapping . . . . 44
12. JobSchedulingConsoleterminologymapping 45 13. StartingtheJobSchedulingConsole . . . . 47
14. Properties-WorkstationinDatabaseGeneral information . . . 54
15. Properties-WorkstationinDatabaseOpen TimeIntervalsinformation . . . 57
16. Properties-WorkstationinDatabase information . . . 59
17. Properties-WindowsUserinformation 65 18. Examplecalendars . . . 71
19. Properties-Domainpanel . . . 75
20. NewJobDefinitiontasktypes . . . 79
21. Properties-JobDefinitiongeneralinformation 80 22. Jobstreamrecoveryoptions . . . 81
23. Tasktypes . . . 83
24. Properties-JobStreampanelforz/OS 86 25. WhatHappensWhenYouDefineaJobStream 87 26. Graphviewjobbuttons . . . 87
27. Properties-JCLJobGeneralinformation 88 28. Properties-JCLJobTaskinformation . . . . 91
29. Properties-JCLJobTimeRestrictions information . . . 91
30. Runcyclebuttons . . . 94
31. RunCycleGeneralinformation . . . 94
32. RunCycleTimeRestrictionsinformation 95 33. Rule-basedRunCycleRulesinformation 96 34. Offset-basedruncyclerulesinformation 99 35. JobStreamPropertiesGeneralinformation 102 36. JobStreamTimeRestrictionsinformation 103 37. Properties-JobGeneralinformation . . . . 108
38. Properties-JobTimeRestrictionsinformation 108 39. Coloredbarsondates. . . 116
40. PropertiesInformation . . . 120
41. Createaresourceinformation . . . 124
42. Createavailabilityintervalsinformation 125 43. Properties-ResourceinDatabasePanel information . . . 126
44. Databasepropertieslistoptions . . . 129
45. Jobstreamlistdatafordistributedengines 131 46. Jobstreamlistdataforz/OSengines 132 47. Workstationlistdatafordistributedengines 133 48. Workstationlistdataforz/OSengines 133 49. Resourcelistdatafordistributedengines 134 50. Resourcelistdataforz/OSengines . . . . 134
51. Properties-JobListinformation . . . 135
52. WorkstationClassListData. . . 136
53. Promptlistdata. . . 136
54. Properties-ParameterListinformation 137 55. Windowsuserlistdata . . . 137
56. Domainlistdata . . . 138
57. Properties-CalendarListinformation 138 58. Planlistoptions. . . 139
59. Properties-JobStreamInstanceListGeneral information . . . 139
60. Properties-JobStreamInstanceListTime Restrictionsinformation . . . 140
61. Properties-JobStreamInstanceList Dependencyinformation. . . 141
62. Properties-JobStreamInstanceList information . . . 142
63. Properties-JobInstanceListGeneral information . . . 143
64. Properties-JobInstanceListTime Restrictionsinformation . . . 145
65. Properties-JobInstanceListDependency information . . . 146
66. Properties-JobInstanceListinformation 146 67. Properties-FileListinformation . . . 149
68. Properties-PromptListInformation 149 69. Properties-DomainStatusListinformation 150 70. Addingandmodifyingjobsand dependenciesinthegraphview . . . 163
71. Addingandmodifyingruncycles–pop-up menu . . . 165
72. DetailsforJobpanel . . . 171
73. Submitjobstreampanel . . . 190
74. JobInstanceDetailsTimelineView . . . . 192
75. Properties-JCLJobInstanceGeneral information . . . 196
76. Properties-JCLJobInstanceTaskInformation 197 77. Properties-JCLJobInstanceDetails information . . . 198
78. Properties-JCLJobInstanceOptions Information . . . 199
79. LogicalResourcesinformation . . . 200
80. DependenciesPredecessorsinformation 201 81. DependenciesPredecessorsTasks . . . 201
82. Dependenciessuccessorsinformation 201 83. Dependenciessuccessorstasks. . . 202
84. TimelineViewJobInstanceDetails . . . . 202
85. Properties-WorkstationinPlanGeneral information . . . 207
86. Workstationlistjoboptions . . . 210
87. Modifyingjobinstanceoptions. . . 211
88. Properties-ResourceinPlanResource information . . . 213
89. Properties-ResourceinPlanDefault Workstationsinformation . . . 214
90. Properties-ResourceinPlanAvailability
Intervalsinformation . . . 215
91. Modifyingjobinstanceoptions . . . 216
92. Jobstreaminstanceoptions . . . 217
93. Properties-JobStreamInstanceGeneral information . . . 218
94. Properties-JobStreamInstanceTime Restrictionsinformation . . . 219
95. Properties-JobStreamInstanceFiles information . . . 220
96. Properties-JobStreamInstancePrompts information . . . 221
97. Properties-JobStreamInstanceResources panel . . . 222
98. Properties-JobStreamInstancePredecessors information . . . 223
99. Dependencies-JobStreamInstance Predecessorinformation . . . 224
100. InternetworkPredecessorsinformation 224 101. Successorsinformation . . . 225
102. JobStreamInstancePriorities . . . 228
103. Jobinstanceoptions . . . 229
104. Properties-WindowsScriptInstanceGeneral Information . . . 230
105. Properties-JobInstanceTaskinformation 232 106. Properties-WindowsScriptInstanceTime Restrictionsinformation . . . 232
107. Properties-WindowsScriptInstanceFiles information . . . 234
108. Properties-WindowsScriptInstancePrompts information . . . 235
109. Properties-WindowsScriptInstance Resourcesinformation . . . 236
110. Predecessorstab . . . 236
111. InternetworkPredecessorstab . . . 237
112. Successorstab . . . 238
113. RerunJobWindowinformation . . . 240
114. SubmitJobStreamintoPlanWindow 243 115. SubmitJobintoPlanWindow . . . 244
116. SubmitJobintoPlaninformation . . . 244
117. Properties-JobInstanceGeneralinformation 245 118. Properties-JobInstanceTimeRestrictions information . . . 246
119. Properties-JobInstanceFilesinformation 248 120. Adhocpromptdependencies . . . 249
121. Predefinedpromptdependencies . . . 249
122. Properties-JobInstanceResources . . . . 250
123. Properties-JobInstancePredecessors 251 124. Properties-JobInstanceGeneral . . . 252
125. Tasktypes . . . 253
126. Properties-JobInstanceTimeRestrictions 255 127. Properties-JobInstanceFiles . . . 256
128. Adhocpromptdependencies . . . 256
129. Predefinedpromptdependencies . . . 257
130. Properties-JobInstanceResources . . . . 258
131. Properties-JobInstancePredecessors 259 132. WorkstationStatusListpane . . . 260
133. StatusofAllFilesList. . . 264
134. PromptDependenciesStatus . . . 265
135. ResourceDependenciesStatus . . . 266
136. SetAlternatePlanFilesWindow . . . 267
137. Loggingpropertieskeys . . . 271
138. Usefulframeworkcommands . . . 323
139. Usefulframeworkcommands . . . 324
140. JobSchedulingConsolejobstates. . . 325
141. TivoliWorkloadSchedulerInternaljobstates 326 142. JobSchedulingConsolejobstreamstates 326 143. TivoliWorkloadSchedulerinternaljobstream states . . . 327
144. Jobstatusmapping . . . 327
About
this
guide
TheIBM®Tivoli®WorkloadScheduler JobSchedulingConsoleUser’sGuidedescribes TivoliWorkload Schedulerforz/OS®,IBMTivoliWorkloadScheduler,andthe IBM TivoliWorkloadSchedulerJobScheduling Console,whichmakeuptheTivoli Workload Schedulersuiteofapplications.TheJobScheduling Consoleprovides userswith aJava-baseduserinterface toIBMTivoliWorkloadSchedulerforz/OS and IBMTivoliWorkloadScheduler.TheJobScheduling Consolesupplements,but doesnottotallyreplace, thetraditionalz/OSISPFpanesonthehost.Itallowsyou toworkwith schedulingobjectsin thefollowingways:
v Definejobstreams,jobs,workstations,andlogicalresourcesinthescheduling database.
v Monitorandmodifyjobstreaminstances,jobinstances, workstationinstances, andresourceinstancesintheplan.
TheIBM TivoliWorkloadScheduler JobSchedulingConsoleUser’sGuideprovidesan introductiontoandan explanationoftheIBMTivoliWorkloadSchedulerJob Scheduling ConsoleFeatureLevel1.3. Itexplainshowtoinstall theconsoleand provides instructionsforperformingschedulingtasks usingIBMTivoliWorkload Schedulerforz/OS andIBMTivoliWorkloadSchedulerfordistributed engines.
What
is
new
in
this
guide
Thischapterdescribesthemodificationsmadetothisguide. Thebookisnowdividedintothefollowingparts:
v Planningand Installation.SeePart2, “Planning,installation andupgrade,”on page9.
v ConsoleOverview.SeePart3, “Consoleoverview,”onpage37. v
DefiningObjects.SeePart4, “Definingobjects,”onpage51.
v ManagingDatabaseObjects.SeePart5, “Managingdatabaseobjects,”onpage 153.
v ManagingPlans.SeePart6,“Managingplans,”onpage187. v Troubleshooting.See Part7,“Troubleshooting,”onpage269. Theprevious issueofthebookwasdividedintothefollowingparts: v Planningand Installation
v UsingtheJobSchedulingConsolewithIBM TivoliWorkloadSchedulerforz/OS v UsingtheJobSchedulingConsolewithIBM TivoliWorkloadScheduler
Tocreatea guidethatismore taskorientedthestructureofthebookwaschanged. Thischangeinstructureimpactsthetasksectionsofthebookasillustratedin Figure1onpagexiv.
Figure1 illustrateshowinthepreviouseditiontasksweredividedbyengine,and notbytasktypes.
Asmalltroubleshootingsectionhasbeenaddedtothebook,whichdocumentsthe Job SchedulingConsolemessagesandthemostcommonproblemsthatare
encountered withtheJobScheduling Console.
Who
should
read
this
guide
Thisguideisintendedforthefollowingaudience:
v Systemadministratorswho havethetaskofinstallingtheJobScheduling Console.Theyshouldbefamiliar withoneormoreofthefollowingoperating systems: Microsoft ® Windows® AIX ® HP-UX SunSolaris Linux ™
v Schedulerswho havetheresponsibilityof creatingandupdatingdefinitionsof
Managing workstations
Listing and modifying job streams Listing job stream instances and job Instances
Managing job stream instances Managing job instances Managing workstations in the plan Managing resources in the plan Managing resources
Creating job streams
Managing database lists Managing jobs Managing job streams Managing workstations and
workstation classes
Managing domains, Windows users and calendars
Managing resources, prompts, and parameters
Plan tasks
Creating workstations
Creating resources Creating job streams
Creating distributed job definitions
Creating workstation classes Creating domains
Creating Windows users Creating calendars Creating prompts Creating parameters Creating objects using copy Creating object lists
Working with object lists Managing workstations
Managing resources in the database
Managing workstation classes
Managing domains Managing Windows users Managing calendars
Managing prompts Managing parameters Managing plans
Managing job streams
Refresh 1
Refresh 2
z/OS DistributedKey
Definition Monitoring Bothdatabaseandplan.They shouldbefamiliarwith performingthese specifictasks andwithworking intheIBM z/OSandMicrosoft Windowsenvironments: v Operatorswhohavetheresponsibilityofcontrollingand monitoringthe
schedulerplan.They shouldbe familiarwithperformingthetasksrelatedto monitoringand modifyingobjectsintheplanandwithworking intheIBM z/OSandWindowsenvironment.
What
this
guide
contains
Thisguidecontainsthefollowingsections: Part 1.Introduction
Part 1providesa descriptionoftheJob SchedulingConsoleandhowit fitsintothe overalltopology. Itcontainsthefollowingchapters:
Job SchedulingConsoleoverview
DescribestheoverallarchitectureofTivoliWorkloadSchedulerand where theJobScheduling Consolefitsintothattopology.SeeChapter1,“Job Scheduling Consoleoverview,”onpage3.
Part 2.Planning,installationandupgrade
Part 2providestheinformationnecessaryforyoutoplanand installtheJob Scheduling Consoleand itsnecessarycomponents.Itcontainsthefollowing chapters:
Planning andinstallingtheJobSchedulingConsole
Describeshowtoplanandinstall theJobSchedulingConsole. See Chapter2,“Planningand installingtheJob SchedulingConsole,”onpage 11.
Planning andinstallingthez/OSconnector
Describeshowtoplanandinstall thez/OSconnector.See Chapter3, “Planningand installingthez/OS connector,”onpage17.
Upgradingthez/OSconnector
Describeshowtoupgrade thez/OSconnector.SeeChapter4,“Upgrading thez/OSconnector,”onpage27.
Installing newlanguagesonanexistinginstallation
Describeshowtoinstall newlanguages.SeeChapter5,“Installingnew languages onan existinginstallation,” onpage31.
Uninstalling thecomponents
Describeshowtouninstall thevariouscomponentsthatcomprisetheJob Scheduling Console.SeeChapter6,“Uninstallingthecomponents,”on page33.
Part 3.Consoleoverview
Part 3providesan overviewoftheJobSchedulingConsoleanda quickstart to working withit.Itcontainsthefollowingchapters:
Job SchedulingConsoleobjectdescriptions
DescribestheobjectsthatarecreatedandmanagedusingtheJob Scheduling Console.SeeChapter7,“JobSchedulingConsoleobject descriptions,” onpage39.
Job SchedulingConsolequickstartguide
DescribesthetasksthatyouperformusingtheJobSchedulingConsole,a flowofthetaskorder,andlinkstothose tasks.SeeChapter8, “Job Scheduling Consolequickstartguide,” onpage41.
StartingtheJobSchedulingconsole
Describesstartingtheconsole,andof theconsoleelements.SeeChapter9, “StartingtheJobScheduling Console,”onpage47.
Part 4.Definitiontasks
Part 4providestheinformationnecessaryforyoutodefinedatabase objects,and createthelistsyouuseto managethem.Itcontains thefollowingchapters: Creatingworkstations
Describeshowto createworkstations inthez/OSand distributed environments. SeeChapter10,“Creatingworkstations,”onpage53. CreatingWindows users
Describeshowto createWindows usersinthedistributed environment.See Chapter11,“CreatingWindows users,”onpage65.
Creatingparameters
Describeshowto createparametersinthedistributedenvironment.See Chapter12,“Creatingparameters,”onpage67.
Creatingprompts
Describeshowto promptsinthedistributedenvironment.SeeChapter13, “Creatingprompts,”onpage69.
Creatingcalendars
Describeshowto createcalendars forthedistributedenvironment.See Chapter14,“Creatingcalendars,” onpage71.
Creatingdomains
Describeshowto createdomains forthedistributedenvironment.See Chapter15,“Creatingdomains,”onpage75.
Creatingworkstation classes
Describeshowto createworkstationclassesinthedistributedenvironment. See Chapter16,“Creatingworkstationclasses,”onpage77.
Creatingdistributed jobdefinitions
Describeshowto createjobdefinitions inthedistributed environment.See Chapter17,“Creatingdistributed jobdefinitions,”onpage79.
Creatingjob streams
Describeshowto createjobstreamsin thez/OSand distributed environments. SeeChapter18,“Creatingjobstreams,”onpage85. Creatingresources
Describeshowto createresources inthez/OS anddistributed environments. SeeChapter19,“Creatingresources,”onpage123. Create objectsusingcreateanother
Describeshowto cloneobjectsinthez/OSand distributedenvironments. See Chapter20,“CreatingobjectsusingCreateAnother,” onpage127. Creatinglists
Describeshowto createlists inthez/OSanddistributed environments. See Chapter21,“Creatinglists,”onpage129.
Part 5.Managingdatabaseobjects
Part 5providestheinformationnecessaryforyoutomanageobjectsinthe database afteryouhavecreated them.Itcontainsthefollowingchapters: Workingwithobjectlists
Describeshowtodisplaytablesofdatabaseand planobjectsusingtheList function. SeeChapter22,“Workingwithobjectlists,”onpage155.
Managingworkstations
Describeshowtomanage workstationsinthedatabase.SeeChapter23, “Managingworkstations,” onpage159.
Managingjob streams
Describeshowtomanage z/OSanddistributed jobstreamsinthe database.SeeChapter24,“Managingjobstreams,”onpage161. Managingresources
Describeshowtomanage z/OSanddistributed resourcesinthedatabase. SeeChapter25,“Managingresources,”onpage169.
Managingjob definitions
Describeshowtomanage distributedjobdefinitionsinthedatabase.See Chapter26,“Managingjobdefinitions,” onpage171.
Managingworkstation classes
Describeshowtomanage distributedworkstationclassesinthedatabase. SeeChapter27,“Managingworkstationclasses,”onpage175.
Managingdomains
Describeshowtomanage distributeddomains inthedatabase.See Chapter28,“Managingdomains,”onpage177.
Managingwindowsusers
Describeshowtomanage distributedWindows usersinthedatabase.See Chapter29,“ManagingWindowsusers,”onpage179.
Managingcalendars
Describeshowtomanage distributedcalendars inthedatabase.See Chapter30,“Managingcalendars,”onpage181.
Managingprompts
Describeshowtomanage distributedprompts inthedatabase.See Chapter31,“Managingprompts,”onpage183.
Managingparameters
Describeshowtomanage distributedparametersinthedatabase.See Chapter32,“Managingparameters,”onpage185.
Part 6.Managingplans
Part 6providestheinformationnecessaryforyoutomanageobjectsinz/OSand distributed plans.Itcontains thefollowingchapters:
Managingz/OSplans
Describeshowtomanage objectsinthez/OSplan.SeeChapter33, “Managingz/OSplans,” onpage189.
Managingdistributed plans
Describeshowtomanage objectsinthedistributedplan.See Chapter34, “Managingdistributed plans,”onpage217.
Part 7.Troubleshooting
Part 7providestroubleshooting information.Itcontains thefollowingchapters: Settingtraces fortheJobSchedulingConsole
Describeshowto settracesfortheJob SchedulingConsole.SeeChapter35, “SettingtracesfortheJob SchedulingConsole,”onpage271.
Troubleshooting
Describesthemostcommon problemsandhowtheyare resolved.See Chapter36,“Troubleshooting,”onpage273.
Job SchedulingConsolemessage
Describesthemessages.SeeChapter37,“JobScheduling Console messages,”onpage279.
Part 8.Appendixes
Part 8providesgeneral information.Itcontainsthefollowingappendixes: Accessibility
DescribestheaccessibilityfeaturesoftheJobScheduling Console.See AppendixA,“Accessibility,” onpage321.
Settingsecurity
DescribessettingSSLsecurityfeatures.SeeAppendixB,“SettingSecurity,” onpage323.
Status descriptionandmapping
Describesjobandjobstreamstateswithin theJob SchedulingConsoleand how tomapbetweentheconsoleandenginestates.SeeAppendixC, “Statusdescriptionandmapping,” onpage325.
Supportinformation
Describeshowto contactIBMsupport.SeeAppendixD, “Support information,” onpage329
Publications
Thissectionlists publicationsintheTivoliWorkloadSchedulerlibraryandanyother relateddocuments.Italso describeshowtoaccessTivolipublicationsonlineand how toorderTivolipublications.
Tivoli
Workload
Scheduler
library
TivoliWorkload Schedulercomprisesseveralseparateproductsavailableona varietyofplatforms,and thelibraryissimilarlydivided:
IBMTivoliWorkloadSchedulingsuitelibrary
Thislibrarycontainsallcross-platformandcross-productpublicationsfor TivoliWorkload Scheduler.
IBMTivoliWorkloadSchedulerdistributedlibrary
ThislibrarycontainsallofthepublicationsthatrefertousingTivoli WorkloadScheduleronplatforms otherthanz/OS.
IBMTivoliWorkloadSchedulerforz/OSlibrary
ThislibrarycontainsallpublicationsthatapplyonlytoIBM Tivoli WorkloadSchedulerfor z/OS.
IBMTivoliWorkloadSchedulerforApplicationslibrary
Thislibrarycontains allpublicationsthatapply onlytoIBM Tivoli WorkloadSchedulerforApplications.
IBMTivoliWorkloadSchedulerforVirtualizedData Centerslibrary Thislibrarycontains allpublicationsthatapply onlytoIBM Tivoli WorkloadSchedulerforVirtualized DataCenters.
IBM
Tivoli
Workload
Scheduling
suite
library
Thefollowingpublicationsareavailable intheIBM TivoliWorkloadScheduling suitelibrary.Thisincludespublicationswhicharecommontoallproducts, platforms,and components.
v IBMTivoliWorkloadScheduler:GeneralInformation,SC32-1256
ProvidesgeneralinformationaboutallTivoliWorkloadSchedulerproducts.It givesanoverview ofhowtheycanbeusedtogethertoprovideworkload managementsolutionsforyour wholeenterprise.
v IBMTivoliWorkloadScheduler:JobSchedulingConsoleUser’sGuide, SC32-1257 Describeshow toworkwithTivoliWorkloadScheduler,regardlessof platform, usinga commonGUIcalledthejobschedulingconsole.
v IBMTivoliWorkloadScheduler:JobSchedulingConsoleReleaseNotes,SC32-1258 Provideslate-breakinginformationaboutthejobschedulingconsole. v IBMTivoliWorkloadScheduler:WarehouseEnablementPackVersion1.1.0
ImplementationGuideforTivoliEnterprise DataWarehouse,Version1.1,
ProvidesinformationaboutenablingTivoliWorkloadSchedulerforTivoliData Warehouse.
Note: ThisguideisonlyavailableontheproductCD.Itisnotpossibletoaccess itonline, asyoucantheotherbooks(see“Accessingpublicationsonline” onpagexxii).
IBM
Tivoli
Workload
Scheduler
distributed
library
Thefollowingpublicationsareavailable intheIBM TivoliWorkloadScheduler distributed library.Thisincludespublicationswhichrefertousingtheproducton all platformsexceptz/OS.
v IBMTivoliWorkloadScheduler:ReleaseNotes,SC32-1277
Provideslate-breakinginformationaboutTivoliWorkloadScheduleron platformsotherthanz/OS.
v IBMTivoliWorkloadScheduler:Planningand InstallationGuide,SC32-1273 Describeshow toplanforand installIBMTivoli WorkloadScheduleron platformsotherthanz/OS,and howtointegrateTivoliWorkloadScheduler withNetView®,TivoliDataWarehouse,andIBM IBMTivoliBusiness Systems
Manager. v
IBMTivoliWorkloadScheduler:ReferenceGuide,SC32-1274
DescribestheTivoliWorkloadSchedulercommandlineusedonplatformsother thanz/OS,and howextendedandnetworkagentswork.
v IBMTivoliWorkloadScheduler:AdministrationandTroubleshooting,SC32-1275 ProvidesinformationabouthowtoadministerTivoliWorkloadScheduleron platformsotherthanz/OS,and whattodo ifthingsgo wrong.Itincludeshelp onmanymessages generatedbythemaincomponentsofTivoliWorkload Scheduler.
v IBMTivoliWorkloadScheduler:LimitedFault-tolerantAgentforOS/400
®,SC32-1280
Describeshow toinstall,configure,anduseTivoliWorkloadSchedulerlimited fault-tolerantagentsonAS/400®.
v IBMTivoliWorkloadScheduler:PlusModuleUser’sGuide,SC32-1276
Describeshow tosetupand usetheTivoliWorkloadSchedulerPlusmodule. See http://www.ibm.com/software/tivoli/products/scheduler/foran
introductiontotheproduct.
IBM
Tivoli
Workload
Scheduler
for
z/OS
library
The followingdocuments areavailableintheTivoliWorkloadSchedulerforz/OS library:
v IBMTivoliWorkloadSchedulerforz/OS:GettingStarted,SC32-1262
DiscusseshowtodefineyourinstallationdataforTivoliWorkloadSchedulerfor z/OSandhowto createand modifyplans.
v IBMTivoliWorkloadSchedulerforz/OS:InstallationGuide Describeshow toinstallTivoliWorkloadSchedulerfor z/OS.
v IBMTivoliWorkloadSchedulerforz/OS:Customizationand Tuning,SC32-1265 Describeshow tocustomizeTivoliWorkloadSchedulerforz/OS.
v IBMTivoliWorkloadSchedulerforz/OS:Managing theWorkload,SC32-1263 Explainshowtoplanandscheduletheworkloadand howtocontroland monitorthecurrentplan.
v IBMTivoliWorkloadSchedulerforz/OS:QuickReference,SC32-1268
Providesaquickandeasy consultationreference tooperateTivoliWorkload Schedulerforz/OS.
v IBMTivoliWorkloadSchedulerforz/OS:DiagnosisGuideandReference,SC32-1261 Providesinformationtohelpdiagnoseandcorrectpossibleproblemswhenusing TivoliWorkloadSchedulerforz/OS.
v IBMTivoliWorkloadSchedulerforz/OS:Messages andCodes, SC32-1267 Explainsmessagesandcodes inTivoliWorkloadSchedulerforz/OS. v
IBMTivoliWorkloadSchedulerforz/OS:ProgrammingInterfaces,SC32-1266 ProvidesinformationtowriteapplicationprogramsforTivoliWorkload Schedulerforz/OS.
v IBMTivoliWorkloadSchedulerforz/OS:LicensedProgramSpecifications,GI11-4208 ProvidesplanninginformationaboutTivoliWorkload Schedulerforz/OS. v IBMTivoliWorkloadSchedulerforz/OS:Memo forprogram5697-WSZ, GI11-4209
Providesasummaryofchangesfor thecurrentrelease oftheproduct.
v IBMTivoliWorkloadSchedulerforz/OS:ProgramDirectoryforprogram5697-WSZ, GI11-4203
ProvidedwiththeinstallationtapeforTivoliWorkloadSchedulerforz/OS (program5697-WSZ), describesalloftheinstallationmaterialsand gives installationinstructionsspecifictotheproductreleaselevelor featurenumber. v IBMTivoliWorkloadSchedulerforz/OS:ProgramDirectoryforprogram5698-WSZ,
GI11-4207
ProvidedwiththeinstallationtapeforTivoliWorkloadSchedulerforz/OS (program5698-WSC),describes alloftheinstallationmaterialsandgives installationinstructionsspecifictotheproductreleaselevelor featurenumber. See http://www.ibm.com/software/tivoli/products/scheduler-zos/foran
IBM
Tivoli
Workload
Scheduler
for
Applications
library
Thefollowingmanualsareavailable intheIBM TivoliWorkloadSchedulerfor Applicationslibrary:
v IBMTivoliWorkloadSchedulerforApplications:ReleaseNotes,SC32-1279 Provideslate-breakinginformationabouttheTivoliWorkloadScheduler extendedagents.
v IBMTivoliWorkloadSchedulerforApplications:User’sGuide,SC32-1278
Describeshow toinstall,use,and troubleshoottheTivoliWorkloadScheduler extendedagents.
See http://www.ibm.com/software/tivoli/products/scheduler-apps/foran introductiontotheproduct.
IBM
Tivoli
Workload
Scheduler
for
Virtualized
Data
Centers
library
Thefollowingmanualsareavailable intheIBM TivoliWorkloadSchedulerfor Virtualized DataCenterslibrary:
v IBMTivoliWorkloadSchedulerforVirtualizedDataCenters: ReleaseNotes,SC32-1453 Provideslate-breakinginformationaboutTivoliWorkloadSchedulerfor
VirtualizedDataCenters.
v IBMTivoliWorkloadSchedulerforVirtualizedDataCenters: User’sGuide,SC32-1454 Describeshow toextendtheschedulingcapabilitiesofTivoliWorkload
Schedulertoworkloadoptimizationandgridcomputingbyenablingthecontrol ofIBMLoadLeveler® andIBMGridToolboxjobs.
See http://www.ibm.com/software/info/ecatalog/en_US/
products/Y614224T20392S50.html foranintroductiontotheproduct.
Related
publications
Thefollowingpublicationsprovideadditionalinformation: v
IBMRedbooks
™:HighAvailabilityScenarioswith IBMTivoliWorkloadSchedulerand
IBMTivoliFramework
ThisIBM Redbook,showsyouhowtodesignand createhighlyavailableIBM TivoliWorkloadSchedulerandIBMTivoliManagement Framework(TMR server,Managed NodesandEndpoints) environments.ItpresentsHigh
AvailabilityClusterMultiprocessing(HACMP™)forAIXand MicrosoftWindows ClusterService(MSCS) casestudies.
ThisRedbookcanbe foundontheRedbooksWebsiteat http://www.redbooks.ibm.com/abstracts/sg246632.html
v IBMRedbooks:CustomizingIBMTivoliWorkloadSchedulerforz/OSV8.2toImprove
Performance
ThisIBM Redbookcoversthetechniques thatcanbe usedtoimprovethe performanceofTivoliWorkloadSchedulerforz/OS(includingend-to-end scheduling).
ThisRedbookcanbe foundontheRedbooksWebsiteat http://www.redbooks.ibm.com/abstracts/sg246352.html
v IBMRedbooks:End-to-EndSchedulingwithIBMTivoliWorkloadSchedulerVersion8.2 ThisIBM Redbookconsidershowbesttoprovideend-to-endschedulingusing TivoliWorkloadSchedulerVersion8.2,bothdistributed(previouslyknown as Maestro™)and mainframe(previouslyknownasOPC) components.
ThisRedbookcanbe foundontheRedbooksWebsiteat http://www.redbooks.ibm.com/abstracts/sg246624.html
The TivoliSoftwareGlossary includesdefinitionsformanyofthetechnicalterms relatedtoTivolisoftware.TheTivoliSoftwareGlossaryisavailable,inEnglishonly, at thefollowingWebsite:
http://publib.boulder.ibm.com/tividd/glossary/termsmst04.htm
Accessing
publications
online
The productCDcontainsthepublicationsthatareintheproductlibrary.The formatofthepublicationsisPDF, HTML,orboth.Toaccessthepublicationsusing a Webbrowser,opentheinfocenter.htmlfile.Thefileisintheappropriate
publicationsdirectoryontheproductCD.
IBM postspublicationsforthisand allotherTivoliproducts,astheybecome available andwhenevertheyareupdated,totheTivolisoftwareinformationcenter Website.AccesstheTivolisoftwareinformationcenter byfirst goingtotheTivoli software libraryat thefollowingWebaddress:
http://www.ibm.com/software/tivoli/library/
Scrolldownandclick theProduct manualslink.IntheTivoliTechnicalProduct DocumentsAlphabeticalListingwindow,clicktheappropriateTivoliWorkload Schedulerproductlinktoaccesstheproduct’slibrariesat theTivolisoftware informationcenter.AllpublicationsintheTivoliWorkloadSchedulersuitelibrary, distributed libraryandz/OSlibrarycanbe foundundertheentryTivoliWorkload Scheduler.
Note: IfyouprintPDFdocuments onotherthanletter-sizedpaper,settheoption intheFile→ PrintwindowthatallowsAdobeReadertoprintletter-sized pagesonyour localpaper.
Tivoli
Workload
Scheduler
online
books
All thebooksintheTivoliWorkloadSchedulerforz/OSlibrary,areavailablein displayable softcopyform onCD-ROMin theIBMOnline Library:z/OSSoftware ProductsCollectionKit,SK3T-4270.YoucanreadthesoftcopybooksonCD-ROMs usingtheseIBM licensedprograms:
v BookManager
®READ/2(programnumber5601-454)
v BookManagerREAD/DOS(programnumber5601-453) v BookManagerREAD/6000(programnumber5765-086)
All theBookManagerprogramsneedapersonalcomputerequipped witha CD-ROM diskdrive(capableofreadingdisksformattedintheISO9660standard) and amatching adapterandcable.Foradditionalhardwareandsoftware
information,refertothedocumentationforthespecific BookManagerproductyou are using.
Updatestobooksbetweenreleasesareprovidedinsoftcopyonly.
Ordering
publications
YoucanordermanyTivolipublicationsonline atthefollowingWebsite: http://www.elink.ibmlink.ibm.com/public/applications/
publications/cgibin/pbi.cgi
v InCanada:800-426-4968
Inothercountries,seethefollowingWebsitefora listof telephonenumbers: http://www.ibm.com/software/tivoli/order-lit/
Accessibility
Accessibilityfeatureshelpuserswitha physicaldisability,suchasrestricted mobilityorlimited vision,tousesoftwareproductssuccessfully.Withthis product, youcanuseassistivetechnologiestohearand navigatetheinterface.Youcanalso usethekeyboardinsteadofthemousetooperateallfeaturesofthegraphicaluser interface.
For additionalinformation,seeAppendixA, “Accessibility,”onpage321.
Tivoli
technical
training
For Tivolitechnicaltraininginformation,refertothefollowingIBMTivoli EducationWebsite:
http://www.ibm.com/software/tivoli/education
Support
information
Ifyouhaveaproblemwithyour IBMsoftware,youwanttoresolveit quickly.IBM provides thefollowingwaysforyoutoobtainthesupportyouneed:
v Searchingknowledgebases:Youcansearchacrossalargecollection ofknown problemsandworkarounds,Technotes, andotherinformation.
v Obtainingfixes:Youcanlocatethelatestfixesthatarealreadyavailableforyour product.
v
ContactingIBM SoftwareSupport:Ifyoustill cannotsolve yourproblem,and youneedtoworkwith someonefromIBM,youcanusea varietyofwaysto contactIBMSoftwareSupport.
For moreinformationaboutthesethreewaysofresolvingproblems,see AppendixD,“Support information,”onpage329.
Conventions
used
in
this
guide
Thisguideusesseveralconventionsforspecialtermsandactions, operating system-dependent commandsandpaths,comman syntax,andmargingraphics.
Typeface
conventions
Thisguideusesthefollowingtypefaceconventions: Bold
v Lowercase commandsandmixedcasecommandsthatareotherwise difficult todistinguishfromsurroundingtext
v Interfacecontrols(check boxes,pushbuttons,radiobuttons,spin buttons, fields,folders,icons,listboxes, itemsinsidelistboxes,
multicolumnlists,containers, menuchoices,menu names,tabs,property sheets), labels(suchasTip:,andOperatingsystem considerations:) v Keywords andparametersintext
Italic
v Wordsdefinedintext
v Emphasisofwords(wordsaswords)
v Newtermsintext(exceptina definitionlist) v Variablesand valuesyoumustprovide Monospace
v Examplesandcodeexamples v
Filenames,programming keywords,andotherelementsthataredifficult todistinguishfromsurroundingtext
v Messagetextandprompts addressedtotheuser v Textthattheusermust type
v Valuesforargumentsorcommandoptions
Operating
system-dependent
variables
and
paths
ThisguideusestheUNIX®conventionforspecifyingenvironment variablesand for directorynotation.
WhenusingtheWindows commandline, replace$variablewith %variable%for environment variablesand replaceeachforwardslash(/) witha backslash(\) in directory paths.Thenamesofenvironmentvariablesarenotalwaysthesamein Windows andUNIX.Forexample,%TEMP%inWindowsisequivalentto$tmpin UNIX.
Note: Ifyouare usingthebashshellonaWindows system,youcanusetheUNIX conventions.
Command
syntax
Thisguideusesthefollowingsyntaxwhereveritdescribescommands:
Table1.Commandsyntax
Syntax convention
Description
Brackets([]) Theinformationenclosedinbrackets([])isoptional.Anythingnot enclosedinbracketsmustbespecified.
Braces({}) Braces({})identifyasetofmutuallyexclusiveoptions,whenone optionisrequired.
Underscore(_) Anunderscore(_)connectsmultiplewordsinavariable.
Verticalbar(|) Mutuallyexclusiveoptionsareseparatedbyaverticalbar(|).Youcan enteroneoftheoptionsseparatedbytheverticalbar,butyoucannot entermultipleoptionsinasingleuseofthecommand.Averticalbar canbeusedtoseparateoptionalorrequiredoptions.
Bold Boldtextdesignatesliteralinformationthatmustbeenteredonthe commandlineexactlyasshown.Thisappliestocommandnamesand non-variableoptions.
Part
1.
Introduction
Chapter1.JobSchedulingConsoleoverview . . 3
TivoliWorkloadSchedulerarchitecture . . . 3
Components . . . 3
Topology . . . 4
Connection . . . 6
Chapter
1.
Job
Scheduling
Console
overview
Thejobschedulingconsoleisan interactiveinterfaceforcreating,modifying,and deleting objectsin theproductdatabaseofTivoliWorkloadScheduler.Italso allows youtomonitor andcontrolobjectsscheduledinthecurrentplan.
Thejobschedulingconsoleispart ofthedistributedarchitecture,butallowsyouto workwith TivoliWorkloadScheduleronbothz/OSanddistributed engines simultaneously.
ThischapterdescribestheoverallarchitectureofTivoliWorkloadSchedulerand where theJob SchedulingConsolefitsintothattopology.
Tivoli
Workload
Scheduler
architecture
Thissectiondescribes thecomponents,topologyand connectionofa Tivoli Workload Scheduler.
Components
ATivoliWorkloadSchedulernetworkismadeupofthefollowingtypesof workstation:
Master DomainManager(MDM)
Themasterdomainmanager isthetopmostdomainofaTivoliWorkload Schedulernetwork. Itcontainsthecentralizeddatabasefilesusedto documentschedulingobjects.ItcreatestheProductionplan, distributesit toall theagentsinthenetworkatthestartofeachday,and performsall loggingandreportingforthenetwork.
Fault-tolerant Agent(FTA)
Aworkstationcapableofresolvinglocaldependenciesandlaunchingits jobs intheabsenceofa domainmanager.
Standard Agent
Aworkstationthatlaunchesjobsonlyunderthedirectionofitsdomain manager.
Theworkstationtypescanassumethefollowingroles: ParentDomain
Thedomaindirectlyabovethecurrentdomain.All domains,exceptthemaster domain,haveaparentdomain.Allcommunicationto andfromadomainis rooted throughtheparentdomainmanager.
BackupMaster
Afault-tolerantagentcapableof assumingtheresponsibilitiesofthemaster domainmanager.
DomainManager
Themanagement hubinadomain.Allcommunicationstoandfromtheagents ina domainareroutedthrough thedomain manager.
BackupDomainManager
Afault-tolerantagentcapableof assumingtheresponsibilitiesofitsdomain manager.
Host
Theschedulingfunction requiredbyextendedagents.Itcanbe performedby anyTivoliWorkloadSchedulerworkstation,exceptanotherextendedagent. ExtendedAgent
Alogicalworkstationdefinitionthatenablesyoutolaunchand controljobson othersystemsandapplications.
NetworkAgent
Alogicalworkstationdefinitionforcreating dependenciesbetweenjobsand jobstreamsinseparate TivoliWorkloadSchedulernetworks.
Topology
YourTivoliWorkloadSchedulertopology canbecomplexorsimple accordingto your jobschedulingrequirements.
Figure2 showsasingletier hierarchy,wheretheagentsare directlyconnectedto themasterdomainmanager.
Figure3 onpage5 showsamulti–tierhierarchywheretheagentsareconnectedto a domainmanagerat thevarioustiersofthetopology.
Master
Domain
Manager
FTAs
AIX
Linux
Windows
Solaris
JSC
Figure2.Singletiertopology
Thedomain managerofdomainAacts asthemasterdomainmanager fordomain C, andthedomainmanagerofdomainB actsasthemasterdomainmanager for domains Dand E.
Normally youwouldconnecttheJobScheduling Consoletothemasterdomain manager tocontrolyour jobschedulingactivities,butthereisnoreasonwhyyou shouldnotconnecttoadomainmanager orafault-tolerantagent.
Figure4onpage6 showsanend-to-endtopologywith theJobSchedulingConsole connected tothez/OS masterdomain.
JSC
Master
Domain
Manager
Domain
Manager
Domain
Manager
Master Domain
DomainA
DomainB
DomainC
DomainD
DomainE
FTA
FTA
SA
FTA
FTA
FTA
FTA
FTA
FTA
FTA
DM
DM
DM
FTA
Backup
Master
Backup
Domain
Manager
Figure3.Multi–tiertopology
Architecture
Connection
The JobSchedulingConsoleconnectstotheenginesthroughtheJobScheduling Servicesand therelevantconnector.Theconnectorsmust beinstalledtogetherwith theJob SchedulingServicesonaTivoliManagementFrameworkserver.TheJob Scheduling Consolecommunicateswith thesystem throughtheconnector,a protocolconverterthattranslatestheinstructionsenteredthroughtheJob Scheduling Consoleintoscheduler commands.
JSC
Domain
Manager
Domain
Manager
DomainA
DomainB
SA
FTA
FTA
FTA
DomainZ
OPCMASTER
z/OS
AIX
Domain
Manager
Domain
Manager
Master
AIX
HPUX
Figure4.End-to-endtopologywithJobSchedulingConsole
Youcanmanageplananddatabase objectsnotonlyfromthemasteroragent workstations,butalso fromanysystemonwhichthejobschedulingconsoleis installedwith aTCP/IPconnectiontothemasterorthefault-tolerantagent runningtheconnector.YoucanmanageIBMTivoli WorkloadSchedulerforz/OS and distributedengine databaseandplanobjectsfromthesame JobScheduling Consoleprovidedyouinstalltherelevantconnectors.
Job Scheduling Services
Tivoli Framework
Connector
z/OS
Connector
Distributed
JSC
Figure5.JobSchedulingConsoleconnection
