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

Reviewing and Deleting Store-and-Forward Messaging History

You can review message histories in the Store-and-Forward Message History view for all the inbound and outbound messages. You may also review an individual user's inbound and outbound messages in the Personal Message History view. These views allow you to access characteristics of an inbound or outbound message, including the unique message ID, the application used for the message, the message direction - either from server or from client, the time when the message was received or sent, the message size, message status, and any error information. You can use this information to troubleshoot or monitor application or system usage.

You can also specify criteria for deleting old message history records for all messages or for an individual user's messages. You do this by specifying a time threshold beyond which the system deletes records for received messages only.

NOTE:  The Store-and-Forward Message History view can display information for Siebel Handheld Clients, Siebel Mobile Web Clients, or both.

The tasks you can perform to review message history and delete message history records are listed below:

• To review all message history records
• To delete all old message history records
• The following procedure describes how to review message history records for a specific user's inbound and outbound messages.
• To delete a user's old message history records

The following procedure describes how to review message history records for all inbound and outbound messages.

To review all message history records

1. Navigate to Administration - Store-and-Forward > Store-and-Forward Message History.
2. Review the information in the Store-and-Forward Message History view.

   The data in the message history records is generated automatically, and the records are read only. Some fields are described in the following table.

   Field	Description
   Application	The name of the Siebel Handheld application.
   Direction	The direction the message has traveled. Either from Server or From Client.
   Error	Message content if this is an ERR (Error) type message.
   Message ID	The message ID in the screen is the row ID of the message history table.
   Message Type	Available types change vary according to the value in the Direction field. For information about message type codes and descriptions, see About Message Types.
   Original Message ID	ID of the corresponding request message if this message is a response message.
   Size	The message size, as transported to the queuing system, after compression.
   Status	Pending. The outbound data message has been created but is delayed until the specified Start to Send time. For information about the Start to Send parameter, see Configuring Data Message Timeout Parameters for Store-and-Forward Messaging. Sent. The server outbound message has been sent to the queuing system. Server Received. The server has received the message from the Siebel Handheld application. Client Received. The Handheld client application has received the message from the server. Overdue - Not Received. The message is not delivered within the Message Delivery Timeout and has been removed from the user's server outbound queue. For information about the Message Delivery Timeout parameter, see Configuring Data Message Timeout Parameters for Store-and-Forward Messaging. Invalid. A message can no longer be generated due to record being deleted or reassigned to a different user. The message appears in the message table to log the fact that a workflow has been initiated, but something was wrong so a message cannot be generated. Send Failed. The server outbound message cannot be delivered due to a transport error.
   Time Received	Time a message was received.
   Time Sent	Time a message was sent.
   Transport ID	Transport-level ID used by the system.
   User ID	User login name.

About Message Types

Store-and-Forward Messaging messages fall into the following categories:

• Outbound Messages. Generated on a Siebel Server for delivery to a Siebel Handheld application.
• Inbound Messages. Generated on a Siebel Handheld application for delivery to a Siebel Server.

This topic describes the message types and their associated codes. These message types and codes appear in the Store-and-Forward Message History view's Message Type fields. Some of these message types are specific to From Server (outbound) messages only, some are specific to To Server (inbound) messages only, and some can be used by both (bi-directional).

The message types and their associated message codes are listed and described in Table 11.

The following procedure describes how to delete message history records for all inbound and outbound messages.

To delete all old message history records

1. Navigate to Administration—Store-and-Forward > Store-and-Forward Message History.
2. In the Store-and-Forward Message History title bar, choose Menu > Delete Old Messages.
3. In the Store-and-Forward Delete All Messages Popup Applet, complete the fields in the following table.

   Field	Comments
   Repeat Weekly?	Select to automatically repeat the delete each week. Occurs at the same day and time each week.
   Message Age	Enter a message age in minutes. The system will delete messages older than that.

4. Click Delete All Messages.

The following procedure describes how to review message history records for a specific user's inbound and outbound messages.

To review a user's message history records

1. Navigate to Administration—Store-and-Forward > User List > Store-and-Forward User Message History.
2. On the Persons list, select an end user whose messages you want to view.
3. Review the information on the Message History tab.

   The table in To review all message history records describes the fields in the Message History list.

The following procedure describes how to delete a specific user's message history records for inbound and outbound messages.

To delete a user's old message history records

1. Navigate to Administration—Store-and-Forward > User List > Store-and-Forward User Message History.
2. On the Persons list, select an end user whose old messages you want to delete.
3. On the Message History tab, choose Menu > Delete My Old Messages.
4. In the Store-and-Forward Delete All Messages Popup Applet, in the Message Age field, enter a message age in minutes.

   The system will delete this user's messages that are older than the age you specified.

5. Click Delete All Messages.