Scheduling An App

Note: On event apps cannot be scheduled. They only run when triggered by an outside event, such as a message from Salesforce.

On schedule and Data replication apps can be scheduled from the Schedule tab of the app details page.

You can choose to run an app:

On demand
Once, at a specified date and time
On a recurring schedule

Run On Demand

Navigate to the Apps page and select a specific app to open it.
On the Schedule tab where it says Run this app, select on demand.
Select Save.
At the top of the app Details page select Run. The app runs once and stops.

Run Only Once

Note: By default, the time zone for the only once schedule option is set to your browser's time zone and stored as UTC time. Time zone cannot be modified.

Navigate to the Apps page and select a specific app to open it.
On the Schedule tab where it says Run this app, select only once.
In the line below, click the date field and type a date or select the Calendar icon to open the Calendar and select a date.
Click the time field and enter a time..
Select Save to save the schedule. The app runs once at the selected date and time and then stops.
After the app runs the first time, the only once setting is ignored unless it is reset. To run the app again, select Run on the app Details page.

Note: When you set, or reset, the only once time, it must be at least 5 minutes later than your computer's local time.

Run On A Recurring Schedule

Note: Time zone defaults to UTC, but can be modified.

Navigate to the Apps page and select a specific app to open it.
On the Schedule tab where it says Run this app, select recurring.
In the line below, click the date field and type a date or select the Calendar icon to open the Calendar and select a date.
Next to repeating, click the field to open a dialog and select how often the app should execute.
Specify the schedule by selecting the days to run, and select Apply.
Click field that displays the time, specify the time to run, and select Apply.
Tip: For a recurring schedule, specify both a day and a time; for example, the 1st and 15th of every month at 3:00 AM.
Note: If you select a recurring day and time, such as Every Tuesday and Every 6 hours, TIBCO Cloud™ Integration - Connect starts the first run at midnight on Tuesday and then runs again 6 hours after the first run completes. However, if, for example, you select Run Now at 10pm (2200h) on Monday, then the first run on Tuesday begins 6 hours after the last run finishes instead of at midnight.
Select Save. The app runs on the requested schedule.

Scheduling Notes

Selecting Days Of The Month

Days 29, 30, or 31 are not available in the Every month on section because if the current month does not contain that day, the app would not run in that time frame.

For example, if you selected Every month on the 15th and 30th, the app runs on February 15, but not at the end of the month.

Tip: To always run on the last day of the month, select Last.

Selecting A Specific Time

In the Times dialog, select At.
Enter a specific time.

The app runs at the selected time on the days specified in the Days section.

Selecting A Time Frequency

If you select:

A frequency such as Every hour, 15 minutes after the hour, then the app starts at the specified time unless the last run is still processing.
Note: If the app is still running at that time, then the app does not restart until the next interval occurs during which the app is not running.
For example, if the app runs from 4:15 to 5:25; the app starts again at 6:15.
A frequency such as Every 2 hours, then the app starts again 2 hours after the last run ends rather than, for example, at 4:00 , 6:00, and 8:00. If the run takes longer than the interval between jobs, the job may run fewer times than anticipated. For example, if you schedule an app to run every 5 minutes and it takes 8 minutes for the app to complete, the appn starts again 5 minutes after the first run finishes.

Note: For Data replication apps — Only changed data is processed. Therefore, even if the first app run takes three hours, later runs may only take a few minutes.

Scheduling Across Time Zones

By default, the time zone setting is set to UTC. You can, however, use the Time zone drop-down box to explicitly select a time zone.

Tip: The next scheduled run time is always shown on the Apps list in the computer's local time.

Agent Not Running

If, for any reason, your TIBCO Cloud™ Integration - Connect agent is down when an app is scheduled to run, the app runs as follows:

If the app is scheduled to run once, and the agent is down at that time, the app does not run.
If the app is scheduled to run at a specific time, and the agent is down when a run is scheduled, TIBCO Cloud™ Integration - Connect skips that run and the app does not run until the next scheduled time.
If the app is set to a frequency, such as every 6 hours, the app runs when the agent is restarted.

Changing Frequency

If you select a time frequency for your app, such as Every 12 Hours, and you later change the frequency, the new setting is treated as follows. After you select Save:

If the app is running, it finishes and then starts again after the new interval elapses.
If the app is running, and you change to on demand, it finishes and then stops.
If the app is not running, the TIBCO Cloud™ Integration - Connect agent compares the old and new intervals. If, using the new interval:
- The app should be running based on when the last run finished, then the app starts immediately.
- The app should not yet be running, the app starts after the new interval elapses.
  For example, assume the original frequency is set to 12 hours, and 9 hours have passed since the last run started. If you then change the frequency to 8 hours, then the app runs immediately because more than 8 hours have passed since the last time the run started.