Connector configuration

Connectors have two types of configuration properties: standard configuration properties and connector-specific configuration properties. You must set the values of some of these properties before running the connector.

A connector obtains its configuration values at startup. During a run-time session, you may want to change the values of one or more connector properties. Changes to some connector configuration properties, such as AgentTraceLevel, take effect immediately. Changes to other connector properties require component restart or system restart after a change. To determine whether a property is dynamic (taking effect immediately) or static (requiring either connector component restart or system restart), refer to your integration broker's administration utility. For instance, if you are using WebSphere InterChange Server, see the Update Method column in the Connector Properties window of the System Manager.

If you are using WebSphere MQ Integrator Broker as the integration broker, you configure connector properties from the Connector Configurator. If you are using WebSphere InterChange Server as the integration broker, you configure connector properties from Connector Designer, which you access from System Manager.

Standard connector properties

Standard configuration properties provide information that all connectors use. See Appendix A, Standard configuration properties for connectors for documentation of these properties.

Important:
Because this connector supports all integration brokers, configuration properties for al brokers are relevant to it.
Note:
Because this connector is single threaded, it cannot take advantage of the AgentConnections property.

Adapter-specific properties

Adapter-specific configuration properties provide information needed by the connector at run time. Adapter-specific properties also provide a way of changing static information or logic within the connector agent without having to re-code and rebuild the agent.

Table 3 lists the adapter-specific configuration properties for the connector. See the sections that follow for explanations of the properties.

Table 3. Adapter-specific configuration properties

Name Possible values Default value Required
ArchiveProcessed true/false
true

ArchiveTableName Name of archive table
xworlds_archive_events

DatabaseURL
metasolv:weblogic:oci:metasolv
No default value Yes
EventDBBrand JDBC driver database type Oracle
EventDBPassword Event database password asap Yes
EventDBUsername Login to event database username asap Yes
EventTableName Name of event table xworlds_events
JDBCDriverClass Specifies the class name of the driver weblogic.jdbc.oci.Driver No default value Yes
MaxEvents Number of events per poll 25
MSLVPassword MetaSolv server password asap
MSLVUserName Username for MetaSolv server asap No
ORB.<property name> The ORB vendor specific properties that would be used by the connector to initialize the ORB. com.inprise.vbroker.orb.ORB Yes
Module-[PSR | LSR | DLR]-IOR Name of the MetaSolv server IOR file. None Yes
Module-[PSR | LSR | DLR] PSR, LSR, DLR None Yes
Module-[PSR | LSR | DLR]-Manager MetaSolv.CORBA.WDI[PSR | LSR | DLR].WDIManager None Yes
Module-[PSR | LSR | DLR]-Session MetaSolv.CORBA.WDI[PSR | LSR | DLR].[PSR | LSR | DLR]Session None Yes
Module-[PSR | LSR | DLR]-Root MetaSolv.CORBA.WDI[PSR | LSR | DLR].WDIRoot. None Yes
Module- [PSR | LSR | DLR]-Impl com.crossworlds.connectors.
MetaSolv.WDINotificationImpl
None Yes
Module- [PSR | LSR | DLR]-POA MetaSolv.CORBA.
WDI[[PSR | LSR | DLR].WDINotification
None Yes
Module-[PSR | LSR | DLR]-StartMeth start[PSR | LSR | DLR]Session None Yes
Module-[PSR | LSR | DLR]-StopMeth destroy[PSR | LSR | DLR]Session None Yes

Note:
For the Module- configuration properties, each set may be implemented with either PSR, LSR, or DLR.

ArchiveProcessed

Specifies whether the connector archives events for which there are no current subscriptions. Set this property to true to cause events to be inserted into the archive table after they are deleted from the event table.

ArchiveTableName

Name of the archive table. The default value is xworlds_archive_events.

DatabaseURL

URL String for accessing the WebSphere business-integration system's database. There is no default value. URL should follow the Oracle thin driver's format as the default driver is Oracle thin driver.

EventDBBrand

Database type for the JDBC Driver. The default value is Oracle.

EventDBPassword

Password for the login into the event table database. The default value is asap.

EventDBUsername

User name for the login into the event table database. The default value is asap.

EventTableName

Name of event queue table. The default value is xworlds_events.

JDBCDriverClass

Class name of the JDBC driver. Use to connect to the database where event and archive tables reside.

MaxEvents

Maximum number of event processes during one poll. The default value is 25.

MSLVPassword

Password for the login into the MetaSolv server. The default value is asap.

MSLVUserName

Username for the login into the MetaSolv server. The default value is asap.

ORB.<property name>

The ORB vendor specific properties that would be used by the connector to initialize the ORB. E.g. the property org.omg.CORBA .ORBClass would be named as "ORB. org.omg.CORBA.ORBClass". The number and names of such properties would depend on the ORB specific vendor. All the properties that start with "ORB." will be treated by the connector as orb properties and would be used in ORB initialization.

Module-[PSR | LSR | DLR]-IOR

The name of the MetaSolv server IOR file. The API uses IOR files to route events to/from the MetaSolv application.

Module-[PSR | LSR | DLR]

The specific instance of the module. The module name has to be prefixed with Module-

Module-[PSR | LSR | DLR]-Manager

The name of the manager class for the module.

Module-[PSR | LSR | DLR]-Session

The name of the session class for the module.

Module-[PSR | LSR | DLR]-Root

The name of the root class for the module.

Module- [PSR | LSR | DLR]-Impl

The name of the WDINotificationImpl class for the module.

Module- [PSR | LSR | DLR]-POA

The name of the class which is implemented by WDINotificationImpl class.

Module-[PSR | LSR | DLR]-StartMeth

The name of the method that starts a session in a module.

Module-[PSR | LSR | DLR]-StopMeth

The name of the method that stops a session in a module.

Copyright IBM Corp. 1997, 2004