Agent Jobs

From Pro 9 Wiki
Revision as of 11:31, 13 February 2023 by Sofial (talk | contribs) (Marked this version for translation)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Scheduled Jobs

In the Scheduled jobs view you get an overview of the scheduled jobs, and you can create new jobs or edit the existing ones. The scheduled jobs are only used when Pro 9 is installed in a cloud environment, to handle the scheduling of regularly recurring jobs, e.g. the AD/HR integration or the aggregation.

Normally you set up a schedule for the job, defining when and how often the job is to be run, but it's also possible to run the job manually.

If you want to stop a job, there are different ways to do it depending on what you want to achieve. If it's temporary, you can either disable the job totally or disable one or more of the job schedules. If it's permanent, you can delete the whole job.


Note: The scheduled jobs functionality is used by advanced users, e.g. Enghouse technical consultants.


How to - Show Scheduled Jobs

  1. Click the role Application Maintenance
  2. Click System monitoring > Scheduled jobs
    • A list of all scheduled jobs is shown


How to - Add a New Job

  1. Click add Icon Add.png
  2. The edit section below the table opens
  3. Define a name for the job
  4. Check the enable box to be able to run the job with a schedule
  5. Click save
  6. Add steps to be executed in the job
    1. Click add Icon Add.png to add a new row
    2. Define the order of the steps by selecting the position for this step in the step menu
    3. Define a name for the step
    4. Enter one or more SQL commands (as you would in a SQL query window) in the command field
    5. Define what to do on success or failure action:
      1. Define what to do if the execution of the command(s) is a success in the on success action menu
      2. Define what to do if the execution of the command(s) is a failure in the on failure action menu
      3. The alternatives are:
        • Go to the next step - Continue with the next step in the list of steps in the job.
        • Quit reporting success - End the execution of the job and report it as successful.
        • Quit reporting failure - End the execution of the job and report it as a failure.
        • Go to a specific step - All steps in the job are listed. Select one to continue with that step.
    6. Click save
    7. Repeat to add more steps


How to - Edit a Job

  1. Click edit Icon Edit.png for the job you want to edit
  2. The edit section below the table opens, showing the current settings
  3. Edit the settings or add/remove steps
    • See the section How to - Add a new job for details on this
  4. Click save to save the changes


How to - Disable/Enable a Job

  1. Click edit Icon Edit.png for the job you want to disable/enable
  2. Change the enable setting for the job
    • To enable - ensure that the box is checked
    • To disable - ensure that the box is not checked
  3. Click save


Note: You can still run a job manually, even if it is disabled.


How to - Delete a Job

  1. Check the box for each job you want to delete
  2. Click the icon Icon Links.png to open the action menu in the toolbar above the table, and select delete
    • The job is immediately deleted


Note: Only user-defined jobs can be deleted.


How to - Run a Job Manually

  1. Click run Icon Run.png for the job you want to run instantly
    • The job will be started and run according to the settings


Note: Some scheduled jobs cause high load on the system server, and are therefore scheduled during the night. If you run them during day time, users may experience slow response from the system.


How to - Create or Edit the Job Schedule

  1. To edit the schedules of how often to run the job, click Links > Edit schedules Icon Links.png


How to - Check Job History

  1. To check the job history, click Links > History Icon Links.png