IBM Cognos Sample Programs

QueryServiceUI.java - Perform Query Service operations.

The Java QueryServiceUI sample program allows the user to perform various operations on a ROLAP cube.

Dependent Files

Associated files are contained under the java sample folder.
Additional files required for running are identified in the CLASSPATH definitions in run.bat or run.sh file.

How To Run The Sample Program

Double click on the file run.bat for WINDOWS or run.sh for UNIX.

A window will be opened containing:
    - Cube dropdown box with a list of available cubes
    - Query Service options dropdown box
    - Run Option command button
    - Server URL text box
    - Output Pane

Select a cube and a Query Service option, then click on the 'Run Option' button to run the sample program.

Expected Results

The 'Get Cube State' option will display the current cube state.
The 'Start Cube' option will send a request to start the cube.
The 'Stop Cube When Not In Use' option will send a request to stop the cube as soon as it is not in use.
The 'Stop Cube Immediately' option will send a request to stop the cube whether it is in use or not.
The 'Restart Cube' option will send a request to restart the cube.
The 'Refresh Data Cache' option will send a request to refresh the data cache for the cube.
The 'Refresh Member Cache' option will send a request to refresh the member cache for the cube.
The 'Refresh Cube Security' option will send a request to refesh the cube security.

Documentation

The IBM Cognos Software Development Kit Developer Guide contains additional information about the samples. See the chapter titled 'Methods' and the appendix titled 'Code Samples and Language-Specific Coding Practices'.

Please note that the samples are not intended to be treated as end-user applications. Refer to the sample code for examples of how to use the API when developing your own applications.