Administration Guide

Local Navigation

Configuring IBM Lotus Notes links on devices

In IBM® Lotus Notes®, BlackBerry® device users can include Lotus Notes links to connect to documents, specific sections of a document, views, folders, or applications in Lotus Notes. The BlackBerry® Enterprise Server Express supports Lotus Notes links in email messages that users create and receive on their BlackBerry devices. The BlackBerry Enterprise Server Express retrieves the properties of document links, anchor links, view links, or database links (also known as application links) from the IBM® Lotus® Domino® server and converts them into HTTP format. In plain-text email messages, the links appear as web addresses. In HTML email messages, the links appear as icons.

Users can click the HTTP links to view documents, folders, views, or database information in the BlackBerry® Browser. If the information that you want the user to access by clicking the link is stored on a Lotus Domino server that requires authentication, the device might prompt users to type their login information after they click the link.

Lotus Notes links contain the name of the Lotus Domino server that the information that you link to is stored on. The Lotus Domino server name is a Lotus Notes name that the BlackBerry Messaging Agent might not be able to use to access the information that you link to using HTTP. The BlackBerry Enterprise Server Express uses a map that is located in the memory of the BlackBerry Messaging Agent to store information about Lotus Domino servers and the host names for the servers. If the BlackBerry Messaging Agent processes an email message to send to a user and the email message contains links, the BlackBerry Messaging Agent searches the map to find the host name for the Lotus Domino server that stores the information that you link to and creates an HTTP link to display in the email message.

The BlackBerry Enterprise Server Express supports Lotus Notes links on devices if the following conditions exist:

  • Lotus Domino servers that contain the information that you link to must have the HTTP task running
  • Lotus Domino servers that contain the information that you link to must permit browser clients to access databases on the servers

For more information, visit www.ibm.com/developerworks/lotus/documentation/domino/ to read the Lotus Domino Administrator Help.

Updating the map for IBM Lotus Domino server names and host names

When you start the BlackBerry® Messaging Agent, it starts the map for IBM® Lotus® Domino® and stores it in memory. When you add the configuration information for each BlackBerry device user to the BlackBerry® Enterprise Server Express, the BlackBerry Enterprise Server Express populates the map with each user’s Lotus Domino server name and host name. If the BlackBerry Enterprise Server Express detects a new Lotus Domino server when it processes email messages, it adds the server name and host name to the map.

By default, the map updates itself daily at 3:00 AM. If the domain name for a server changes, you must wait until after 3:00 AM for the map to update. You can use a registry value to change how often the map updates. If the map updates more frequently, you have more frequent access to the Lotus Domino Directory.

Change how often the BlackBerry Messaging Agent updates the map for IBM Lotus Domino server names and host names

  1. On the computer that hosts the BlackBerry® Messaging Agent, click Start > Run.
  2. Type regedit.
  3. Perform one of the following actions:
    • If you are running a 32-bit version of Windows®, go to HKEY_LOCAL_MACHINE\SOFTWARE\Research In Motion\BlackBerry Enterprise Server\Agents.
    • If you are running a 64-bit version of Windows, go to HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Research In Motion\BlackBerry Enterprise Server\Agents.
  4. If the DocLink registry key does not exist, create a registry key that you name DocLink.
  5. In the DocLink registry key, create a DWORD value that you name ServerHostNamesCacheTimeout.
  6. Double-click the new DWORD value.
  7. In the Value data field, type the interval, in seconds, that can elapse before the map updates itself. The minimum value is 3600 seconds (1 hour); the maximum value is 86,400 seconds (24 hours).
  8. Click OK.

Was this information helpful? Send us your comments.