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

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 CES folder.
  4. Expand the Connectors folder.
  5. Double-click CESConnector::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
    IDL (the default transport method)
    JMS
  9. If JMS is the transport method, you must define the values for the following standard connector properties:

    Refer to Appendix A, Standard configuration properties for connectors for descriptions of these properties.

    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.

  10. Click the Connector-Specific Properties tab.
  11. Click to expand wbiadapter.
  12. Click to expand transports.
  13. Expand CES.
  14. Expand senders.
  15. Expand cesSender.
  16. Expand parameters.
  17. Specify the values for the properties listed in Table 4 and Table 5 as appropriate.

    The following properties are required:

    Note:
    These properties apply to the JMS transport.

    Table 4. Connector-specific configuration properties for CES Centricity Gateway MQ transport

    Property / Parameter Description Value Default value
    locationOfObjectType An XPath statement describing the location of business object type within the XML.

    XMLReceiver only.


    N/A
    hostname The host name of the MQ queue manager.
    N/A
    port The port of the queue manager listener.
    1414
    channel The channel used for communications with the queue manager.
    None
    qmanager The name of the queue manager.
    N/A
    queue The name of the queue or the queue URI.
    N/A
    pollinterval The interval with which to check the queue for new messages (in milliseconds).

    XMLReceiver only.


    10000
    extraintegrity Determines the method with which the receiver gets messages off the queue. If this parameter is true, then the receiver peeks at the queue and only removes the message once it has been successfully added to the event store for processing by the adapter core. This ensures persistence throughout the adapter but suffers a minor performance penalty. If this parameter is set to false, then messages are removed from the queue upon receipt, but may be lost if the adapter fails before the event was added to the event store.

    XMLReceiver only.


    True
    expectReplyOnVerb The verb for which to expect a synchronous reply. This causes the sender to make an entry in its correlation table between the message ID and the broker ID. The sender then waits until the receiver has processed a message whose correlation ID matches the message ID entry within the correlation table. The results are then sent to the broker and the service call completed. Multiple verbs can be specified by separating each verb with a comma.

    XMLSender only.


    N/A
    replyTimeout The time to wait, in milliseconds, before giving up while waiting on a reply. This returns an APPRESPONSE_TIMEOUT to the broker.

    XMLSender only.


    30000

    Table 5. Connector-specific configuration properties for CES Centricity Gateway JMS transport

    Property / Parameter Description Value Default value
    locationOfObjectType An XPath statement describing the location of business object type within the XML.

    XMLReceiver only.


    N/A
    PROVIDERL_URL The URL of the JNDI provider.
    N/A
    INITIAL_CONTEXT_FACTORY The JNDI initial context factory class.
    N/A
    SECURITY_PROTOCOL The JNDI security protocol to use.
    N/A
    SECURITY_PRINCIPAL The JNDI security principal.
    N/A
    SECURITY_CREDENTIALS The JNDI security credentials.
    N/A
    queueConnectionFactory The queue connection factory JNDI name.
    N/A
    queue The queue JNDI name.
    N/A
    expectReplyOnVerb The verb for which to expect a synchronous reply. This causes the sender to make an entry in its correlation table between the message ID and the broker ID. The sender then waits until the receiver has processed a message whose correlation ID matches the message ID entry within the correlation table. The results are then sent to the broker and the service call completed. Multiple verbs can be specified by separating each verb with a comma.

    XMLSender only.


    N/A
    replyTimeout The time to wait, in milliseconds, before giving up while waiting on a reply. This returns an APPRESPONSE_TIMEOUT to the broker.

    XMLSender only.


    30000
  18. Expand receivers.
  19. Expand cesReceiver.
  20. Expand parameters.
  21. Specify the values for the properties listed in Table 4 and Table 5 as appropriate.

    The following properties are required:

    Note:
    These properties apply to the JMS transport.
  22. Expand logicmodules.
  23. Expand TranslationManager.
  24. 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 6.

    Table 6. Connector-specific configuration properties for adapter for CES Centricity Gateway logic module

    Property / Parameter Description Value Default value
    schemaConfig Used internally for configuring the adapter translation component. 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
    CES Used to configure routing path.
    CW
    CW Used to configure routing path. This value must match the routing paths. CES
  25. 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.
  26. After making the changes, click File->Save-> To Project.
  27. Exit the Connector Configurator.

Copyright IBM Corp. 1997, 2003