Siebel Server Sync Guide > Configuring Siebel Server Sync for Microsoft Exchange Server > Modifying Enterprise and Server Component Parameters >

SSSE-Related Siebel Enterprise Server Parameters


Table 12 lists SSSE-related Siebel Enterprise Server parameters. Most of these parameters relate to the PIMSI Engine. If a parameter relates to the PIMSI Dispatcher, this is indicated.

Table 13 lists SSSE-related Siebel Enterprise Server parameters that are applicable only if your SSSE environment implements the DCOM Exchange Connector.

Table 12. SSSE Siebel Enterprise Server Parameters
Parameter Name
Parameter Alias
Comments

Business Service Query Access

BusinessServiceQueryAccessList

The Siebel database and Microsoft Exchange differ in how they store addresses. This parameter specifies the name of the script that is used to combine two Siebel address field values when transmitting address data to Microsoft Exchange, and split one Microsoft Exchange address field value into two values when transmitting address data to the Siebel database. The value for this parameter, SSSE Address Parser (eScript), is set automatically during installation.

Calendar Lock Expire After

CalendarLockExpireAfter

The lock on a calendar record expires after the specified number of seconds. A calendar record is locked whenever it is being updated.

Calendar Lock Sleep Time

CalendarLockSleepTime

Time interval that SSSE waits before checking the calendar lock again.

Dispatcher Abort Limit Low B

Applies to the PIMSI Dispatcher component only.

DispAbortLowBound

When the PIMSI Dispatcher inspects changed records to determine which users the PIMSI Engine must synchronize, if the total number of changed records to inspect is larger than DispAbortLowBound, then the Dispatcher stops inspecting records individually and sets a flag that notifies the PIMSI Engine to search for changed records for all SSSE users. This improves SSSE performance in situations where large numbers of records are changed frequently.

Dispatcher Abort Limit Per Use

Applies to the PIMSI Dispatcher component only.

 

DispAbortLimit

The maximum number of updates that the Dispatcher processes for each dispatch cycle. If there are more changes in the Siebel database than this number, then the Dispatcher stops searching for changes and sends dispatch messages for the users determined so far.

Dispatcher Garbage Collection

Applies to the PIMSI Dispatcher component only.

 

DispGCCycleCount

Determines how many times the Dispatcher runs before information that is no longer required is removed from the S_SD_SYNC_INFO table. The S_SD_SYNC_INFO table stores information about data to synchronize. Using default values, this removal of unnecessary information occurs once an hour, because the Dispatcher job is normally run every five minutes.

Dispatcher Notification Frequency

Applies to the PIMSI Dispatcher component only.

 

DispNotificationFreq

If the PIMSI Dispatcher detects that a PIMSI Engine component is not responding correctly, the Dispatcher signals the Engine to discover whether it can respond. This parameter specifies how many times the Dispatcher requests a response from an unresponsive PIMSI Engine before attempting to recover it.

NOTE:  The PIMSI Dispatcher automatically attempts to recover users' data changes that are being processed on any PIMSI Engine that has failed to respond to the set number of requests. See the Dispatcher log for records of any unresponsive Engines. See the individual Engine logs for information that might help you diagnose why the Engine stopped responding.

Dispatcher Reconciliation Dura

Applies to the PIMSI Dispatcher component only.

 

DispReconciliationDuration

Specifies how many seconds the PIMSI Dispatcher waits after signaling a PIMSI Engine. If the Dispatcher does not receive a response within this time period, the Dispatcher either attempts to recover the Engine or signals it again, depending on whether or not the number of unsuccessful signals has reached the value of the Notification Frequency setting.

Distribution List Query Size

DistributionListQuerySize

When the Siebel Exchange Connector determines the members of a Distribution List, it requests information about one or more batches of members. This setting specifies the maximum number of members in each batch. Maximum valid value is 1500 for Windows 2003. Minimum value is 1.

Enable Inbound Activity Filter

EnableInboundActivityFilter

