@MailDbName (Formula Language)

Syntax

@MailDbName

Return value

Server : path

Text list with two elements:

• server is the canonical hierarchical name of the server on which the user's mail database resides.

  This element is an empty string ("") if:

  • The database is local
  • The formula is used in a Scheduled agent running on the server

  Use @Name to extract a part of the name; for example, [CN] to extract the common name.

• path is the path and file name of the database. The path is relative to the Notes® or Domino® data directory.

Usage

This function works in any formula except column formulas. When a formula runs on a server, the server is considered the current user, so @MailDbName returns the server's mailbox.

The returned value is formatted as a two-item text list specifying Server : Directory\Database.NSF, as in:

CN=acmemail/O=Acme : mail\dlee.nsf

If the database is stored on the user's own computer, Notes/Domino returns the empty string for the server name. For example, user Debbie Lee may keep a local replica of her Mail database on her workstation; when she is set up for workstation-based mail, @MailDbName returns:

"" : mail\dlee.nsf

This is useful in applications that send mail; for example, you can use it to determine whether the current user is set up for server-based mail, and determine the appropriate course of action based on the result.

You cannot use this function in Web applications.

Examples

1. This example returns the server and path of the user's mail file.

   @MailDbName

2. This example returns the path of the user's mail file.

   @Subset(@MailDbName;-1)

3. This example returns the canonical name of the server containing the user's mail file.

   @Subset(@MailDbName;1)

4. This example returns the common name of the server containing the user's mail file.

   @Name([CN]; @Subset(@MailDbName; 1))