Using the Agent Editor to modify the agent

Edit online

Use the Agent Editor to change, save, and commit a version of your agent.

You can create a new agent in Agent Builder; for more information, see Creating an agent. After creating an agent, you can modify it using the Agent Editor.

To open an agent that you created in Agent Builder in the Agent Editor, in the Project Explorer pane, find the name of the agent and expand it. Under the name of the agent, double-click Agent Definition. Alternatively, double-click the itm_toolkit_agent.xml filename.

The Agent Editor is a multi-page Eclipse editor that you can use to modify the properties of an existing agent. Each page in the editor corresponds to a specific function of the agent.

The list of available pages is shown in the Outline view under the Agent Definition node. You can easily switch to another page by clicking a node in the Outline view. If the Outline view is missing, or hidden behind another view, you can reset the Agent Definition perspective. Reset the perspective by selecting Window > Reset Perspective. Alternatively, right-click the Agent Definition tab and select Reset from the menu.
Note: For detailed information and procedures for creating an agent, see Creating an agent.
The following pages are included in the Agent Editor:
Note: When you view an Editor page, you can also switch to another page by clicking the tab for the page. Some pages show tabs only when they are selected in the Outline view. You can force a page to have a tab even when it is not selected. To force a page to have a tab, click the pin icon so that the pin in the icon points toward the page.

Agent Information page

The Agent Information page is the main page of the Agent Editor.

The Agent Information page contains the following information:
  • General agent information, including the agent service name and the product code. You can click Advanced to set different names for different use, but this setting is normally not needed.
  • Agent Content information
    • Default Operating Systems link
    • Self-Describing Agent link
    • Environment Variables link
    • Watchdog Information link
    • Cognos Information link
    • Data sources link
    • Runtime Configuration link
    • Resources link
    • Dashboards link
  • Test Agent link
  • Generate Agent Wizard link
  • Commit Agent Version link

Configuring the time for transient error messages

Agent Editor wizards sometimes display transient error messages. A message is displayed for a short time (by default, 3 seconds) in the header of the wizard. You can configure the duration for which these messages are displayed. To change this setting:

  1. Select Window > Preferences from the Agent Builder menu bar. The Preferences window opens.
  2. Select Agent Builder.
  3. Set the Time (seconds) that transient error message are displayed setting.
  4. Click OK.