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 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 sends the device 4 bytes of ACP data instead of 8 bytes.

If you do not configure this trait, the BlackBerry Enterprise Server 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 .

CalendarRescanInterval

This trait specifies the amount of time, in minutes, that can occur between the scans that the BlackBerry Enterprise Server performs on the calendar contents on the device. When the amount of time between scans expires, the BlackBerry Enterprise Server synchronizes the calendar contents on the device with the calendar contents in the user's email application. If the BlackBerry Enterprise Server detects any differences between the calendar contents, the BlackBerry Enterprise Server synchronizes the differences.

The default value is 15.

EnableLegacyProfileConfig

This trait specifies how the BlackBerry Messaging Agent modifies MAPI profile settings when you install the BlackBerry Enterprise Server. If you want the BlackBerry Messaging Agent to modify the MAPI profile settings that the BlackBerry Enterprise Server requires for BlackBerry Enterprise Server version 4.1 SP6 and earlier, set the trait to true (1).

The default value is false (0), the BlackBerry Messaging Agent modifies the MAPI profile settings by configuring the reconnect settings for the global catalog server that are required for global catalog referrals for Microsoft® Exchange Server 2007.

EWSCASURL

This trait specifies whether the BlackBerry Messaging Agent uses a specific web address to access the client access server for Microsoft® Exchange. You can configure this trait for all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server, or all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances.

If you do not configure this trait, the BlackBerry Messaging Agent uses the Microsoft® Autodiscover service to find the client access server for Microsoft Exchange.

For more information, see Configure the BlackBerry Messaging Agent instances to use a specific web address for a client access server for Microsoft Exchange.

EWSDomain

This trait specifies the domain name to use with the Service Account if you configure the EWSServiceAccount trait.

EWSEnable

This trait specifies how the BlackBerry Enterprise Server manages calendars on devices. You can configure this trait for a specific BlackBerry Messaging Agent, all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server, or all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances.

If you want the BlackBerry Enterprise Server to use only Microsoft Exchange Web Services to manage calendars on devices, change the value to true (1). If you want the BlackBerry Enterprise Server to use only MAPI and CDO libraries to manage calendars on devices, change the value to false (0). If you want the BlackBerry Enterprise Server to use Microsoft Exchange Web Services whenever possible and MAPI and CDO libraries when using Microsoft Exchange Web Services is not possible, delete the trait value which restores the default setting.

For more information, see Configure the BlackBerry Enterprise Server to use Microsoft Exchange Web Services, and

Configure the BlackBerry Enterprise Server to use MAPI and CDO libraries.

EWSMaxWorkerThreads

This trait specifies how many worker threads Microsoft Exchange Web Services uses. This trait is valid for BlackBerry Enterprise Server 5.0 SP1.

The default value is 27.

EWSPassword

This trait specifies the password to use with the Service Account if you configure the EWSServiceAccount trait.

EWSSCPURL

This trait specifies whether the BlackBerry Messaging Agent uses a specific web address to access the Microsoft Autodiscover service. You can configure this trait for all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server, or all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances.

If you do not configure this trait, the BlackBerry Messaging Agent uses a web address to access the Microsoft Autodiscover service that the record lookup for the Microsoft Active Directory Service Connection Point provides.

For more information, see Configure the BlackBerry Messaging Agent instances to use a web address for a specific Microsoft Autodiscover service.

EWSServiceAccount

Service account name that you can use to connect to Microsoft Exchange Web Services to impersonate all other BlackBerry Enterprise Server users.

EWSUserAvailabilityAccess

This trait specifies whether the BlackBerry Messaging Agent receives the user's status using Microsoft Exchange Web Services or by searching for the information in the Microsoft Exchange public folders. You can configure this trait for a specific BlackBerry Messaging Agent, all BlackBerry Messaging Agent instances on a specific BlackBerry Enterprise Server, or all BlackBerry Messaging Agent instances on all BlackBerry Enterprise Server instances. If you want the BlackBerry Messaging Agent to receive the user's status using Microsoft Exchange Web Services, change the value to EWS.

The default value is PF, the BlackBerry Messaging Agent receives the user's status using Microsoft Exchange public folders.

For more information, see Configure the BlackBerry Messaging Agent instances to look up a user's status using only Microsoft Exchange Web Services.

ExchangeDisableConfirmEmailDelivery

This trait specifies whether a user can append the word "confirm" to the subject of email messages to receive an automatic confirmation that the email message is 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.

