Connector configuration properties

You must configure the connector's standard and connector-specific connector configuration properties before you can run it. To configure connector properties, use Connector Configurator, which you access from System Manager. As you enter configuration values, they are saved in the repository.

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.

Table 2 provides information specific to this connector about configuration properties in the appendix.

Table 2. Property information specific to this connector

Property Note
AgentConnections Because this connector is single-threaded, do not change the default value of this property.
CharacterEncoding The connector uses this property to specify native encoding.
Locale Because this connector has been internationalized, you can change the value of this property. See release notes for the connector to determine currently supported locales.
Important:
WebSphere MQ Integrator Broker does not support multiple locales. Ensure that every component of your installation (for example, all adapters, applications, and the integration broker itself), are set to the same locale.
Note:
Because this connector supports all integration brokers, configuration properties for all brokers are relevant to it.

Connector-specific properties

Connector-specific configuration properties provide information needed by the connector at runtime. Connector-specific properties also provide a way of changing static information or logic within the connector without having to recode and rebuild the agent.

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

Table 3. Quick reference to Siebel-specific connector properties

Name Possible values Default
ApplicationPassword
CWCONN.
ApplicationUserName
CWCONN.
ConnectorId

SiebelConfigFile
siebeljpn.cfg.
SiebelDirectory
\sea\\client\\bin
Transactional true or false true
UseDefaults true or false false.
ViewMode 1 (Sales Rep)2 (Manager)3 (All)4 (Personal) 3 (All)
ConnectErrors
An Oracle database error has occurred. Possibly the database name is invalid. This is the message displayed when the connection terminates in Siebel 99.5.
RefreshLogonCycle

RestartConnectorCycle

ApplicationPassword

The Password for the user account in the Siebel application.

ApplicationUserName

Name of user account in Siebel.

ConnectorId

If multiple connectors have been configured, identifies the connector used to process particular Siebel events. The value must be an integer.

SiebelConfigFile

The Name of the Siebel configuration file.

SiebelDirectory

For Siebel COM support, the directory and filename of the Siebel configuration file must be known. It is typically the client installation directory.

Transactional

If Transactional is set to true, business objects with nomvl=1 are not processed on Request, Update, Create, or Delete operations. If Transactional is set to false, all events are processed, but there is no transactional support on objects with nomvl=1 in CWSiebelConn.

If the Transactional property is set to false, it may be necessary to set the Cascade Delete property in Siebel. Cascade Delete is an optional value in Siebel. The Cascade Delete property indicates what action to perform on detail business component records of the link if the master business component is deleted. See the Siebel Tools Guide for more information.

UseDefaults

On a Create operation, if UseDefaults is set to true or not set, the connector checks whether a valid value or a default value is provided for each required business object attribute. If a value is provided, the Create succeeds; otherwise, it fails.

If this property is set to false, the connector checks only for value valid values; the Create operation fails if valid values are not provided.

ViewMode

Sets the visibility level in the system. For example, 0=SalesRep, 1=Manager. See the object interfaces reference in the Siebel documentation for a complete value set.

ConnectErrors

If this value is set in the connector properties, the connector terminates whenever the specified error message is displayed in the Siebel log. This is used to stop the connector based on the error message. Multiple messages can be specified in this field. Separate the messages using colon ":" delimiters.

The text should contain a section of the error message after the string "Text:".

Attention: Use caution when creating the value as the connector will terminate when a matching string is encountered in the Siebel connector log.

The default message value is: An Oracle database error has occurred. Possibly the database name is invalid. This is the message displayed when the connection terminates in Siebel 99.5.

Note:
The connector no longer supports the MaxEvents configuration property. Setting a maximum number of events to poll is supported at the business object level rather than the connector level. For information on setting the number of events to poll, see Processing multiple events per poll

RefreshLogonCycle

This property indicates the number of requests the connector processes before the agent is disconnected and restarted.

RestartConnectorCycle

If this value is set, the connector will terminate completely in the first poll call after the specified number of objects have been processed. The difference between this property and RefreshLogonCycle is that RefreshLogonCycle only disconnects the agent from the Siebel API.

Copyright IBM Corp. 1997, 2004