Schedulers

{"URL":["/*.*/AddScheduler_Select"],"heroDescriptionIdentifier":"ice_adding_schedulers"}
definitional data,runtime data

A scheduler is a representation of an automation engine that regularly provides the data that populates AAI. Once AAI is installed and fully integrated with the scheduler(s), AAI can start extracting the data that it needs to build jobstreams, perform calculations, predict outcomes, populate charts, generate reports and so forth. AAI extracts two types of data:

  • Object definitions

    Static object definitions that describe the jobs: Their schedules, dependencies and resource conditions, how they are connected, when they start, and so forth. AAI converts this data into jobstream definitions.

    When installing and configuring AAI and the connectors, the technical teams have set up the regular intervals at which AAI polls this data. Since these definitions do not change very often, the usual polling cycle is once or twice a day.

  • Run data and metadata

    Job events, status changes that occur as executions take place in the scheduler. AAI recreates those job events and status changes and generates jobstream runs accordingly.

    When installing and configuring AAI and the connectors, the technical teams have set up the regular intervals at which AAI polls this data. Run data is dynamic, it changes constantly so the polling cycles are short in this case (every 20 seconds, every minute and so forth).

You can add as many schedulers to a single AAI server as you need. You can also add multiple schedulers for one particular automation engine. For AutoSys, each of these instances can have a different scheduler version.

You use the Configuration Tool to manage the intervals at which AAI retrieves data from the schedulers. For more information, see Configuration Tool - Intervals Tab.

This page includes the following:

The Scheduler List

The Schedulers list on the System Monitoring page provides the following information for each connected scheduler:

  • Name and Type as defined when you added the scheduler

  • Status

    The scheduler retrieves the data from its automation engine at regular intervals that are configured per scheduler. The status of the scheduler indicates how current the data provided to the scheduler is in relation to the configured interval.

    • Behind

      When administrators configure the system, they also define the period of time that the scheduler is allowed NOT to retrieve data without issuing an alert. The scheduler is behind if the specified period has been exceeded more than 15 minutes have elapsed since the last job event was processed.

    • On Time

      This status means that the scheduler is retrieving data as defined in its configuration.

    • In Progress

      This status means that the scheduler is being created.

    • Offline

      This status indicates that the scheduler is down.

  • Event as of

    The last time that the scheduler collected data from its automation engine. So, you know that the data is as up-to-date with the automaton engine as this time.

    This time will always be the equal to or greater than the time of the Last Event that was collected. If the scheduler is very busy, these times will stay the same during that busy interval.

  • Last Event

    The most recent time that an event was collected by the scheduler from its automation engine. Although the scheduler might check for event data in regular intervals, sometimes there is no new event.

  • Job Definitions Updated

    The timestamp including the time zone of the last update of the job definitions.

  • Active Jobs

    The number of jobs that are currently active in the scheduler.

  • Deleted Jobs

    The number of jobs that have been deleted from the scheduler. Deleted jobs definitions and their historical execution data are retained in the AAI database to be available for historical jobstream data for as long as your company retains historical data.

From the Schedulers list you can do the following:

  • Add a new scheduler

  • View the definition of a scheduler

    Click the link in the Name column. The resulting dialog displays the scheduler properties and it also lets you edit and delete the scheduler as well as take it offline/online.

Adding Schedulers

To add a scheduler, click the Add Scheduler button. Depending on the type of scheduler that you want to add, you must configure different properties. For details about how to configure each type, see:

Note:

You can also add and configure schedulers using the Command Line Interface. For more information, see Command Line Interface.

After adding a scheduler through the web interface, the new scheduler is available in both interfaces.

Taking Offline/Putting Online

online schedulers,offline schedulers

Sometimes you need to take a scheduler offline from its connection to AAI while you do maintenance work on either the scheduler or AAI, such as installing software updates. The scheduler continues to run, although AAI does not try to connect to it to get updated data (jobs definitions and events).

The scheduler remains defined to AAI and historical data in the AAI database is available for analysis and reporting, but no new data will be processed while the scheduler is offline. When you put the scheduler back online, AAI will gather the data for the any updated job definitions or events that occurred in the offline time. If this is a large amount of data, AAI does this in increments with each regular pull or push intervals of the connection.

To Take a Scheduler Offline or Put it Online

  1. Start at the System Monitoring page.

  2. Click the link in the scheduler name.

  3. On the resulting dialog toggle on/off the Online button. AAI will resume its normally scheduled download of data from the scheduler (including job definition changes and new events).

Deleting Schedulers

Deleting a scheduler means that all data related to that scheduler is removed from the AAI database permanently, including jobs, job runs, and jobstreams.

  1. Start at the System Monitoring page.

  2. Click the Actions icon to the right of the scheduler name.

  3. Select Delete.

See also:

Jobstream Administration