View the Run History for Entries

You can view the run history of entries that are scheduled to run in the background, without anyone 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 Viewing report output versions 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 folders 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.

  • For data movement, you can view nodes that were executed as part of a data movement entry in IBM Cognos Administration. For more information about nodes, see the Data Manager User Guide.
  • For index update tasks, you can view the IBM Cognos Connection folder or package that is indexed. You can view the scope of the index, either all entries or only entries that have changed. You can also view the type of data collected for indexed entries.

You can rerun failed entries Rerun 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. If you are an administrator, from the Launch menu, click IBM Cognos Administration. On the Status tab, click Schedules or Past Activities.

    If you are a user, in IBM Cognos Connection, in the upper-right corner, click the my area options button My area icon, click My Activities and Schedules, and in the left pane, click Schedules or Past Activities.

  2. Next to the entry, click the arrow and then click View run history View run history icon.
  3. If you want, select the Status of entries that you want to view.

    A list of selected entries appears.

  4. 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.

  5. 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.

    Note: For data movement tasks, a log file may be associated with the entry. To view a log file associated with an entry, click the view the log file button.

  6. If you want to view messages, click an item with a link in the Messages column.

    Tip: Messages are nested. There may be child messages within child messages. If a message is displayed as a link, you can continue to drill down through the child messages.