Defining jobs by using the Dynamic Workload Console

You can define HCL Workload Automation jobs to run IBM Cognos reports by using the Dynamic Workload Console.

1. In the console navigation tree, expand Administration > Workload Design and click Manage Workload Definitions.
2. Select an engine and click Go. The Workload Designer opens.
3. In the Working List panel, select:

   On z/OS egnine:

   New > Business Analytics > Cognos

   On a distributed engine:

   New > Job Definition > Business Analytics > Cognos

   The properties of the job are displayed in the right-hand panel for editing.
4. In the properties panel, specify the attributes for the job definition you are creating. You can find detailed information about all the attributes in the help available with the panel. In particular:

   In the General panel:

   

   Environment:

   Enter the name of the HCL Workload Automation job that runs the IBM Cognos report.

   Enter the name of the workstation where you installed the HCL Workload Automation agent.

   

   Environment:

   Enter the name of the partitioned data set where you want to create the JCL.

   Enter the name of the JCL you want to create in the partitioned data set.

   Enter the name of the workstation where you installed the HCL Workload Automation agent.

   In the Cognos panel:

   In the Credentials section:

   Enter the namespace and the credentials related to the IBM Cognos report. If you do not want to specify them here, you can define them in the CognosJobExecutor.properties file. In this case HCL Workload Automation reads them from the .properties file when you retrieve any information by using a list or when you submit the job.

   You do not need to specify this value if you set the true value for the Allow anonymous access? property in the IBM Cognos Configuration > Local Configuration > Security > Authentication > Cognos window.

   In the Server connection section:

   Enter the host name or TCP/IP address and the port of the IBM Cognos server you want to connect to. If you do not want to specify them here, you can define them in the CognosJobExecutor.properties file.

   Select Use SSL connection security to communicate in SSL with the IBM Cognos server. If you do not select it the communication is HTTP.

   In the Report section:

   Enter the path to the report you want to run, the fully qualified path where you want to save the report, the format in which you want to generate the report and parameters if required for the report.

   The path must exist and you must have the permission to write in it otherwise you receive an error message.

   When you specify parameters that can have multiple values, use -Value: as separator. For example, you can write as follows:

   Rome-Value:Paris

   Parameters of type date, time, and time stamp, must be specified using a specific syntax. See Specifying the parameter format for date, time, and time stamp.

   Values for parameters that require parameterized filters must be specified using the procedure described in Specifying parameterized filters.

   In the Delivery options panel:

   Use this panel to define the options to specify the delivery options for the IBM Cognos report. If you did not insert a value in the Output file field you must enter at least an email address.

5. Click Save to save the job definition in the database.