Prompt API - Auto refresh a report in the Browser / Web with a timed interval

Technote (FAQ)


How can we autorefresh a report in IBM Cognos Prompt API with a time interval ?
It needs to work in the Browser / Web interfaces of Cognos Connection, the Portal Portlets and the Cognos Workspace.


NOTE : Any previous documentation using unsupported Javascript in the older versions before C10.2.x for refreshing a report in a timed manner, are obsolete for this version.

This Javascript code is based on the Prompt API and is supported in IBM Cognos 10.2.x and later versions only.

Include the following JavaScript code in the HTML item in the report, it will automatically refresh the report for the defined interval.


var ocr = cognos.Report.getReport("_THIS_");
function sendPRMT_Request(eAction) {
function sendFinishRequest() {

global.setInterval( function() { sendFinishRequest(); }, 5000 );
// for Auto Refresh 5000 is a value in milliseconds, ie 5 seconds here.

Design comments :
Of course if your report is a large report and takes much longer than 5 seconds of run time, you need to take in account a much bigger value for Autorefresh in the Browser.

This technology would not be recommended for use in long running reports, as these should be Scheduled for user review later.
Browser / Web operation is considered a more immediate operation , and users should not be put to wait for long running reports.

Document information

More support for:

Cognos Business Intelligence
Software Development Kit

Software version:

10.2, 10.2.1

Operating system(s):

AIX, HP-UX, Linux, Solaris, Windows

Software edition:

Edition Independent

Reference #:


Modified date:


Translate my page

Content navigation