Use Jobs to Schedule Multiple Entries

You can set the same schedule for multiple entries by creating a job. A job identifies a collection of reports, report views, and other jobs that are scheduled together and share the same schedule settings. When a scheduled job runs, all the entries in the job run.

If a job item is unavailable, you can select a different link by clicking Link to an entry.

Jobs contain steps, which are references to individual reports, jobs, and report views. You can specify whether to run the steps all at once or in sequence.

  • When steps are run all at once, all the steps are submitted at the same time. The job is successful when all the steps run successfully. If a step fails, the other steps in the job are unaffected and still run, but the job has a Failed status.
  • When the steps are run in sequence, you can specify the order in which the steps run. A step is submitted only after the preceding step runs successfully. You can choose to have the job stop or have the other steps continue if a step fails.

You can schedule a job to run at a specific time, on a recurring basis, or based on a trigger, such as a database refresh or an email Trigger-based Entry Scheduling.

The individual reports, jobs, and report views in steps can also have individual schedules. Run options for individual step entries override run options set for the job. You can set run options for the job that serve as the default for step entries that do not have their own run options.

You can run reports to produce outputs based on the options that you define, such as format, language, and accessibility.

Permissions required to include an entry as part of a job vary depending on the type of entry. The permissions are the same as for scheduling an entry Schedule an Entry.

Procedure

  1. In IBM® Cognos® Connection, click the new job button New job icon.
  2. Type a name and, if you want, a description and screen tip for the job, select the location in which to save the job, and then click Next.

    The Select the steps page appears.

  3. Click Add.
  4. Select the check boxes for the entries you want to add and click the right arrow button Right arrow icon. When the entries you want appear in the Selected entries box, click OK.

    You can also click Search, and in the Search string box, type the phrase you want to search for. For search options, click Edit. When you find the entry you want, click the right arrow button to list the entry in the Selected entries box and click OK.

    To remove entries from the Selected entries list, select them and click Remove. To select all entries in the list, select the check box for the list. To make the user entries visible, click Show users in the list.

  5. If you want to change run options for an individual entry when it runs as part of the job, click the set icon Set icon, click Produce report outputs, select the Override the default values box, make the changes, and click OK.

    To send the report to mobile recipients, select Send the report to mobile recipients and click Select the recipients.

    Tip: To return to defaults for individual entries, click the delete button.
  6. If you want to refresh the cache for a report when the job runs, click the edit icon next to the report, and then from the Run the report to menu, click Refresh the report cache. Click Override the default values. To accept the displayed language, click OK. To change the language, click Select the languages, select the languages you want, and then click OK. Click OK to accept the displayed languages.
    Tip: To clear the cache, click the delete button.
  7. If you want to create or refresh the cache, click the set icon, click Refresh the report cache, select the Override the default values box, add languages, if you want, and click OK.
    Tip: To clear the cache, click More next to the report whose cache you want to clear, click Clear the cache, and click OK twice.
  8. Under Submission of steps, select whether to submit the steps All at once or In sequence.

    If you select In sequence, the steps are executed in the order they appear in the Steps list. If you want the job to continue to run even if one of the steps fails, select the Continue on error check box.

    Tip: To change the order, click Modify the sequence, make the changes, and click OK.
  9. If you want to specify default run options at the job level, under Defaults for all steps, click Set.

    Note that the run options that are available for a job with multiple entries may not apply to every entry. If the option does not apply to an entry, it is ignored.

  10. If you want to override defaults, select the category and select the Override the default values check box and select the default options you want for the job and click OK.
  11. To save the complete history details for the job steps when the run activity completes successfully, click All from the Run history details level list. Click Limited to save limited run history details for the job. If the job run fails, the complete history details are saved.

    The default is All.

  12. Select the action you want:
    • To run now or later, click Run now or at a later time and click Finish. Specify the time and date for the run. Click Find only or Find and fix, then click Run. Review the run time and click OK.
    • To schedule at a recurring time, click Schedule to run at a recurring time and click Finish. Then, select frequency and start and end dates. Click Find only or Find and fix, then click OK.
      Tip: To temporarily disable the schedule, select the Disable the schedule check box. To view the schedule status, see Activities Management.
    • To save without scheduling or running, click Save only and click Finish.

Results

A job is created and will run at the next scheduled time.