'); $("#tabs").tabs({ selected: 1 }); $("#ic-homepage__ic-tips").append( quickTipHTML() ); unhideOneProductTip(); $("#ic-homepage__product-tips").wrapInner('
'); $("#ic-homepage__feed-tips").wrapInner('
'); });
IBM Tivoli Monitoring > Version 6.3 > User's Guides > Agent Builder User's Guide IBM Tivoli Monitoring, Version 6.3
The Tivoli Monitoring Agent Editor
Use the Tivoli Monitoring Agent Editor to change, save, and commit a version of your agent.
Before you modify an agent, see Prepare your agent for modifications or for regeneration.
The IBM Tivoli Monitoring Agent Editor is a multi-page Eclipse editor that you can use to modify the properties of an existing IBM Tivoli Monitoring 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 beneath the Tivoli Monitoring Agent node. You can 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 Tivoli Monitoring perspective. Reset the perspective by selecting Window > Reset Perspective. Alternatively right-click IBM Tivoli Monitoring and select Reset from the menu.
Figure 1. Choosing Reset from the Tivoli Monitoring perspective.
For detailed information and procedures for creating an agent, see Create a basic agent.
The following pages are included in the Agent Editor:
- Agent Information page
- Data Source Definition page
- Runtime Configuration Information page
- Agent XML Editor page (itm_toolkit_agent.xml)
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 Tivoli Monitoring Agent Editor.
The Agent Information page (Figure 2) contains the following information:
- General agent information
- 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
- Outline View link
- Generate Agent Wizard link
- Commit Agent Version link
Figure 2. Agent Information page
General agent information
This general agent information was entered in the New Agent Wizard when the agent was created.
- Default operating systems
Use the Default Operating Systems page to identify the operating systems for which your agent is built.
- Self-Describing Agent
Use the Self-Describing Agent page to specify whether the agent's support files are bundled with the agent.
- Environment variables
Use the Environment Variables page to view and modify environment variables that are available to your agent while it is running.
- Watchdog information
Use the Watchdog Information page to specify configuration information for the Agent Watchdog
- Cognos information
Use the Cognos Information page to specify the information that is used when a Cognos data model is generated for your agent.
- Generate Agent wizard link
When you finish creating or editing the new agent, use the Generate Agent wizard to prepare the installation.
- Committing a version of the agent
Commit your agent when you are certain you are finished developing this version of the agent and you are ready to deliver it.
- The Data Source Definition page
Use the Data Source Definition page to manipulate data sources.
- Runtime Configuration Information page
The Runtime Configuration Information page displays the values that are defined during configuration.
- Agent XML Editor page
The Agent XML Editor page displays the XML for the IBM Tivoli Monitoring Agent definition.
- Saving your edits and changes
Changes that you make with the editor are not stored until you save them.
- Change a subsequent version of your agent
To save changes to a committed agent, first enter a new version number.
- Change the product code
If you change the product code, you have an agent that is incompatible with any previous version of the agent. Any records of previous commit actions are lost and you are developing a new agent.