Beruflich Dokumente
Kultur Dokumente
Version 5.3
Copyright
Copyright20042007byTidalSoftware ,Inc.
TidalSoftware,Inc.2100GengRoad,Ste210,PaloAlto,California94303,U.S.A.
UnpublishedrightsreservedundertheCopyrightLawsoftheUnitedStates.Printedinthe
U.S.A.
Thisdocumentmaynotbestoredinaretrievalsystem,reproduced,ortransmittedinany
formorbyanymeans,eitherinwholeorinpart,withouttheexpresspriorwritten
permissionofanofficerofTidalSoftware,Inc(Tidal).Copyingincludestranslatinginto
anotherlanguageorformat.ThisdocumentcontainsproprietaryinformationofTidal.
TidalhaspreparedthisdocumentforuseonlybyTidalsemployeesandcustomersunder
Tidalscurrentcommerciallicenseandmaintenanceagreements.Theonlyundertakingsof
Tidalrespectingtheinformationinthisdocumentareascontainedinsuchcontracts,and
nothingcontainedinthisdocumentshallbeconstruedaschangingsaidcontracts.
Informationinthisdocumentissubjecttochangewithoutnoticeanddoesnotrepresenta
commitmentonthepartofTidal.Anyuseofthisinformationexceptasdefinedbyawritten
contractwithTidal,isnotauthorizedand,withrespecttoanysuchunauthorizeduse,
neitherTidalnoranyofthecontributorstothisdocumentmakesanyrepresentationor
warranty,norshallanywarrantybeimplied,astothecompleteness,accuracy,or
usefulnessoftheinformationcontainedinthisdocumentorthatsuchuseofsuch
informationmaynotinfringeprivatelyownedrights,nordotheyassumeany
responsibilityforliabilityordamageofanykindwhichmayresultfromsuchuseofsuch
information.
TidalEnterpriseSchedulerandTidalSoftwarelogoaretrademarksofTidalSoftware,
Inc.
MicrosoftWindows,NTandallvariationsoftheWindowsproductfamilyare
trademarksorregisteredtrademarksofMicrosoftCorporationintheUnitedStatesof
Americaandinseveralothercountries.
Allothertrademarksarepropertyoftheirrespectiveownersandareusedpurelyfor
informationalpurposes.
February 2007
CONTENTS
Preface
AboutthisGuide.......................................................8
Conventions....................................................8
AlertStatements................................................8
TidalProductDocumentation............................................9
DocumentationFormats .........................................9
GuidesandReleaseNotes ........................................9
OnlineHelp ....................................................9
TechnicalSupport .....................................................10
1
Scheduler Concepts
Overview .............................................................12
SystemConfigurations .................................................13
Masters .......................................................13
Clients........................................................14
Agents .......................................................14
JobDefinition.........................................................15
JobHierarchy.........................................................16
Dependencies .................................................16
Calendars .....................................................18
JobInstances ..................................................18
ProductionSchedule ...........................................18
Dashboard....................................................19
MasterStatusDisplay ..........................................19
1
EventsandActions.............................................19
Queues.......................................................21
QueueFilters...........................................22
AgentLists....................................................22
SecurityPolicies ...............................................22
LogsandReports ..............................................23
2
Contents
ViewingJobOutput ............................................51
4
SchedulingtheJobGroup...............................................94
SchedulingaJobthatDependsonaGroup ................................95
AddingaJobGroupDependency ........................................97
ReleasingaJobGroup ..................................................99
7
Contents
10
11
12
Setting Up Queues
Overview ............................................................172
SettingUptheInventoryWeeklyJobGroup..............................174
CreatingJobsfortheInventoryWeeklyJobGroup ................175
DuplicatingaJobDefinition ....................................177
SettingUpaQueue...................................................178
AddingtheInventoryWeeklyJobGrouptoProduction ............182
MonitoringtheJobGroupinProduction.........................182
ChangingtheQueueLimit.....................................184
ResubmittingtheInventoryWeeklyJobGroup ...................185
13
14
PREFACE
TOPICS
Boldsansseriftextisusedtodesignatefileandfoldernames,dialog
titles,namesofbuttons,icons,andmenus,andtermsthatareobjectsof
auserselection.
Italictextisusedtoindicatedefinedterms,userspecifiedtext,
documenttitles,andwordemphasis.
Monospacetext(Courier)isusedtoshowliteraltextasyouwould
enterit,orasitwouldappearonscreen.
Alert Statements
ThealertstatementsNote,Caution,andWarningareformattedinthe
followingstyles:
Note
Caution
Advises of machine or data error that could occur should the user
fail to take or avoid a specified action.
Warning
Preface
Tidal Product Documentation
AdobeAcrobatPDFfiles
Onlinehelp
YoumusthaveAdobeReaderinstalledtoreadthePDFfiles.Adobe
Readerinstallationprogramsforcommonoperatingsystemsareavailable
forfreedownloadfromtheAdobeWebsiteatwww.adobe.com.
Online Help
YoucanaccessonlinehelpbyclickingtheHelpbuttonfromwithinthe
application,orclickingStart>Programs>Tidal
Software>Scheduler>Client>Client Help.
Technical Support
Tidaliscommittedtoprovidingsuperiorserviceandsupporttoour
customers.Wetakepersonalprideinlivinguptothiscommitmentandto
developinghighquality,highvalueproductsthatimprovedatacenter
operations.
Telephoneassistanceisavailabletocustomerswithcurrentmaintenance
contractsduringstandardofficehoursof7:00a.m.to7:00p.m.CST,
MondayFriday.
FormoreinformationoncontactingTidalSoftware,refertotheinformation
belowortotheTidalSoftwarewebsite:www.tidalsoftware.com
10
Department
Contact Info
Support
6504754600
support@tidalsoftware.com
tidaltraining@tidalsoftware.com
ProfessionalServices
6504754600
consulting@tidalsoftware.com
Sales
87755TIDAL(8775584325)
sales@tidalsoftware.com
Headquarters
TidalSoftware,Inc.
2100GengRoad,Suite210
PaloAlto,CA94303
Main:6504754600
Fax:6504754700
1
SCHEDULER CONCEPTS
TOPICS
11
Overview
WelcometoScheduler!Thistutorialwillintroduceandguideyouthrough
thefeaturesandfunctionsoftheworldspremiernetworkscheduling
solution,Scheduler.
Eachchapterinthisguidebuildsuponthefoundationofpreviouslessons.If
thisisyourfirsttimeworkingwithproductionschedulingsoftware,oryour
firsttimeusingScheduler,youshouldworkthrougheachchapter
consecutively.Moreexperiencedusersmightwanttomovedirectlytothe
lessoninwhichtheyareinterested;however,manyexercisesutilizethe
resultsofpreviousexercises.
Asyouprogressthroughthetutorial,moreadvancedanddetailedtopics
arecovered.Bytheendofthismanual,youwillbefamiliarwithmostofthe
majorfeaturesofScheduler,andyouwillhavetheknowledgetocreateand
maintainyourownproductionschedules.
12
System Configurations
Schedulerusesaclientservermodeltoscheduleandmanagejobson
severaldifferentsystemsevendifferentoperatingsystemsthrougha
singleoperatorstation.Thissinglepointofcontrolmeansthatyouhave
onlyoneclientinterfacerunningonyourPCtomanagejobsacrossmultiple
systems.Mastersarethecentralpointforschedulingjobsonassociated
agents.Schedulerjobscanonlyrunonlicensedagents.
Figure 1
Masters
ThemasteristheWindowsorUNIXsystemonwhichyouinstallthe
brainsofyourSchedulernetwork.Youinteractwiththemasterusingthe
Schedulerclient,whichpassesrequeststothemaster.Themasterperforms
therequestedserviceonalocalorremoteagent,andthenreturnsupdated
informationtotheclientthatdisplaystheresults.
13
Themasterlaunchesjobsonmachineslicensedasagents.Anagentis
softwareonanothermachineinthesamenetworkasthemaster,andruns
jobsonbehalfofthemaster.Theclientdoesnotconnectdirectlytothe
agent,butschedulesandmanagesitsjobsthroughthemaster.
Clients
Theclientsoftwareusesagraphicaluserinterface(GUI)toperformthe
schedulingfromyourlocalPCrunningWindowsNTorWindows2000.You
caneasilymonitorandcontrolschedulesacrossyournetworkwithout
leavingtheclientinterface.Clientsaccessonlymasters.Multipleclientscan
communicatewiththesamemaster.
Forexample,individualsindifferentdepartmentscanscheduleand
managetheirownjobs,independentofeachanother,whiletheoperator
monitorsalljobactivitiesandonlyintervenesifresourceconflictsarise.
Agents
TheagentisanymachinethatrunsjobsonbehalfofaSchedulermaster.The
masterandtheagentcommunicatewitheachothertoexecutejobsremotely.
MultipleScheduleragentsprovidegreaterproductionreliabilityshouldthe
masterbecomeunavailableforsomereason.
Jobcommandsthatrunontheagentshouldbeaccessibletotheagent
machineonyournetwork.Theyarescheduledonthemaster,andinitiated
ontheagentbythemasterwhenscheduledependenciesaresatisfied.
Agentsoperateindependentlyfromthemaster.Thisallowscontinued
processingofanyworkthatisalreadysentbythemasterifeitherthemaster
scheduleorthecommonsharednetworkbecomesunavailable.Theagent
relaystheresultsofthejobitcontinuedprocessingwheneitherthenetwork
connectionorthemasterisavailableagain.
14
Job Definition
Thejobdefinitioniscentraltojobscheduling.Itisasetofjobrulesthat
defines:
Whichcommandtorun
Wherethecommandruns
Whentorunthejob
Howtohandledependencies
Whethertoissueactionsbasedonpredefinedjob events
Thejobpriorityrelativetootherjobs
Whenyouwanttoscheduleacommandtobeexecuted,youuseajob.Once
ajobisdefined,youcankeepthedefinitionandrunthejobrepetitively
accordingtoitsspecifiedcalendar,orasneeded.
Eachjobisassignedtoonlyonecommand.Thecommandcanbean
executable,abatchfile(Windowsonly),ashellscript,acommandfileor
anyotherexecutableprocess.Youcanspecifyparameterstobepassedtothe
command.Thisenablesyoutouseonecommandindifferentways,based
upontheparametersthatyoupasstoit.
Forexample,ajobcanbackupfilestotape,runaprogramtopost
transactionstoadatabaseorrunasetofreports.InScheduler,yougiveeach
jobaname,and,ifthejobisrepetitive,acalendarbywhichitruns.Youcan
alsodefinedependenciesthatmustbemetbeforethecommandisexecuted.
Usingthecalendar,Schedulerautomaticallylaunchesjobseachtimethey
arescheduledtorun,butonlyafteralloftheirdependencieshavebeenmet.
15
Job Hierarchy
Jobsarebuiltonahierarchyofjobandjobgroupownership.Ajob groupis
acontainerforasetofjobs,usuallypartofacommonapplicationor
department.Thejobgrouphasitsownnameandsetofruntime
instructions.
Youcanusejobgroupstosubmitjobsthateitherdependoneachother,or
shouldruntogether.Forexample,allthejobsinpayrollcanbelongtoa
groupcalledPayroll.Thejobgroupcanprovidedefaultsettingstoallthe
childjobsthatbelongtoit.JobsandjobgroupsaredisplayedintheJobs
pane.Jobgroupscansaveyouthetimeittakestosetupjobdefinitions
becauseeachjobinthejobgroupcaninheritthecharacteristicsofthatjob
group.Whenyouwanttocreateseveraljobswithsimilarscheduling
characteristics,youcandefinethosejobswithinajobgroupandsetthe
schedulingcharacteristicsinthejobgroupdefinition.Itisalsopossibleto
changeschedulingcharacteristicsatthejobleveleventhoughthejob
belongstoagroup.
Forexample,ifajobgroupisdefinedtoruneveryFriday,theneveryjobin
thatjobgroupisautomaticallydefinedtorunonFriday.Ifonejobinthejob
groupmustrunonSaturday,thenthatonejobcanbechangedtotheproper
rundaywithoutaffectingtheotherjobsaslongasyoudisinheritthejob
groupcalendarandchangethecalendarfromwithinthatjob.
Theultimateownershipofajoborjobgroupbelongstoeithertheuserora
workgroup.Aworkgroupisacollectionofuserswhocanshareaccessto
thesamejobs.WorkgroupsaredisplayedintheWorkgroupspane.
Dependencies
Dependenciesareprerequisiteconditionsthatmustbemetbeforeajobcan
run.
Date and Time Dependencies
ThemostcommondependencyisthedateandtimewhenScheduler
executesajob.
Forexample,youcanscheduleajobtoruneveryTuesdayafter6:00pm,
exceptonholidayswhenitisnottorun.Datedependenciesarebuiltusing
calendars.Timedependenciesarespecifiedwithinajobsdefinition.
16
Job Dependencies
Jobscanalsodependonotherjobsreachingaparticularstatus.
Forexample,youcanrunJob51afterJob101andJob207havereachedthe
statusofCompleted Normally.Duringthejobslifecycle,Scheduler
recognizesthecurrentstatusofajob,suchas:
Table 1
Job Status
Status
Description
dependencies.
Waiting on Resources
Thejobiswaitingforanexecutionslot.All
Dependencieshavebeenmet.
Waiting on Operator
Allthejobsdependenciesaremetandthejobis
waitingfortheoperatortoreleaseit.
Active
ThejobisactivelyrunningintheProduction
Schedule.
Completed Normally
Thejobcompletednormally.
Completed Abnormally
Thejobcompletedabnormally.
Error Occurred
Aninternalerroroccurredwhichpreventedthe
jobfromrunning.
File Dependencies
Ajobcanalsodependonthestatusofafile.Thestate,size,creationor
modificationdateofthefilecanallbetakenintoconsideration.
Forexample,youcanrunJob101iftheWindowsfile
C:\payroll\data\trandata:
Hasbeenmodifiedinthelasttwelvehours
Hasafilesizegreaterthan1024KB
Variable Dependencies
Ajobcanalsodependonthevalueofauserdefinedvariable.Schedulerhas
arepositoryofuserdefinedvariablesthatcanbeupdatedorincremented
eithermanuallyorthroughanactionassociatedwithajobeventorsystem
event.
17
Forexample,youcansetajobtorunwhen:
Calendars
Calendarsareusedtodeterminewhentorunthejobs.Calendarsletyou
schedulejobstorunonaperiodicyetintelligentbasis.
Forexample,LaborDayintheUnitedStatesiscelebratedonthefirst
MondayinSeptemberwhichfallsonadifferentdateeachyear.Bydefining
LaborDayasthefirstMondayinSeptember,youavoidtheneedto
manuallyredefineiteveryyear.
Youcanalsodefinecalendargroupsthatcombineindividualcalendars.
Forexample,the1st Half HolidayscalendargroupcanincludetheNew
Years Day,Presidents Day,andMemorial Daycalendars.
Job Instances
Ajobinstanceisaspecific,scheduledrunofajobdefinition(job)by
Scheduler.Onejobcancreatemanyinstances.
Forexample,ifajobisdefinedtoruneveryMonday,Wednesdayand
Friday,thenSchedulercreatesoneinstanceforMonday,oneforWednesday,
oneforFriday,oneforthenextinstanceofMondayandsoon.
Jobscanentertheproductionscheduleonascheduledorunscheduled
basis.Forexample,youmayhavesomejobsyouexpecttorunattheendof
eachmonth,andotherjobsthatyourunonlyondemand.
Production Schedule
Theproduction scheduleisthetimelineSchedulerusestomanage
instances.Youcontrolthespanoftimecoveredbytheproductionschedule,
typicallybetweenafewdaysandseveralweeks.Jobinstancesaredisplayed
intheJob Activitypane.
18
Pastjobinstancesremainavailableforauserdefinedperiodoftime.
Presentjobinstancesandtheirstatuses(i.e.Waiting,Active,
Completed Normally,etc.)aredisplayedintheJob Activitypane
defaultview.
Futurejobinstancesdefinedintheproductionspanappearonthe
futuredatesintheJob Activitypane.
Astimeprogresses,theproductionscheduleisrecorded,andautomatically
updatesjobinstancesforthedefinednumberofdaysforthepast,current
andfutureruns.Theconceptsoftimeoffsetsandbasingtheproduction
scheduletimesonagenttimezonesareexploredinChapter2:Understanding
OffsetConceptsinProductionScheduling.
Dashboard
Thedashboardisacustomizablegraphicalrepresentationofthe
productionschedule.Fromthedashboard,youcaninstantlyseejobsand
theirstatusesrepresentedbyapiechart.Youcanalsoseejobprogress,
systemutilizationandalertstatususingvariousmeters,linecharts,bar
graphsandtables.
Thedashboardisidealformanagerstogetaquickviewoftheoverall
productionschedule.Itisalsousefultomonitorsystemresourceutilization,
suchasdeterminingwhetheraparticularmachineorsetofmachinesis
overorunderutilizedforschedulingpurposes.
Systemconditionsthatwilltriggertheevent
19
Oneormoreactionstotakeinresponse
Jobstowhichtheeventapplies(forjobevents)
Ascheduleoftimeintervalswhentheeventisactive(file,emailand
variableevents)
Eventscanbeinternallygeneratedbyconditionswithinthesystem(joband
systemevents)ortheycanbegeneratedbyconditionsthatareoutsidethe
system(file,emailandvariableevents).Todetectexternalconditions,you
mustcreateaneventmonitortowatchforthosedefinedconditions.
Job eventscombineeventtriggerswithactionssuchasstoppingor
restartingajobwhileinproduction.
Commonevent triggersincludeabnormaltermination,excessiveruntime
andfailuretocompletebyaspecifictime.Youcantakethefollowingtypes
ofactions:
Sendemailmessages
ControlajobinstanceintheJobActivityConsole
Alertanoperatortoajobcondition
SendSNMPmessages
Launchanunscheduledjob(newjobaction)
Issuealogmessage
Updateauserdefinedvariable
Forexample,youcandefineajobeventthatistriggeredeverytimeajobis
cancelledbyanoperator.Whenajobcancellationoccurs,youcanhavean
emailsenttoyouandamessagesenttoyourSNMPmanagementsoftware
notingthisevent.
Asystem eventoperatesidenticallytoajob event,exceptthatthemaster
originatestheeventratherthanajob.Systemeventsdefineglobal
conditionsversusajobeventdefiningconditionsthataffectjobs.For
example,ifanagentshutsdown,asystem eventcanbetriggeredtonotify
usersoftheproblem.
Anemail eventisthedetectionofaspecifiedtextstringinanemailthat
arrivesatadesignatedemailaccountonandesignatedExchangeserver.An
emailmonitoriscreatedtowatchforthespecifiedemail.
Afile eventisthedetectionofafileonanagentreachingaspecifiedstate.
Afilemonitoriscreatedtowatchforafilethematchesthespecified
conditions.
20
Avariable eventisthedetectionofavariablereachingaspecifiedvalue,
whetherthevariableisonalocalorremotemaster.Avariablemonitoris
createdtowatchforthevariabletoreachthedesiredvalue.
Queues
Queuesletyouoptimizethroughputandallocatesystemresourcesfor
scheduledandunscheduledjobs.TheSchedulerqueuemanagerassigns
jobstoqueueswhenalltheirdependencieshavebeenmet,anddecides
whentolaunchjobsbasedupontheavailablesystemresourceslots.The
maximumnumberofslotsavailableisdeterminedeitherbythelimitthat
yousetinthesystemqueue,thesumofeachqueueslimitorthesumof
eachlicensedagentsjoblimit.
Queuescanlimitthenumberofjobsrunningonacomputeroranetworkof
computersatagiventime.
Ifthesystemisnotrunningatitscapacity,ajobcanrunimmediately
providedthatallofitsdependenciesaremet.
Ifthesystemisrunningatitscapacity,theSchedulerQueueManager
decideswhichjobslaunchbasedonaprioritystructurethatincludes
thefollowinginorderofimportance:
Table 2
Queue Priorities
Status
Description
Queueprioritylevels
Jobsinactiveandopenqueuesathigherpriority
levelsrunfirst.
Queuelimits
Onlyjobsinqueuesnotrunningattheirallowable
limitcanbelaunched.
Agentjoblimits
Onlyjobsassignedtoagentsnotrunningattheir
allowablelimitcanbelaunched.
Jobprioritylevels
Jobswiththehighestpriority(assignedinthejob
definition)inthequeuearerunfirst.
Queuesaredisplayedinahierarchy.Eachiteminthehierarchyisa
queueandcancontainjobs.Youdefinethequeuelimittosetthe
numberofjobsthatcanlaunchfromanyindividualqueue.Youalso
defineapriorityforeachqueue.
21
Queue Filters
Jobsaredirectedtoaqueuebasedonthequeuefiltersthatyoudefine.These
filtersdescribethejobpropertiesthatmustexistforthequeuemanagerto
assignajobtoaparticularqueue.Someexamplesofthequeuefiltersthat
directjobstoqueuesare:
Jobclass
Jobname
Jobowner
Jobestimatedruntime
Agent Lists
Schedulerextendsitscapabilityforautomaticjobmanagementthrough
agent lists.Anagentlistdescribesasetofnodesonyournetworkavailable
torunjobs.Agentlistsdesignatenodesasprimaryoralternatenodesforjob
submission,andallowjobstobebroadcastacrossallavailablenodes.
Workloadbalancingalgorithmscandistributejobsevenlyamongall
availablenodes.
Security Policies
SecuritypoliciesrestrictaccesstocertainSchedulerfunctions.Thedefined
accessrightscanbesavedasasecuritypolicy,andthenassignedtooneuser
ormultipleusers.
Forexample,theremightbedifferentsetsofuserswho:
AdministerScheduler
Createandschedulejobsforthemselvesandothers
Operatethejobschedule
Usingsecuritypolicies,theusersthatcreateandschedulejobscanbe
restrictedfrommodifyingtheschedules.Likewise,theoperatorscanbe
restrictedfromcreatingjobs.
Schedulerincludesdefaultsecuritypolicytemplatesthatcanbemodifiedto
createyourownsecuritypolicies.Eachuserwithinthesuppliedworking
modelhasadefinedsetofSchedulerfunctions.Whenallthedefault
securitypoliciesareinuse,allaspectsofschedulingarecoveredand
available.
22
Thefollowingtableliststhesystemfeaturesavailableforeachofthedefault
securitytemplate:
Table 3
Scheduler_Admin
Thedefaultfornewinstallations.Thisincludesall
availablefunctions.
Administrator
Configuresusers.
User
Creates,edits,andsubmitsjobs.Createsworkgroups
anduserdefinedvariables.
Scheduler
Editsandtestsjobschedules.
Operator
Runsandcontrolsjobs.Respondstoalertsthatjobs
mayissue.
Inquiry
Viewsjobsandresources.Cannotperform
modification.
Datadisplayedineverywindow
Operatoralertsandresponses
Jobstatuses
Eventhistory
Dependencycrossreferences
Productionschedulesummary
23
24
2
OFFSET CONCEPTS IN
PRODUCTION SCHEDULING
TOPICS
25
Overview
Schedulerv.5.3followscertainconceptswhenitcompilesaproduction
schedule.Theconceptsarebasicbutcanresultincomplicatedtiming
scenarioswithdateshiftsthatcauseconfusionamonguserswhenputinto
practice.Themostcomplextimingissuesarisefromtheshiftingofthestart
oftheproductiondaythroughaseriesoftimeoffsetsasscheduledjobsrun.
Schedulercompilesaproductionschedulefromyourjobrulesforeachmaster.
Thisproductionschedulecoversatleastthecurrentdaybutmayextendto
multipledays.Youdeterminethedurationofeachschedulebyspecifying
thenumberofdaystoinclude.Eachmasterinyournetworkhasitsown
productionschedule,soscheduledurationscanvary.Theactiveproduction
scheduleforamasterincludeshistorydata(fordatespast),thecurrentdate
andanyremainingdaysintheschedule(future).
Total Production Schedule
Mon
May 22
Tue
May 23
History
Figure 2
Wed
May 24
Fri
May 26
Thu
May 25
Current
date
Future
dates
Theproductiondaycontainsallofthejobrulesthatarescheduledtorun
duringtheproductionday.Aproductiondayalwayscontains24hoursand
bydefaultstartsatmidnightandendsat23:59:59PM.(Forsimplicityssake,
wewillusethe24hourtimeformatinthisdiscussionso11:59PMis2359.)
Toaccommodatealloftheprocessingneedsofabusiness,aproductionday
oftendiffersfromthecalendarday.Youcandesignatethattheproduction
daystartatanytime.Forinstance,youmightspecifythattheproduction
daystartsat0500insteadofstartingatmidnighttoallowforthecompletion
ofthepreviousdaysjobs.Thisiscalledaproductiondayoffset.
Iftheoffsetispositive,thefiscaldaybeginsatsometimeaftermidnightand
continuesintothenextcalendarday.Iftheoffsetisnegative,thefiscalday
beginsatsometimebeforemidnight.Themaximumoffsetthatyoucan
defineis23hoursand55minutes.Schedulerusesthedesignatedstartofthe
26
productiondaytodeterminewhentheproductiondaystarts,andtoselect
andlaunchjobsaccordingly.
Figure 3
27
Figure 4
28
Figure 5
Hereisanotherexampleofthemasterandagentindifferenttimezones
withoutaproductionoffset.Thisexampleshowsamasterthatisseven
hoursbehindtheagent.Ajobdefinedtorunat0500ontheproductionday
29
ofAugust11thisactuallylaunchedbythemasterat2200ontheproduction
dayofAugust10thtoaccountforthedifferenceintimezones.
Figure 6
30
Figure 7
Thisexampleshowsanagentthatisfivehoursaheadofthemaster.A
productiondayoffsetofpositivethree(+3)shiftsthestartoftheproduction
day(0000)threehoursaheadincalendartimeforbothmasterandagent.A
jobdefinedtorunat0500ontheproductiondayofAugust11thlaunchesat
0000onAugust10thonthemastersproductionday.
31
Figure 8
32
Figure 9
33
Figure 10
Thisconfigurationhasanagentthatisrunningfivehoursbehindthe
master.Ajobdefinedtorunat2300ontheproductiondayofAugust10this
launchedbythemasterat0300onAugust11th.
34
35
36
3
CREATING YOUR FIRST JOB
TOPICS
37
Overview
ThischapterdescribeshowtousetheSchedulerclientgraphicalinterfaceto
create,runandviewtheresultsofajob.
Caution
Beforeyoubeginthetutorial,youmustinstallatleasttwoagentinstances
anddefineconnectionstothem.Refertothechaptersoninstallingagentsin
theInstallationandConfigurationGuideformoreinformation.Thesetwo
agentsmustbeinstalledandrunningtoperformtheexercisesinthis
tutorial.
For each section of this tutorial, the very first step is to start the client.
The instructions continue from that point.
38
Ifusingademolicense,clicktheDemo Licensebutton,enterthe
democodeandclickOK.
Ifusingaproductionlicense,clicktheLoad Licensebuttonand
browsetothelocationofthelicensefileyoureceived.
Ifyoudonothavealicense,callSupport.Youcannotcontinue
withthistutorialwithoutalicenseofsometype.
TheSchedulerclientinterface displays.
Figure 11
Note
If this is the first time you run the client, and the database is not
online, it may take 20-40 seconds for the client database engine to
connect to the master database. Also, the Master status light at the
bottom of the console must be green and Agents status light must be
yellow or green indicating that network connections are functioning. If
the Agents light is yellow, it indicates that at least one of the defined
agents is not available. As long as you use an agent with a valid
connection, you can successfully complete the tutorial exercises.
Iftheconsolewindowisnotopen,selectNew ConsolefromtheFile
menu.
39
ClicktheDefaultstab.
Figure 12
Tochangethedefaultagent,selectavalidagentfromtheAgent Name
list.
3
40
ClickOK.
StarttheSchedulerclient.
Ifaconsolewindowisnotopen,selectNew ConsolefromtheFile
menu.
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane(Figure 11).
Unlessotherusershavealreadycreatedjobdefinitions,thedisplay
doesnotshowanydataatthistime.
onthetoolbar.
Figure 13
IntheJob Namefield,enterReportasthenameofyournewjob.
IntheCommandfield,clicktheellipsis
Program dialog.
todisplaytheSelect
41
8
Note
ClickOK.
Report.bat is a batch file which executes the sleep.exe program for
30 seconds.
Aconfirmationdialogdisplays.
Figure 14
Confirmation Dialog
Thisconfirmationdialogremindsyouthatsinceacalendarisnot
associatedwiththejob,itwillnotbescheduledtorunautomatically.
Wedidnotselectacalendarbecausewearegoingtosubmitthejob
manually.
9
ClickYes.
TheReport jobdisplaysintheJobspanewithyourusernameasthe
owner.
42
Figure 15
43
Figure 16
44
ClickOK.
seewhenjobsareaddedorscheduled
removejobs(ifyouhavesufficientsecurityprivileges)
monitortheprogressofajobfromascheduledstatethroughexecution
ofthejob
controljobexecution
SomeofthejobstatisticsavailablefromtheJob Activitypaneare:
thejobowner
theScheduleragentassignedtorunthejob
estimateddurationofthejob
theexitcodeofthecompletedjob
theactualcommandthatthejobrepresents
thenextdateonwhichthejobwillrun
thecalendarassociatedwiththejob(ifany)
thequeueassociatedwiththejob(ifany)
thejobsprioritylevel
thejobgroupassociatedwiththejob(ifany)
Whenjobsarescheduled,theJobspaneinthecenteroftheconsoleshows
onejobperline,plusthejobnumber,jobname,jobstatus,etc.Therightside
ofthedisplay,theBar Chart pane,showsthesamejobsinabarchart
format.Individualjobsdisplayascoloredbarsindicatingtheirstatus.The
lengthofthebaracrossthehorizontaltimelineindicatesthejobsestimated
elapsetime(beforethejobcompletes)oractualelapsedtime(afterthejob
completes).Ifthebarchartisnotvisible,adjustthebottomscrollbarand/or
therightsashlinetoincreasethesizeoftheBar Chartpane.
45
Figure 17
Movethecursoratoponeofthesashlinesdividingthewindowinto
threepanes.
Thecursorchangestoadoublearrow
46
Presstheleftmousebuttonwhiledraggingthesashlinetoanew
position.
Tosavethenewsettings,gototheViewmenuandselectSave
Desktop.
Toreverttotheoriginalsettings,gototheViewmenuandselect
Restore Desktop.
FromtheViewmainmenu,selectPreferences or rightclickJob
ActivityintheNavigatorpaneandselectPreferencesfromthemain
menu.
Figure 18
2
ClicktheColumnstab.TheColumnstaballowsyoutoselectand
arrangethosecolumnsyouwantdisplayedintheJob Activitypane.
Acheckmarkinthecheckboxofacolumntitledisplaysthecolumn.
Deselectingthecheckboxnexttothecolumntitleomitsitfromthe
display.
Draganddropthecolumnsintotheorderyouprefer.
ClicktheStatus Colorstab.
FromtheStatus Colorstabyoucansetthecolorsthatrepresenteach
availablestatus.ThesesettingsalsoaffecttheBar Chartdisplay.
TheBar Chartsettingsareexplainedinthenextsectionofthischaper.
ClicktheOthertab.
Hereyoucanselectwhetheryourdefaultjobgroupdisplaysettingwill
becollapsedorexpandedtodisplaythejobscontainedwithinthe
group.
ClickOK.
TheJob Activitypanewillreflectthechangesyoumade.
47
Status
Description
WaitStatus
Whenajoboccurrenceiswaitingintheproduction
schedule,itsbarintheJob Activitypaneshowsthe
estimatedstart,durationandfinishtimesinthecolor
selectedforthestatus.
LaunchorActiveStatus
Whenajobisactive,itsbarshowsitsactualstarttime,
andtheestimateddurationandfinishtimesinthecolor
selectedforthestatus.
CompletedStatus
Whenajobhascompleted,itsbarshowsitsactualstart,
durationandfinishtimesinthecolorselectedforthe
completionstatus.
Asajobruns,itscolorchangestocorrespondtoitscurrentstatus.Status
colorsaresetontheStatus ColorstaboftheJob Activity Preferences
dialog.ThecoloroftextintheJob ActivitypaneandofthebarsintheBar
Chart panesignifiestherepresentedjobscurrentstatus.
Table 5
48
Status
Description
Red
Aborted,AgentInactive,AgentUnavailable,Cancelled,Completed
Abnormally,ErrorOccurred,ExternallyDefined,Orphaned,
Skipped,TimedOut
Green
Active,Launched
Blue
CompletedNormally
Gray
Deferred,TimedOutForDay,WaitingOnGroup
Status
Description
Purple
Held,Stopped,WaitingOnOperator
Black
Scheduled,WaitingOnDependencies
FromtheViewmainmenu,selectPreferences.
Figure 19
FromtheViewmainmenu,selectPreferences.
49
Figure 20
FromtheViewmainmenu,selectPreferences.
Figure 21
3
50
FromtheDisplay Unitlist,selectthetimeunitofyourchoice.
SchedulersdefaultisQuarter Hour.
DiscardDiscardsalljoboutputs.Therewillbenooutputlog
availableforreview.
AppendSavesjoboutputsbyappendingthecurrentoutputtoa
singlelog.
ReplaceCreatesanewoutputfileeachtimethejobruns,replacing
thepreviouslog.
Note
ClicktheDefaultstab.
ClickOK
Note
GototheJob Activitypane.
TodisplaytheJob Detaildialog,eitherdoubleclicktheReportjobor
rightclicktheReportjobandselectDetailsfromthecontextmenu.
51
Figure 22
4
52
ClickOK.
4
USING SCHEDULER
CALENDARS
TOPICS
53
Overview
Inthepreviousexercise,youcreatedanunscheduledjob.Inthischapter
youwillcreateascheduledjobbycreatingacalendar,andaddingittothe
job.Scheduledjobsrunonaregularbasisaccordingtothedatesintheir
calendar.Someschedulesaresimplewithjobsrunningeverydayfrom
MondaythroughFriday,oronthefirstdayofeverymonth.Othersaremore
involved,withjobsrunningonirregularaccountingperiods,holidaysor
fiscalperiodoffsets.
Schedulerusescalendarstodefinethesetofdatesonwhichjobsrun.
Schedulercontainsfivedifferentmethodsforcreatingcalendars,depending
ontheperiodinwhichyouneedyourjobtorepeat.Forexample,youmay
needyourjobtorunasneededona,daily,weeklyormonthlybasis.Each
methodaddressesaparticularperiod.
Thischapterdescribeshowtobuildfourcalendars:
first wkdyAlistcalendar(asneeded)representingthefirstworkday
ofeachweek.
work dayAdailycalendarrepresentingMondaythroughFriday.
Thursday.
dayofaquarter
Youwillthenscheduleajobusingthework day calendar,andconfirmthat
itisscheduledproperly.
Caution
54
FromtheNavigatorpane,selectDefinitions>Calendarstodisplaythe
Calendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Calendar>Listfromthecontextmenuto
displaytheList Calendar Definitiondialog.
Figure 23
Inthecalendarview,doubleclickthedatesthatrepresentMondayof
eachweekforthecurrentmonth,orrightclickfromwithinthe
Calendarsviewtodisplaythelist,andselectSelect Day of
Week>Monday.
55
Figure 24
To add scheduling dates to other months, use the inner right arrow
buttons. To add scheduling dates to other years, use the outer right
arrow buttons.
ClickOKafteryouhavecompletedyourselections.
TheCalendarswindowshouldlooksimilartoFigure 25below
displayingthenewlycreatedcalendarfirst wkdy.
56
Figure 25
Congratulations,youjustcreatedyourfirstlistcalendar!
Youcancreateacalendarforanydatesyouspecify.Thiscalendarcan
beassociatedwithajobfromwithintheJob Definitiondialog,butwill
notbeusedinanyfuturetutorialexercises.
57
FromtheNavigatorpane,selectDefinitions>Calendarstodisplaythe
Calendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Calendar>Daily fromthecontextmenuto
displaytheList Calendar Definitiondialog.
Figure 26
3
58
ClicktheForecasttabtogeneratethecalendar.
Figure 27
ThistabdisplaysallthedatescalculatedfromtheDetailstab.The
ForecasttabisviewedthesamewayasintheList Calendardialog,
whenthecalendarfirst wkdaywasentered.Youcanaddindividual
datesfromthistabbydoubleclickinginthecalendarviewonthedates
youwanttochange.Youcandeletedatesbyselectingthedatein
Selected DatesandeitherrightclickingthedatetoselectDeleteor
clickingtheDeletebutton.Theforecastdisplaysafouryeartime
window,butthecalendarextendsindefinitely.
Note
This step can take from a few seconds to a minute, depending on your
systems configuration.
ClickOK.
TheCalendarsviewdisplaysthetwocalendarsyoucreated.Bydefault,the
rowsofthedisplayaresortedalphabeticallyaccordingtocalendarname
(theNamecolumn).Youcanalsosortbyothercolumnsbyclickingthe
columnname.Forexample,ifyouclicktheOwnernameatthetopofthe
Ownercolumn,calendarsaregroupedbytheircreator.Ifyouclickthe
ModifiedlabelatthetopoftheModifiedcolumn,yournewestcalendarsare
groupedtogether
59
Figure 28
60
IntheWeek Beginslist,selectFriday.Thissetsyourfiscalweekto
startonFridayandendonThursday.
ClickOK.
ClickOKwhentheWarningdialogdisplays.Thiswarningdisplays
wheneveryouchangethecalendarweekstartingday.
Figure 29
Note
Warning Dialog
FromtheNavigatorpane,selectDefinitions>Calendarstodisplaythe
Calendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Calendar>Subset fromthecontextmenuto
displaytheCalendar Subset Definitiondialog.
Figure 30
IntheOccurrencelist,selectEvery.
IntheCalendarlist,selectFriday.
61
definedforScheduler.Youcanchoosetobaseacalendardefinitionon
afiscalyear,ratherthanastandardJanuarythroughDecember
calendaryear.
Makingnoselectioninthe Based on Fiscal listresultsintheuseofa
standardcalendar.Forthisexercise,leavethefieldempty.
12 Now,weneedtosetaconditiontoletSchedulerknowwhattodoifa
holidayoccursonThursday.ClicktheConditionstab.
Figure 31
13 ClickAddtodisplaythe Conditiondialog.
Figure 32
Condition Dialog
62
inthepasttogo.Thedefaultis0 days.Selectavalueof1,andinthe
adjacentlist,selectWorkdays.
17 ClickOK.
TheconditionnowdisplaysintheConditionsview.
Figure 33
63
FromtheNavigatorpane,selectDefinitions>Calendarstodisplaythe
Calendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Calendar>Weekly fromthecontextmenuto
displaytheWeekly Calendar Definitiondialog.
Figure 34
64
ClicktheConditionstab,andthenclickAdd.
TheCalendarfielddefineswhichcalendartouseandhowmanydays
inthepasttogo.Thedefaultis0 days.Selectavalueof1,andinthe
adjacentlist,selectWorkdays.
ClickOK.
10 ClickForecasttoverifythedatesthatSchedulerhaschosen.
11 ClickOKintheWeekly Calendar Definitiondialog.
FromtheNavigatorpane,selectDefinitions>Fiscal Calendarsto
displaytheFiscalCalendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Fiscal Calendar fromthecontextmenuto
displaytheFiscal Calendar Definitiondialog.
65
Figure 35
3
ClickOK.
FromtheNavigatorpane,selectDefinitions>Calendarstodisplaythe
Calendarspane.
ClicktheAddbutton
ontheSchedulertoolbarorrightclicka
calendarandselectAdd Calendar>Subset fromthecontextmenuto
displaytheCalendar Subset Definitiondialog.
Figure 36
66
Ifnotalreadyselected,clicktheDetailstab.
ClicktheForecasttabtoverifythedatesthatwillbeselectedfor
productionexecutionandthenclickOK.
Thecalendardefinitionsarereadytobeusedinproduction.
Youhavecreatedtwoquarterlycalendars,onebasedonafiscalyear
calendarandonebasedonastandardcalendaryearstartinginJanuary.
67
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
RightclicktheReportjobandselectEdit Job/Groupfromthecontext
menutodisplaythe Job Definitiondialog.
Figure 37
68
ClicktheScheduletabontheJob Definitiondialog.
Figure 38
Toviewthedatesinthecalendar,clicktheForecastbuttonandthen
clickOK.
Figure 39
69
ClickOKagainontheJob DefinitiondialogtodisplaytheEffective
Datedialog.
Figure 40
TheEffective Datedialogdisplaysaskingyouwhenthejobshould
entertheproductionschedule.Thedatesrepresentthecurrentspanof
theproductionschedule.
7
ClickOK toacceptthedefault(today).
AnotheroccurrenceoftheReportjobenterstheproductionschedule.
70
5
SETTING UP A JOB
DEPENDENCY
TOPICS
71
Overview
Inmanycases,ajobshouldrunonlyaftersomeexternalrequirementsare
satisfied.Forexample,ajobmayneeddatageneratedbyanotherjob,orit
canrunonlyafteranotherjobhascompletedsuccessfully.
Schedulerhastheflexibilitytoencompassthedifferentschedulingneeds
encounteredinabusinessenvironment.Youusejobdependenciesto
preventajobfromrunninguntiltheprecedingjobcompletesorentersa
predefinedstatus.Youcanalsosetjobstorunonlywhenmanuallyreleased.
Inthischapter,wearegoingtodefine(add)ajobcalledInv21.Wewill
assignacalendartothisjob,butwewillalsomakeitRequire operator
release.Evenifaccordingtoitscalendar,thejobisduetorun,itdoesnot
rununtilitisreleasedfromWaiting on Operator status.Wewilldefinea
secondjob,Inv22,whichdependsonInv21.Inv22doesnotrununtil
Inv21completesnormally.Finally,wereleaseInv21,andbothjobsend
withaCompleted Normallystatus.
Figure 41
72
Thischapterdescribeshowto:
Defineajobthatwaitsforanoperatortoreleaseit
Defineajobthatdependsonthecompletionofanotherjob
Monitorjobsandjobdependencies
Releaseajobthatrequiresoperatorintervention
Caution
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
ontheSchedulertoolbar.
73
Figure 42
3
Note
74
Setthefollowingoptions:
a
IntheJob Namefield,enterthenameInv21.
IntheCommandfield,clicktheellipsisbutton
Opendialog.
NavigatetotheTutorial directory,anddoubleclicktheInv21
batchfile.
Thefullpathto Inv21.batnowappearsintheCommandfield.
todisplaythe
Although the command executable has the same name as the job in
this case, this is not required. The job Name is any logical name that is
meaningful to you. However, the command name refers to the physical
file and must match the actual command.
ClicktheScheduletab.
Figure 43
6
ClicktheOptionstab.
75
Figure 44
ClickOKtosavethejobdefinition.
Wewillleavethisjobfornow,andreleaseittotheProductionSchedule
lateraftercreatingasecondjobwithadependencyonInv21
completingnormally.
76
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
ontheSchedulertoolbar.
Setthefollowingoptions:
a
IntheCommandfield,clicktheellipsisbutton
Opendialog.
NavigatetotheTutorial directory,anddoubleclicktheInv22
batchfile.
todisplaythe
Thefullpathto Inv22.batnowappearsintheCommandfield.
4
ClicktheScheduletab.
77
DisplaytheDependenciestab,byclickingitstabontheJob
Definitiondialog.
Figure 45
7
ClicktheAddbuttontodisplaythelist.
Figure 46
78
andselect
10 AcceptthedefaultsandclickOK.Thedefaultsarepresettosatisfythe
dependencywhenInv21completesnormally.
NowInv21showsasadependencyforInv22.TheInv21dependency
ispartofthejobdefinitionofInv22.
11 ClickOKintheJob Definitiondialogtocloseit.
12 ClickOKintheEffective Date dialog.
TheInv22jobisaddedtotheproductionschedule.
Figure 47
79
Noticethatbothjobsareinwaitingmode.Inv21needsmanualintervention
beforeitcanrun(WaitingOnOperator)andInv22iswaitingforInv21 to
completenormally (WaitingOnDependencies).
DoubleclicktheInv22jobintheJob ActivitypanetodisplayitsJob
Detail dialog.
clicktheDependenciestab.Thedependencyappearsinthe
Predecessorsfield.
Figure 48
ThisshowsthatInv22iswaitingforInv21tocompletenormally.
CurrentlyInv21isinWaiting on Operator status.Inv22cannotrun
untilInv21goestoCompleted Normallystatus.
3
80
ClickOK.
Rightclickthejobtodisplaythecontextmenu.
Figure 49
TheConfirmdialogdisplays.
Figure 50
Confirm Dialog
81
ClickYes.
NowInv21isfreetorun.Oncecomplete,Inv21entersaCompleted
Normallystatus.ThecolorofInv21changestogreenandthentoblue
(ifusingthedefaultstatuscolors),andthenInv22runs.Inv22
displayssimilarstatusandcolorchanges.
Figure 51
5
ClickOKwhentheInformationdialogdisplays.
Congratulations!Inthischapter,youhavedefinedjobsrequiringmanual
releaseandajobdependency.Youhavescheduledandmonitoredyourjobs
throughthevariousstatesuntilcompletion.
82
6
SCHEDULING JOBS IN
GROUPS
TOPICS
83
Overview
Schedulerletsyouorganizeyourjobsintojobgroupstomakeiteasierto
manageandcontroljobs,andtomakeitmoreefficienttosetjobattributes.
Jobscaninheritcharacteristicssuchasdependenciesandcalendarsfrom
theirassociatedjobgroup,eliminatingtheneedtospecifycommonjob
detailsforeachjob.
Whenajobgroupisaddedtotheschedulemanually,allofitsmemberjobs
(calledchildjobs)areaddedaswell,savingyouadditionalworkand
reducingthepotentialformistakes.Ajobgroupcanbeconfiguredtheway
asinglejobcanbetodependonanotherjoborjobgroup.
Inthisexercise,wewillcreateajobgroupcalledapmonth.apmonthwill
consistoftwojobs,Ap31andAp32.WewillmaketheAp32jobdependent
ontheAp31jobcompletingsuccessfully.Oncetheapmonthjobgrouphas
completednormally,Glfinalwillrun.
Figure 52
84
Thischapterdescribeshowto:
Defineajobgroup
Createjobsthatbelongtothegroup
Schedulethejobgroup
Createajobthatdependsonagroup
Releasethejobgroup
Caution
85
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
onthe
Figure 53
86
ClickOK.
AConfirmdialogdisplays.
Figure 54
6
Confirm Dialog
ClickYes.TheapmonthjobgroupisaddedtotheJobspane.
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
Selecttheapmonth jobgroup.
EnterAp31intheJob Namefield.
NoticethattheapmonthjobgroupisdisplayedintheParent Group
field.Youcanalsospecifyapmonthasthejobgroupbyselecting
\apmonthfromtheParent Grouplist.
87
Clicktheellipsisbutton
Program dialog.
Figure 55
7
intheCommandfieldtodisplaytheSelect
ClickOK.
AConfirmdialogdisplays.
88
ClickYes.
Now,whentheapmonthjobgroupisdisplayedinthejobswindow,it
willhaveeitheraplus(+)oraminus()signtotheleftofit,inthefirst
columnofthedisplay.Theplussignindicatestherearejobsand/or
morejobgroupsunderneathitthatarenotcurrentlyvisible.Clicking
theplussignexpandstheselectedjobgroup,showingthechildjobs
and/orjobgroupsbelongtoit.Clickingtheminussigncollapsesthejob
group.
Jobsdonothaveexpand(+)orcollapse()symbolsnexttothem
becauseajobissingularandcannothavechildjobs
Note
Figure 56
Allofthejobsandjobgroupswithinapmonth willbelistedbeneathit.
Iftheyarenot,expandthe apmonth listingbyclickingtheexpandsign
nexttoit.
89
Figure 57
90
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
Selecttheapmonth jobgroup.
IntheJob Namefield,enterthejobnameAp32.Theapmonthjob
groupshouldbedisplayedintheParent Groupfield.Ifitdoesnot
appear,select\apmonthfromtheParent Grouplist.
Clicktheellipsisbutton
Program dialog.
ClicktheDependenciestab.
Clickthedownarrowbutton
Ap31 job.
Figure 58
intheCommandfieldtodisplaytheSelect
intheJob/Grouplistandselectthe
10 ClickOK.
Ap31isnowdisplayedontheDependenciestaboftheJob Definition
dialog.NoticethattheTypeofdependencyisidentifiedasJOB.
91
Figure 59
11 ClickOK.
TheConfirm dialogdisplays,remindingyouthatacalendarhasnot
beenspecified.
12 ClickYestoacceptthejobdefinitionwithoutassigningitacalendar.
TheAp32jobappearsalongwithAp31inthehierarchyunderthe
apmonthjobgroup.
92
Figure 60
93
Doubleclicktheapmonthjobgrouptoopenitsdefinition.
IntheCalendar Namelist,selecttheDailycalendar.
Sincechildjobsdefaulttoinheritingtheparentgroupsattributes,by
settingthisoptionforthegroup,youareeffectivelyassigningaDaily
calendartoeachchildjob.
Figure 61
3
ClickOK.TheEffective Datedialogappears.Acceptthedefaultsand
clickOK.
ThejobgroupandjobsaresubmittedanddisplayedintheJob
Activitypane.
94
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
Verifythatnojobgroup(suchasapmonth)ishighlighted,clickthe
Addbutton
ontheSchedulertoolbarorrightclickintheJobspane
andselectAdd Job fromthecontextmenu.
TheJob Definitiondialogdisplays.
Figure 62
95
IntheJob Namefield,enterGlfinal.
LeavetheParent Group fieldempty.
IntheCommandfield,clicktheellipsisbutton
Program dialog.
todisplaytheSelect
ThefullpathtoGlfinal.batwillappearintheCommandfield.
6
ClicktheScheduletab.
SelecttheDailycalendarfromtheCalendar Namelist.
Figure 63
96
GototheJob/Group field,andclickthedownarrowbutton
Selecttheapmonthjobgroup.
Figure 64
Thedependencywillbemetwhentheapmonthjobgroupreaches
Completed Normally status.Eachjobinthegroupmustcomplete
normallyforapmonthtocompletenormally.
5
97
Figure 65
6
98
Figure 66
Highlightandthenrightclicktheapmonthjobgrouptodisplaythe
contextmenu.
ClickYes.
99
TheInformationdialogdisplays.
5
ClickOKintheInformationdialog.
ApmonthwillenterActivestatus.Then,theAp31jobruns,andAp32
followsafterAp31completesnormally.WhenAp32completes,the
apmonthjobgroupshowsaCompleted Normallystatus.Thenthe
Glfinaljobruns.Thetotalprocessshouldtakeafewminutes.
100
7
CREATING A FILE
DEPENDENCY
TOPICS
101
Overview
Jobdependenciesmeanthatjobsdependonthestatus(suchasCompleted
Normally)ofotherjobstorun.Usingfiledependencies,youcanhavejobs
dependontheavailabilityandstatusoffilesasaconditionofexecution.File
dependenciesaresetupusingtheFile Dependencydialogwhichis
accessiblewhenyoucreateoreditajobdefinition.
Inthischapter,wewillcreateajob(EDI_Download)thatisdependenton
theexistenceoftheEDI_File.txtfile.
Figure 67
Toproperlycompletethisexercise,youneedtohaveasolidunderstanding
ofthefollowingconcepts:
Howtoaddandcreateanewjobdefinition
Thischapterdescribeshowto:
102
Createajobwithafiledependency
Createafiletosatisfythedependency
Caution
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
onthetoolbar.
Figure 68
103
OntheProgramtab,clicktheellipsisbutton
field.
intheCommand
ClicktheScheduletabandfromtheCalendar Namelistselectthe
work daycalendar.
ClicktheDependenciestab.
EnterC:\Program Files\<Installation
Directory>\Agent\Tutorial\Edi_File.txt intheFile Name field.
Thefullpathtothisfilemustbetypedinbecausethefiledoesnt
yetexist.Wewillcreate Edi_File.txt later,inthesectionCreating
aFiletoSatisfytheDependencyonpage 108.
TheAgent NamefieldshouldalreadyhaveaWindowsagent
listedtheagentyouselectedasyourdefaultagentatthe
beginningofthistutorial.Ifthereisnoagentlistedoranagent
otherthantheWindowsagentisselected,thenselectyourlocal
WindowsagentfromtheAgent Namelist.
Figure 69
104
ClickOKtoacceptthedefaultsettings.Schedulersdefaultisthatthe
dependencyismetafterthefileiscreated.
ClicktheDependenciestab.
Figure 70
ClickOKtosavethejobdefinitionforEDI_Download.
105
OpentheJob Activitypane.
TheEDI_Download jobfirstappearswithaWaiting on
Dependencies status.Itgoesthroughdifferentstagesandendsina
Scheduledstatus.
Figure 71
106
SelecttheEDI_Downloadjoboccurrence.
RightclicktheEDI_DownloadjobandselectDetailsfromthecontext
menutoseeitsJob Detaildialog.
Figure 72
5
ClicktheDependenciestabtoviewthefiledependencystatus.
Figure 73
TheJob Detaildialogdisplaysthefiledependencyforthisjob.
6
ClickOKtoclosethedialog.
107
Openanewdocumentinatexteditororwordprocessingprogram,
suchasNotepadorMicrosoftWord.
SavethefileasEDI_File.txtinthelocationthatyouspecifiedwhen
definingthefiledependency(C:\Program Files\<Installation
Directory>\Agent\Tutorial EDI_File.txt),substitutingthenameof
thedirectorywhereSchedulerisinstalledfor <Installation
Directory>. Somesoftwarewillsupplyafileextensionforyou,suchas
.textor.doc.Foryourfiletosatisfythedependency,thenamemust
matchexactly.Savingasaplain textfilehelpsensurethecorrectfile
name.
Doublecheckthatthefileexists,iscorrectlynamedandinthecorrect
directory.
Scheduler polls every minute (by default) for the file dependency data.
Therefore, it may take up to one minute for the job to become active
after you create the file.
Congratulations!Inthischapter,youhavecreatedajobwithafile
dependency,andfulfilledthatdependencyrequirementbycreatingthefile.
Bythistime,youshouldalsofeelcomfortablewithmovingbetweentheJob
ActivitypaneandJobspane,andwiththebasicprocedureforaddingajob.
108
8
DETECTING JOB EVENT
CONDITIONS
TOPICS
109
Overview
UsingSchedulerjobeventsallowsyoutoautomaticallytriggeractions
whenevercertaineventtriggers(jobconditions)arise.Actionsincludeuser
notificationviaemail,consolealertmessages,launchingnewjobs,job
controlcommands,variableupdates,logmessagepostingandSNMPtraps
toHPOpenVieworothernetworkmanagers.Thischapterdescribeshowto:
Defineanoperatoralertaction
Submitthejobtoproductionandwatchtheoperatoralertactionoccur
Caution
Understanding Actions
Anactionisapredefinedresponsetoajobeventthatistriggeredbyajobin
theproductionschedule.YoudefineeventtriggersforjobsintheJob
Eventsdialogandassociatethemtoactions.Actionscanbelinkedto
multiplejobsandjobgroups.
TherearedifferenttypesofactionsthatcanbedefinedwithinScheduler.
SomeoftheseactionsEachtypeofactioncanbetriggeredbasedonanyjobs
status,jobcontrolbyanoperatorand/oraneventtriggeredbythesystem.
Furthermore,youcanpersonalizeactionsfromasetofincludedvariables
suchassystem,job,jobevent,actionanduserdefinedinformation.
110
FromtheNavigatorpane,selectDefinitions>Actions>Alertto
displaytheAlertActionspane.
Figure 74
IntheSeverity Levelsection,checkError.
111
Typethefollowingmessageandselectthevariablesshowninangle
bracketsfromtheVariableslist.Thevariablesappearbetweenthe
bracketsas<variable>.
The Job <Jobname>, owned by <JobOwner> went to
<JobStatus> status on <SysDate.M/d/yy>. <JobOwner>s pager
number is <JobPager>
Note
This dialog does not accept carriage returns. Text automatically wraps
to the next line.
Table 6
Variable
Path
Description
<JobName>
Job
Variables\JobNAME
Thenameofthejobthat
triggeredtheaction.
<JobOwner>
Job
Variables\JobOWNER
Thenameoftheuserthat
ownsthejob.
<JobStatus>
Job
Variables\JobSTATUS
ThestatustheJobisinatthe
timeofthemessage.
<SysDate.M/d/yy>
SystemVariables\
SystemDate\M/d/yy
Theday,month,date,year
actionwastriggered
<JobPager>
JobVariables\
Thepagernumberofthe
OwnersPagerNumber owner
Thisactionistriggered,andanalertrecordissenttotheJob Activity
panefortheoperatortotakeaction.
6
112
ClickOKtoaccepttheaction.TheactionisdisplayedintheActions
pane.
FromtheNavigatorpane,selectDefinitions>Events>Job Events to
displaytheJob Events pane.
ClicktheAdd Event
buttonontheSchedulertoolbarorrightclick
theEventspaneandselectAdd Eventfromthecontextmenuto
displaytheJob Event Definitiondialog.
Figure 75
113
NowtoassociatetheEDI_Downloadjobtothejobevent,clickthe
Associated Job(s)tab.
Figure 76
DisplaytheavailablejobsintheCommand listandselectthe
EDI_Downloadjobbydoubleclickingit.
SelectthePublicoption,ifnotalreadyselected.Thismakesyourevent
availabletootherSchedulerusers.
114
Figure 77
115
IntheJobspane,doubleclickEDI_Download orrightclickitand
select Edit Job/Groupfromthecontextmenu.
Figure 78
2
116
Clicktheellipsisbutton
Programdialog.
intheCommandfieldtodisplaytheSelect
Figure 79
3
RightclicktheEdi batchfileandfromthecontextmenu,selectEdit.
The Edi.bat fileopensinMicrosoftNotepad.
Figure 80
Changethelastlineofthefileocsexit 0toocsexit 1.
FromNotepadsFilemenu,selectExit.
WhentheNotepaddialogdisplays,clickYestosaveyourchanges.
117
ClickOKintheEffective Datedialog.
10 Now,letsinsertthejobintotheschedulebyrightclickingthe
EDI_Download jobandselectingInsert Job into Schedule fromthe
contextmenu.
Figure 81
Figure 82
118
DoubleclickthealerttodisplaytheAlert Detaildialog.
SelecttheAcknowledged option.
YoucanenteraresponseorcommentintheResponsefield.
ClickOKtoclosethedialog.
TheAlertslightatthebottomoftheSchedulerwindowchangesto
yellow.
119
120
9
CREATING VARIABLE
DEPENDENCIES
TOPICS
121
Overview
Inthepreviouschapter,wecreatedanalertmessagethatusedsystem
variables.Inthischapter,wewillcreateajobthatdependsonthevalueofa
userdefinedvariable.Auserdefinedvariableisavariableyoucreate
manually.Ajobcanchangethevalueofavariableyouhaveassignedtoitby
usingavariableupdateaction.Ajobcanbedependentuponthevalueofa
variable.Usinguserdefinedvariables,youaregivenunlimitedcontrolover
theconditionalstructuringofjobs.
Forexample,ajobcanrun,andsetavariabletoaspecificdate.Anotherjob
canbetriggeredtorunbasedonthatvariablesdate.Whenthespecificdate
arises,thesecondjobruns.
Inthischapter,youwillincrementavariablewiththeactionofJobAand
makeJobBdependentonthatvariablereachingaspecificvalue.The
variablewillstartwithavalueof0andincrementby1eachtimeJobAruns.
JobBwilldependonthevariableequalling3.AfterJobArepeats3times,
JobBwillstart.Youcouldsetupajobtostartafteranydefinednumberof
previousdependencyjobscomplete.
Thefollowingfigureillustrateshowthisprocessworks:
122
Caution
123
Creating a Variable
X
To create a variable:
IntheNavigatorpane,selectDefinitions>Variablestodisplaythe
Variablespane.
DisplaytheVariable DefinitiondialogbyeitherclickingtheAdd
Variablebutton
orbyrightclickingintheVariablepaneand
selectingAdd Variable fromthecontextmenu.
FromtheTypelist,selectNumber.
IntheValuefield,enterthenumber0.
SelectthePublicfield,ifitisnotalreadyselected.
Figure 83
8
ClickOK.
ThenewlycreatedvariablenowappearsintheVariablespane.
124
Figure 84
125
FromtheNavigatorpaneselectDefinitions>Actions>Variableto
displaytheVariable Actionspane.
SelecttheAdd Actionbutton
orrightclicktheVariable Actions
paneandselectAdd Actionfromthecontextmenutodisplaythe
Action Definition: Variabledialog.
Figure 85
126
IntheValuefield,enter1ifitisnotalreadysetat1bydefault.
ClickOK.
TheSet Gather Var actionnowdisplaysintheVariable Actionspane.
Figure 86
127
FromtheNavigatorpaneselectDefinitions>Events>Job Events to
displaytheJob Events pane.
Figure 87
128
ClickOK.
FromtheNavigatorpaneselectDefinitions>Jobs todisplaytheJobs
pane.
Figure 88
ClickOK.
ClickOKattheEffective Datedialog
129
Note
When you click OK at this dialog, the job group enters the production
schedule, but nothing will run because there are no jobs associated
with the job group yet. Since you can manually add the job group to
the schedule later, clicking Cancel at this dialog is also acceptable.
Figure 89
2
130
IntheCommandfield,clicktheellipsisbutton
Program dialog.
SelecttheGather batchfileandclickOpen.
ClicktheScheduletab.
Figure 90
todisplaytheSelect
ClickOK.
ClickOKintheEffective Datedialog.
131
Figure 91
132
Figure 92
Figure 93
133
Figure 94
15 ClickOKtoclosetheJob Definitiondialog.
16 ClickOK toconfirmtheEffective Datedialog.
EverytimetheGather Reportjobcompletesnormally,thevariable
Gather Orderswillbeincrementedby1.
134
Figure 95
IntheCommandfield,clicktheellipsesbutton
Programdialog.
SelecttheOrdr_rpt batchfileandclickOpen.
ClicktheDependenciestab.
todisplaytheSelect
135
Figure 96
IntheVariable Valuefield,typethenumber3.
10 ClickOKtoacceptthevariabledependency.
Figure 97
136
IntheJobspane,doubleclicktheGather_Report jobtodisplaythe
Job Definitiondialog.
ClickOKtodisplaytheEffective Datedialog.
Figure 98
ClickOK.Thejobenterstheproductionschedule.
ClickOKintheInformationdialog.
FromtheNavigatorpane,selectOperations>Job Activitytodisplay
theJob Activitypane.
DoubleclicktheOrder Reportsjoboccurrence.
137
ClicktheDependenciestab.
Figure 99
Thevariabledependencyappearsshowingthepresentvalueofthe
variableandthevalueitneedsforthedependencytobemet.
10 ClickCancelandlookatthejobsintheJob Activitypane.
ThethreeoccurrencesoftheGather ReportjobrunbeforetheOrder
Reportsjobruns.
138
Figure 100 Monitoring the Gather Report and Order Reports Jobs
139
140
10
MANAGING JOBS IN THE
PRODUCTION SCHEDULE
TOPICS
141
Overview
Inthischapteryoulearntousejobcontrol,typicallyperformedbyan
operator,tomanagethecurrentproductionschedule.Jobcontrolconsistsof
releasing,stopping,restartingandabortingjobs.Youcanalsorerunjobs,
overridetheirdependenciesandchangetheircompletionstatus.
Thischapterdescribeshowto:
Cancelajob
Removeajob
ReleaseajobgroupintheWaiting on Operatorstatus
PlaceajobonHold
Overrideajobdependency
Rerunajobthatfails
Caution
142
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
ClickOK.
ClickOKintheEffective Datedialog
143
Tocreateachildjobofajobgroup,selecttheProduction Jobsjob
groupontheJobspane.
IntheCommandfield,clicktheellipsisbutton todisplaytheSelect
ProgramdialoganddoubleclicktheAp31 batchfiletoselectit.
ClicktheOptionstab.
144
Figure 103 Production Jobs Job Group and the Prod Job 1 Child Job
10 AjobcalledCopy of Prod Job 1appearsintheJobspane.
145
button
menu.
Thesecondjobhasbeencreated.
14 Createathirdjob,calledProd Job 3,thesamewaywecreatedProd
Job 2.
Forthisjob,wewilladdanunreasonabletimedependencytoshow
howwecanoverridethisdependencyintheJobActivitywindow.
15 DoubleclickProd Job 3.
146
If you set a time window that is before the present time, e.g., 12:00
AM to 12:15AM, the job will enter todays schedule with a Timed Out
status.
19 ClicktheOptionstab.
20 MakesuretheRequire operator releaseoptioniscleared.Thisjob
willwaitbasedonitstimewindow.(Weareassumingthatyouarenot
runningthistutorialatmidnight.)
21 ClickOK,thenclickOKagainintheEffective Datedialog.
22 Rightclickthenewjobgroupthatyoudefined,thenselectInsert Job
into ScheduleandclickOK.
23 ClickOKintheInformationdialog.
147
Figure 106 Production Jobs Job Group and its Children Jobs
Job Sorting
JobscanbesortedandfilteredbyanycolumnintheJob Activitypane.On
everyrefresh,sortingoccursonthecolumnwhichcontainsacaret(^)inthe
columnheader.Inthisexercise,wewillsetthedefaultsortcolumntobethe
Estimated Start Time.
clicktheEst Start Timecolumnheader.Thejobsaresortedbythe
estimatedstarttime.
148
SelectDelete Job/Groupfromthecontextmenu.
WhentheConfirmdialogisdisplayedclickYes.
Note
You can also remove a job by clearing the Enabled option in the job
definition, or by deleting the job from the Jobs pane. You can only
remove a job from the production schedule if it is not currently running
or has not yet run.
149
Thereareseveralwaystoenterajobinthisdialog.Forthisexercise,we
willuseSchedulerssophisticatedsearchfunction.
2
clicktheellipsesbutton
intheJob/GroupfieldtodisplaytheJob
Search dialog.
150
IntheNamefield,typeProd*.Leavetheothertextfieldsblank.
Theasterisk(*)isawildcardcharacter,sothissearchwillfindalljobs
thatstartwithProd.(Theasteriskmatchesanycharacteror
combinationofcharacters.)
ClicktheFindbutton
SelectProd Job 1.
ClickOKattheInformationdialog.
Thejobisaddedtothescheduleoutsideitsjobgroup.Notethatjobs
outsideofajobgrouparenotindentedunderthegroup.
10 ClickYesintheConfirmationdialog.
11 ClickOKintheInformationdialog.
Thejobbeginstorun.
151
FromtheNavigatorpane,selectOperations>Job Activitytodisplay
theJob Activitypane.
152
ClickYesattheConfirmationdialog.
ClickOKintheInformationdialog.
ThestatusofthejobchangestoCancelled.
Figure 112 Displaying Cancelled Prod Job 2 Job in Job Activity Pane
ClickYesintheConfirmationdialog.
ClickOKintheInformationdialog.
ThejobentersHeldstatus.
153
ClickYesintheConfirmationdialog,andthenclickOKatthe
Informationdialog.
ThejobreenterstheWaiting On Dependenciesstatus.Ifthejobs
dependenciesweremet,thejobwouldlaunch.
154
Overriding a Dependency
Youcanalsooverridejob,file,timeandvariabledependencieswiththe
Overridecommand.Forthisexercise,wewilloverridethetime
dependency.
X
To override a dependency:
ClickYesintheConfirmationdialog,andthenclickOKatthe
Informationdialog.Thejoblauncheseventhoughthedependencies
havenotbeenmet.
When a dependency is overridden, the Job Detail dialog for the job
whose definition includes the dependency will show which dependency
was overridden.
155
156
toterminateifitrunsoveritsmaximumtime
tonotifyanoperatorifitcompletesunderitsminimumtime
toperformotheractionsautomatically
11
MANAGING COMMAND
PARAMETERS
TOPICS
157
Overview
Thischapterdescribeshowto:
Passcommandparameterstoanexecutable
Determinethejobcompletionstatusbasedonthejobsoutput
Definecommandparametersandenablealternativetrackingmethods
158
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
159
YouspecifycommandparametersfromtheCommand Parameters
sectionintheProgramtab.
Clicktheellipsisbutton
160
intheCommandfield.
FromtheTutorialdirectory,rightclicktheArgdemo batchfileand
selectEditfromthecontextmenu.
TheMicrosoftNotepadtexteditoropensthebatchfileandyouseethe
batchfiletextasshownbelow.Thecommandparametersspecifiedin
theJob Definitiondialogwillbeenteredintothebatchfileinthe
locations%1,%2,etc.
161
ExitNotepadandclickCanceltwicetoreturntotheJobspane.
For more information on batch processing, please refer to your
Windows or DOS documentation.
Tracking Methods
Ajobscompletionstatusisdeterminedbyitsexitcode.Theexitcodecanbe
setbyusingtheocsexitcommandattheendofabatchfile.Usingocsexit
tofacilitatejobtracking,thecompletionstatusofajobcanbe:
Completed Normallyindicatedbyanexitcodeof0tonotifythatthe
jobsucceeded
Completed Abnormallyindicatedbyanexitcode0tonotifythatthe
jobran,butfailed.
Note
Thecompletionstatusisfrequentlyusedtocontroldependencies.For
example,youcansetupjobsthatrunifitspredecessorcompleteswitha
CompletedNormallystatus.
Schedulersupportsfourothertrackingmethods:
ExternalYoucanusethisoptionifyouneedtoinspectthejobbefore
determininghowthejobcompleted.SchedulersetsthestatustoSet
Externallywhenthejobcompletes.
162
ThetrackingselectionsarelocatedintheTrackingsectionoftheRuntabin
theJob Definition dialog.
Figure 118 Specifying Tracking in the Job Definition Dialog, Run Tab
163
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
ClicktheScheduletab,ifnotalreadyselected.
orrightclickandselectAdd Job
ClickOKtosavethejobgroup.
ClickCancelattheEffective Datedialog.
Note
164
If you click OK at this dialog, the job group enters the production
schedule, but nothing will run because there are no jobs associated
with the job group yet. Clicking Cancel means the job group will be
added to the schedule manually.
RightclicktheReportingjobgroupandselectAdd>Job fromthe
contextmenu.
intheCommandfieldtodisplaytheSelect
Programdialog.
FromtheTutorialdirectory,doubleclicktheArgdemo batchfile.
ClicktheRuntab.
165
Inthetextfieldbelow,typeFind OK.ThistellsSchedulertosearch
throughtheoutputofthejobforthestringOK.SinceOKispassed
asacommandparameter,itwillappearintheoutput.
ClickOK.
10 ClickCancelintheEffective Datedialog.Thisjobwillenterthe
schedulewhenmanuallysubmititsjobgroup.
166
IntheCommand Parametersfield,changeOKtoFAILED.
TheRuntabshouldcontainFind OKintheTrackingsection.This
wasinheritedwhenyoucopiedthejob.
6
ClickOK.
ClickCancelattheEffective Datedialog.
RightclicktheReportingjobgroup.
167
ClickOKintheInformationdialog.
Thejobsstartwithonecompletingnormallyandtheothercompleting
abnormally.ThejobgroupresultsinaCompleted Abnormallystatus
becauseoneofitsjobscompletedabnormally.
168
ClickOK.
ClickOKattheEffective Datedialog.
ResubmitthejobsbyaddingtheReportingjobgroupusingthe
Insert into Scheduleoption,fromtherightclickcontextmenuor
selectingtheoptionfromtheActionsmainmenu.
ClickOKintheInformationdialog.
BothReport Writer 1 andReport Writer 2completesuccessfully.
169
170
12
SETTING UP QUEUES
TOPICS
171
Overview
Thischapterexplainshowtosetupqueuessothatyourjobsrunefficiently
onyournetwork.Jobsenterqueueswhentheirdependenciesaremetand
arereleasedfromaqueuebythemaster.Inthepreviouschapters,thejobs
youcreatedranfromthedefaultqueues.
Queuesaremosteffectivewhenmorejobsarescheduledthanyouhave
resourcestohandlethem.Eachqueuehasajoblimitandaprioritythat
helpstodeterminefromwhichqueuejobsarelaunched.Whenaqueues
limitisreached,Schedulerselectsthenextqueuetorunjobsonaccordingto
queuepriorities.Withinaqueue,ajobsindividualprioritydetermines
whichjobinthequeueislaunchedfirst.
Queuesaredefinedinahierarchy,withtheSystem Queueatthetop.
ToviewSchedulerspredefinedjobqueues,selectScheduling>Queuesin
theNavigatorpane.
Eachqueuecontainsasetofqueuefilters.Queuefiltersaredesignedto
acceptorrejectjobsbasedontheirproperties.
172
Besidesprioritizingtheexecutionoflargequantitiesofjobs,queuescanbe
usedforanumberofotherpurposes:
Tolimitthenumberofjobsofaparticulartypeorgrouprunning
concurrently
Tocontroltheflowofjobsexecuted,overallorbyanindividualqueue,
sothatsystemresourcesareusedmoreevenlyandpeakdemandsare
reduced
Tosinglethreadjobsrequiringaparticularresource,suchasexclusive
accesstoadatabase
Torestrictthehourswhenjobsruntoatimewindowdefinedbythe
queue,forexample,toallowbatchprocessingtooccurovernight
Tolaunchjobsimmediatelyforspecialcaseswhereitisrequired
Thischaptercovers:
SettinguptheInventory Weeklyjobgroup
CreatingthreejobsfortheInventory Weeklyjobgroup
Settingupaqueue
AddingtheInventory Weeklyjobgrouptoproduction
Monitoringthejobgroupinproduction
Changingthequeuelimit
Caution
173
FromtheNavigatorpane,selectDefinitions>Jobs todisplaytheJobs
pane.
Figure 125
174
ClicktheScheduletab,ifnotselected.
IntheCalendarlist,selectthework daycalendar.
ClicktheOptionstab.
ClickOK.
IntheJobspane,selecttheInventory Weeklyjobgroup.
ClicktheAdd Jobbutton
orrightclickandselect Add Job fromthe
contextmenutodisplaytheJob Definition dialog.
Figure 126
175
Clicktheellipsisbutton
Program dialog.
FromtheTutorial directory,doubleclicktheInv10batchfile.
ClicktheNotestab.WewillusetheNotestabtoenterashort
descriptionofthejob.
intheCommandfieldtodisplaytheSelect
TheNotestabisagoodplacetoaddspecialinstructionsor
explanatorycommentswithoutaffectingthejobsexecution.
8
Figure 127
9
ClickOK.
10 ClickCancelattheEffective Datedialog.
176
SelecttheInventory_10 jobintheJobspaneifnotalreadyselected,
andeitherclicktheCopy Job/Groupbutton orrightclickand
selectCopy Job/Groupfromthecontextmenu.
AjobdisplaysintheJobspanenamedCopy of Inventory_10.
IntheCommandfield,changeInv10.battoInv11.bat usingthe
Select Program dialog.
ClickOK.
ClickCanceltopreventthejobfrombeingscheduled.
RepeatthestepsabovetocreateathirdjobcalledInventory 12
selectingthe Inv12.bat fileinthe Command field.
177
Setting Up a Queue
WewillsetupaqueuenamedInv_Weeklyandgiveitaqueuelimitof
three.ThejobsintheInventory Weeklygroupwillruninthisqueue.The
queueconfigurationparameterswillsinglethread(runoneatatime)the
jobsinthegroup.
X
To set up a queue:
FromtheNavigatorpane,selectScheduing>Queuestodisplaythe
Queuespane.
Figure 128
178
Adding a Queue
Figure 129
LeaveSystem QueueintheParentfield.
WedefinedInv_Weekly asadirectsubqueueofthesystemqueuein
thequeuehierarchy.Thismeanstherearenointermediatequeuesto
imposetheirownrestrictionsandaffectjobexecution.
ChangetheLimitvalueto3. Thisallowsamaximumofthreejobsfrom
thisqueuetorunconcurrently.
ChangethePriorityvalueto60.
Defaultqueueshaveaprioritysettingof50.Sincedefaultqueuescan
acceptthejobsthatyoucreated,thishigherpriorityvaluewillensure
thatthejobsenterthisqueue.Whenthequeuemanagerseestwoor
morequeuesthatcanacceptajob,italwaysassignsthejobtothequeue
withthehighestpriority.
179
Figure 130
SelecttheInventory Weeklyjobgroup.
ClickOK.ThefilterisenteredintotheFilterstab.
Figure 131
180
operatewithinaspecifictimewindow.Jobsassignedtothequeue
wouldthenrunonlyifthecurrenttimewerewithinthattimewindow.
10 ClickOK.Inv_Weeklyisaddedtothelistofqueuesonyoursystem.
Figure 132
181
Figure 133
ClickOKintheInformationdialog.
182
ClickYesintheConfirmdialog.
ClickOKintheInformationdialog.
Figure 134
TheInventory Weeklyjobgroupgoesactive,alongwiththethree
jobs:Inventory_10,Inventory_11,andInventory_12.Becausethe
limitontheInv_ Weeklyqueueissetto3,allthreejobsinthegroup
Inventory Weeklyarelaunchedatonce,andnowruntocompletion.
5
ScrolltotherightintheJobspanetoviewtheQueuecolumn.
NotethattheInventory_10,Inventory_11andInventory_12jobs
arerunningfromtheInv_Weeklyqueue.
183
Figure 135
184
FromtheNavigatorpane,selectDefinitions>Queuestodisplaythe
Queuespane.
DoubleclicktheInv_Weeklyqueuetodisplayitsdefinitiondialog.
LowertheLimitfrom3to1.
ClickOKtosavethechanges.
ThelimitchangeisdisplayedintheQueuespane.
Figure 136
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
RightclicktheInventory Weeklyjobandfromthecontextmenu
selectInsert Job into Schedule.
ClickOKintheInformationdialog.
FromtheNavigatorpane,selectOperations>Job Activitytodisplay
theJob Activity pane.
Youcannowseeanotheroccurrenceofyourjobgroupanditsjobsin
theJob Activitypane.
185
SelecttheRelease/Resumeoption.
ClickYesintheConfirmdialog.
10 ClickOKintheInformationdialog.
TheInventory Weeklyjobgroupgoesactive,andthejobswithinthegroup
runagaininnoparticularorder.Thistime,however,theyrunoneatatime
becausetheirassignedInv_Weeklyqueuehasalimitof1.Whiletheyare
running,ifyouinsertorrerunanyotherjobontheschedulethatbelongsto
adifferentqueue,itrunsimmediatelysinceitdoesnotbelongtothe
Inv_Weeklyqueueandisnotrestrictedbyitslimit.
186
13
REVIEWING THE
DASHBOARD
TOPICS
187
Overview
TheDashboardisacentralizedmanagementviewofjobsummary
information.Itconsistsofcustomizedgraphs,chartsandtablesshowingthe
currentproductionscheduleorresultsfrompreviousdays.
Type
Description
Pane Configuration
188
AlertsBreakdown Displaysasnapshotof
Alertstatusesinbarchart
format.
Filteralertsbystatusandseverity
level.
JobStatistics
Displaysatableofkeyjob
statuscountsand
percentages.
Filterjobsbyjobclass,agent,
queue,scheduledor
unscheduledandstatus.
JobActivity
Displaysalinechartofjob
activityoverthecourseof
thedayin15minute
intervals.
Filterjobsbyjobclass,agent,
queue,scheduledor
unscheduledandstatus.
JobProgress
Displaysoveralljob
executionprogressona
meter.
Filterjobsbyjobclass,agent,
queue,scheduledor
unscheduledandstatus.
Youcanconfigureseveralcustomizedpanesofthesametypetoviewjobsof
aparticularclass,agentorqueue.Forexample,supposeyouhavefive
agents,andyouwanttomonitorthenumberandstatusesofjobsrunning
oneach.UsingtheStatus Breakdownpanetype,youcancreatefivepanes
usingadifferentagentasafilterforeach.Thedisplayisupdatedevery20
seconds.
Inthisexerciseyouwillcreateandeditanewpane,andcompareittoan
existingdefaultpane.
Caution
189
to
190
to
191
ClickOK.
YounowhaveanewpanecalledInv Weekly.Thenewpanewill
displaytheproductionstatusbreakdownforjobsassignedtotheInv
Weekly queue.
ClickOK.
YounowhaveanewlyaddedDashboardpanecalled Inv Weekly,and
youhavereshowntheOverall Status Breakdownpane.Now
comparetheinformationoftheInv WeeklypanetotheOverall
Status Breakdownpane.
192
Asyoucansee,thethreejobsthatenteredthequeueInv Weeklyhave
runandcompletednormally,whiletheOverall Status Breakdown
paneshowsjobscompletingwithnormalstatuses.
ClicktheInv_WeeklypaneandselectEdit Panefromthecontext
menutodisplaytheDashboard Pane Definition dialog.
ClickOK.
ViewtheInv_Weeklypaneandnoticethatitnolongershowsjobsthat
havecompletednormally.
193
Figure 142 Inv_Weekly Pane Showing All Jobs That Did Not
Complete Normally
YouhavejustlearnedhowtoviewtheDashboard,andconfigureitspanes.
YouthencreatedthepaneInv_WeeklyanddisplayeditinDashboard,
madeeditstoit,andcomparedittotheOverall Status Breakdownpane.
194
14
USING SCHEDULER AGENTS
TOPICS
195
Overview
IfyouhaveinstalledtwoormoreTidalAgentsforWindowsonseparate
machines,youcanperformtheproceduresinthischapter.Ifyouhaveonly
oneagent,youmaystillwanttoreadthischaptertounderstandhowother
agentsareintegratedinScheduler.
Inpreviousexercises,youscheduledjobstorunontheSchedulermaster
systemwhichincludedanagentofitsown.Youcanalsorunjobson
multipleexternalagents.Agentsletyouexpandyourcomputingpowerand
flexibility,helpingyougetjobsdonemorequicklyandefficiently.
ForaSchedulermastertorecognizeanagent,theScheduleragentsoftware
mustbeinstalledonthatagentmachine,andavalidlicensefilemustexist
foritonthemaster.Refertotheinstallationguideformoreinformationon
licensingandregisteringagents.
TheSchedulermasterprovidescentralizedcontroloverschedulingina
distributedcomputingenvironment.Thereisnolimitonhowmanyagents
youcanattachtoamaster,ifyourlicensecontainstheunlimited(floating)
provisionforagents.Youcanalsoscheduleajobtorunonanyagentinyour
network.
Schedulerletsyougroupmultipleagentsintosetscalledagentlists.When
youassociateoneoftheselistswithajob,Schedulerlaunchesthatjob
dependingonthetypeoflist:
Ordered ListRunsonthefirstagentavailableinthelist,chosen
sequentiallyfromthetopofthelist
Balanced ListRunsontheagentwiththelightestloadatthetimethe
jobisreadytorun.
Random ListRunsonanagentpickedatrandomfromthelist.
Rotation ListRunsontheagentfollowingthelastagentusedfor
execution.
Broadcast ListRunsonallagentsinthelist.
Inthischapter,youlearnhowtorunajobonanexternalagent.Youwill
alsolearnhowtocreateaninteragentdependency,thatis,adependencyon
ajobthatrunsonadifferentmachine.Wewilladdanagentandrunajob
thatislocatedonit.
196
Caution
FromtheNavigatorpane,selectAdministration>Connectionsto
displaytheConnectionspane.
DoubleclicktheagentconnectiontodisplaytheConnection
Definitiondialog.
197
ClicktheConnectiontab.
IntheMachine Namefield,enterthemachinewiththeScheduler
agentinstalledonit.
SelecttheEnabled option,ifnotalreadyselected.
ClickOK.
Theagentwillbegintheconnectionprocess.Theagentstatuslightat
thebottomoftheclientisyellowuntiltheagentisconnected.The
statuslightthenturnsgreen.Thisnormallytakesabout45secondsor
less.
198
FromtheNavigatorpane,selectDefinitions>JobstodisplaytheJobs
pane.
todisplayaJob Definitiondialog.
IntheCommandfield,clicktheellipsesbutton
Programdialog.
ClickOKtoclosethedialog.
todisplaytheSelect
199
ThejobisplacedintheproductionschedulewithaWaiting on
Operator status.Wewillreleasethisjob,butfirstletscreateajobwith
adependencyonthisjobtoshowtheagentdependencyfeature.
200
FromtheCommandfield,clicktheellipsisbutton
Select Programdialog.
DoubleclicktheInv22batchfileintheTutorialdirectory.Thisenters
thecommandfilenameintotheCommand Name field.
ClicktheRuntabandselecttheagentthatexistsonthemaster.
OntheDependenciestab,clicktheAddbuttonandselectAdd Job
DependencyfromthelistofoptionstodisplaytheJob Dependency
Definitiondialog.
todisplayaJob Definitiondialog.
todisplaythe
IntheJob/Group list,selecttheAgent_Job1job.
Only jobs that have already been defined will appear in the menu. If
you have not defined any jobs, none will appear.
201
Whenthedialogcloses,theAgent_Job2jobappearsintheJobspane.
202
SelecttheAgent_Job1job.
Rightclickthejob,andthenselectJob Control>Release/Resume
fromthecontextmenutoreleaseAgent_Job1fromtheWaiting on
Operator status.
ClickYesintheConfirmdialog.
ClickOKintheInformationdialog.
TheAgent_Job1runsontheexternalagent.Whenitcompletes
successfully,theAgent_Job2 runsonthelocalagent.
Summary
Congratulations!Withthecompletionofthischapter,youhavebuiltagood
foundationofknowledgeaboutScheduler.YouarereadyforSchedulerto
increaseandcomplementyourproductivity.
Ifyouneedanyfurtherinformationortraining,contact
support@tidalsoftware.com.
203
204
4/6/06 9:41:23 AM