Siebel System Administration Guide > Siebel Server Components and Parameters > Siebel Enterprise, Server, and Component Parameters >

Generic Parameters

This section describes in detail the generic parameters listed in Table 29. Many of these parameters can be set at the Siebel Enterprise Server, Siebel Server, or component levels.

Alert Level. This is the level of logging to the Server Alert File. The value is set to 1 by default, but more detailed information may be specified by setting the parameter to a higher value. Currently, only levels 1 and 2 are supported. Level 1 sends only information about abnormal process and task terminations to the Alert File. Level 2 sends information about every process or task as it exits, whether normally or unexpectedly.

Application Datasource. This parameter specifies the Siebel Application Object Manager default configuration datasource. The value for this parameter is one of the values listed for the OM-Named Data Source name parameter.

Application Scripting Enabled. This parameter determines if the Siebel Application Object Manager server component can execute a server script. If you flag this to true, scripting DLL files are loaded and the application can then execute scripts. The default value for this parameter is true. Setting this parameter to false also disables browser scripts in addition to server scripts.

Application Shared Mode users directory. This parameter specifies the users directory used in shared mode. Update the value of this parameter if you change the location of the Siebel File System.

Auto Restart. This component can be restarted automatically. This parameter works in conjunction with the Number of Restarts parameter to determine the number of attempts that are made to restart the target component.

NOTE:  For multithreaded server components, auto-restart does not occur if a process initially fails to start and is terminated by the Siebel application. Only processes that reach the running state are restarted.

Compressed File Download. By default, files are downloaded to a client's browser in a compressed form when using Siebel File System Manager. On certain versions of Microsoft Internet Explorer, this may result in the renaming of the file. If you want to disable compressed file download, then set this parameter to FALSE for the Application Object Manager that you want this feature to be disabled. Default value is TRUE.

DB Multiplex - Max Number of Shared DB Connections. The DB Multiplex - Max Number of Shared DB Connections parameter is one of two (the other being DB Multiplex - Min Number of Shared DB Connections) that configure shared database connections. Shared connections are used by most Application Object Manager operations. The DB Multiplex - Max Number of Shared DB Connections parameter controls the maximum number of shared database connections, and is defined for each component; that is, DB Multiplex - Max Number of Shared DB Connections controls the maximum total number of shared database connections for the component on each Siebel Server, not an instance (task or process) of the component. A setting of -1 disables this parameter and is the default setting.

DB Multiplex - Min Number of Dedicated DB Connections. The DB Multiplex - Min Number of Dedicated DB Connections parameter controls the minimum number of dedicated database connections within an Application Object Manager process. Dedicated database connections are used primarily by specialized Siebel components, such as Siebel EAI, that need transactions to span multiple Application Object Manager operations. The DB Multiplex - Min Number of Dedicated DB Connections parameter is defined for each instance of the component; that is, DB Multiplex - Min Number of Dedicated DB Connections controls the minimum number of dedicated database connections for each instance (process) of the component, not for the entire component. This functionality is different from the parameters that configure shared database connections. A setting of -1 disables this parameter and is the default setting.

DB Multiplex - Min Number of Shared DB Connections. DB Multiplex - Min Number of Shared DB Connections is one of two parameters (the other being DB Multiplex - Max Number of Shared DB Connections) that configure shared database connections. Shared connections are used by most Application Object Manager operations. The DB Multiplex - Min Number of Shared DB Connections parameter controls the minimum number of shared database connections, and is defined for each component; that is, DB Multiplex - Min Number of Shared DB Connections controls the minimum number of shared database connections a component tries to maintain on each Siebel Server across all instances of this component. A setting of -1 disables this parameter and is the default setting.

NOTE:  Set the DB Multiplex - Min Number of Shared DB Connections parameter less than the value of the Maximum Tasks (alias MaxTasks) parameter. Setting this value greater than MaxTasks disables database connection pooling.

Default Processes. Default number of component processes to start on Siebel Server startup. This parameter only applies to components that are defined to run in background mode. The processes instantiated during Siebel Server startup connect to the database using the values for the following Siebel Server-level parameters, unless overridden at the component level for any of the background mode components:

• ODBC Data Source
• Username
• Password

Default Tasks. This is the number of processes to start for a background mode component when the component is started explicitly through the Siebel Server Manager, or when the Siebel Server is started (if the component state was last set to Running). Components with a Default Tasks parameter set to a value greater than zero start automatically when the Siebel Server is started.

