Administration Guide

Local Navigation

BlackBerry Enterprise Trait Tool traits

The BlackBerry® Enterprise Trait Tool includes the following traits that you can change to meet the requirements of your organization's environment:

Trait

Description

ACPByteSizeDeviceVersion

This trait specifies the minimum version of the BlackBerry® Device Software that can receive 8 bytes of ACP data. The typical amount of ACP data that BlackBerry devices can receive is 4 bytes. The BlackBerry® Enterprise Server Express check-s the value of this trait to find out how many bytes of ACP data to send to devices. If the version of the BlackBerry Device Software that the device is running is earlier than the version that this trait specifies, the BlackBerry Enterprise Server Express sends the device 4 bytes of ACP data instead of 8 bytes.

If you do not configure this trait, the BlackBerry Enterprise Server Express sends 8 bytes of ACP data to the device.

ActiveDirectoryLDAPConnectTimeout

This trait specifies the number of seconds that the BlackBerry Administration Service waits for the BlackBerry Administration Service and the Microsoft® Active Directory® to connect over LDAP before the connection times out.

The default value is 5.

BASIsProxyWPADOptionEnabled

This trait specifies whether the BlackBerry Administration Service uses the Web Proxy Autodiscovery protocol to discover proxy servers automatically. If you want to enable the Web Proxy Autodiscovery protocol, change the value to 1. If you want to disable the Web Proxy Autodiscovery protocol, change the value to 0.

If you do not change the value to 1, the Web Proxy Autodiscovery protocol is not enabled.

For more information, see Configure the BlackBerry Administration Service to use Web Proxy Autodiscovery Protocol to discover a proxy server .

BASNumberOfAdditionalWiredApplicationsToIncludeInACP

This trait specifies the number of additional wired applications to include in the application control policy when reconciling applications.

BASPASBundleRequestVersionSupport

This trait specifies the version of the BundleRequest.xml file that the BlackBerry® Infrastructure supports.

The default version is 1.0.

BASProxyBasicAuthPassword and BASProxyBasicAuthUID

If the BlackBerry Administration Service uses HTTP basic authentication to authenticate with a proxy server, these traits specify the password and user name that the BlackBerry Administration Service can use. You can specify the password and user name for a BlackBerry Administration Service instance, or for all the BlackBerry Administration Service instances in the BlackBerry Domain. If you do not configure these traits, you cannot use HTTP basic authentication for proxy authentication.

For more information, see Configure the BlackBerry Administration Service to use HTTP basic authentication .

DocumentThrottleMaxDocOpen

This trait specifies the maximum number of documents that have the same Universal Note ID that the BlackBerry Messaging Agent can open.

If you do not configure this trait, there is no limit to the number of documents that have the same Universal Note ID that the BlackBerry Messaging Agent can open.

DominoDisableConfirmEmailDelivery

This trait specifies whether a BlackBerry device user can append the word "confirm" to the subject of an email message to receive an automatic confirmation that the email message was delivered to the intended recipient. If you want to permit the BlackBerry Messaging Agent to send confirmations automatically when the BlackBerry Messaging Agent delivers email messages, change the value to false (0). If you want to prevent the BlackBerry Messaging Agent from sending confirmations automatically when the BlackBerry Messaging Agent delivers email messages, change the value to true (1).

The default value is false (0), the BlackBerry Messaging Agent sends confirmations automatically when the BlackBerry Messaging Agent delivers email messages.

DominoSmartSyncDays

This trait specifies how many days in the calendar, after the current date, that the BlackBerry Enterprise Server Express checks for calendar errors on devices. You can configure the BlackBerry Enterprise Server Express to check for calendar errors for a user account, all user accounts that you associate with a specific BlackBerry Enterprise Server Express, or all user accounts.

The default value is 1.

For more information, see Configure the range of days to check for calendar synchronization errors.

DominoSmartSyncEnable

This trait specifies whether the BlackBerry Enterprise Server Express checks for calendar errors on devices. You can configure the BlackBerry Enterprise Server Express to check for calendar errors for a specific user account, all user accounts that you associate with a BlackBerry Enterprise Server Express, or all user accounts. If you want the BlackBerry Enterprise Server Express to check for calendar errors on devices, change the value to true (1).

The default value is false (0), the BlackBerry Enterprise Server Express does not check for calendar errors on devices.

For more information, see Turn on corrective calendar synchronization.

DominoSmartSyncSchedule

This trait specifies when the calendar synchronization process runs. You can configure the calendar synchronization process to start running on multiple recurring days or on only one recurring day for a user account, all user accounts that you associate with a BlackBerry Enterprise Server Express, or all user accounts.

The default value is Daily.

For more information, see Configure when corrective calendar synchronization runs.

DominoSmartSyncSendUpdate

