Siebel Server Sync Guide > Configuring Siebel Server Sync for Microsoft Exchange Server >

Configuring and Starting PIMSI Dispatcher

PIMSI Dispatcher runs as a job on a Siebel Server computer. This topic describes how to create and run the PIMSI Dispatcher job and how to configure PIMSI Dispatcher by creating PIMSI Dispatcher user groups. This topic also describes the parameters that affect PIMSI Dispatcher behavior when the PIMSI Engine components stop working and the PIMSI Dispatcher enters recovery mode.

This task is a step in Roadmap for Configuring SSSE.

About PIMSI Dispatcher Recovery Mode Parameters

PIMSI Dispatcher runs for a certain amount of time for each dispatching cycle. The amount of execution time is dependent upon your current configuration, for example, the number of active users and the computer configuration.

If PIMSI Engine components stop working, the PIMSI Dispatcher enters recovery mode. In recovery mode, the PIMSI Dispatcher sends a number of requests to the PIMSI Engines to respond. The number of requests that are made is determined by the value of the DispNotificationFreq parameter. If the Engines fail to reply after the specified number of response requests are issued, the PIMSI Dispatcher attempts to remove old PIMSI Engine job requests from the server request queue so that synchronization can resume.

When PIMSI Dispatcher enters recovery mode, you can determine how much additional time the PIMSI Dispatcher requires to complete its run by multiplying the value specified for the DispNotificationFreq parameter by the value specified for the DispReconciliationDuration parameter. The DispReconciliationDuration parameter determines how many seconds the PIMSI Dispatcher waits after signalling a PIMSI Engine.

For additional information on the DispNotificationFreq and the DispReconciliationDuration parameters, and on the other parameters that influence PISSI Dispatcher operation, see Table 13.

Creating the PIMSI Dispatcher Job

The following procedure describes how to create the PIMSI Dispatcher job, tune the job's parameters, and start the job. For information on creating the PIMSI Dispatcher job if you implement PIMSI Dispatcher user groups, see Creating PIMSI Dispatcher User Groups.

To create the PIMSI Dispatcher job and tune its parameters

1. Log in to your Siebel application as an administrator.
2. Navigate to the Administration - Server Management screen, then the Jobs view.
3. In the Jobs List or the Jobs Detail form, click New.
4. Complete the fields as described in the following table.

   For more information about starting jobs, see Siebel System Administration Guide.

   Field	Comment
   Component/Job	Specify PIMSI Dispatcher.
   Mode	Specify Asynchronous.
   Requested Server	Specify the computer where you installed the Siebel Server software for PIMSI Dispatcher.
   Repeating?	Select the check box.
   Repeat Unit	The suggested value is Minutes.
   Repeat Interval	The value you set for this field varies according to your business requirements. It is recommended that you set the Repeat Interval value as high as possible to minimize the performance impact of running the PIMSI Dispatcher job. CAUTION:  Setting a Repeat Interval less than five minutes can cause SSSE to miss some Siebel updates, causing incomplete synchronization and possibly decreasing performance throughout the Enterprise.
   Repeat From	Set the value of this field to End.
   Repetitions	Accept the default value for this field (0).

5. Save the record and click Submit Job to begin the initial extract.

   Ongoing extracts follow automatically, separated by the repetition interval.

Creating PIMSI Dispatcher User Groups

During each synchronization cycle, the PIMSI Dispatcher by default sends synchronization task requests to the PIMSI engine for all users who have synchronization enabled. However, you can optionally filter the users for whom synchronization task requests are issued during each cycle by defining PIMSI Dispatcher user groups, and specifying different synchronization schedules for each group.

For example, if you create PIMSI Dispatcher user groups for different geographic regions, such as EMEA and the United States, you can specify different synchronization schedules for each group; instead of all users being synchronized during each cycle, each user group can be configured to synchronize more frequently during their hours of business than during the evenings.

The procedure in this topic describes how to:

1. Define a PIMSI Dispatcher user group.
2. Assign users to the new PIMSI Dispatcher user group.
3. Create a job template for the PIMSI Dispatcher user group.
4. Create a PIMSI Dispatcher job based on the job template you have created.

To configure PIMSI Dispatcher user groups

1. Define a new PIMSI Dispatcher user group as follows:
   1. Navigate to the Administration - Data screen, then the List of Values view.
   2. Create a new record, specifying values similar to the following:

      Type	Display Value	Language Independent Code	Language Name
      PIMSI_DISPATCHER_GROUP	The display name of the PIMSI Dispatcher user group, for example, Sync Group EMEA	The name of the PIMSI Dispatcher user group, for example, Sync Group EMEA	Specify the language, for example, English-American

2. Assign users to the PIMSI Dispatcher group you defined in Step 1 as follows:
   1. Navigate to the Administration - PIM Server Integration screen, Sync Access Control, and then the User Map view.
   2. Select the user you want to associate with a PIMSI Dispatcher group.
   3. In the Dispatcher Group field, select the PIMSI Dispatcher user group to associate with the user.
   4. Save the User Map record.
3. Create a job template for the new PIMSI Dispatcher user group as follows:
   1. Navigate to the Administration - Server Configuration screen, then the Job Templates view.
   2. Create a new job template, specifying values similar to the following:

      Name	Component	Component Type
      The name of the job template, for example, Sync Group EMEA	PIMSI Dispatcher	BusSvcMgr

   3. In the Job Parameters list, add a job parameter to the job template, specifying values similar to the following:

      Name	Value
      Encoded Input Arguments	DispatcherGroup:value where value is the name of the PIMSI Dispatcher user group you are defining. For example, for the Sync Group EMEA user group, specify the following for the Value field: DispatcherGroup:Sync Group EMEA

4. Create a new PIMSI job using the job template you created in Step 3 as follows:
   1. Navigate to the Administration - Server Management screen, then the Jobs view.
   2. In the Jobs list, click New.
   3. In the Component/Job field, select the name of the job template you created in Step 3, for example, Sync Group EMEA.
   4. In the Jobs list or Job Detail view, complete other fields as appropriate.

      For information on these fields, see Creating the PIMSI Dispatcher Job.

5. Save the record and click Submit Job to start the initial extract.