EnableSIDataLossWarning. When set to TRUE for standard-interactivity mode employee applications a dialog box appears that warns the user if he or she attempts to change context without saving changes. By default, this parameter is set to TRUE.

Error Flags. Flags used for tracing error information. This parameter is used to turn on various types of component-specific error tracing.

Honor MaxTasks. When the parameter value is TRUE, a component process that reaches Max Tasks stops accepting requests from the Server Request Broker. If another request is sent, an error message results. The process resumes accepting requests after some tasks finish. If the parameter value is FALSE, all requests are queued in the component process.

Language Code. Three-letter language code for the component processes. Translatable messages (including error messages) are output in the specified language. The translated message files for the language must exist in the locale subdirectory of the Siebel Server installation. For more information, see Siebel Global Deployment Guide.

Locale Code. Three-letter locale code for the component processes. A locale is a set of rules guiding how common data is displayed to the user or is received from the user. Siebel Business Applications support formatting of data, such as dates, time, numbers, and currency, based on locale settings. Locales are administered using the Locale Administration View. For more information, see Siebel Global Deployment Guide.

NOTE:  Siebel Business Applications use the three letter acronym (TLA) code conventions of Microsoft for locale and language code. For more information on setting locales, see Siebel Applications Administration Guide.

Local load balancing upper threshold. This parameter determines the load threshold at which a new Application Object Manager (AOM) process launches, and is based on the load percentage of a given AOM process. For example, setting this parameter to 80 percent on an AOM that handles 50 concurrent sessions launches a new AOM process when 40 sessions become active. The default value is 100 percent. For further information on load balancing, see Siebel Deployment Planning Guide.

NOTE:  If the AOM parameter Minimum MT Servers (alias MinMTServers) is equal to Maximum MT Servers (alias MaxMTServers), the effective value for this parameter is 100 percent despite the actual setting.

Log Print Timestamp. This parameter specifies whether to print a timestamp on records written to the trace files. The value is set to TRUE by default, but administrators may want to override it to FALSE for components that perform a large amount of logging (or if a high value is set for the Trace Flags or SQL Trace Flags parameters).

Maximum MT Servers. This is the maximum number of multithreaded Siebel Server processes to be run concurrently for a component that has multithreading enabled. Note that only batch mode and interactive mode components may run with multithreaded set to TRUE. Tasks and client sessions run as threads within the multithreaded Siebel Server processes. The number of tasks that may run in each Siebel Server process is determined by the value of the Maximum Tasks parameter divided by Maximum MT Servers. Increase or decrease this value based on the number of users for the given component process. For more information, see Siebel Performance Tuning Guide.

Maximum Processes. The maximum number of concurrent running processes for a Siebel Server component. The Siebel Server must be restarted in order for any changes to this parameter to take effect.

Maximum Tasks. The maximum number of background mode, batch mode, or interactive mode processes or threads that may run concurrently for a component. This value applies to threads for components that have multithreading enabled, or otherwise component processes. You should increase or decrease this value based on the number of users for the given component process. This value also determines the number of tasks for each component that are tracked by the Siebel Server. For more information on the maximum tasks parameter, see Siebel Performance Tuning Guide.

NOTE:  Multithreaded Siebel Server processes are not included in the counting of tasks. The tasks run as threads within the processes; these multithreaded processes are guided by the Minimum MT Servers and Maximum MT Servers parameters.

Memory Usage Based Multithread Shell Recycling. If set to TRUE, processes for this component are recycled automatically when virtual memory usage reaches a specified threshold. The threshold is set using the parameter Process VM Usage Lower Limit. For example, when a component is set with this parameter and the memory usage has exceeded the configured threshold, the recycling procedure begins by disabling new tasks, spawning a new process, and commencing a normal shutdown (that is, waiting for all tasks to finish before shutting down). The default value is FALSE. Use this parameter to remedy your application only if excessive memory usage created by memory leaks appears to exist.

Minimum MT Servers. The default number of multithreaded Siebel Server processes that are started for a component that has multithreading enabled. These processes are brought up when the component is started explicitly through the Siebel Server Manager, or when the Siebel Server is started (if the component state was last set to Running). Additional multithreaded Siebel Server processes are started as needed (namely, when the maximum number of threads that may run in a Siebel Server process has been reached), up to the value of the Maximum MT Servers parameter. Setting this parameter to 0 disables the component.

