Run or Schedule a Job

HID_getting_started_run_or_schedule_job
ccppmod153
HID_getting_started_run_or_schedule_job
Jobs are sets of actions that you can run or schedule to automate common administrative processes. For example, jobs can populate or refresh database tables and run background processes. A job can include queries, statements, or procedures.
 
 
View the Job Run Time and Run Status
Use the
Scheduled Job
page to view the run times of a job and the run status. All scheduled runs (except deleted ones) are listed regardless of their status. A scheduled run can have one of the following statuses:
  • Cancelled
    Indicates that the scheduled run was stopped and that future recurring instances are permanently canceled.
  • Completed
    Indicates that the single, nonrecurring scheduled run has completed. If the job definition is set to generate a log, you can view it in the Job Log.
    Note:
    Recurring scheduled runs never show a status of
    Completed
    .
  • Paused
    Indicates that the scheduled run is stopped temporarily.
  • Running
    Indicates that the scheduled run is in progress.
  • Scheduled
    Indicates that the scheduled run starts executing the job on its prescribed date and time.
  • Waiting
    Indicates that the scheduled job has reached its start date and time, but cannot run until an incompatible job or process ends.
  • Pending for Process Engine
    Indicates that the status appears only if the process engine is not run before the Assign Incident job is run.
Run or Schedule Jobs
The
Available Jobs
page list all jobs that a user or administrator can access and can run immediately or can schedule it to run later. Each available job has one corresponding definition and one job type.
Follow these steps:
  1. Click 
    Home
    ,
    Personal
    ,
    Reports and
     
    Jobs
    .
  2. Click
    Jobs
    ,
    Available Jobs
    .
  3. Click a job.
  4. Complete the following fields:
    • General
      Edit the job name. For scheduled runs, you can change the name to distinguish each instance of a job. After you submit a scheduled job, a read-only job ID and status appear.
    • Parameters
      Specify your job parameters. This section appears only if your administrator defined the parameters. Click
      Save Parameters
      to save the defined set of parameters for reuse. The saved parameters appear on the
      Available Jobs
      list page as a child job below the original parent job.
    • When
      Defines the interval at which the job runs. Select
      Scheduled
      to run the job later. To run the job at a recurring time, click the
      Set Recurrence
      link.
      You can also set the recurrence of a scheduled job using the UNIX crontab. To use crontab, select Use UNIX Crontab Entry Format and enter the schedule. For example, the following entry indicates that the job runs at midnight on the 1st and 15th of every month:
      0 0 1,15 * *
      You can use the crontab option on Windows, Linux, and UNIX operating systems where the 
      Clarity PPM
      instance is running. When you use this option, the scheduled configuration takes the system time from the server where the 
      Clarity PPM
      instance is running.
      For more information about the UNIX Crontab format and special character usage, see the Oracle Documentation.
  5. Click Submit.
Edit Scheduled Job Run Properties
The
Scheduled Jobs
page lists the run times of a job and the run status. All scheduled runs (except deleted ones) are listed regardless of their status. Using the Job Properties page, you can edit the properties of scheduled job runs that have statuses as
Canceled
or
Completed
. Otherwise, you can only view job run properties.
If you schedule a job to run only once, you can only edit its properties before the scheduled run time.
Follow these steps:
  1. Click 
    Home
    Personal
    Reports and
     
    Jobs
    .
  2. Click 
    Jobs
    Scheduled Jobs
    .
  3. Click the name of the job you want to edit.
  4. Edit the information and save your changes.
    If a job fails, verify the status of scheduled instances for more information or contact your administrator for assistance.
Manage a Scheduled Job Run
You can manage how a scheduled job runs in the following ways:
  • Pause or resume a scheduled job run
    On the
    Scheduled Jobs
    page, you can pause any job with a status of
    Scheduled
    and can resume the job. You can pause a job  to stop it from running. When in this state, the job cannot run at its scheduled time until you resume it. When you resume the job, it runs at its next scheduled run time.
  • Cancel a scheduled job run
    You can cancel a scheduled job run to stop the job immediately and cancel any future runs. However, the server processing for the started job continues to run in the background. A canceled job remains in the scheduled jobs list with a
    Canceled
    status. The status takes some time to reflect in the
    Scheduled Jobs
    list page. After you cancel a job run, you cannot change its status and cannot edit any of its properties.
  • Delete a scheduled job run
    You can delete the scheduled job runs with a
    Canceled
    or
    Completed
    status using the
    Scheduled Jobs
    page. Deleting scheduled runs does not delete the job type, or any of the run job logs.
Follow these steps:
  1. Click 
    Home
    Personal
    Reports and
     
    Jobs
    .
  2. Click 
    Jobs
    Scheduled Jobs
    .
  3. Select the check box next to the scheduled job and complete one of the following actions:
    • Click
      Pause
      .
    • Click
      Resume
      .
    • Click
      Cancel Job
      .
    • Click
      Delete Job
      .
View or Delete the Job Log
You can use the Log page to view information about a job run or delete outdated job logs. A job log consists of a read-only version of its run properties and lists job entries, times, and any messages. If a job fails, the log indicates the nature of the error.
You can schedule the Remove Job Logs job to remove job logs periodically from the job log.
Follow these steps:
  1. Click 
    Home
    Personal
    Reports and
     
    Jobs
    .
  2. Click 
    Jobs
    Log
    .
More Information
:
  • Jobs Reference
    in the English edition of the documentation