Siebel Store-and-Forward Messaging Guide for Handheld > Installation and Configuration of Siebel Store-and-Forward Messaging > Process of Installing and Configuring Handheld Applications >
Preparing for Installation of Siebel Handheld Applications
Prior to installing a Siebel Handheld application on a handheld device, you must first edit and verify the setup.ini parameters. Following this step, you may then install the Siebel Handheld application on the handheld device. See the Siebel Handheld Guide for the Siebel Handheld application you are using.
You must partition the user Handheld devices in advance and assign them to specific Queue Managers. It is recommended that you duplicate the Siebel Handheld installation packages in separate directories and modify the setup.ini files to point to different Queue managers in advance.
CAUTION: You statically assign users to Queue Managers. The relationship, once made, is constant. Therefore, plan carefully when deploying devices to make sure that end users are as evenly spread as possible across the available Queue Managers, both in terms of the number of devices and in terms of expected load (allowing for other attributes such as time zone).
NOTE: Store-and-Forward Messaging is supported for Direct Server Synchronization mode, but not for Companion Synchronization.
To verify and edit the setup.ini parameters
- Open the application's setup.ini file.
For information on working with the setup.ini file, see the Siebel Handheld Guide for the Siebel Handheld application you are using.
- Change or verify the following parameter:
- Change or verify the following parameter values in the [Wireless Messaging] section.
- QueuingSoftware = MQE
QueuingSoftware can be MQE or NONE (if NONE is used, the Wireless Messaging feature is disabled)
- SMQCompression = GZIP
[Optional parameter] SMQ Compression setting. The valid values could be GZIP or blank. If this parameter is blank, no compression is applied.
- SMQEncryption = RC4
[Optional parameter] SMQ Encryption setting. The valid values could be RC4 or blank. If blank, no encryption is applied.
If MQE is selected for QueuingSoftware, the following parameters need to be specified. If you are implementing load balancing, you must assign individual handheld devices to different Queue Managers. When a device sends messages to the Siebel server, the messages arrives in its pre-assigned Queue Manager's InboundQ first. For more information, see About the Siebel Load Balancer.
- MQeServerQMgr = ServerQM
Name of the MQe server Queue Manager to which you are assigning this handheld device. The default value is ServerQM. It should be the same as the subsystem parameter "SmqQueueManagerName" in the subsystem specified in the Queue Info field in Store-and-Forward Applications View.
- MQeServerQueue = InboundQ
MQe server Queue name. The default value is InboundQ. It should be the same as the subsystem parameter "SmqQueueName" in the subsystem specified in the Queue Info field in Store-and-Forward Applications View.
- MQeServerAddr = [MQe Server Name]
Address of the MQe server hosting the Queue Manager to which you are assigning this handheld device. The server domain name or IP address of the machine running the Queue Manager. Make sure the domain name or IP address is resolvable from the handheld devices in the deployed environment.
- MQeServerPort = 8080
Number of the port to which the assigned Queue Manager is listening. The default value is 8082. It should be the same as the subsystem parameter "SmqServerPortNumber" in the subsystem specified in the Queue Info field in Store-and-Forward Application View.