eG Help

Whenever the BlackBerry Enterprise server experiences processing bottlenecks or flaky connectivity with the BlackBerry devices, the delivery of messages to the devices is bound to be affected. Anomalies can range from a delay in delivery to total failure of the delivery mechanism. To assess the extent of the damage, administrators would need to know the length of the pending message queue, the count of failed messages, and also the number and names of users who are affected by the delay/delivery failure. The BlackBerry User Messages test provides this information. For every user whose BlackBerry device is connected to BES, this test reports the number of pending messages, failed messages, and expired messages, so that administrators can accurately identify the devices/users who were worst hit by processing delays/failures in the BES.

Measurement	Description	Measurement Unit	Interpretation
Filtered_msg_count	Indicates the number of email messages that were filtered based on the filter preferences set by the user on his/her BlackBerry handheld device during the last measurement period.	Number	By using the Filter option, the user provides directions to the BlackBerry server to automatically redirect the email messages to the specified location or the user can just try to block the messages using this option.
Pending_msg_count	Indicates the number of messages that were waiting to be delivered to this user's BlackBerry handheld device.	Number	When the BlackBerry Enterprise Server is unable to deliver a message to a BlackBerry handheld device, the pending count on the BlackBerry Enterprise Server for that BlackBerry handheld device user will increase by one. Messages cannot be delivered to the BlackBerry handheld device if it is outside an area of wireless network coverage or is turned off. Once the BlackBerry handheld device is turned on, or returns to an area with wireless network coverage, the pending messages will be delivered. The pending count on the server will then decrease on the BlackBerry Enterprise Server. Comparing the value of this measure across users will help you identify to which user the maximum number of pending messages were addressed.
Expired_msg_count	Indicates the number of messages that were not delivered to this user's BlackBerry handheld device and are subsequently purged by the Blackberry Enterprise Server during the last measurement period.	Number	Ten minutes after the connection between the BlackBerry® Enterprise Server and the BlackBerry® Infrastructure closes, the BlackBerry Infrastructure notifies the sender’s BlackBerry device and deletes the message that is not delivered. The wireless network can queue up to 5 undelivered messages for up to 7 days. If more than 5 undelivered messages exist in the queue, the BlackBerry Enterprise Server stores the messages in the BlackBerry Configuration Database. The BlackBerry Infrastructure does not store data to send to BlackBerry devices. If the BlackBerry Infrastructure is not responding and the connection closes unexpectedly, the wireless network deletes the undelivered messages. The BlackBerry device does not receive the messages and it does not send acknowledgment packets to the BlackBerry Enterprise Server. When the BlackBerry Infrastructure becomes available again, the BlackBerry Enterprise Server resends messages that it did not receive acknowledgment packets for. Comparing the value of this measure across users will help you identify to which user the maximum number of expired messages were originally addressed.
Failed_msg_count	Indicates the number of email messages that the messaging agent received from this user's BlackBerry handheld device and was unable to process them during the last measurement period.	Number	Comparing the value of this measure across users will help you identify which user's messages failed the most.
Forwarded_msg_count	Indicates the number of email messages that were forwarded to this user's BlackBerry handheld device from the BlackBerry Enterprise Server during the last measurement period.	Number
Failed_conn_count	Indicates the number of times the connection between the BlackBerry Enterprise Server and this user's BlackBerry handheld device failed during the last measurement period.	Number	Comparing the value of this measure across users will help you identify which user's handheld device has experienced the maximum number of connection failures. You may want to investigate the network links between such devices and the BES to ascertain the reasons for the frequent failures.