IBM WebSphere Business Integration Adapter Network Card User Manual


 
Appendix B. Connector Configurator
Before you can use a connector, you must create a connector configuration file that
sets the properties for the connector, designates the business objects and any
meta-objects that it supports, and sets logging and tracing values that the
connector will use at runtime. The configuration file may also contain properties
for the use of messaging and data handlers required by your connector.
Use Connector Configurator to create and modify the configuration file for your
connector. If a configuration file has previously been created for your connector,
you can use Connector Configurator to open the file and modify its settings. If no
configuration file has yet been created for your connector, you can use Connector
Configurator to both create the file and set its properties.
When you complete a connector configuration file, the file is saved as an XML
document. You will save the XML document either as a project in System Manager
(if ICS is your broker) or as a file with a *.cfg extension in a directory folder (if
WebSphere MQ Integrator Broker is your broker, or if you are using the file as a
local configuration file for ICS).
This appendix describes how to use Connector Configurator to:
v Create a connector-specific property template for configuring your connector
v Create a configuration file
v Set properties in a configuration file
Connector Configurator runs only in a Windows environment. If you are running
the connector itself in a UNIX environment, use Connector Configurator in the
Windows system in the network to modify the configuration file. Then copy the
file to your UNIX environment.
Note: Some properties in the connector configuration file use directory paths, and
these paths default to the Windows convention for directory paths. If you
use the connector configuration file in a UNIX environment, revise any
directory path constructs in the configuration properties to match the UNIX
convention for directory paths.
Using Connector Configurator in an internationalized environment
Connector Configurator is internationalized and handles character conversion
between the configuration file and the integration broker. Connector Configurator
uses native encoding. When it writes to the configuration file, it uses UTF-8
encoding.
Connector Configurator supports non-English characters in:
v All value fields
v Log file and trace file path (specified in the Trace/Log files tab)
The drop list for the CharacterEncoding and Locale standard configuration
properties displays only a subset of supported values. To add other values to the
drop list, you must manually modify the \Data\Std\stdConnProps.xml file in the
product directory.
© Copyright IBM Corp. 2002, 2003 55