Blackbe;rry ENTERPRISE SERVER FOR MICROSOFT EXCHANGE - CALENDAR SYNCHRONIZATION TOOL - TECHNICAL... User manual

BlackBerry Calendar Synchronization
Tool
BlackBerry Enterprise Server for Microsoft Exchange
Version 4.1 Service Pack 6
©2008 Research In Motion Limited. All rights reserved. www.rim.com

BlackBerry Calendar Synchronization Tool
2 of 7
Last saved: 14/08/2008
www.rim.com
Overview
You can run the BlackBerry®Calendar Synchronization Tool on a BlackBerry®Enterprise Server
to find and correct differences between the calendar entries on users’ BlackBerry devices and the
calendar entries on users’ computers. You can specify the recurring day and time when the tool
runs, how many days in advance of the current date that the tool checks users’ calendars for
synchronization errors, and whether the tool checks calendar entries for all users, the users on a
specific messaging server, or a specific user.
By default, the tool writes information about calendar synchronization errors to the BlackBerry
Messaging Agent log file. You can configure the tool to correct automatically the calendar
synchronization errors that it finds.
The tool is located in the Tools directory on the BlackBerry Enterprise Server installation media.
The file name is TraitTool.exe.
Requirements
•BlackBerry Enterprise Server for Microsoft®Exchange version 4.1 SP6
Managing the BlackBerry Calendar Synchronization Tool
Specify a setting
1. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
2. Type: TraitTool <level> -trait <name> -set <value>
•For <level>, type the level that you want to specify a setting for. See “Configuration
levels” below.
•For <name>, type the trait that you want to specify. See “BlackBerry Calendar
Synchronization Tool traits” below.
•For <value>, type a value for the trait that you specified. See “BlackBerry Calendar
Synchronization Tool traits” below.
3. Press ENTER.
Delete a setting
If you delete the setting for a trait, the trait uses the setting that is defined at the next highest
level. If no values are defined, the default setting is used. For example, if you delete a setting at
the user level, the trait uses the setting that is defined at the server level.
1. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
2. Type: TraitTool <level> -trait <name> -erase
•For <level>, type the level that you want to delete a setting for. See “Configuration
levels” below.
•For <name>, type the trait that you want to delete the setting for. See “BlackBerry
Calendar Synchronization Tool traits” below.
3. Press ENTER.

BlackBerry Calendar Synchronization Tool
3 of 7
Last saved: 14/08/2008
www.rim.com
View the current settings
1. At the command prompt, navigate to the folder that the TraitTool.exe file is located in.
2. Type: TraitTool <level> -list
•For <level>, type the level that you want to view the settings for. See “Configuration
levels” below.
3. Press ENTER.
Configuration levels
Settings at the user level take precedence over settings at the server level. Settings at the server
level take precedence over settings at the global level. Settings at the global level take
precedence over the default settings.
Level Description
-global The setting that you specify applies to all users.
-server <servername> The setting that you specify applies to all users on a specific
messaging server.
-user <smtpaddress> The setting that you specify applies to a specific user.
BlackBerry Calendar Synchronization Tool traits
Trait Description Trait values
SmartSyncEnable This trait turns on or turns off the
BlackBerry Calendar
Synchronization Tool.
•To turn on the tool, type true.
•To turn off the tool, type false.
The default value is false.
SmartSyncTriggerHour This trait specifies the hour that
the BlackBerry Calendar
Synchronization Tool starts
running.
•0 through 23, where 0 is 12:00
AM and 23 is 11:00 PM.
The default value is 0 (12:00 AM).
SmartSyncDays This trait specifies the number of
days in advance of the current
date that the BlackBerry
Calendar Synchronization Tool
checks for calendar
synchronization errors.
•1 through 365
The default value is 1.
SmartSyncSchedule This trait specifies the recurring
day or days when the BlackBerry
Calendar Synchronization Tool
runs. To specify more than one
value, you can use a comma-
separated list.
•Monday
•Tuesday
•Wednesday
•Thursday

