Cognos Reporting Task

This task allows the user to create a Cognos® job that will automatically run one or more of the Common Services or Digital Payments Cognos sample reports.

Create multiple configurations of this task to:
  • Run different reports
  • Run the same report with different parameters
Note: The reports should be available in Cognos Content Manager before they can be executed using this task.
The Cognos reporting task:
  1. Opens connections to the Cognos content manager service, the Cognos report service, and the Cognos event management service. The connection details are specified in the task configuration for the task.
  2. Sends the login credentials to all of these services. The task exits with an error if it cannot log on to the services.
  3. Creates a Cognos job. The name of job is based on the task configuration name. The job is added to the content store at same location as the report.
  4. Creates report views for each report to be executed. The name of each report view that is created is based on the file name pattern that is defined in the task configuration for the task. The report view is saved at the location that is specified in the task configuration for the task. Additional options from the task configuration parameters, such as report parameters and whether to save the report output, are added to the report view.
  5. Adds one or more steps to the job. Each step executes a report view with its options, so one step is added for each of the report views that were created in step 4.
  6. Sets default options, such as the output format, for the entire job.
  7. Creates a schedule for running the job so that the task does not need to wait for Cognos to execute the reports. By default, the job is scheduled to run at the current time plus five seconds.
  8. The task exits.
The status of the jobs running reports can be monitored using the IBM® Cognos Connection user interface.
The following steps are necessary to implement this task using Services Framework:
  1. Register the Cognos reporting task.
  2. Create one or more configurations of the Cognos reporting task.
    1. Set the appropriate configuration parameters for the report being run by this Cognos reporting task configuration.
  3. Manually run the different Cognos reporting task configurations or schedule the configurations to run as required.