Defining a Control-M for IBM Cognos job

This procedure describes how to define a Control-M for IBM Cognos job, which enables you to run IBM Cognos jobs and reports on an IBM Cognos server.

Before You Begin

Ensure that you have met the following requirements:

• A configured IBM Cognos connection profile, as described for the Connection profile management.
• Successful completion of Accessing the IBM Cognos job properties pane.

To define a Control-M for IBM Cognos job:

1. From the Connection Profile field, click Load.

   The Connection Profile Selection dialog box appears.

2. Select the connection profile that you want to use to run an IBM Cognos job or report, and click OK.

   The Connection Profile field is set.

3. In the Search Path field, click .
4. Navigate to the job or report that you want to run, and click OK.

   The Location, and Type fields are populated, and the associated fields appear as follows:

   • The steps associated with a job definition appear.
   • The parameters associated a report appear.
5. For each parameter, type a value, as described in Parameter types.
6. Click Cognos - More.
7. In the Output Handling area, do the following:
   1. In the Output Format field, accept the default output format from IBM Cognos or click Edit, and select an output format.

      If you are generating a job, you cannot override the value in the Output formats field.

   2. In the Output Delivery field, click Edit, select one or more of the following report distribution options, and select Enabled:
      • Save Report: Distributes the report to a IBM Cognos server in the default location, or you can select the As a report view option and click Browse to specify a different location on the IBM Cognos server
      • File System: Specifies the name and location of the report on the file system and the action to take when saving a file that already exists

        To use the File System option, verify that the Archive Location File System Root is defined on the IBM Cognos Server Global Configuration, and the File System Locations were defined.

      • Email Recipients: Specifies the recipients and contents of the email.

        If you are running a IBM Cognos job definition, you cannot override the value in the Output delivery field.

   Control-M for IBM Cognos uses IBM Cognos Run History to monitor the Control-M for IBM Cognos jobs. Ensure that the Number of occurrences parameter in the Report, ReportView and Job objects is sufficient for the number entities that you are running.

   For more information about defining a job in the properties pane, see Using Control-M Workload Automation.