BlackBerry Calendar Synchronization Tool
4 of 7
Last saved: 14/08/2008
www.rim.com
•Friday
•Saturday
•Sunday
•Weekdays
•Weekends
•Daily
The default value is Daily.
SmartSyncSendUpdate This trait specifies whether the
BlackBerry Calendar
Synchronization Tool writes
calendar synchronization errors
to the BlackBerry Messaging
Agent log file, or if it writes and
corrects calendar synchronization
errors.
•If you want the tool to write
calendar synchronization errors
to the BlackBerry Messaging
Agent log file without correcting
errors, type false.
•If you want the tool to write and
correct calendar synchronization
errors, type true.
The default value is false.
Examples
Turning on the BlackBerry Calendar Synchronization Tool for all users
TraitTool -global -trait SmartSyncEnable -set true
Configuring the BlackBerry Calendar Synchronization Tool to run on weekdays for all users
TraitTool -global -trait SmartSyncSchedule -set Weekdays
Configuring the BlackBerry Calendar Synchronization Tool to check calendar entries 3 days in
advance for all users
TraitTool -global -trait SmartSyncDays -set 3
Configuring the BlackBerry Calendar Synchronization Tool to run at 10:00 PM for all users on the
messaging server SERVER01
TraitTool –server SERVER01 -trait SmartSyncTriggerHour -set 22
Configuring the BlackBerry Calendar Synchronization Tool to run at 11:00 PM for all users on the
messaging server SERVER02
TraitTool –server SERVER02 -trait SmartSyncTriggerHour -set 23
Configuring the BlackBerry Calendar Synchronization Tool to correct calendar synchronization
errors for a specific user
TraitTool –user [email protected] -trait SmartSyncSendUpdate
–set true

BlackBerry Calendar Synchronization Tool
5 of 7
Last saved: 14/08/2008
www.rim.com
Configuring the BlackBerry Calendar Synchronization Tool to run on Monday, Wednesday, and
Friday for a specific user
TraitTool –user [email protected] -trait SmartSyncSchedule -set
Monday,Wednesday,Friday
Turning off the BlackBerry Calendar Synchronization Tool for a specific user
TraitTool –user [email protected] -trait SmartSyncEnable -set
false
Deleting the setting for the hour that the BlackBerry Calendar Synchronization Tool runs on the
messaging server SERVER01
TraitTool –server SERVER01 –trait SmartSyncTriggerHour –erase
Viewing the global BlackBerry Calendar Synchronization Tool settings
TraitTool -global -list
Troubleshooting
When the BlackBerry Calendar Synchronization Tool finds differences between the calendar
entries on a user’s computer and the calendar entries on a user’s BlackBerry device, the tool
writes information to the BlackBerry Messaging Agent log file. You can use this information to
troubleshoot calendar synchronization issues.
Known limitations
In certain circumstances, the BlackBerry Calendar Synchronization Tool might not be able to
correct calendar synchronization errors. For example, if a recurring meeting appears in the
calendar on a user’s BlackBerry device but not in the calendar on the user’s computer, the tool
might not delete the recurring meeting from the user’s BlackBerry device. Research In Motion is
currently investigating other circumstances.
Performance impact
Visit www.blackberry.com/go/serverdocs to see the Impact of using the BlackBerry Calendar
Synchronization Tool technical note.

