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:
- <fetchURL>?fetchIDParameter=[messageID]&fetchStatusParameter=[status]
The retrieve URL configuration items are:
- fetchURL
- URL from which this store retrieves events. For this adapter:
- fetchURL = {IBM servlet location}/getEventXML
- 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>?updateIDParameter=[messageID]&updateStatusParameter=[status]
- updateURL
- URL that allows updating of events in the store. For this
adapter:
- updateURL = {IBM servlet location}/setStatus
- 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>?deleteIDParameter=[messageID]
- deleteURL
- URL that supports deletion of events from the store. For this
adapter:
- deleteURL = {IBM servlet location}/removeEvent
- 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:
- Edit the configuration file
- Find the line:
<param name="pollinterval" value="10000" />
- Change the value to the value suitable to your application.
- Save the configuration file.
- 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.