Minimum Up Time. Minimum time an MTS or Siebel Server-mode component needs to up for a restart to be successful (in seconds). In order for the component restart to be considered successful, the component must be running for the duration specified by this parameter. This parameter works with the Number of Restarts parameter to determine the number of restart attempts in a time interval allowed for a component (NumRestart * MinUpTime). If a component instance cannot be restarted after this time interval, no new restart is attempted (the component instance will not be running). The default value for this parameter is 60 seconds.

Multithreaded. Specifies whether the component is multithreaded or multiprocess. This parameter only applies to batch mode and interactive mode components. Use the default value for this parameter.

CAUTION:  Do not change the value of this parameter without direct guidance Global Customer Support. For help with changing the value of this parameter , create a service request (SR) on My Oracle Support. Alternatively, you can phone Global Customer Support directly to create a service request or get a status update on your current SR. Support phone numbers remain the same and are listed on My Oracle Support.

Number of lines after which to flush the log file. Specifies how often data is written to the log file. Set the value to n so that data is written to the log file every n lines. For example, set the value to 1 to write every line to the log file. Set the value to 0 (default value) to allow the operating system to determine when to write data to the log file.

Number of Restarts. Number of times an MTS or Siebel Server-mode component will be restarted if it exited with errors in less than the time set for Minimum Up Time. This parameter works with Auto Restart to determine if MTS or Siebel Server-mode components will be restarted. This parameter also works with the Minimum Up Time parameter to determine the number of restart attempts in a time interval allowed for a component (NumRestart * MinUpTime). If a component instance cannot be restarted after this time interval, no new restarts are attempted (the component instance will not be running). The default value for this parameter is 10.

Number of Retries. Number of retries for recovery. This parameter works with the Retry Interval and Retry Up Time parameters to reconnect MTS or Siebel Server-mode components to the database if database connectivity has been lost.

Number of Sessions for each SISNAPI Connection. This parameter specifies how many sessions can be multiplexed (shared) through each SISNAPI connection (connections between the Web server [SWSE] and the Application Object Manager), which helps to reduce the number of open network connections. If Number of Sessions for each SISNAPI Connection (alias SessPerSisnConn) is -1, all the sessions are created through only one SISNAPI connection. The default value for this parameter is 20; however, while 20 is a good value to use for user sessions, it does not apply to incoming HTTP requests from other systems (for example, EAI HTTP Adapter Access).

OM-Data Source. This parameter specifies the Siebel Application Object Manager datasource.

OM-Named Data Source Name. This parameter lists the named subsystems that the Siebel Application Object Manager preloads when it initializes. That is, all the data sources that the Object Manager might use are listed here.

OM-Model Cache Maximum. This parameter determines the size of the cache for model objects in Object Manager-based server components, such as Business Service Manager and Workflow Process Manager. Each model in the cache creates two database connections for the life of the model (one connection for insert, update, and delete operations; the other connection for read-only operations). The model cache improves performance for the object manager server components, and it is generally recommended not to disable this parameter. The default value is 10. A value of 0 disables this parameter, and the maximum setting for this parameter is 100.

OM-Preload SRF Data. This parameter determines whether to preload all Siebel repository file (SRF) information upon startup of a Siebel Object Manager server component. If the value is false (default setting), the Siebel repository file data is loaded only at first task or Web client connection request, which can delay the startup page.

OM-Resource Language Code. This parameter specifies the language code used for Siebel Application Object Manager resources. Each language has its own three-letter code identifier. For example, ENU identifies U.S. English.

OM - Save Preferences. Set the value for this parameter to FALSE to prevent the Application Object Manager creating or reading user preference files (file extension equals .spf). When TRUE (the default value) for high-interactivity applications, the Application Object Manager creates a user preference file when a user logs in if one does not already exist. For standard-interactivity applications, the Application Object Manager does not create user preference files.

OM - Timed Statistics. This parameter enables the use of the statistics in the Administration - Server Management, Statistics screen. Statistics include, Average Connect Time (seconds), Average Response Time (milliseconds), and Average Think Time (seconds). Restart the Siebel Server for this parameter to take effect. The statistics are refreshed on completion of each task, so a specific user session must log out for the statistics for that session to be reflected in the Statistics screen. When a task for a component completes its operation, both generic and component specific statistics roll up to the component level. Only generic statistics roll up to the Siebel Server level. The statistics data will be reset when the component is restarted.