When set to TRUE for the PIMSI Engine server component, synchronizes calendar and task items that originate in Microsoft Exchange only if the value of the Category field matches a valid Siebel Value for an LOV that has Siebel LIC Type set to TODO_Type.

When this parameter is set to FALSE, SSSE attempts to synchronize all calendar and task items that originate in Microsoft Exchange for each user who has synchronization enabled.

For more information on using this parameter, see:

Extract Start Date Format

ExtractStartDateFormat

Format of the Extract Start Date parameter. Default value is MM/DD/YYYY. SSSE uses the format that you specify in this setting to interpret the value of your ExtractStartDate setting correctly. It is not necessary for this format to match the date format that your Siebel application generally uses. For information on the Extract Start Date parameter, see PIMSI Engine Server Component Parameters.

Force Transcode

ForceTranscode

Forces text conversion to use transcode. Set this parameter to TRUE if your Siebel implementation uses a transcode database type.

Max Alarm Lead Minutes

MaxAlarmLead

Maximum number of minutes for an appointment alarm lead time. The maximum value you can specify is 1440 minutes (1 day).

Max Extract Request Batch Size

Applies to the PIMSI Dispatcher component only.

 

MaxExtReqBatchSize

Maximum number of user extractions that can be requested in one synchronization request. The default value is 10.

For example, if the Max Extract Request Batch Size parameter is set to 10, and if 1000 users have synchronization enabled, the PIMSI Dispatcher creates 100 PIMSI Engine jobs, each containing 10 user extractions. The data for 100 users is synchronized at one time, because each PIMSI Engine processes each user in a job sequentially.

When specifying a value for this parameter, consider the number of users who have synchronization enabled, and the number of jobs that your server can process in parallel without affecting performance. If there are multiple users in a single PIMSI Engine job, data, such as LOVs and system parameters, is queried only once and is shared by the jobs for each user.

Maximum Tasks

MaxTasks

The maximum number of PIMSI Engine jobs that can run simultaneously on a single Siebel Server computer. For more information about this setting, see About Tuning SSSE for Optimal Performance.

The value of the Maximum Tasks parameter determines the total number of users who can be synchronized in parallel. For example, if the Maximum Tasks parameter is set to a value of 50, and the PIMSI engine is installed on three Siebel Server computers in your SSSE environment, then 150 users can be synchronized simultaneously.

Only Sync Categorized Contacts

OnlySyncCategorized
Contacts

Determines whether or not initial extract operations synchronize only Microsoft Exchange contact records that have the Category field set to a specified value—the value that matches the Siebel domain's PIM Category Value setting—or all contact records. Valid values are TRUE and FALSE, case-insensitive. For more information about this parameter, see Initial Extract and Ongoing Extract and Setting PIM Category Values for Siebel Domains.

Preserve Attachments

PreserveAttachments

Indicates whether or not the Exchange Connector preserves PIM attachments for non Calendar domains. (Calendar attachments are automatically preserved.) If this parameter is set to FALSE, attachments are removed when the Exchange Connector updates the record in Microsoft Exchange. This setting does not affect Siebel attachments.

Preserve Unmapped Fields

PreserveFields

Indicates whether or not the Exchange Connector preserves the data for PIM fields which are not mapped for synchronization for non Calendar domains. If this parameter is FALSE, any data in an unmapped field is removed from the record in Microsoft Exchange.

Query External Exchange Domain

QueryExtExDomains

When the Exchange Connector cannot locate a calendar record attendee or organizer in the Active Directory Global Catalog, this setting determines whether or not to perform an exhaustive Active Directory search. If set to TRUE, Exchange Connector queries as many domain controllers in the Active Directory topology as required to resolve the missing name. The default value is FALSE.

Remove Attendees With No Email

RemoveOutAttendees
WithoutEmail

If set to TRUE, do not synchronize attendees who do not have email addresses when synchronizing from Siebel Business Applications to Microsoft Exchange.

