> #### Setting up job completion actions and alerts

> You can optionally monitor and manage information about jobs that have executed. In so doing, you can:

> - Associate job status details with actions to automatically notify appropriate personnel about the status of the job's execution.
> - Set up alerts to trigger if a job execution exceeds the time frame in which the job was scheduled to run.
> - Initiate a series of job activities based on exit code values. This activity, known as job chaining, allows you to plan job actions to occur for more than one exit code condition. See the "Job chaining" section for more information.

> ##### Job completion actions

> You can associate exit codes with existing actions to define which actions occur based on the status of a job's execution. Once a job execution completes, an exit code is generated. The exit code indicates whether or not the process succeeded. Based on the exit code and the action you associate with the code, Fathom can ensure that the specified action occurs.

> Typically, an exit code of zero indicates success, while a nonzero code indicates an error. For more information on nonzero exit codes, search the log file. If a job running on Windows returns a positive, nonzero code, use the `net helpmsg` command for information.

> For example, consider a job that returns an exit code of 1326. Entering net helpmsg 1326`` at the command line returns the following message:

>     Logon failure: unknown user name or bad password

> You can also use exit codes to chain jobs together using flow control. See the "Job chaining" section for more information.

> ##### Job completion alerts

> A job alert definition instructs Fathom to trigger a warning alert if the job execution time frame exceeds the time frame during which the process is scheduled to run. You can also associate an action with the alert.

> To specify job completion actions and alerts:

> 1. Click the Edit button at the bottom of the Job page:

> The Job Completion Action and Alerts page opens:

> 2. Enter an exit code number in the Exit Code field. The number must be between 0 and 255; you can also type the word default. From the Action drop-down list, select a predefined action to associate with the exit code. Click Add/Update. The exit code and action pair created display in parallel columns under their respective fields.
> 3. Repeat Step 2 in this section to define additional exit code and action pairs. For example, you might have several exit code and action pairs:

> 4. In the Alert if execution time exceeds field, enter the threshold of time after which you want a warning alert to trigger. You can specify the time in minutes or hours, and you must use whole numbers.
> For example, if you want to be notified at the 30-minute mark that the job execution has not occurred, enter the value 30 in the first field and click Minutes from the drop-down list.

> 5. From the On alert perform action drop-down list, select an action from the list of available, predefined actions that you want to associate with this alert.
> 6. Click Save to submit your selections. The Job summary page appears.

Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095