Start Parameters

Before using either the parameterized URL or cognosLaunch method you must first locate the object that you want to access.

The easiest way to identify the location of an object, such as a saved report, is to start IBM® Cognos® Connection and copy the object search path Using a Page ID Instead of the Object Search Path into the required URL command. The full path must be copied, as listed in the report properties, including the relevant package name and report names.

For example, using the following parameterized URL starts IBM Cognos Viewer and runs the report named 2005 Sales Summary:

http://localhost/cgi-bin/cognos.cgi?b_action=cognosViewer&ui.
action=run&ui.object=/content/folder
[@name='Samples']/folder
[@name='Models']/package
[@name='GO DataWarehouse (analysis)']/folder
[@name='Report Studio Report Samples']/report
[@name='EmployeeSatisfaction 2006']

The following script performs the same function using the cognosLaunch method in an enabled Web page:

cognosLaunch('ui.gateway','http://localhost/ibmcognos
/cgi-bin/cognos.cgi','ui.tool','CognosViewer','ui.
action','run','ui.object','/content/folder
[@name=\'Samples\']/folder[@name=\'Models\']/package
[@name=\'GO DataWarehouse (analysis)\']/folder
[@name=\'Report Studio Report Samples\']/report
[@name=\'EmployeeSatisfaction 2006\']'

The following topics describe each of the parameters used in this example, and examples of some other commonly used parameters.