Scheduling actions - Native and Classic Web UI

You can schedule actions to run based on a time and date or based on an event.

You use the Scheduler to run actions automatically at specific times, when files are present, or when certain events occur.

1. In the native UI, select Tools > Scheduler in the menu bar or click Schedule in the toolbar.

   Each action and host action branch in the active tree pane is listed in the schedule table. Scheduled actions are listed at the top and unscheduled actions are listed below. Sorting by columns only affects the scheduled action rows.

   A schedule of actions that you can edit appears.
2. Select the action you want to schedule. You can right-click the action row and select Schedule, double-click the action row to select the action and display the Scheduling dialog box, or single-click the action row and click the clock icon.
   Alternatively, you can right-click a host or user mailbox action in the Active tab of the tree pane.

   The Scheduling dialog box appears.

3. In the Scheduling dialog box, select the Run this action automatically check box to enable the following scheduling options.
   • polling for files: checks your folder for the files at intervals you define and runs the action when files are present. See Scheduling actions to run automatically by polling for files.
   • scheduled date/time: applies date- and time-based scheduling for your action. See Scheduling actions to run at specific dates and times.
   • events: runs the action when the selected event occurs. See Scheduling actions to run based on events. Cleo Harmony and Cleo VLTrader applications only.
   Note: If you selected an action that is already scheduled, you can click Edit to modify the existing schedule. You can also clear the Run this action automatically check box to unschedule the action.
4. When you finish specifying values for scheduling parameters above and click Schedule.
   The Scheduling dialog box is dismissed and the new schedule information is displayed on the Schedule page

By default, the schedule does not automatically start when the application is started. You can, however, configure your system to run schedules at start up using the property Automatically run schedules at startup. See Other system options.

For the Cleo LexiCom application, the schedule will only run one action at a time. If more than one action is scheduled for the same time, the actions are run sequentially. If a scheduled action is still running when another action's scheduled time arrives, the action is not started until the running action ends.

For the Cleo Harmony and Cleo VLTrader applications, you control concurrently running scheduled actions using the property Allow Scheduled Actions to Run Concurrently. See Other system options.

You can schedule actions to run automatically based on a weekly, monthly, or one-time period. For weekly and monthly scheduling, it is possible to set up multiple day and time ranges.

1. In the Scheduling dialog box, select Run this action automatically.
2. Select at scheduled date(s) and time(s), and then click Continue.
   The Schedule for dialog box appears.
3. Specify a weekly, monthly, or one-time schedule. See Scheduling actions to run weekly, Scheduling actions to run monthly, and Scheduling actions to run one time for more information.
4. After you specify a schedule, click OK on the Schedule for dialog box.
   The Schedule for dialog box is dismissed and the Scheduling dialog box appears.
5. Click OK on the Scheduling dialog box.
   Your action is scheduled and the schedule is reflected in the table of actions on the Scheduler page.

You can schedule actions to run automatically on a weekly schedule. You can set up multiple day and time ranges.

1. In the Schedule for dialog box, select the Weekly radio button.
2. Select a time zone.

   The times you select for this schedule are relative to this time zone. The time zone you select is displayed in the Scheduler dialog box in the Scheduled column.

3. Select one or more days of the week within the Day(s) of Week section.
4. Specify one or more start times (24-hour clock). A start time of 00:00 indicates 12:00 midnight; a start time of 17:00 indicates 5:00 PM.
5. Optional: For each start time, specify a recurrence. A recurrence can be scheduled either continuously, by selecting the Recurring continuously check box, or at an interval, by selecting the Recurring every check box and specifying the interval in hours, minutes, and seconds. Finally, choose when the recurrence should stop by selecting a time from the Until menu. An end time of24:00 indicates the end of the day.
6. If a different time schedule is required on different days (for example, weekdays and weekends), click New Day(s) and repeat the steps above.
   When you configure multiple days, you can scroll through them using the arrow buttons in the upper left of the dialog box.
   You can click Remove Day(s) to delete the schedule for the days currently displayed.
