WebSphere brand IBM WebSphere Premises Server, Version 6.1.x

Adding and configuring a new agent and PIDs

This topic describes how to add a new agent and configure a persistent ID (PID) using the WebSphere® Premises Server Administrative Console.

About this task
To define an agent, enter the agent name, a description of the agent, and indicate the agent type. A new agent can the following agent types: ControllerType, DeviceType, LocationType, or TaskAgentType. After adding an agent, you define properties for PIDs associated with the agent. For information about PIDs, refer to Understanding PIDs and factory PIDs.
Procedure
  1. Open the WebSphere Premises Server Administrative Console. The Welcome page displays.
  2. In the left navigation panel, navigate to Data Capture Configuration > Agent Configuration. The Agent Configuration panel displays.
  3. Click Create Agent. The New Agent panel displays.
  4. Enter a descriptive name for this agent.
  5. In the Agent Type field, select the type of agent from the list.
  6. Enter a unique description of the agent.
  7. Click Add PIDs to the Agent.
    Note: For TaskAgents, the PID should match the Java™ package name of the agent, and you are not allowed to define Factory PIDs or multiple PIDs as part of the agent. For SystemAgent, you are not allowed to define additional PIDs.
    The Add Agent Properties panel is displayed with the new agent name and description. Use this panel to add properties to PIDs and PIDs to bundles.
  8. In the PID field, enter the PID to which you are adding properties. If this PID is a factory PID, click the check box to select it. For an explanation of PIDs and factory PIDs, refer to Understanding PIDs and factory PIDs.
  9. Enter the bundle name and bundle version to which you are associating the PID. This field is optional.
  10. Enter the property information as follows:
    1. Enter the property name.
    2. Enter a value for this property.
    3. Enter a brief description of this property.
    4. Select the type of property from the list.
    5. Select the cardinality value from the list.
    6. Indicate whether the property is required. Select true to indicate that the property is required and false to indicate that it is not required.
    7. Indicate whether to include the property in the XML configuration file. Select true to include the property, even if it is not required, and false to not include it. This property is used by the Data Capture and Delivery configuration servlet that generates the XML configuration file that is sent to the Data Capture and Delivery component.
    8. To display a new line to add another property, click Add Property.
  11. When you finish adding properties to a PID, click Save. The New Agent panel displays with the PID and properties that you entered.
  12. To add another PID to this agent, repeat steps 7 through 11 above or click Cancel.
  13. On the New Agent panel, when you finish adding PIDs to the agent, click Done.

Library | Support | Terms of use

(c) Copyright IBM Corporation 2004, 2008. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.