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.

Function

Description

@Domain

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

@MailDbName

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).

@OptimizeMailAddress(address)

Removes unnecessary domains from an address.

@Password(string)

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

@Platform

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

@StatusBar

Writes a message or messages to the status bar.

@UserAccess

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

@UserNamesList

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.

@UserPrivileges

Returns a text list of the user's privileges.

@UserRoles

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

@Version

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