KB02899 - userOTAFM


Environment

• BlackBerry® Enterprise Server software versions 3.6 through 4.1
• Microsoft® Exchange
• BlackBerry device

---

Overview

Each BlackBerry device user’s wireless message reconciliation state is displayed in the userOTAFM entry of the BlackBerry Enterprise Server debug log. For example, the BlackBerry Enterprise Server debug log displays the following lines of code:
[40442] (10/22 08:16:44):{0x190C} User settings: email=user@maildomain.com, routing=S9999999, service=BlackBerry2, device=, calendar=1, MDS=1,userOTAFM=47, incradle=0, SMIME=0, dir=user, server=EXCHANGE01
The wireless message reconciliation state can be determined using the table below:

userOTAFM Entry	State Description
47	A BlackBerry device user’s account has enabled wireless message reconciliation on the BlackBerry device with the following states turned on: status, delete, move, and purge.
63	Wireless message reconciliation is enabled and the following states are turned on: status, delete, move, purge, and enabled.
32	Wireless message reconciliation has been disabled on the device, or through an IT Policy.

The decimal value of the userOTAFM entry is obtained by adding the hexadecimal values of each applicable state. For example:

OTAFM_STATUS (0x01) + OTAFM_DELETES (0x02) + OTAFM_WIRELESS_FILING (0x04) + OTAFM_PURGE (0x08) + OTAFM_DEVICE_INIT (0x20) = 0x2F (hexadecimal value)
0x2F = 47 (decimal value)

The following table lists some feature states, corresponding hexadecimal values, and additional details:

Feature Description	Hexadecimal Details
OTAFM_STATUS	0x01 Feature bit that implies read, reply to, and forward.
OTAFM_DELETES	0x02 Feature bit
OTAFM_WIRELESS_FILING	0x04 Feature bit
OTAFM_PURGE	0x08 Feature bit
OTAFM_USER_ENABLED	0x10 This is only used in conjunction with the OTAFM_USER_CONFIG flag. Wireless email reconciliation was enabled on the device.
OTAFM_DEVICE_INIT	0x20 This is only used in conjunction with the OTAFM_USER_CONFIG flag.
OTAFM_USER_CONFIG	The value of this state is cumulative. BlackBerry Desktop Software uses this feature and the OTAFM_DEVICE_INIT flag to determine if wireless message reconciliation is enabled on the device, and to display the appropriate interface. This feature enables the interface and functionality appropriate to the OTAFM_SERVER_SUPPORT bitmask. This is cleared by the BlackBerry Desktop Software and the BlackBerry Enterprise Server administrator, if BlackBerry devices are switched. BlackBerry Enterprise Server uses this and the OTAFM_DEVICE_INIT flag to determine if wireless message reconciliation functions should be processed (for example, polling).
OTAFM_SERVER_SUPPORT	0x0f or 0 The value of this state depends on whether or not the registry entry OTAFMSupport has a value of 0 or 1.

__________________
http://blog.port3101.org/hdawg/

The views expressed by me on Port3101 and its affiliated sites are my own and do not necessarily reflect the views of my employer.