Bookshelf v7.5: Editing the 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 ePharma Handheld directory) on the Siebel Handheld CD-ROM. To modify this file, create a Siebel Handheld installation directory on the network, or create and duplicate a custom CD-ROM for distribution to end users. This installation directory must include the same files and directory structure as the original CD-ROM. Then, modify the setup.ini file in the custom installation directory.

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

Table 19. Siebel Handheld Sync setup.ini Parameters
Parameter	Default Value	Description
Version	7.5.2	Version of the desktop Siebel application against which the Siebel Handheld version synchronizes.
ApplicationName	Siebel ePharma CE	The handheld application. This value can be ignored in the setup.ini file because the value will be read from the configuration file on the server (for DSS) or the PC (for CS).
ApplicationSplashText	ePharma CE Handheld	The Siebel Handheld application name as shown on the splash screen.
MultiCurrency	True	Required for the application to handle multiple currencies.
DSSURL	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 DSS URL on Devices for more information on this parameter.
[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 handheld application and database are installed. See Setting up Installation on a CompactFlash Card for more information on the parameters in this section of the setup.ini file.
InternetOptionReceiveTime out	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.
LogSqlStmts	N	This outputs all SQL statements generated by the handheld application to a log file in the Siebel Handheld directory on the handheld. See Configuring Handheld Logging Parameters for more information on this parameter.
LogSSAErrors	N	This outputs all system error messages generated by the handheld application to a log file in the Siebel Handheld directory on the handheld. See Configuring Handheld Logging Parameters for more information on this parameter.
SyncLogReportingLevel	1	Specifies the level of logging by Siebel Handheld Sync. Valid values are: 0 - includes critical errors for the Siebel Handheld Sync client and all messages that are displayed to the end user. 1 - includes all error messages for the Siebel Handheld Sync client, repository version information, device Id, extraction Id, and last processed transaction Id. 2 - includes transactions that are sent to the server, schema file and repository file activity, and device information.
TXNErrorLevel	1	Specifies the level of transaction errors returned by the server and displayed to the end user. Valid values are: 0 - returns only critical messages from the server. This setting is not recommended. 1 - returns all error messages from the server.