Configuring the adapter

The connector component of the adapter has two types of configuration properties: standard configuration properties, which apply to most adapters, and connector-specific configuration properties, which apply only to your adapter and provide a way for you to change static information or logic within the connector without having to recode and rebuild it. A connector obtains its configuration values at startup. You must set the values of these properties before running the connector.

To configure connector properties, use the Connector Configurator tool. Details are given in Appendix B, "Connector Configurator". This tool provides a graphical user interface for configuring the connector.

When you have finished specifying values for the connector's configuration properties, Connector Configurator saves the values in the adapter repository (for ICS) or generates a configuration file and places it in the adapter's local repository (for WebSphere MQ Integrator Broker and WebSphere Application Server).

Specifying properties

In this section, the steps required to specify properties are described. The project name for the folder used in these procedures is ESRI.

To specify properties, start the WebSphere Business Integration System Manager and do the following steps:

  1. Expand the User Projects folder.
  2. Expand InterChange Server Projects.
  3. Expand the ESRI folder.
  4. Expand the Connectors folder.
  5. Double-click ESRIConnector::wbieuicl.
  6. Click the Standard Properties tab to add or modify configuration properties.
  7. Specify the AgentTraceLevel for the adapter. Selecting the value 5 generates detailed trace level; zero (0) generates no trace information.
  8. Your application information might inform you which of the following transports to select for the DeliveryTransport property. The examples in this guide assume MQ:
    MQ (the default transport method)
    IDL
    JMS

    Accept the defaults for the remainder of the configuration for standard properties.

    In the next few steps, you define the connector-specific properties for the transport.

  9. Click the Connector-Specific Properties tab.
  10. Click to expand wbiadapter.
  11. Click to expand transports.
  12. Expand ESRI.
  13. Expand senders.
  14. Expand Sender.
  15. Expand parameters.
  16. Specify the appropriate values for the properties listed in Table 2.

    Table 2. Connector-specific configuration properties for ESRI Spatial Database transport

    Property / Parameter Description Sample Value Default value
    hostname The name of host on which ArcSDE is running. localhost N/A
    port The instance of ArcSDE to connect with. 5151 N/A
    database The database to extract information from. SDE N/A
    username The username to log on with. SDE N/A
    password The password to use when logging on. SDE N/A
    minXExtent The double minx coordinate for SeExtent for SeLayer - Refer to ESRI product documentation for this value. 0.0 N/A
    minYExtent The double minY coordinate for SeExtent for SeLayer - Refer to ESRI product documentation for this value. 0.0 N/A
    maxXExtent The double maxX coordinate for SeExtent for SeLayer - Refer to ESRI product documentation for this value. 10000.0 N/A
    maxYExtent The double maxY coordinate for SeExtent for SeLayer - Refer to ESRI product documentation for this value. 10000.0 N/A
    coordFalseX The double X value for SeCoordinateReference - Refer to ESRI product documentation for this value. 0.0 N/A
    coordFalseY The double Y value for SeCoordinateReference - Refer to ESRI product documentation for this value. 0.0 N/A
    coordXYUnits The double unit value for SeCoordinateReference - Refer to ESRI product documentation for this value. 1000.0 N/A
  17. Expand logicmodules.
  18. Expand TranslationManager.
  19. Expand parameters.

    The adapter uses the XSLT logic module as the primary transformation mechanism for translating between the adapter's XML messages and the WBI XML. Translations between XML formats are direct, there is no chaining. To configure the logic module with properties other than the defaults, specify values for the properties listed in Table 3.

    Table 3. Connector-specific configuration properties for adapter for ESRI Spatial Database logic module

    Property / Parameter Description Value Default value
    schemaConfig Provides translation between application and integration broker data formats. repository_dir\schemaTypes.xml translations \schemaTypes.xml
    repository The xslt subdirectory is specified as the root for name resolution within the repository, versus the top-level translations directory. repository_dir\xslt translations\xslt
    ESRI Used to configure routing path.
    CW
    CW Used to configure routing path. This value must match the routing paths. ESRI
  20. If you selected MQ as the delivery transport in step 8, you must specify the queue manager name:
    1. Click the Messaging tab.
    2. Specify the queue manager name in the Queue Manager field. The default is server.queue.manager.
  21. After making the changes, click File->Save-> To Project.
  22. Exit the Connector Configurator.

Copyright IBM Corp. 1997, 2003