- Note:
- When you create an additional instance of this adapter (or any adapter that
is supplied with WebSphere Business Integration Server Express or Express
Plus), that instance of the adapter is counted as a separate adapter by the
licensing function that limits the total number of adapters that can be
deployed.
You can set your system up to create and run multiple instances of a
connector by following the steps below. You must:
- Create a new directory for the connector instance
- Make sure you have the requisite business object definitions
- Create a new connector definition file
- Create a new start-up script
You must create a connector directory for each connector instance.
This connector directory should be named:
ProductDir\connectors\connectorInstance
where connectorInstance uniquely identifies the
connector instance.
If the connector has any connector-specific meta-objects, you must create a
meta-object for the connector instance. If you save the meta-object as
a file, create this directory and store the file here:
ProductDir\repository\connectorInstance
If the business object definitions for each connector instance do not
already exist within the project, you must create them.
- If you need to modify business object definitions that are associated with
the initial connector, copy the appropriate files and use Business Object
Designer Express to import them. You can copy any of the files for the
initial connector. Just rename them if you make changes to them.
- Files for the initial connector should reside in the following
directory:
ProductDir\repository\initialConnectorInstance
Any additional files you create should be in the appropriate
connectorInstance subdirectory of
ProductDir\repository.
You create a configuration file (connector definition) for the connector
instance in Connector Configurator Express. To do so:
- Copy the initial connector's configuration file (connector definition)
and rename it.
- Make sure each connector instance correctly lists its supported business
objects (and any associated meta-objects).
- Customize any connector properties as appropriate.
To create a start-up script:
- Copy the initial connector's start-up script and name it to include
the name of the connector directory:
dirname
- Put this start-up script in the connector directory you created in Create a new directory.
- (For Windows only.) Create a start-up script shortcut.
- (For Windows only.) Copy the initial connector's shortcut text
and change the name of the initial connector (in the command line) to match
the name of the new connector instance.
- (For OS/400 only.) Create a job description for the connector using
the information below:
CRTDUPOBJ OBJ(QWBIEMAILC) FROMLIB(QWBISVR43) OBJTYPE(*JOBD) TOLIB(QWBISVR43)
NEWOBJ(newconnname) where newconnname is a 10-character
name that you use for the job description for your new connector
- (For OS/400 only.) Add the new connector to the WebSphere Business
Integration Console. For information about the WebSphere Business
Integration Console, refer to the online help provided with the
Console.
You can now run both instances of the connector on your integration server
at the same time.