Resolve Contact by Email

 

ResolveContactbyEmail

When synchronizing Microsoft Exchange calendar records with Siebel Business Applications, SSSE categorizes calendar record attendees as employees, contacts, or unresolved attendees. When matching attendees to Siebel contact records, the value of the Resolve Contact by Email parameter determines whether or not the attendee and the contact record must have identical email addresses to be considered as matching records.

If the Resolve Contact by Email parameter is TRUE, an attendee's email address must be identical to the email address of a single Siebel contact record for the records to be considered a match. SSSE does not match records on the basis of matching names if the email address differs (or does not exist).

If the Resolve Contact by Email parameter is FALSE, if an attendee's email address is not identical to the email address of a single contact record, SSSE searches for a contact record with the same first and last names as the attendee. If a record is found with matching first and last names, then provided that the records do not contain different email addresses, SSSE treats the two records as a match.

Table 13 lists SSSE-related Siebel Enterprise Server parameters that apply to the DCOM Exchange Connector. You do not have to specify values for these parameters if you use the Web service Exchange Connector only.

Table 13. SSSE Siebel Enterprise Server Parameters For DCOM Exchange Connector
Parameter Name
Parameter Alias
Comments

Connector Attendee Cache Verify Duplicate Member

 

ConnectorAttCacheVerify
DupMems

Determines whether or not the DCOM Exchange Connector verifies the content of the attendee cache when using a cache value or when adding new attendees to the cache. The default value is FALSE. Set to TRUE only if you expect users to create one or both of the following:

  • Distribution lists that share list names with existing distribution lists but contain different members.
  • Private distribution lists that have email addresses as their list names that match the email addresses of public distribution lists.

Connector Client Cert Name

 

ConnectorClientCertName

String value containing a certificate name. The default value is an empty string. Applies only if ConnectorUseHTTPS is set to TRUE. This parameter is required if you are using HTTPS and the Exchange Server is set up to require client certificates. If this setting does not contain an empty string, then the connector provides the value when making the HTTPS connection. The connector computer must have access to the certificate.

Connector HTTP Connect Timeout

 

ConnectorHTTPConnectTimeout

Number of seconds the Siebel Exchange Connector waits while attempting to establish an HTTP or HTTPS communication socket with the Exchange Server. Applies to synchronization of calendar data only.

Connector HTTP Port

ConnectorHTTPPort

HTTP or HTTPS port number that the Siebel Exchange Connector uses to synchronize calendar data.

Connector HTTP Receive Timeout

 

ConnectorHTTPReceive
Timeout

Number of seconds the Siebel Exchange Connector waits to receive a single response packet from the Exchange Connector. Applies to both HTTP and HTTPS, but for synchronization of calendar data only.

Connector HTTP Resolve Timeout

 

ConnectorHTTPResolve
Timeout

Number of seconds the Siebel Exchange Connector waits while attempting to map a Domain Name Server (DNS) host name to a corresponding IP address. Applies to both HTTP and HTTPS, but for synchronization of calendar data only.

Connector HTTP Send Timeout

 

ConnectorHTTPSendTimeout

Number of seconds the Siebel Exchange Connector waits while attempting to send a single packet of information to the Exchange Server. Applies to both HTTP and HTTPS, but for synchronization of calendar data only.

Connector Idle Timeout

 

ConnectorIdleTimeout

Determines how long an idle Siebel Exchange Connector application waits before terminating automatically. Applies to ongoing synchronizations, but not to initial extractions, which always terminate automatically.

Connector Ignore CN

 

ConnectorIgnoreCN

Indicates whether or not the Exchange Connector is to ignore certificate errors related to a mismatch between the visited hostname and the certificate name being used on the Exchange Server. Default value is TRUE. Applies only if ConnectorUseHTTPS is set to TRUE. When TRUE, if the certificate has a mismatching name, synchronization succeeds because the errors are ignored. When FALSE, if the certificate has a mismatching name, then synchronization fails because the error is not ignored.

