Sets the value of a string or numeric environment variable.

Defined in

Session

Syntax

public void setEnvironmentVar(String vname, Object value)
   throws NotesException

public void setEnvironmentVar(String vname, Object value, boolean issystem)
   throws NotesException

Parameters

String vname

The name of the environment variable to set.

The value of the environment variable. Date values are converted to strings.

If true, no dollar sign character ("$") is prepended to the variable name. If false or omitted, a dollar sign is prepended.

If an environment variable called vname already exists, it is assigned the new value. Otherwise, a new environment variable is added to the NOTES.INI (or Notes Preferences) file.

SetEnvironmentVar prepends a dollar sign character ("$") to the name before setting the value of the environment variable, unless you specify issystem as true or have already included a "$" as the first character of the name. When you examine the environment variable in the NOTES.INI (or Notes Preferences) file, you see the "$" character. When retrieving environment variables with the getEnvironmentString or getEnvironmentValue methods, you have the option of including or omitting the "$" from the variable name.

The environment variable is set in the notes.ini file for the current session.

Language cross-reference

SetEnvironmentVar method in LotusScript NotesSession class

@SetEnvironment function in formula language

@Environment function in formula language

ENVIRONMENT keyword in formula language

Example
See Also

Using environment variables

Glossary