This trait specifies whether the calendar synchronization process writes calendar synchronization errors to the BlackBerry Messaging Agent log file, or writes the errors to the log file and corrects the calendar synchronization errors on devices. You can configure the BlackBerry Messaging Agent to correct calendar synchronization errors automatically for a specific user account, all user accounts that you associate with a BlackBerry Enterprise Server Express, or all user accounts. If you want the BlackBerry Messaging Agent to correct calendar synchronization errors automatically, change the value to true (1).

The default value is false (0), the BlackBerry Messaging Agent does not correct calendar synchronization errors automatically.

For more information, see Permit the calendar synchronization process to correct errors automatically.

DominoSmartSyncStartWindow

This trait specifies the duration of the time window, in minutes, that calendar synchronization sessions are distributed randomly to throttle the calendar synchronization process. The time window starts at the time that you specify for DominoSmartSyncTriggerHour. The minimum value is 20 minutes, the maximum value is 1440 minutes (24 hours).

The default value is 60 minutes, the BlackBerry Enterprise Server Express distributes calendar synchronization sessions randomly over a one-hour time window starting at the time specified for DominoSmartSyncTriggerHour.

For more information, see Configure throttling for corrective calendar synchronization.

DominoSmartSyncTriggerHour

This trait specifies when the BlackBerry Enterprise Server Express checks for calendar synchronization errors on devices. You can configure the BlackBerry Enterprise Server Express to check for calendar synchronization errors on devices at a specific hour for a specific user account, all user accounts that you associate with a BlackBerry Enterprise Server Express, or all user accounts.

The default value is 0, the BlackBerry Enterprise Server Express checks for calendar synchronization errors on devices at 12:00 AM.

For more information, see Configure when corrective calendar synchronization runs.

DominoSuppressBodyOfSentItems

This trait specifies whether the body of an email message is included in an email message sent to a device when the BlackBerry Enterprise Server Express synchronizes email messages that an email application sends.

The default value is false (0), the body of an email message is sent to a device.

EnableNNEIDFileProvisioning

This trait specifies whether the BlackBerry Enterprise Server Express can synchronize IBM® Lotus Notes® .id files with the Lotus Notes ID vault automatically and send the files to devices. Devices require the Lotus Notes .id files to support Lotus Notes encryption. If you want the BlackBerry Enterprise Server Express to synchronize Lotus Notes .id files with the Lotus Notes ID vault automatically and send the files to devices, change the value to true (1). If you do not want the BlackBerry Enterprise Server Express to synchronize Lotus Notes .id files automatically with the Lotus Notes ID vault and send the files to devices, change the value to false (0).

The default value is true (1), the BlackBerry Enterprise Server Express synchronizes Lotus Notes .id files with the Lotus Notes ID vault automatically and sends the files to devices.

For more information, see Configure BlackBerry Enterprise Server Express instances to import Lotus Notes .id files to BlackBerry devices.

MailstoreAddressRefreshEnabled

This trait specifies whether you want the BlackBerry Mail Store Service to update the user directory in the BlackBerry Configuration Database. If you want the BlackBerry Mail Store Service to update the user directory in the BlackBerry Configuration Database, change the value to true (1). If you do not want the BlackBerry Mail Store Service to update the user directory in the BlackBerry Configuration Database, change the value to false (0).

The default value is true (1), the BlackBerry Mail Store Service updates the user directory in the BlackBerry Configuration Database.

For more information, see Configure the BlackBerry Mail Store Service instance that updates the contact list.

MailstorePublicFolderLookupEnabled

This trait specifies whether the BlackBerry Administration Service looks up public folders and displays them in the list of public contact folders. When an organization has a large number of public folders available, it can take longer than expected for the BlackBerry Messaging Agent to display the folders and the BlackBerry Administration Service might time out. If you want to turn off the look up function, change the value to false (0). If you turn off the look up function, you can access the BlackBerry Messaging Agent in the BlackBerry Administration Service but you cannot see the list of available public folders in the Email component page in the BlackBerry Administration Service.

The default value is true (1), the BlackBerry Administration Service looks up public folders.

MaxDomainSlowSyncsPerMin

This trait specifies the maximum number of full synchronization events that the BlackBerry Synchronization Service can process each minute, in a BlackBerry Domain.

The default value is 300.

MaxPollCycleCountForHungSlowSync

This trait specifies the maximum number of times that the BlackBerry Synchronization Service polls a device to determine if there is a hung synchronization event.

The default value of 10.

MaxPollCycleCountForNoResponseToSlowSync

This trait specifies the maximum number of times that the BlackBerry Synchronization Service polls a device to determine if the device is out of a wireless coverage area or if wireless synchronization is disabled on the device.

The default value is 2.

MaxSyncServerSlowSyncsInProcess

This trait specifies the maximum number of full synchronization events that a BlackBerry Synchronization Service can start before it schedules more full synchronization events.

The default value is 10.

MaxSyncServerSlowSyncsPerMin

This trait specifies the maximum number of pending full synchronization events that the BlackBerry Synchronization Service can process each minute.

The default value is 30.

MonitorJunkEmailFolderForETP

This trait specifies whether the BlackBerry Messaging Agent monitors the Junk folder and the Inbox for email messages that include an etp.dat attachment. When the activation process over the wireless network begins, the BlackBerry Enterprise Server Express sends an email message that includes an etp.dat attachment from the blackberry.net domain to the email account of the user. In some scenarios, anti-spam software applications that the messaging server or gateway uses filters the email messages and places them in the Junk folder. If you do not want the BlackBerry Enterprise Server Express to monitor the Junk folder for activation messages, change the value to false (0) and restart the BlackBerry Controller.

The default value is true (1), the BlackBerry Enterprise Server Express monitors the Junk folder for activation messages.

NumberOfUserTargetTypeForSlowSyncInParallel

This trait specifies how many different types of organizer data, such as tasks, memos, and contacts, the BlackBerry Synchronization Service can synchronize at the same time during a full synchronization event.

The default value is 10.

OutOfOfficeAPIEnable

This trait specifies whether you want to turn on the use of the out-of-office API that is available in Lotus Notes 8.5.1 and later. If this trait is configured to false (0), the BlackBerry Enterprise Server Express uses a previous implementation for the out-of-office functionality on devices, which does not work correctly if a user turns on the out-of-office service mode in Lotus Notes.

The default value is true (1), the out-of-office API in Lotus Notes 8.5.1 and later is used.

PolicyEnterpriseWipeCommandOrderTraitType

This trait specifies the order for commands that run when the BlackBerry Policy Service sends the "Delete only the organization data and remove device" IT administration command to a device. The value is a string that contains the command IDs separated by a colon (:), for example, commandId1:commandId2.

The default value is 3:18.

Contact a BlackBerry Technical Support representative before you change the default value of this trait.

PolicyThrottlingAppPush

This trait specifies whether the BlackBerry Policy Service uses throttling to send applications the same way that it throttles IT policies and service books. If you want the BlackBerry Policy Service to send applications using throttling in the same way that it throttles IT policies and service books, change the value to true (1). If you do not want the BlackBerry Policy Service to send applications using throttling in the same way that it throttles IT policies and service books, change the value to false (0).

The default value is false (0), the BlackBerry Policy Service does not use throttling to send applications the same way that it throttles IT policies and service books.

For more information, see Configure BlackBerry Policy Service throttling for application polling.

PolicyThrottlingInProcessJobs

This trait specifies the maximum number of processes for IT policies or processes for service books that a BlackBerry Policy Service can run at one time before the BlackBerry Policy Service schedules additional processes for IT policies or service books.

The default value is 30.

For more information, see Configure BlackBerry Policy Service throttling for IT policies and service books.

PolicyThrottlingMaxBESJobs

This trait specifies the maximum number of IT policies and service books that a BlackBerry Policy Service can send to devices each minute.

The default value is 100.

For more information, see Configure BlackBerry Policy Service throttling for IT policies and service books.

PolicyThrottlingMaxDomainJobs

This trait specifies the maximum number of IT policies and service books that all BlackBerry Policy Service instances can send to devices each minute.

The default value is 300.

For more information, see Configure BlackBerry Policy Service throttling for IT policies and service books.

PolicyThrottlingP2PKeyRate

This trait specifies the maximum number of processes for PIN encryption keys that a BlackBerry Policy Service can process at one time before the BlackBerry Policy Service schedules additional processes for PIN encryption keys.

The default value is 60.

For more information, see Configuring BlackBerry Policy Service throttling for PIN encryption keys.

PrepopulatePIMForNotesUsers

This trait specifies whether administrators can change the PIM location for roaming. If you want to permit administrators to change the PIM location for roaming, change the value to false (0). If you do not want to permit administrators to change the PIM location for roaming, change the value to true (1) and the BlackBerry Messaging Agent determines the PIM location.

The default value is true (1), administrators cannot change the PIM location for roaming.

RouterAutoDiscoveryMethod

This trait specifies the method that the BlackBerry Enterprise Server Express uses to update the list of BlackBerry Router instances in the BlackBerry Configuration Database. If you want the BlackBerry Enterprise Server Express to compile the list of BlackBerry Router instances automatically, change the value to true (1). If you want the BlackBerry Router instances to provide the BlackBerry Enterprise Server Express with the list of BlackBerry Router instances, change the value to false (0).

The default value is true (1), the BlackBerry Enterprise Server Express compiles the list of BlackBerry Router instances automatically.

SlowSyncPollCycleInterval

This trait specifies the interval (in minutes) between the times that the BlackBerry Synchronization Service reviews the list of users, to determine how many pending full synchronization events can be scheduled based on the throttling parameters.

The default value is 2.


Was this information helpful? Send us your comments.