Siebel Loyalty Administration Guide > Getting Started with Siebel Loyalty > Setting Up Server Components for Siebel Loyalty >

Setting Up the Batch Server Component


To set up the Loyalty Engine batch component, you can configure its parameters and you can set up a workflow to start this component when the server starts. This topic describes these tasks. For information about the architecture of the Siebel Loyalty Engine batch server component, see Siebel Loyalty Engine Reference.

Configuring Parameters of the Batch Server Component

You can configure the batch server component by changing the parameters that are used in processing, as described in the following procedure.

To configure parameters for the Loyalty Engine batch server component

  1. Navigate to Administration - Server Configuration, Enterprises, then the Component Definitions view.
  2. Query for the eLoyalty Processing Engine - Batch component.
  3. In the Component Parameters view, specify values for the parameters used in batch processing, which are summarized in Table 8. All of the parameters in this table apply only to the Siebel Enterprise eLoyalty Processing Engine - Batch component.
Table 8. Parameters Used in Batch Processing
Name
Display Name
Default Value
Description

LOYEngineNumberOfRuns

LOY - Engine Number of Runs

5

The number of times to query after the queue becomes empty. This parameter must have the value -1 or greater than 0. If -1, then the eLoyalty engine keeps running indefinitely until it is shut down. Otherwise, it queries the specified number of times after the current query has run out of records.

LOYEngineNumberOfTasks

LOY - Engine Number of Tasks

0

The number of processing threads that are automatically started when the Loyalty Engine server component is started. By default, it is 0, which means that there is no processing thread started, but there is one queue manager thread started. If -1, then no queue manager thread can be started either. If 4, then 4 processing threads plus one queue manager thread can be started for each MT server.

LOYEngineSearchSpec

LOY - Engine Search Specification

None

 

Currently not supported. Reserved for future use.

LOYEngineSleepTime

LOY - Engine Sleep Time (secs.)

10

The time (in seconds) for which the eLoyalty engine must wait after it has processed the records and there are no more records in the next query. After sleeping for that time, the eLoyalty engine can requery.

About Starting the Batch Server Component

The batch component must be started whenever the server is started. You can automate this process by using a workflow included in the product which can be invoked on server startup to initialize the server.

To start the batch component, you must know:

  • The number of servers and number of processes on each server. This number is determined by the administrator based on the transaction load.
  • The number of threads desired in each process. This number is determined based on the hardware being used. For each process, at least two threads are necessary—the queue manager thread and the processing thread. There can be more than one processing thread, depending on the number of CPUs and other resources available. Having too many threads causes unnecessary paging and using too few threads causes slow processing. It is best to use two or three threads for each process.

NOTE:  Before starting the component, be sure that the keys have been correctly defined, as described in Setting Up Server Keys for Siebel Loyalty.

Starting the Batch Server Component Manually

The following procedure describes how to start the batch server component manually.

To start the server component manually

  1. Be sure that the component parameters MinMTServers and MaxMTServers are set to the number of processes desired on each server.

    For more information about these parameters, see Siebel System Administration Guide.

  2. For each server:
    1. Calculate (number of processes on server) x (1 plus number of Processing Threads/Process)
    2. Submit this number of component requests for the eLoyalty Processing Engine - Batch component.

      You can submit these component requests from the user interface or using the server manager program.

Starting the Batch Server Component Using a Workflow

The following procedure describes how to use a workflow to initialize the server component.

NOTE:  Before using a workflow to initialize the server, you must set up the workflow so it runs whenever you start the server. For more information about setting up workflows, see Siebel Business Process Framework: Workflow Guide.

To use a workflow to initialize the server component

  1. In Siebel Tools, set up the workflow LOY Engine - Start Engine workflow by specifying the following two process properties:
    • NumberOfProcesses
    • NumberOfProcessingThreadsPerProcess
  2. Activate this workflow.

    When you start the server component eLoyalty Process Engine - Batch, this workflow submits the component requests to start the required number of processes.

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