7. Click OK.
   Your new schedule is saved and the schedule table is displayed, including your new schedule information.

You can schedule actions to run automatically on a monthly schedule. You can set up multiple day and time ranges.

1. In the Scheduling dialog box, select the Monthly radio button.
2. Select a time zone.
   The time zone you select is displayed in the Scheduler dialog box in the Scheduled column.
3. Select one or more months and then one or more days of the month within the Day(s) of Month section.
4. Specify one or more start times (24-hour clock). A start time of 00:00 indicates 12:00 midnight; a start time of 17:00 indicates 5:00 PM.
5. Optional: For each start time, specify a recurrence. A recurrence can be scheduled either continuously, by selecting Recurring continuously, or at an interval, by selecting Recurring every and specifying the interval in hours, minutes, and seconds. Finally, choose when the recurrence should stop by selecting a time from the Until dropdown menu. An end time of 24:00 indicates the end of the day.
6. If a different time schedule is required on different months (for example, even months versus odd months), click New Month(s) and repeat the steps to specify days and times.
   When you configure multiple months, you can scroll through them using the arrow buttons in the upper left part of the dialog box.
   You can click Remove Month(s) to delete the schedule for the months currently displayed.
7. Click OK.
   Your new schedule is saved and the schedule table is displayed, including your new schedule information.

You can schedule actions to run automatically one time at a specific date and time.

1. In the Scheduling dialog box, select One Time.
2. Select a time zone.
   The time zone you select is displayed in the Scheduler dialog box in the Scheduled column.
3. Select a single year, month, day, and time.
4. Click OK.
   Your new schedule is saved and the schedule table is displayed, including your new schedule information.

You can configure your system to poll folders for files and then run actions automatically when files are present.

1. In the Scheduling dialog box, select the Run this action automatically check box, and then select by polling for files.
2. If you want to poll for files continuously, click OK.
   If you want to specify how often to poll for files, click Edit. The Schedule for dialog box appears. See Scheduling actions to run at specific dates and times for more information.
   If you do not explicitly specify how often to poll for files, default polling period values are used.
3. Click OK.

You can configure your system to run actions based on a trigger created when certain events occur. When the trigger is created, the action runs immediately. Note that, by default, actions configured to be triggered for an FTP server (under a Users host or a Local FTP Users host) are not triggered immediately. They are triggered when the connected FTP client issues another command or the session is closed. See Trigger At Upload Completion in Local FTP users mailbox advanced properties.

Triggers are generated when:

• a new file arrives in a folder
• a new file fails to arrive in a folder
• a user session ends successfully
• a user session fails to end.

When you schedule an action to be run based on a trigger, the Scheduler window displays the triggering event in the Scheduled column. If there are multiple events, they are displayed in the Scheduled column as a comma-separated list.

1. In the Scheduling dialog box, select Run this action automatically check box and then select when ANY of the following events occur.
2. Select the events you want to trigger actions. Choose from the following:

   New file arrives

   Runs the action when a new file arrives in the folder. You can choose successful or failed file transfers or both to trigger the action.

   This event type is valid only for FTP and SFTP uploads, AS2 and HSP receives, and LCOPY commands.

   For a Commands action scheduled for new file arrives, the Commands action will be run only if at least one of the sources of the PUT or LCOPY commands in the action match the path of the new file. And then at runtime, all of the sources of the PUT, LCOPY, LDELETE, and LREPLACE commands that match the new file's path are modified to explicitly point to the new file.

   User session ends

   Runs the action when an FTP or SFTP user session ends. Choose successful or failed session end or both to be the trigger event.

   Note: This option is available only for JavaScript actions.

   Note: For both new file arrives and user session ends triggers, the trigger object is accessible in the JavaScript action viaISessionScript.getTrigger(). The user session end trigger includes all the relevant new file arrives triggers that occurred during the session.
3. Click OK.
   When the trigger event occurs, the action runs.