Setting the Parameters of the Workflow Monitor Agent

The following table describes the parameters to set for the Workflow Monitor Agent in the Server Manager command line interface.

Parameter Name Display Name Description Default Value

ActionAgent

Use Action Agent

Determines if the Action Agent runs with Monitor Agent.

If set to FALSE (the default value), then the Workflow Action Agent server component starts in the Workflow Monitor Agent and the Workflow Monitor Agent runs the actions.

Several factors apply when configuring Use Action Agent. For more information, see Setting the Use Action Agent Parameter.

FALSE

ActionInterval

Action Interval

Specifies the action execution interval in seconds. This parameter determines when Siebel CRM runs actions for a Workflow Policy on the row of a base table. This parameter limits the number of times that Siebel CRM runs an action if a row continues to go in and out of a matching state.

If the same record repeatedly meets the same Workflow Policy before the action interval expires, then Siebel CRM removes the record from the S_ESCL_REQ table and does not perform the action again. For more information, see Tables That Workflow Monitor Agent Uses.

The default value is 3600 seconds. If you use this parameter, then you must set the parameter to a value greater than 0 (zero) or unexpected behavior might result.

3600

BatchMode

Processes the batch policies

Determines if Monitor Agent runs in batch mode. If the BatchMode parameter is set to:

  • TRUE, then Siebel CRM evaluates only those policies with the Batch Flag set to TRUE. Workflow Monitor Agent runs one time. It processes records in the table, and then exits.

  • FALSE, then Siebel CRM evaluates only those policies with the Batch Flag set to FALSE.

FALSE

CheckLogCacheSz

Cache size of Policy violations

Specifies the number of Workflow Policies that Siebel CRM stores in the cache. To determine if an action already started, Siebel CRM uses the ROW_ID and RULE_ID in the map or cache.

The Workflow Monitor examines the S_ESCL_LOG table for policy violations for the same BT_ROW_ID and RULE_ID.

100

DeleteSize

Request delete size

Specifies the number of records to commit at a time. The minimum value is 1. If the Workflow Monitor encounters a deadlock, then you can reduce the default value from 500 to 125 with minimal performance degradation. To avoid a call stack error, do not set the DeleteSize parameter to zero.

500

GenReqRetry

Number of seconds to retry

Specifies the number of seconds to retry sending a Generic Request message.

120

GroupName

Group Name

(Required) Specifies the Workflow Policy group on which Monitor Agent works.

Not applicable

IgnoreError

Ignore errors

Determines if Siebel CRM ignores errors while it processes a request. By default, the Workflow Monitor Agent and Workflow Action Agent do not ignore errors that occur while processing a request. If an error occurs, and if the IgnoreError parameter is set to:

  • TRUE., then the Workflow Monitor Agent logs the error, deletes the request, and continues processing the next request.

  • FALSE, then the Workflow Monitor Agent exits and sends an email to the mail Id that you define in the Mailing Address parameter.

It is recommended that you set the IgnoreError parameter to FALSE.

FALSE

KeepLogDays

Number of days to keep violation information

Specifies the number of days of violation information that Siebel CRM retains in the log. It removes log information that is older than the value in the KeepLogDays parameter. To prevent Siebel CRM from removing this log information, you can set this value to 0 (zero). For more information, see Setting the Keep Log Days Parameter.

30

LastUsrCacheSz

Cache size of last user information

Specifies the number of last user information items that Siebel CRM caches on the Siebel Server.

If running an action, then the information about the last user who modified the row of the base table is available as a token substitution in the program arguments. To improve throughput performance of actions that Siebel CRM runs, it can cache this information.

100

MailServer

Mail Server

Specifies the name of the email server where Siebel CRM sends an email to notify you that an abnormal termination occurred.

Not applicable

MailTo

Mailing Address

Specifies the email address where Siebel CRM sends an email if an abnormal termination occurred.

If a Workflow Agent process exits with an error, then Siebel CRM sends an email to the address that you specify. An error can result if an action fails to run, an object definition is not valid, and so on.

Not applicable

NumRetries

Number of Retries

Specifies the number of times Siebel CRM attempts a recovery.

If Siebel CRM loses connectivity with the Siebel database, then the NumRetries parameter works in conjunction with the Retry Interval and Retry Up Time parameters to reconnect MTS or server components to the Siebel database.

10000

ReloadPolicy

Reload Policy

Specifies the policy reload interval in seconds. It determines how frequently Siebel CRM reloads Workflow Policies. Reloading allows Siebel CRM to change the information that it displays and to incorporate changes that Generate Triggers creates. The default value is 600 seconds.

600

Requests

Requests Per Iteration

Specifies the maximum number of requests that Siebel CRM reads for each iteration. It controls the maximum number of requests that Workflow Monitor Agent reads from the requests queue in one iteration. Between iterations, Workflow Monitor Agent does the following:

  • Deletes processed requests and commits from the requests queue

  • Optionally reloads policies from the Siebel database

  • Determines if a shutdown request exists

  • Optionally sleeps

5000

Sleep Time

Sleep Time

Specifies the time in seconds that the Workflow Agent server task sleeps after it polls for events and fulfills obligations to notify. This task waits for more requests when it sleeps. The default setting is 60 seconds so this task sleeps every one minute. It wakes up, processes requests if there are any, and then sleeps. It does this work repeatedly.

After the Workflow Agent process finishes, the Workflow Agent process stops polling until the time period that the Sleep Time parameter expires. This parameter affects the performance of the Workflow Agent process and the responsiveness of the Siebel Server.

60