Manage memory and file caches

RtReports utilizes two caches when reports are generated: a memory cache and a file cache.

The memory cache resides in memory and is used to store reports that are running or reports that are in edit. The time that reports are cached in memory is short, and it is configurable via the web.config setting ExpirationMemory.

The file cache resides on disk. All released reports that are based on completed contexts are stored in the file cache on the RtReports server. Reports are not cached if they are generated against an in-progress context. Completed contexts do not change over time.

All cache information is accessible by systems administrators from the Cache folder and in the Cachemanagement.aspx web utility.

Reports in either cache (file or memory) are removed after a configurable period of time. The ExpirationMemory and ExpirationFile cache settings are only used if the report is released and the report context is completed. For more details on the cache expiration settings, see Report Remoting defaults for Cache Manager.

To view the statuses and errors for all print jobs, cancel print jobs or restart the print manager utility, click the Reports Printed tab.

1. To open the Cache Management page, browse to the URL https://webserver/RtReports/WebPages/CacheManagement.aspx and sign in as a system administrator.

   From this page you can access reports in the file cache, reports running in the memory cache, reports that are pending, reports that generated an error while being run, and the printing status of reports.

2. Optional: To view and edit the reports in the file cache, click the Reports in Cache tab.

   1. View the fields for the report.

      • Select

        Marks reports to be removed from the cache when you click Remove Selected Reports.

      • Report Name

        Hyperlink that opens a cached report in the Report Viewer window.

      • Report Version

        The version number of the report.

      • Data server

        The PI Server used to obtain data context for the report.

      • Type

        The type of report, either Batch or Time.

      • ID

        Hyperlink for the unique batch ID for a batch report.

        Clicking the link displays the batch report details beneath the report grid.

        Time reports do not have an ID.

      • Start Time

        The start time of the report for time reports.

      • End Time

        The end time of the report for time reports.

      • Insert Time

        The time the report was added to the file cache.

   2. To remove one or more reports, select the check boxes for the reports in the Select column, then click Remove Selected Reports.

   3. To remove all reports from the file cache, click Remove All Reports and click Yes in the confirmation window.

3. Optional: To view and edit the currently running report, click the Reports Running tab.

   All fields and options on this tab are identical to those on the Reports in Cache tab, except reports in the running list cannot be deleted, as they are not stored in the cache yet .

4. Optional: To view reports that are pending in the queue and waiting to be generated, click the Reports Pending tab.

   All fields and options on this tab are identical to those on the Reports in Cache tab, except Priority, which indicates the priority level for the report.

   High priority means the report is requested for viewing after being run. Medium priority means the report is selected to be generated.

5. Optional: To view and edit reports that generated an error while being run, click the Reports Error tab.

   All fields and options on this tab are identical to those on the Reports in Cache tab.

6. Optional: To view the statuses and errors for all print jobs, cancel print jobs, or restart the print manager utility, click the Reports Printed tab.