Starting Query Studio

You can use a URL to quickly open a specific report in IBM® Cognos® Query Studio.

Use the following mandatory parameters to start Query Studio with the parameterized URL method:

http://localhost/cgi-bin/cognos.cgi?b_action=xts.run&m=
portal/launch.xts&ui.tool=
QueryStudio&ui.object=/content&ui.action=new

Use the following mandatory parameters to start Query Studio with the cognosLaunch method:

cognosLaunch('ui.gateway','http://localhost/ibmcognos/cgi-bin/cognos.cgi','ui.
tool','QueryStudio','ui.action','new')

The ui.action parameter is a mandatory for both methods.

The following parameters are optional for Query Studio:

cv.header
Specifies whether to display the header. Acceptable values are true and false.
ui.spec
Specifies an XML document that contains an IBM Cognos BI report specification. For information about IBM Cognos BI report specifications, see the report specification topics in the IBM Cognos Software Development Kit Developer Guide.
run.outputLocale
Specifies the output language. Acceptable values are expressed as a hyphenated language-region pair, in accordance with the RFC3066 standard. The default value is en-us.
run.prompt
Specifies whether the report service issues prompts, so you can enter report option values. Acceptable values are true and false. The default value is true.
ui.object
Specifies the path of the target object. Acceptable values are the Content Manager search path or store ID. For more information, see Using Search Paths and Page IDs.
ui.folder
Specifies the target folder. Acceptable values are the Content Manager search path or store ID. For more information, see Using Search Paths and Page IDs.
ui.backURL
Specifies the URI to open after you close the selected component.

IBM Cognos Application Firewall validation is enforced on URLs that contain this parameter. For more information see, URL Validation.

Use the following parameters for debugging purposes only:

run.outputFormat
Specifies the output format. Acceptable values are CSV, HTML, PDF, XHTML, XLWA, and XML.
asynch.primaryWaitThreshold
Specifies the maximum amount of time, in seconds, that the server can use to process the request before sending a response to the client. Acceptable values are any integer. Use a value of 0 to make the client wait indefinitely. The default value is 7.
asynch.secondaryWaitThreshold
Specifies the maximum amount of time, in seconds, that the server can use to process the request before sending a response to the client. Acceptable values are any integer. Use a value of 0 to make the client wait indefinitely. The default value is 30.

For a list of all common optional launch parameters for both methods, see Common Optional Parameters.