Run or Schedule a Job

HID_getting_started_run_or_schedule_job
ccppmop151
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. Open
    Home
    , and from
    Personal
    , click
    Jobs
    .
  2. Open the
    Jobs
    menu, and click
    Available Jobs
    .
  3. Click the name of the job you want to run or schedule.
  4. Complete the requested information. The following sections require explanation:
    • General
      Edit the job name. For scheduled runs, you can change the name to distinguish each instance of a run. For submitted scheduled job entries, a read-only job ID and status are displayed.
    • Parameters
      Set the parameters as desired. This section appears only if your 
      CA PPM
      administrator defined the parameters. Click Save Parameters to save the defined set of parameters for reuse. The saved parameters display in the list on the
      Available Jobs
      list page below the job type from which it is based.
    • 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 
      CA PPM
      instance is running. When you use this option, the scheduled configuration takes the system time from the server where the 
      CA PPM
      instance is running.
      For more information about the UNIX Crontab format and special character usage, see the Oracle Documentation.
  5. Submit your changes.
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. Open
    Home
    , and from
    Personal
    , click
    Jobs
    .
  2. Click the
    Jobs
    menu, and click
    Scheduled Jobs
    to edit the schedule of an existing job run.
  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. Open
    Home
    , and from
    Personal
    , click
    Jobs
    .
  2. Open the
    Jobs
    menu, and click
    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. Open
    Home
    , and from
    Personal
    , click
    Jobs
    .
  2. Open the
    Jobs
    menu, and click
    Log
    .
More Information
:
  • Jobs Reference
    (see the English edition of the documentation)