BlackBerry Calendar Synchronization Tool
6 of 7
Last saved: 14/08/2008
www.rim.com
©2008 Research In Motion Limited. All rights reserved. BlackBerry®, RIM®, Research In Motion®,
SureType® and related trademarks, names and logos are the property of Research In Motion Limited and
are registered and/or used as trademarks in the U.S., Canada and countries around the world.
Microsoft is a trademark of Microsoft Corporation. All other trademarks are the properties of their respective
owners.
The BlackBerry smartphone and other devices and/or associated software are protected by copyright,
international treaties, and various patents, including one or more of the following U.S. patents: 6,278,442;
6,271,605; 6,219,694; 6,075,470; 6,073,318; D445,428; D433,460; D416,256. Other patents are registered
or pending in the U.S. and in various countries around the world. Visit www.rim.com/patents for a list of RIM
(as hereinafter defined) patents.
This documentation including all documentation incorporated by reference herein such as documentation
provided or made available at www.blackberry.com/go/docs is provided or made accessible "AS IS" and "AS
AVAILABLE" and without condition, endorsement, guarantee, representation, or warranty of any kind by
Research In Motion Limited and its affiliated companies ("RIM") and RIM assumes no responsibility for any
typographical, technical, or other inaccuracies, errors, or omissions in this documentation. In order to
protect RIM proprietary and confidential information and/or trade secrets, this documentation may describe
some aspects of RIM technology in generalized terms. RIM reserves the right to periodically change
information that is contained in this documentation; however, RIM makes no commitment to provide any
such changes, updates, enhancements, or other additions to this documentation to you in a timely manner
or at all.
This documentation might contain references to third-party sources of information, hardware or software,
products or services including components and content such as content protected by copyright and/or third-
party web sites (collectively the "Third Party Products and Services"). RIM does not control, and is not
responsible for, any Third Party Products and Services including, without limitation the content, accuracy,
copyright compliance, compatibility, performance, trustworthiness, legality, decency, links, or any other
aspect of Third Party Products and Services. The inclusion of a reference to Third Party Products and
Services in this documentation does not imply endorsement by RIM of the Third Party Products and
Services or the third party in any way.
EXCEPT TO THE EXTENT SPECIFICALLY PROHIBITED BY APPLICABLE LAW IN YOUR
JURISDICTION, ALL CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS, OR
WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY
CONDITIONS, ENDORSEMENTS, GUARANTEES, REPRESENTATIONS OR WARRANTIES OF
DURABILITY, FITNESS FOR A PARTICULAR PURPOSE OR USE, MERCHANTABILITY,
MERCHANTABLE QUALITY, NON-INFRINGEMENT, SATISFACTORY QUALITY, OR TITLE, OR ARISING
FROM A STATUTE OR CUSTOM OR A COURSE OF DEALING OR USAGE OF TRADE, OR RELATED
TO THE DOCUMENTATION OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY
SOFTWARE, HARDWARE, SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES
REFERENCED HEREIN, ARE HEREBY EXCLUDED. YOU MAY ALSO HAVE OTHER RIGHTS THAT
VARY BY STATE OR PROVINCE. SOME JURISDICTIONS MAY NOT ALLOW THE EXCLUSION OR
LIMITATION OF IMPLIED WARRANTIES AND CONDITIONS. TO THE EXTENT PERMITTED BY LAW,
ANY IMPLIED WARRANTIES OR CONDITIONS RELATING TO THE DOCUMENTATION TO THE
EXTENT THEY CANNOT BE EXCLUDED AS SET OUT ABOVE, BUT CAN BE LIMITED, ARE HEREBY
LIMITED TO NINETY (90) DAYS FROM THE DATE YOU FIRST ACQUIRED THE DOCUMENTATION OR
THE ITEM THAT IS THE SUBJECT OF THE CLAIM.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, IN NO
EVENT SHALL RIM BE LIABLE FOR ANY TYPE OF DAMAGES RELATED TO THIS DOCUMENTATION
OR ITS USE, OR PERFORMANCE OR NON-PERFORMANCE OF ANY SOFTWARE, HARDWARE,
SERVICE, OR ANY THIRD PARTY PRODUCTS AND SERVICES REFERENCED HEREIN INCLUDING
WITHOUT LIMITATION ANY OF THE FOLLOWING DAMAGES: DIRECT, CONSEQUENTIAL,
EXEMPLARY, INCIDENTAL, INDIRECT, SPECIAL, PUNITIVE, OR AGGRAVATED DAMAGES, DAMAGES
FOR LOSS OF PROFITS OR REVENUES, FAILURE TO REALIZE ANY EXPECTED SAVINGS,
BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, LOSS OF BUSINESS
OPPORTUNITY, OR CORRUPTION OR LOSS OF DATA, FAILURES TO TRANSMIT OR RECEIVE ANY
DATA, PROBLEMS ASSOCIATED WITH ANY APPLICATIONS USED IN CONJUNCTION WITH RIM
PRODUCTS OR SERVICES, DOWNTIME COSTS, LOSS OF THE USE OF RIM PRODUCTS OR
SERVICES OR ANY PORTION THEREOF OR OF ANY AIRTIME SERVICES, COST OF SUBSTITUTE
GOODS, COSTS OF COVER, FACILITIES OR SERVICES, COST OF CAPITAL, OR OTHER SIMILAR

