Bookshelf v7.7: 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 (for example, the Service Handheld directory) on the Siebel Handheld DVD-ROM. 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 15 lists the parameters that you may need to modify in the setup.ini file, their default value, and a description of the parameter.

Table 15. Siebel Handheld setup.ini Parameters
Parameter	Default Value	Description
Version	7.7	Version of the desktop Siebel application against which the Siebel Handheld version synchronizes.
Application Title	SiebelService for CE	The Siebel Handheld application. This value must match the name of the application as it is specified in Siebel Tools.
ApplicationName	SiebelService for CE	The Siebel Handheld application. This value must match the name of the application as it is specified in Siebel Tools.
ApplicationSplashText	Service Handheld	The Siebel Handheld application name as shown on the splash screen.
MultiCurrency	True	Required for the application to handle multiple currencies.
SyncURL	http://Web Server Name or IP address/Virtual Directory Name	Required for Direct Server Sync. 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 Settingsfor more information on the parameters used to configure printing.
[Backup] Section		Enables handheld database backups. See Editing the Database Backup Parameters 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
DefaultLogLevel	2	This is for logging messages
MaxLogFileSize	2000	This is for the maximum log file size in KB
MaxSavedLogFiles	3	Determines the number of log files to save.