Run an Agent

You can run the agent manually at any time if you want to check for occurrences of specified events and perform specified tasks if those events occur.

Usually, agents run automatically according to the schedule specified by the agent author. But you may want to run an agent manually in certain circumstances. For example, an agent is created to send an e-mail to sales staff when they reach 75 percent of their sales quota for the month. The agent prompts for the sales region. A sales manager specifies Spain, and e-mails are sent only to sales staff in Spain.

Before you begin

You must have execute permission to run an agent. You must have traverse permissions for the folder that contains the agent.

Procedure

  1. In IBM® Cognos® Connection, click the run with options button Run with options icon on the actions toolbar next to the agent you want to run.
  2. Under Time, click Now to run the agent now or click Later to specify a later date and time.
  3. If you want the agent to prompt for values to filter the results it retrieves, under Prompt Values, select the Prompt for values check box.
  4. Click Run.

    The confirmation page appears.

    You are prompted for values if the agent specification or model includes prompts or if you have access to multiple data source connections or signons.

  5. To view the run history of the agent, select View the details of this agent after closing this dialog.
  6. Click OK.

    The options override the default agent options for the current run only.

Parent topic: Agents