BlackBerry Calendar Synchronization Tool
7 of 7
Last saved: 14/08/2008
www.rim.com
PECUNIARY LOSSES, WHETHER OR NOT SUCH DAMAGES WERE FORESEEN OR UNFORESEEN,
AND EVEN IF RIM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW IN YOUR JURISDICTION, RIM SHALL
HAVE NO OTHER OBLIGATION, DUTY, OR LIABILITY WHATSOEVER IN CONTRACT, TORT, OR
OTHERWISE TO YOU INCLUDING ANY LIABILITY FOR NEGLIGENCE OR STRICT LIABILITY.
THE LIMITATIONS, EXCLUSIONS, AND DISCLAIMERS HEREIN SHALL APPLY: (A) IRRESPECTIVE OF
THE NATURE OF THE CAUSE OF ACTION, DEMAND, OR ACTION BY YOU INCLUDING BUT NOT
LIMITED TO BREACH OF CONTRACT, NEGLIGENCE, TORT, STRICT LIABILITY OR ANY OTHER
LEGAL THEORY AND SHALL SURVIVE A FUNDAMENTAL BREACH OR BREACHES OR THE FAILURE
OF THE ESSENTIAL PURPOSE OF THIS AGREEMENT OR OF ANY REMEDY CONTAINED HEREIN;
AND (B) TO RIM AND ITS AFFILIATED COMPANIES, THEIR SUCCESSORS, ASSIGNS, AGENTS,
SUPPLIERS (INCLUDING AIRTIME SERVICE PROVIDERS), AUTHORIZED RIM DISTRIBUTORS (ALSO
INCLUDING AIRTIME SERVICE PROVIDERS) AND THEIR RESPECTIVE DIRECTORS, EMPLOYEES,
AND INDEPENDENT CONTRACTORS.
IN ADDITION TO THE LIMITATIONS AND EXCLUSIONS SET OUT ABOVE, IN NO EVENT SHALL ANY
DIRECTOR, EMPLOYEE, AGENT, DISTRIBUTOR, SUPPLIER, INDEPENDENT CONTRACTOR OF RIM
OR ANY AFFILIATES OF RIM HAVE ANY LIABILITY ARISING FROM OR RELATED TO THE
DOCUMENTATION.
Prior to subscribing for, installing, or using any Third Party Products and Services, it is your responsibility to
ensure that your airtime service provider has agreed to support all of their features. Installation or use of
Third Party Products and Services with RIM's products and services may require one or more patent,
trademark, copyright, or other licenses in order to avoid infringement or violation of third party rights. You are
solely responsible for determining whether to use Third Party Products and Services and if any third party
licenses are required to do so. If required you are responsible for acquiring them. You should not install or
use Third Party Products and Services until all necessary licenses have been acquired. Any Third Party
Products and Services that are provided with RIM's products and services are provided as a convenience to
you and are provided "AS IS" with no express or implied conditions, endorsements, guarantees,
representations, or warranties of any kind by RIM and RIM assumes no liability whatsoever, in relation
thereto. Your use of Third Party Products and Services shall be governed by and subject to you agreeing to
the terms of separate licenses and other agreements applicable thereto with third parties, except to the
extent expressly covered by a license or other agreement with RIM.
The terms of use of any RIM product or service are set out in a separate license or other agreement with
RIM applicable thereto. NOTHING IN THIS DOCUMENTATION IS INTENDED TO SUPERSEDE ANY
EXPRESS WRITTEN AGREEMENTS OR WARRANTIES PROVIDED BY RIM FOR PORTIONS OF ANY
RIM PRODUCT OR SERVICE OTHER THAN THIS DOCUMENTATION.
Certain features outlined in this documentation require a minimum version of BlackBerry® Enterprise Server
Software, BlackBerry® Desktop Software, and/or BlackBerry® Device Software and may require additional
development or Third Party Products and Services for access to corporate applications.
This product includes software developed by the Apache Software Foundation (www.apache.org/) and/or
licensed pursuant to Apache License, Version 2.0 (www.apache.org/licenses/). For more information, see
the NOTICE.txt file included with the software. Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing
permissions and limitations under the License.
Document ID: 19151692
Last Modified: May 9, 2008