Viewing the run history of entries

You can view the run history of entries that are scheduled to run in the background, without waiting to view them.

This includes scheduled entries that are run once and saved, and interactive entries that are saved or mailed. Interactive entries do not have run histories.

IBM® Cognos® software keeps history information each time an entry runs in the background. The run history for an entry includes information such as the request time, start time, completion time, and whether the report ran successfully.

You can look at a more detailed run history for the entry, which includes general, error, and warning messages related to the entry and any actions you can take. If there is any email associated with the entry, the status of the email delivery is included.

Some types of entries display additional information in the detailed run history page:

  • For reports, a report output version is kept each time a report is run according to a schedule. You can view the report output version from the detailed run history.
  • For jobs and agents, you can view a list of steps and see a detailed run history for each one. You can also see the parts of the job or agent that have not yet completed. If the entry is part of a parent entry, you can view the parent entry that initiated the run.
  • For human tasks contained within an agent, you can view a list of steps and see a detailed run history for each one.
  • For deployment export and import entries, you can view the public content in IBM Cognos Administration.

    You may see the following message: Only progress information is currently available. The information will be updated following the completion of the parent activity.

    This means that the deployment has completed, but the parent activity is still running. Once the final completion information is obtained from Content Manager, the message no longer appears.

You can rerun failed entries Rerunning a failed entry task from the detailed run history page. You can view a list of related runs that are part of the rerun series and see a detailed run history for each one. You can specify how many run history occurrences to keep or for how long to keep them Specifying how long to keep run histories.

Procedure

  1. From the Manage menu, click Administration console.
  2. On the Status tab, click Schedules or Past Activities.
  3. Next to the entry, click the arrow and then click View run history View run history icon.
  4. If you want, select the Status of entries that you want to view.

    A list of selected entries appears.

  5. If you want to view the run history details, in the Actions column, click the view run history details button View run history details icon next to the entry you want. Then, if you want, from the Severity list, select the severity of the entries.

    Under job steps, the complete run history details is shown. If the job run history details level was set to Limited, no history details for the jobs steps are recorded.

  6. If there is a report output version, in the Actions column, click the view outputs button View outputs icon for the entry you want. Then, from the Versions list, click the version you want. To delete a version, click Manage versions click the check box for the version, and then click Delete.
  7. If you want to view messages, click an item with a link in the Messages column.

    Messages are nested. You can see child messages within child messages. If a message is displayed as a link, you can continue to drill down through the child messages.