Connector Ignore Invalid Date

 

ConnectorIgnoreInvalidDate

Indicates whether or not the Exchange Connector is to ignore certificate errors related to invalid certificate dates or expired certificates. Default value is TRUE. Applies only if ConnectorUseHTTPS is set to TRUE. When TRUE, if the certificate has date errors, synchronization succeeds because the errors are ignored. When FALSE, if the certificate has a date error, then synchronization fails since the error is not ignored.

Connector Ignore Server Errors

 

ConnectorIgnoreServer
Errors

Indicates whether or not all certificate-related errors are ignored. Default value is TRUE. Applies only if ConnectorUseHTTPS is set to TRUE. When TRUE, then any certificate-related errors are ignored and the synchronization succeeds. When FALSE, synchronization fails if there are any certificate-related errors.

NOTE:  Setting this parameter to FALSE causes the Exchange Connector to ignore the other Connector Ignore settings listed in this table, because any certificate error results in a failed synchronization attempt. To trap specific certificate errors but allow others, set this parameter to TRUE and choose other Connector Ignore parameters to set to FALSE.

Connector Ignore Unknown CA

 

ConnectorIgnoreUnknownCA

Indicates whether or not the Exchange Connector is to ignore unknown Certificate Authority errors. Default value is TRUE. Applies only if ConnectorUseHTTPS is set to TRUE. When TRUE, then if the Certificate Authority (CA) who issued the certificate that is associated with the Web Server for Microsoft Exchange is not a trusted CA on the Connector computer, then synchronization still succeeds because the error is ignored. When FALSE, if the CA is not trusted then synchronization fails because the certificate error is not ignored.

Connector Ignore Wrong Usage

 

ConnectorIgnoreWrong
Usage

Indicates whether or not the Exchange Connector is to ignore certificate errors related to malformed certificates such as a certificate with no subject name. Default value is TRUE. Applies only if ConnectorUseHTTPS is set to TRUE. When TRUE, if the certificate is malformed, synchronization succeeds because the errors are ignored. When FALSE, synchronization fails since the error is not ignored.

Connector Max Users

 

ConnectorMaxUsers

It specifies the maximum number of users for which each instance of a DCOM Exchange Connector application can simultaneously perform ongoing extract synchronizations. This parameter does not apply to initial extracts—each initial extract uses a dedicated instance of the DCOM connector application. Maximum value is 200. For more information about this setting, see About Tuning SSSE for Optimal Performance.

Connector Reconnect Timeout

 

ReconnectTimeout

When a running Exchange Connector application detects that no PIMSI Engine instance is exchanging data with it, the application waits the number of seconds specified in this setting for a PIMSI Engine instance to reestablish a connection. If no connection is established, the Exchange Connector application shuts down to conserve resources. You might want to increase the value of this setting if your users run SSSE over a slow network.

Connector Retry Count

ConnectorRetryCount

Maximum number of times that the Siebel Exchange Connector retries an unsuccessful calendar synchronization operation.

Connector Sleep Time

ConnectorSleepTime

Number of seconds the Siebel Exchange Connector waits between retries when retrying a calendar operation.

Connector Timeout

 

ConnectorTimeout

Number of seconds the Siebel Exchange Connector application waits for a PIMSI Engine to establish a connection to the connector application after the PIMSI Engine spawns the application.

Connector Use HTTPS

 

ConnectorUseHTTPS

Indicates whether or not the connector is to use HTTPS when synchronizing the Calendar domain. The default value is FALSE. When FALSE, set the Connector HTTP Port parameter to the value of the unsecured HTTP port that is configured on the Web Server for Microsoft Exchange (typically port 80). When TRUE, set the Connector HTTP Port parameter to the value of the secure HTTP port that is configured on the Web Server for Microsoft Exchange (typically port 443).

Related Topic

Modifying Enterprise and Server Component Parameters

Siebel Server Sync Guide Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.