Bookshelf v7.8: Editing the Handheld Application Installation Configuration File

The Siebel Handheld application setup.ini file configures the Siebel Handheld Client application installer. Before you deploy a custom-configured Siebel Handheld application, you must update the parameters in the setup.ini file so that the correct values are written to the device registry before distributing the client installer to end users.

The setup.ini file resides in the Siebel Handheld application directory. To modify this file, create a Siebel Handheld installation directory on the network, or create and duplicate a custom DVD-ROM for distribution to end users. This installation directory must include the same files and directory structure as the original DVD-ROM. Then, modify the setup.ini file in the custom installation directory.

NOTE: If you wish to set up parameter values other than default values, add the parameter to the setup.ini file and add the proper values.

Table 20 lists the parameters that you may need to modify in the setup.ini file, their default value, and a description of the parameter.

Table 20. Siebel Handheld setup.ini Parameters
Parameter	Default Value	Description
Version	7.8	Version of the desktop Siebel application against which the Siebel Handheld version synchronizes.
Application Title	Siebel CG Sales Enterprise CE	The Siebel Handheld application. This value must match the name of the application as it is specified in Siebel Tools.
ApplicationName	Siebel CG Sales Enterprise CE	The Siebel Handheld application. This value must match the name of the application as it is specified in Siebel Tools.
ApplicationSplashText		The Siebel Handheld application name as shown on the splash screen.
EnableRemote	N	Used for Integrated Sync. The default value is "N". Valid values are "Y" = [Enable Remote Sync] checkbox is selected, "N" = [Enable Remote Sync] checkbox is unselected in handheld sync window.
MultiCurrency	True	Required for the application to handle multiple currencies.
PressureThreshold	29	Specifies when the end user is prompted to restart the application. See Changing the SyncURL on Siebel Handheld Devices for more information on this parameter.
SyncURL	http://Web Server Name or IP address/Virtual Directory Name	Required for all synchronization methods. This value is entered in the registry on the handheld. See Changing the SyncURL on Siebel Handheld Devices for more information on this parameter.
[EndUserLocalization] Section
User DefinedLang	Y
LogUserDefinedLangErrors	N
[Printing] Section		See Print Configuration Settings for more information on the parameters used to configure printing.
[Backup] Section		Enables handheld database backups. See Enabling Database Backup for more information on settings for the parameters in this section of the setup.ini file.
[ApplicationLocation] Section		Specifies where the Siebel Handheld application and database are installed. See Setting Up Siebel Handheld Application Installation on a CompactFlash Card for more information on the parameters in this section of the setup.ini file.
InternetOptionReceiveTimeout	600000	Length of time to receive data (except data extraction) from the server before the handheld client times out. This parameter only applies to synchronizations using Direct Server Sync. In milliseconds. The default value, 600000, is 10 minutes.
InternetOptionSendTimeout	600000	Length of time to send data to the server in a single call the handheld client times out. This parameter only applies to synchronizations using Direct Server Sync. In milliseconds. The default value, 600000, is 10 minutes.
InternetOptionDataExtractionTimeout	900000	Length of time to extract data from the server to the handheld device the handheld client times out. This parameter only applies to synchronizations using Direct Server Sync.
[Logging] Section
TXNErrorLevel	1	This level controls the extent of transaction error information received from the server. The default value is 1. Valid values are 0 = no log information, 1 = report txn errors in the client log, txnerror.hh. A "Transaction Errors Reported" message appears during sync when txn errors occur. To view errors, double click the message.
DefaultLogLevel	2	The default value is 2. You can set the value to any of the following: -1 = NO LOGGING 0 = LOG_SYSTEM 1 = LOG_ERROR 2 = LOG_WARNING 3 = LOG_INFO, INCLUDING SQL TRACING 4 = LOG_DEBUG The log messages with level equal to or lower than the set value will be logged. For example, if the default log level is set to 2, the messages belonging to System, Error, and Warning log levels will be logged. If the DefaultLogLevel is -1, no logging will be provided.
MaxLogFileSize	2000	This is the maximum log file size in KB. If the program finds the size of the latest log file is greater than this value, a new log file should be used for logging.
MaxSavedLogFiles	3	Determines the number of log files to save on the device. It does not include the one currently used by the program. If the value is set to 2, then the valid log file names are siebel_log.txt, Siebel_log1.txt, and siebel_log2.txt. Siebel_log.txt is the current log file. Siebel_log1 is an older one and Siebel_log2 is the oldest.
PressureThreshold	29	Prompts user to restart application after 30 visits, thereby freeing application memory.