IBM Cognos Sample Programs

cancel.sln - Cancels a running report.

The C# Cancel sample contains methods to cancel an executing report.


Dependent Files

All associated files are contained in the bin directory of the csharp directory.

How To Run The Sample Program

Double click on the file ../bin/cancel.exe.

A window will be opened containing:
    - Cancel command button
    - URL text box
    - Report Path and Name input boxes
    - Results Display Window
Click on the 'Cancel' button to run the sample program.

Expected Results

The report identified in the report path and name text box will begin to execute. The cancel method is then invoked and will prevent the report from being saved in IBM Cognos Connection.
Note: A report, such as a simple list report, may complete execution prior to the cancel method being called. If this occurs, the report will be saved.

This sample does not demonstrate working with parameters or prompts. Select a report that does not prompt for parameter values.

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.