ExchangeEnableMLangConversion

This trait specifies whether the BlackBerry Messaging Agent uses the Microsoft Multi Language Support DLL to perform character set conversions. If you want the BlackBerry Messaging Agent to use Microsoft Multi Language Support DLL, change the value to true (1).

The default value is false (0).

ExchangeEnableWriteUserStatsToMailbox

This trait specifies whether the BlackBerry Messaging Agent writes statistics to each user's Microsoft Exchange mailbox when it processes email messages for users. By default, to reduce the workload on the Microsoft® Exchange Server, BlackBerry Messaging Agent 5.0 SP2 or later does not write statistics to user mailboxes when it processes email messages. If you want the BlackBerry Messaging Agent to write statistics to users' Microsoft Exchange mailboxes, change the value to true (1).

By default, the value is false (0). If you change this value, the result might be an impact on the performance of your organization's BlackBerry Enterprise Server environment and the Microsoft Exchange Server.

For more information, see Permit the BlackBerry Messaging Agent to write statistics to Microsoft Exchange mailboxes.

ExchangeSmartSyncDays

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

The default value is 7.

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

ExchangeSmartSyncEnable

This trait specifies whether the BlackBerry Enterprise Server checks for calendar errors on devices. The BlackBerry Enterprise Server checks for calendar errors on devices for all user accounts. If you don't want the BlackBerry Enterprise Server to check for calendar errors on devices, change the value to false (0) for a specific user account, all user accounts that are associated with a BlackBerry Enterprise Server, or all user accounts.

The default value is true (1), the BlackBerry Enterprise Server checks for calendar errors on devices.

For more information, see Turn off corrective calendar synchronization process.

ExchangeSmartSyncSchedule

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, or all user accounts.

The default value is Daily.

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

ExchangeSmartSyncSendUpdate

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. If you don't want the BlackBerry Messaging Agent to correct calendar synchronization errors automatically, change the value to false (0) for a specific user account, all user accounts that you associate with a BlackBerry Enterprise Server, or all user accounts.

The default value is true (1), the BlackBerry Messaging Agent corrects calendar synchronization errors automatically.

For more information, see Turn off automatic error correction in corrective calendar synchronization.

ExchangeSmartSyncTriggerHour

This trait specifies when the BlackBerry Enterprise Server checks for calendar synchronization errors on devices. You can configure the BlackBerry Enterprise Server 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, or all user accounts.

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

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

ExchangeSuppressBodyOfSentItems

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 synchronizes email messages sent by an email application.

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

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 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 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 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.

PolicySRPWhitelist

This trait specifies a list of calendar services, messaging services, and browser services that a device can connect to when you turn off the Allow Other Browser Services IT policy rule. To specify a list of services that the device can connect to, type the SRP IDs of the services. Separate the SRP IDs with a comma (,).

The default value is empty, a device cannot connect to calendar services, messaging services, and browser services that your organization does not provide.

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.

RouterAutoDiscoveryMethod

This trait specifies the method that the BlackBerry Enterprise Server uses to update the list of BlackBerry Router instances in the BlackBerry Configuration Database. If you want the BlackBerry Enterprise Server 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 with the list of BlackBerry Router instances, change the value to false (0).

The default value is true (1), the BlackBerry Enterprise Server 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.

ServerHealthPercentage

This trait specifies the percentage of messaging servers that are healthy. The BlackBerry Dispatcher uses this trait to change the Connection to the messaging server(s) health parameter. If this health parameter indicates that the primary BlackBerry Enterprise Server is unhealthy and you turn on automatic failover, the BlackBerry Enterprise Server starts the failover process. You can change the percentage for this trait to customize the percentage of messaging servers that must be unhealthy before an automatic failover occurs in your organization's environment.

The default value is 75%.

For more information, see Change when automatic failover occurs by customizing the health parameters for user accounts and messaging servers.

UserHealthPercentage

This trait specifies the percentage of user accounts that are healthy. The BlackBerry Dispatcher uses this trait to change the User accounts health parameter. If either of the health parameters indicate that the primary BlackBerry Enterprise Server is unhealthy and you turn on automatic failover, the BlackBerry Enterprise Server starts the failover process. You can change the percentage for this trait to customize the percentage of user accounts that must be unhealthy before an automatic failover occurs in your organization's environment.

The default value is 75%.

For more information, see Change when automatic failover occurs by customizing the health parameters for user accounts and messaging servers.


Was this information helpful? Send us your comments.