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 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 Mro.

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 Mro folder.
  4. Expand the Connectors folder.
  5. Double-click MroConnector::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 Mro.
  13. Expand senders.
  14. Expand Sender.
  15. Expand parameters.
  16. Specify the values for the properties listed in Table 4 as appropriate.
  17. Expand receivers.
  18. Expand Receivers.
  19. Expand parameters.
  20. Specify the values for the properties listed in Table 4 as appropriate.

    Table 4. Connector-specific configuration properties for Maximo MEA MQ transport

    Property / Parameter Description Value Default value
    hostname The host name of the MQ queue manager.
    localhost
    port The port of the queue manager listener.
    1414
    channel The channel used for communications with the queue manager.
    CHANNEL1
    queue The name of the queue or the queue URI.
    queue:///MROTESTOUT (sender) or queue:///MROTESTIN (receiver)
    pollinterval The interval with which to check the queue for new messages (in milliseconds).

    Receivers only


    10000
    locationOfObjectType An XPath statement describing the location of business object type within the XML.

    Receivers only


    //DATAAREA/*
    qmanager The name of the queue manager.
    .queue.manager
  21. Expand eventstore.
  22. Expand parameters.
  23. For the eventDir property, specify the directory in which event store is located. This argument can be relative or fully qualified.
  24. For the archive property, specify the full path name to the directory in which the archive store is located. Set this argument to null or omit it to not implement archival.
  25. Expand logicmodules.
  26. Expand TranslationManager.
  27. 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 5.

    Note:
    If you change any of the values, the value you specify must begin with a non-numeric character.

    Table 5. Connector-specific configuration properties for adapter for Mro 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
    MRO Used to configure routing path.
    CW
    CW Used to configure routing path. This value must match the routing paths. MRO
  28. 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.
  29. After making the changes, click File->Save-> To Project.
  30. Exit the Connector Configurator.

Copyright IBM Corp. 1997, 2003