Editing the configuration file

You must edit several lines in the \ICSdir\connectors\Indus\conf\indus_conf.xml configuration file. You can use any ASCII editor. Make a backup copy of the configuration file before you begin.

Find and modify the following lines. Substitute the default values with the values appropriate to your installation.

HTTP SenderReceiver. There are several configuration properties for the base HTTPSenderReceiver:

sendUrl
This is the URL to which this sender component sends events. This URL must be fully qualified and resolvable over HTTP. This parameter should point to the IndusConnect process servlet.

pollingInterval
Interval in milliseconds that specifies how long to wait before calling the poll() method. The default value is 5000ms (5s). See Setting polling parameters for information about changing the polling interval.

DefaultPollingMethod
Parameter indicating whether to default to GET or POST as the method for accessing URLs. This parameter should be configured to GET or POST as the value. The default is POST.

HTTPTransportEventStore. The configuration parameters for the HTTPTransportEventStore relate to how the system retrieves, updates and deletes events in the store.

useGetMethod
You can configure this boolean parameter to either TRUE or FALSE indicating whether or not to use GET as the method for accessing URLs. Change this value to FALSE in a production environment. The default is TRUE to use POST.

Retrieve URL Parameter. The retrieve URL is used to retrieve events. This URL points to the IBM servlet installed on the IndusConnect host. It is expected to be called as follows:

The retrieve URL configuration items are:

fetchURL
URL from which this store retrieves events. For this adapter:

fetchIDParameter
Parameter name that the remote site uses to identify the event to retrieve. When placed in the URL, the value of this parameter will be the eventID argument passed into the fetchRecords method. For this adapter:
  • fetchIDParameter = eventID

fetchStatusParameter
Parameter name that the event store will use to retrieve events of a set status. When placed in the URL, the value of this parameter will be the status argument passed into the fetchRecords method. For this adapter:
  • fetchStatusParameter = status

Update URL Parameter. The update URL is used to update the status of events and is expected to be called as follows:

updateURL
URL that allows updating of events in the store. For this adapter:

updateIDParameter
Parameter name that the remote site uses to identify the event to update. When placed in the URL, the value of this parameter is the eventID argument passed into the setEventStoreStatus method. For this adapter:
  • updateIDParameter = eventID

updateStatusParameter
Parameter name that the remote site uses to identify the new status of the specified event. When placed in the URL, the value of this parameter is the status argument passed into the setEventStoreStatus method. For this adapter:
  • updateStatusParameter = status

Delete URL Parameter. The delete URL is used to remove events from the remote store and is expected to be called as follows:

deleteURL
URL that supports deletion of events from the store. For this adapter:

deleteIDParameter
Parameter name that the remote site uses to identify the event to delete. When placed in the URL, the value of this parameter is the eventID argument passed into the deleteEvent method. For this adapter:
  • deleteIDParameter = eventID

IndusSenderReceiver

prePollStatus
When polling, this is the status level of events that are searched for. Events of this status are returned in the poll() method. The default value is R.

postPollStatus
When polling, this is the status level that events are set to after polling. All events returned in the poll() method have their status level set to this value. The value of this option must be a single-digit integer.

apifwVersion
The version of APIFW business objects. (for example, V090000). This value is used to construct the DTD and header for process requests.

username
Application (for example, Passport) username that adapter uses when conducting requests. This value must match the apifw.properties apiUsername property. See IndusConnect Framework documentation for this property.

dtdLocation
Location of business object DTD documents on the IndusConnect Framework server. This value is necessary to construct DTD headers for process requests.

environment
Indus PassPort environment name needed for apiFW. IndusConnect Framework application environment (for example, D903). This value is necessary to construct DTD headers for process requests.

FileSystemEventStore. The configuration parameters for this event store are as follows:

eventDir
Directory in which event store is located. This argument can be relative or fully qualified.

archive
Directory in which archive store is located. Set this argument to null or omit to not implement archival

archiveFailureFatal
Boolean indicating whether to return a fatal exception if the system fails to initialize the archive. Default value is false.

deleteOnArchive
Boolean indicating whether to delete an event when requested to archive an event.

IndusEventStore.

postPollStatus
Event status to set after poll. This value is used to indicate when an event has been copied from the HTTP event store to the file system event store. The value of the option should match that specified in the IndusSenderReceiver class and must be a single-digit integer.

successCompletionStatus
Event status to set after the adapter has successfully consumed an event (for example, successfully passed the event on to the integration broker). The value of this option must be a single-digit integer.

errorCompletionStatus
Event status to set after the adapter has failed to consume an event (for example, failure either in logic processing or in sending the event to the integration broker). The value of this option must be a single-digit integer.

Setting polling parameters

You can set parameters for polling intervals. See Troubleshooting and error handling for error messages.

Polling parameters

The polling parameters control how often the IndusConnector polls for business objects to transmit to the Interchange Server. The configuration file, indus_conf.xml contains a value specifying the polling interval. See Appendix C, The IndusConnect Framework Configuration file for a listing of the configuration file. The default value is 10000 milliseconds.

You might poll less often if the application at the other end of the collaboration processes requests in a batch mode. If you set the polling frequency too high, performance might suffer. Aim to balance polling between the applications at both ends of the collaboration.

To modify this parameter, do the following steps:

  1. Edit the configuration file
  2. Find the line:
    				<param name="pollinterval" value="10000" />
        
       
  3. Change the value to the value suitable to your application.
  4. Save the configuration file.
  5. Restart the adapter.

The Connector Configurator also has a polling value. You need not change this value.

Logic modules

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, edit the following XML in the logicmodules section of the adapter configuration profile listed in Appendix C, The IndusConnect Framework Configuration file.

<logicmodule id="TranslationManager"
                class="com.ibm.wbix.adapter.logicmodules.XsltLogicModule">
       <param name="repository" value="repository_dir\xslt"/>
       <param name="schemaConfig" value="repository_dir\schemaTypes.xml"/>
       <param name="IndusConnect Framework" value="CW" />
       <param name="CW" value="IndusConnect Framework" />
   </logicmodule>
    
   

The XSLT subdirectory is specified as the root for name resolution within the repository, as opposed to the top-level translations directory. This is a necessary step for the translation manager to resolve the translation chains correctly. The logic module must be added to any routing paths between the adapter and WBI transports.

Copyright IBM Corp. 1997, 2003