FORMULA LANGUAGE

Accessing the user environment
Example

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.

FunctionDescription
@DomainReturns the name of the user's Lotus Notes/Domino mail domain.
@MailDbNameReturns 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.
@PlatformReturns the platform that the user is running on: Macintosh, NetWare, OS2V1, OS2V2, UNIX, Windows/16, or Windows/32.
@StatusBarWrites a message or messages to the status bar.
@UserAccessGiven a server and file name, indicates the user's level of access to the database.
@UserNamesListReturns 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.
@UserPrivilegesReturns a text list of the user's privileges.
@UserRolesFor databases on servers, returns a list of roles for the current user.
@VersionReturns (as a string) the version of Notes that is running.

Example
See Also