Managing and viewing the history of instances

The History page displays all of the instances for a selected object. The Instance Time column displays the title of the instances and the date of the last update for each instance. The Status column displays the status of each instance. The Run By column indicates which user scheduled the instance.

For report objects, the Format column displays which format the report is, or will be stored in and the Parameters column indicates what parameters were or will be used for each instance. For program objects, the Arguments column lists the command-line options that were or will be passed to the command line interface for each instance.

Crystal Enterprise creates instances from objects. That is, a report instance is created when a report object is scheduled and run by the Report Job Server. Essentially, a report instance is a report object that contains report data that is retrieved from one or more databases. Each instance contains data that is current at the time the report is processed. You can view specific report instances on the History page of the report object.

Crystal Enterprise creates a program instance each time that a program object is scheduled and run by the Program Job Server. Unlike report instances, which can be viewed in their completed format, program instances exist as records in the object history. Crystal Enterprise stores the program's standard out and standard error in a text output file. This file appears when you click a program instance in the object History.

To manage instances

1. In the Objects management area of the CMC, select an object by clicking its link.
2. Click the History tab.

   The History tab appears.

   

3. Select an instance or instances by selecting the appropriate check boxes.
4. Click either Run Now, Pause, Resume, Delete, Select All, Clear All, or Refresh.

   Note:    If you click Run Now, a new instance will be generated (which uses the current settings of the object).

To view an instance

1. Select a object in the Objects management area of the CMC.
2. Click the History tab.

   The History page appears.

3. In the Instance Time column, click the instance you want to view.

Tip:    You can also use the Instance Manager tool to view a list of instances by status or by user. Access the Instance Manager by clicking its link in the Administrative Tools area of the Crystal Enterprise Admin Launchpad.