Scheduling, running, and managing designs : Scheduling a job : Specifying scheduling properties
 
Specifying scheduling properties
You can schedule a job to run immediately or at a scheduled time. You can set the time explicitly or base it on a system event. If you create a job that uses an event‑based criteria and schedule the job to run immediately, the job does not run until the event occurs. If you create a job that uses both a system event and a schedule, the job runs when both conditions occur.
For example, you can schedule a job to run at 4:00 p.m. on Monday if file
\\server2\mydocuments\document.xls exists. If the file does not exist at that time, the job remains scheduled until the file does exist. Then, the job runs. If iHub is down when the conditions by which the job can run are satisfied, the job runs when iHub restarts.
Table 5‑1 describes the properties of the Run job section of Schedule—Schedule.
Table 5‑1 Job scheduling properties 
Property
Description
Right now
Run the job immediately.
Once
Run the job once, at some future date and time. Specify the date and time. You can use the calendar option # to select a date. The default date is the current date. The default time is 10 minutes later than the current time.
Recurring
Run the job at regular intervals. Select the interval in Recurring, and specify the time of day.
Advanced
Create a custom schedule. Selecting this option enables Edit Schedule, which invokes Job Schedule Builder, in which you can design a specific schedule.
Wait for event
Set a system event as the criteria for running a job. In Wait for event, select File Event, Job Event, or Custom Event.
Optionally, you can provide a file or event name.
Your choice of event type determines the availability of options described in Table 5‑2.
Table 5‑2 Scheduling event types
Event type
Description
File event
Specify a fully qualified path to an operating system file or folder as the event criteria. Do not use a relative path. iHub runs the event-based job when it finds the file or folder. If the item does not exist, iHub waits until the item exists before running the job.
Job event
Use Job Selector to choose the name of a scheduled job as the event criteria. iHub runs the event-based job when the scheduled job completes. You can specify whether to trigger a job after a successful or a failed job completion event, or both. You can also specify a lag time, in minutes, after which iHub scans previously completed, qualifying jobs. For example, if you specify 60 minutes, iHub scans jobs that completed in the preceding 60 minutes. If a job meets the event-based criteria, iHub runs the event-based job.
Custom event
Specify a web service that iHub monitors. iHub communicates with the web service and runs a custom event-based job when the web service returns a signal to iHub. To specify a custom event, you must create a web service application and deploy it in the BIRT iHub System environment, then configure the web service in System Volumes—Events in Configuration Console.