Bookshelf v8.1/8.2: Editing the Siebel Handheld Application Installation Configuration File

The Siebel Handheld application setup.ini file configures the Siebel Handheld Client 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 Siebel Handheld Client installer to users.

The setup.ini file resides in the Siebel Handheld application directory. To modify this file, create a Handheld application installation directory on the network, or create and duplicate a custom DVD-ROM for distribution to 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 27 lists the parameters that you might need to modify in the setup.ini file, their default value, and a description of the parameter.

Table 27. Siebel Handheld Application setup.ini Parameters
Parameter	Default Value	Description
Version	8.0	Version of the desktop Siebel application against which the Siebel Handheld application version synchronizes.
ApplicationName	SiebelMedicalCE	The Siebel Handheld application. This value must match the name of the Handheld application as it is specified in Siebel Tools.
ApplicationSplashText	SiebelMedicalCE	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] check box is selected, N = [Enable Remote Sync] check box is unselected in the synchronization window of the Handheld application.
MultiCurrency	True	Required for the Handheld application to handle multiple currencies.
SyncURL	http:///Web Server Name or IP address/Virtual Directory Name	Required for all synchronization methods. This value is entered in the registry for the Siebel Handheld application. NOTE: PPC 2002 and PPC 2003 do not have a hosts file similar to the Windows Operation System (for example, `C:\WINNT\system32\drivers\etc\hosts.file`), where you can set up mappings for the IP address and host name. For more information about this parameter, see Changing the SyncURL on Handheld Devices.
[EndUserLocalization] Section
User DefinedLang	Y
LogUserDefinedLangErrors	N
[Printing] Section	(various)	For more information about the parameters used to configure printing, see Print Configuration Settings.
[Backup] Section	(various)	Enables Siebel Handheld application database backups. For more information about settings for the parameters in this section of the setup.ini file, see Enabling Siebel Handheld Application Database Backup.
[ApplicationLocation] Section	(various)	Specifies where the Siebel Handheld application and database are installed. For more information about the parameters in this section of the setup.ini file, see Setting Up Siebel Handheld Application Installation on a CompactFlash Card.
InternetOptionReceiveTimeout	600000	Length of time to receive data or a response (except data extraction) from the server in the case of Direct Server Synchronization or the Laptop in the case of Companion Synchronization, before the Siebel Handheld application times out. The default value, 600000 milliseconds, is 10 minutes.
InternetOptionSendTimeout	600000	Length of time to send data to the server in the case of Direct Server Synchronization or to the Laptop in the case of Companion Synchronization, before the Siebel Handheld application times out. The default value, 600000 milliseconds, is 10 minutes.
InternetOptionDataExtractionTimeout	900000	Length of time to extract data from the server in the case of Direct Server Synchronization or from the Laptop in the case of Companion Synchronization (to the handheld device), before the Siebel Handheld application times out. The default value, 900000 milliseconds, is 15 minutes.
RemoteTimeout	1800000	Length of time for the handheld device Syncmanager process to wait for a remote synchronization to complete, before timing out. The default value, 1800000 milliseconds, is 30 minutes. NOTE: This parameter only applies to synchronizations using Companion Synchronization and when remote synchronization is enabled.
[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 Siebel Handheld Client log, txnerror.hh. A "Transaction Errors Reported" message appears during synchronization 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 must 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 the Handheld application after 30 visits, thereby freeing application memory.

Siebel Medical Handheld Guide		Copyright © 2013, Oracle and/or its affiliates. All rights reserved. Legal Notices.