Password. Database user password. This parameter specifies the password for the account referenced by the User Name parameter (both are prompted for during the Siebel Server installation process). The User Name and Password parameters are used to connect to the database for Siebel Update version checking, auto-startup of background mode components (see the description for the Auto Startup Mode parameter, and Synchronization Server processes under Siebel Server Parameters.)

Process VM Usage Lower Limit. This parameter sets the virtual memory usage threshold (in megabytes). A component process that reaches this threshold is recycled. The parameter to enable this feature is Memory Usage Based Multithread Shell Recycling. Use this parameter to remedy your application only if excessive memory usage created by memory leaks appears to exist.

Process VM Usage Upper Limit. Set the value of this parameter to the percentage above the value of Process VM Usage Lower Limit at which a fast shutdown is triggered.

Retry Interval. Defines the time interval before a series of retries are made for recovery. This parameter works with the Number of Retries and Retry Up Time parameters to reconnect MTS or Siebel Server-mode components to the database if database connectivity has been lost.

Retry Up Time. Minimum up-time for a new set of retries for recovery. This parameter works with the Number of Retries and Retry Interval parameters to reconnect MTS or Siebel Server-mode components to the database if database connectivity has been lost.

SISNAPI Connection Maximum Idle Time. This parameter configures connection timeout between the Web server and the Siebel Server. Valid values are numeric, specifying the period of idle time (in seconds) after which the connection is disconnected by the component. See the following table for parameter setting descriptions. It is recommended that you set this parameter to a value slightly below the firewall connection timeout value. The default value is -1.

NOTE:  There is no direct relationship between this parameter and the Session Timeout parameter in the eapps.cfg configuration file. The SISNAPI Connection Maximum Idle Time parameter controls the SISNAPI connection behavior while the Session Timeout parameter controls the user session behavior.

SISNAPI-Log Traffic. This parameter specifies whether Siebel Application Object Manager records a log of all Siebel Internet Session API (application programming interface) messages. SISNAPI is a session-based remote procedure call (RPC) designed to support high responsiveness between the Siebel Server and client applications.

Sleep Time. Time to sleep between iterations (in seconds). This parameter is used for the sleep time of component processes running in background mode when the Siebel Server is idle.

SQL Trace Flags. Flags for tracing of SQL statements. If this parameter is set to 1, every SQL statement issued by the component tasks is logged to the information log file for each task. If this parameter is set to 2, each SQL statement is logged in addition to information about the number of parse, execute, and fetch calls, and timing information about each type of call.

Static Port Number. The network port number on which a component listens for client requests. If no value is specified, a unique port number is generated dynamically for each component starting at port number 49150 and up depending on the number of components configured and the occupied ports above this number. This parameter applies to interactive, batch, and background mode components with the exception of all Application Object Manager (AOM) components. AOM components receive inbound traffic through the Siebel Connection Broker component (alias SCBroker). The port number, whether static or dynamic, is hidden from the end user and is provided primarily so that administrators can fix the port numbers used by a component for firewall configuration. If configuring this parameter, select a port number either below 49150 or high enough to make sure there are no conflicts with dynamically generated port numbers.

Trace Flags. Flags for component-specific tracing information. This parameter is used to turn on various types of component-specific tracing. See the chapters describing the individual Siebel Server components for a description of how to set this parameter for each component.

User IP Address. Specifies if the SISNAPI connect strings should be constructed using the IP address instead of the hostname. Default value is TRUE. Changing the value to FALSE affects performance because the hostname must be looked up each time it connects.

Use Shared Log Files. This parameter specifies whether all tasks within a component process should log to a shared file. When set to FALSE, one log file for each task is generated.

User Name. Database user name. This parameter specifies the user name of the database account that is used by the Siebel Server or Siebel Server components that are not started interactively or in batch mode by the Siebel Server Manager. The password for this database account must be specified by the Password parameter (both are prompted for during the Siebel Server installation process). The User Name and Password parameters are used to connect to the database for Siebel Update version checking, auto-startup of background mode components (see the description for the Auto Startup Mode parameter and Synchronization Server processes described under Siebel Server Parameters and in Table 29. When running component tasks from the Server Manager GUI, the value for the User Name parameter is used because the tasks are submitted as component jobs and launched using the Server Request Broker server component (alias SRBroker), which uses the User Name parameter value. When running component tasks from the Server Manager command-line interface-in the case of manually started batch or background mode components-the User Name parameter is that of the user who starts tasks on these components.