Programs

Notifications

When you create a program, you can select whether to have the system notify you if the program:

• Succeeds
• Fails, and at what step it failed

You enter one or more email addresses to be notified.

Process

When you create a program, you specify the steps involved in the program. After one step is complete, the next step begins. A step can have one or more tasks to complete an activity or send a message. You should put tasks in the same step if they can be done at the same time, such as importing two separate files.

Schedule

When you create a program, you have the option to specify a schedule for the program to run. You choose a date and time when the program first runs and schedule it to recur.

Starting and Stopping a Program

After the program definition is complete, you must start the program in order for it to execute the steps. If you start the program without a schedule, the system will prompt you to choose one of the following:

• Start Immediately, run once - Select this option to run the program one time without a schedule.
• Start using the recurring schedule - This option is disabled, but you can click the Edit Schedule link to create a schedule.
• Start on the following date and time, run once - Select this option to run the program one time in the future without recurrence.

If you do provide a schedule, clicking the Start button allows the system to execute the steps on the scheduled date. A program will not run, even if it is scheduled, until you start the program. When you stop a program, you have the option to stop the currently running instance or all future instances. You can skip a future scheduled instance of a program.

Note: If you stop a currently-running instance, the system completes the current step before stopping to allow the program to end gracefully.

You can identify whether a program is scheduled to run in the future by whether a value appears in the Next Occurrence column in the My Programs workspace.

View Activity

You can view history for a program by selecting the program in the My Program workspace and clicking the View Activity button. You can filter the program activity to see currently Running instances, History instances, or All. You can stop a Running activity from this screen. The history contains the following information for each instance of the program running:

• Start Date - The scheduled start date and time for the program.
• Status - The current status of the program. Valid values include:
  
  • New - The program is scheduled for a future time.
  • Initializing -The program is beginning.
  • Pending - The program is waiting on an external system.
  • Processing - The program in running.
  • Completed - The instance of the program has completed.
  • Errored - The program encountered an error and has not completed.
  • Stopped - The program was stopped from within the interface.
  • Skipped - The instance of the program was skipped.
• Execute Type - Whether the program is scheduled to recur.
• Executed By - The name of the user who started the program.