Blackbe;rry Enterprise Server 4.1 User manual

Support for IBM Lotus Notes
Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino
Version 4.1 Service Pack 6
©2008 Research In Motion Limited. All rights reserved. www.rim.com

Support for IBM Lotus Notes Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1 Service Pack 6 2 of 6
Last saved: 05/06/2008
www.rim.com
Overview
In IBM®Lotus Notes®, users can include document links, anchor links, view links, or database
links (application links) in their email messages. BlackBerry®Enterprise Server version 4.1 SP6
supports IBM Lotus Notes links in the email messages that users receive on their BlackBerry
devices. The BlackBerry Enterprise Server retrieves the target information from the appropriate
IBM®Lotus®Domino®server and converts it into HTTP format. In plain text messages, the link
appears as a web address. In HTML messages, the link appears as an icon.
Users can click the HTTP links to view documents, folders, views, or database information in the
BlackBerry®Browser. If the target information is stored on a secure IBM Lotus Domino server, the
BlackBerry device might prompt users to type their login information after they click the link.
IBM Lotus Notes links contain the name of the IBM Lotus Domino server that the target
information is stored on. This name is an IBM Lotus Notes name that the BlackBerry Messaging
Agent might not be able to use to access the target information through HTTP. The BlackBerry
Enterprise Server uses a map that is located in the memory of the BlackBerry Messaging Agent
to store information about IBM Lotus Domino servers and the host names for those servers.
When the BlackBerry Messaging Agent processes a message that contains links to send to a
user, the BlackBerry Messaging Agent searches the map to find the host name for the IBM Lotus
Domino server that stores the target information. It also creates an HTTP link to display in the
message.
The map starts and is stored in memory when you start the BlackBerry Messaging Agent. When
each user’s configuration information is added to the BlackBerry Enterprise Server, the
BlackBerry Enterprise Server populates the map with each user’s IBM Lotus Domino server name
and host name. If the BlackBerry Enterprise Server detects a new IBM Lotus Domino server
when it is processing messages, it adds the server name and host name to the map. You can add
IBM Lotus Domino server names and host names to the map manually using a registry value. By
default, the map updates itself daily at 3:00 AM.
By default, support for IBM Lotus Notes links is turned on. You can turn off support for IBM Lotus
Notes links using a registry value.
Requirements
•BlackBerry Enterprise Server version 4.1 SP6
•Any IBM Lotus Domino servers containing the target information must have the HTTP
task running
•Any IBM Lotus Domino servers containing the target information must be configured to
allow browser clients to access databases on the servers
Allow the BlackBerry Enterprise Server to access target information
on other IBM Lotus Domino servers
The BlackBerry Enterprise Server detects the IBM Lotus Domino servers that user accounts are
assigned to and updates the map of IBM Lotus Domino server names and host names
accordingly so that it can access the target information on these servers. If the BlackBerry
Enterprise Server cannot detect an IBM Lotus Domino server (for example, if an IBM Lotus
Domino server is in a different domain), you can add the IBM Lotus Domino server name and
host name to the map manually using a registry value.

Support for IBM Lotus Notes Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1 Service Pack 6 3 of 6
Last saved: 05/06/2008
www.rim.com
1. On the computer that hosts the BlackBerry Messaging Agent, on the Start menu, click
Run.
2. Type regedit.
3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry
Enterprise Server\Agents.
4. If necessary, create a registry key that is named DocLink.
5. In the DocLink registry key, create a multistring value that is named ServerHostNames.
6. Double-click the new multistring value.
7. In the Value data field, type the IBM Lotus Domino server name and host name using the
following format: <servername>!!<hostname> (for example,
CN=server01/O=central!!test.rim.net). Type additional server names and host names
on separate lines.
8. Click OK.
Change how often the map for IBM Lotus Domino server names and
host names updates
By default, the map that the BlackBerry Enterprise Server uses to access target information on
IBM Lotus Domino servers updates daily at 3:00 AM. You can use a registry value to change how
often the map updates.
1. On the computer that hosts the BlackBerry Messaging Agent, on the Start menu, click
Run.
2. Type regedit.
3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry
Enterprise Server\Agents.
4. If necessary, create a registry key that is named DocLink.
5. In the DocLink registry key, create a DWORD value that is named
ServerHostNamesCacheTimeout.
6. Double-click the new DWORD value.
7. In the Value data field, type the interval, in seconds, that the map updates itself.
The minimum value is 3600 seconds (1 hour); the maximum value is 86,400 seconds (24
hours).
8. Click OK.
Turn off support for IBM Lotus Notes links
1. On the computer that hosts the BlackBerry Messaging Agent, on the Start menu, click
Run.
2. Type regedit.
3. Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry
Enterprise Server\Agents.
4. If necessary, create a registry key that is named DocLink.
5. In the DocLink registry key, create a DWORD value that is named Disable.

Support for IBM Lotus Notes Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1 Service Pack 6 4 of 6
Last saved: 05/06/2008
www.rim.com
6. Double-click the new DWORD value.
7. In the Value data field, type 1.
8. Click OK.
After you finish: To turn on support for IBM Lotus Notes links, change the Disable registry value
to 0.
Troubleshooting
Not applicable.
Known limitations
If the map that stores the IBM Lotus Domino server names and host names changes after the
BlackBerry Messaging Agent creates an HTTP link in a message and sends the message to a
user, the user might receive an “HTTP not found” error message when the user clicks the link.
Performance impact
Research In Motion is investigating the potential performance impact of supporting IBM Lotus
Notes links on the BlackBerry Enterprise Server for IBM Lotus Domino.

Support for IBM Lotus Notes Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1 Service Pack 6 5 of 6
Last saved: 05/06/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.
IBM, Lotus, Lotus Notes, and Domino are trademarks of International Business Machines 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

Support for IBM Lotus Notes Links on BlackBerry Devices
BlackBerry Enterprise Server for IBM Lotus Domino Version 4.1 Service Pack 6 6 of 6
Last saved: 05/06/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: 19203255
Last Modified: May 27, 2008