Connector re-use

You can use the information provided here to have detailed understanding on connector re-use and its features.

When a Connector is instantiated, usually it allocates a certain amount of resources to communicate with a particular system (connection objects, session objects, result set, and so forth). When multiple Connectors of the same type are connected to the same system, often it is reasonable to share the underlying resources. This means that a single connection to the given system will be re-used by multiple Connectors.

IBM Security Directory Integrator allows Connector re-use to happen within an AssemblyLine. For a given AssemblyLine you have the option to re-use an already configured Connector from the same AssemblyLine.

With regards to the IBM Security Directory Integrator Server, when re-using a Connector, a single physical Connector object is instantiated and a number of logical Connectors share it.

With regards to configuration, Connector re-using is a master-slave relation: the re-used ("master") Connector has a full connection and parser configuration and all re-using Connectors have references to the master Connector. All re-using Connectors share the connection and parser settings of the Connector they re-use. Although connection and parser settings are fixed for re-using Connectors, certain other features are configured separately (if any parameter is not configured separately, it is inherited from the master Connector): Generally, a Connector can be re-used in the same mode (except for Iterator and Server) without any problem. This means that, for example, you can safely re-use a Connector in Lookup mode as many times as you wish.

A problem can potentially arise when a Connector is re-used in different modes. The shared physical Connector object is initialized and terminated only once. So the Connector's initialization and termination procedure must be common for all supported modes.

Following is a list of IBM Security Directory Integrator Connectors which can be re-used in different modes: Any Connector not in this list can not be re-used in the same AssemblyLine; either because it makes no sense, or because the Connector's internal logic does not allow it.

For configuring a Connector for re-use in an AssemblyLine, refer to Configuring Directory Integrator. In the configured AssemblyLine, the re-used Connectors will show up with their name prepended with '@'.