Accessing the user environment

The user environment is the server or workstation containing the database for: replication formulas, agents with the triggers "After new mail has arrived" or "On schedule," selection formulas, or column formulas. Otherwise, the user environment is the Notes® workstation of the user running the formula.

User names can be either distinguished or non-distinguished, and distinguished names can be canonical or abbreviated. Use @Name to change the form of a user name.

The following @functions return or process information on the user environment.




Returns the name of the user's Notes/Domino mail domain.


Returns the server name and path name for the user's mail database. This @function evaluates to a 2-member list.

@Name([key]; name)

Changes the form of a user name. The keywords include [CN] to extract the common name from a distinguished name, [Abbreviate] to abbreviate a distinguished name in canonical form, [Canonicalize] to do the reverse, and [ToKeyword] to put the name components in reverse order separated by backslashes (for categorized views).


Removes unnecessary domains from an address.


Encodes a string. You cannot determine the original string from the encoded result.


Returns the platform that the user is running on: Macintosh, NetWare, OS2V1, OS2V2, UNIX, Windows/16, or Windows/32.


Writes a message or messages to the status bar.


Given a server and file name, indicates the user's level of access to the database.


Returns a text list containing the user's common name, hierarchical names, ACL roles (if any), and if the database is on a server, any groups the user belongs to.


Returns a text list of the user's privileges.


For databases on servers, returns a list of roles for the current user.


Returns (as a string) the version of Notes® that is running.