Siebel Store-and-Forward Messaging Guide > Administration of Siebel Store-and-Forward Messaging > Process of Administering Applications with Siebel Store-and-Forward Messaging >

Setting Outbound Data Message Timeout Parameters

To make sure server outbound data messages are delivered in a timely manner, Store-and-Forward Message Timeout view allows you to specify three message timeout parameters.

• Message Delivery Timeout parameter. This parameter determines the amount of time, in seconds, allowed for a given outbound data message to be delivered before it is timed out. The timeout length can be field-value dependent, for example, different activity messages can have different timeouts based on the value entered into the activity priority field. A message is removed from the user's server outbound queue if it is not delivered within the defined time period. Also, the related activity record's status is changed to Dispatch Failed when the system is unable to successfully transmit the message to a device.
• Message Acceptance Timeout parameter. This parameter determines the amount of time, in seconds, within which a server outbound data message needs to be accepted or declined by the mobile user. This is an application-level parameter and can be used in a customized workflow or business process to define proper actions. The timeout length can be field-value dependent. For example, by setting values for activities, you can determine the amount of time, within which a service technician needs to tap Accept or Decline after a dispatched activity, received through Store-and-Forward Messaging, reaches his or her device.

  NOTE:  This parameter is currently not deployed by default in the Service Handheld application.

• Start to Send parameter. This parameter determines a time window, in seconds, within which a newly created data message may be sent to a Siebel Handheld application. This is an application-level parameter. This parameter needs to be associated with a field, such as the Planned Start field for Activity. The value setup for this parameter can be used in a customized workflow to define delay of an outbound data message. For example, if the parameter is set to 36 hours, an outbound data message for a new activity can only be sent to a handheld device when the activity's Planned Start time is within 36 hours of the current time.

  NOTE:  This parameter is not currently deployed for the Service Handheld application.

The values set for all the three message timeout parameters are in seconds.

To set up outbound data message timeout parameters

1. Choose Navigate > Site Map > Administration—Store-and-Forward > Store-and-Forward Applications, and select a Siebel Handheld application.
2. Click the Message Timeout view tab, then highlight the message object for which you would like to set a timeout parameter.

   For example, the ActionSHCE message object, which is the data message object defined for the Action business object.

3. In the Store-and-Forward Timeout Administration subview, click New.
4. Choose a timeout parameter, either Message Delivery Timeout, Message Acceptance Timeout, or Start to Send.
5. In the Field Values and Time Out subview, enter the required fields.

   For example, the timeout values can vary for activity records based on the Priority field. See the following table for an example:

   Field	Value	Time
   Priority	1 - ASAP	600
   Priority	2 - Important	1200

   If you do not select a field value, the Default Time value set applies to all the records.