IBM Support

How does Notes determine which replica to use with @Command([FileOpenDBRepID]) or a database link?

Technote (FAQ)


Question

How does the IBM Notes client determine on which server to open a replica when using @Command([FileOpenDBRepID]), a Notes Data Link (NDL), or a database link?

Answer

The procedure Notes uses to open replicas using @Command([FileOpenDBRepID]), a Notes Data Link, or a database link is as follows:

1. Use the icon for the replica on the user's workspace if one exists. Note: If the icons are stacked, Notes uses the top icon. If the icons are unstacked, it uses the last replica which was opened.
2. If using Catalog/Domain Search, this will be used to locate* a replica.
3. Search the server listed in the Server Hint if one exists.
4. Search the user's home/mail server specified in the current Location document.
5. Search the local machine.
6. Present the user with a list of servers in a "Choose Servers to Search" dialog box. This list is the list of servers that are in the same Notes Network as the user's home server.

*Note: The Catalog/Domain Search server is specified in a user's Location document. The search will open the catalog and find the "best" server choice containing a replica, searching by server name alphabetically. The best choice considers server availability.

While there is no utility to remove icons from the user's desktop (as discussed in the technote "Is there a utility to remove icons from users' desktops associated with a particular server?" #1084489), a workaround is to use LotusScript code to juggle the stacked icons so an available server's database is on the top of the workspace. For this workaround in LotusScript, review the technote "Embedded view displays as a gray box even though a replica available on workspace" (#1139199).


The documentation for @Command([FileOpenDBRepID]) states that Notes "....searches all servers available in the current session." The fact that the documentation and the observed behavior do not coincide was reported to Quality Engineering (SPR # VPAA384HCZ), and it was determined that Notes is performing as designed. The fact that the documentation is not accurate was reported to Quality Engineering (SPR # AMOR4K7J86) and addressed in release 6.0.

An enhancement request, asking that the Server Hint parameter be given precedence over Catalog/Domain Search when attempting to locate a replica, has been submitted to Quality Engineering (SPR # EAVM4THH42).

In addition, an enhancement request, asking that the Server Hint parameter be given primary precedence, when attempting to locate a replica, has been submitted to Quality Engineering (SPR # KTOT7BHSUA).

Supporting Information:
Notes Network information is stored in the Domino Directory and can be seen in the Servers\Networks view. Each server's Notes Network is specified in the Server document. The information is found by selecting the Ports tab, then the Notes Network Ports tab.

Related information

Doclinks access only the server located on top ...
How Does Notes Determine Which Servers To List ...
Embedded view displays as a gray box even though ...
Is there a utility to remove icons from users' desktops
Database link ignores hint when using Database Catalog

Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications IBM Domino Designer Not Applicable 8.5, 8.0 All Editions

Document information

More support for: IBM Notes
Replication

Software version: 8.0, 8.5

Operating system(s): Linux, Windows, iOS

Software edition: All Editions

Reference #: 1094418

Modified date: 13 February 2008


Translate this page: