getEnvironment

getEnvironment takes an Environment Name and returns the matching Environment Object.


Usage:


getEnvironment(FQN)


Where:


FQN: Is the qualified name of the Environment to be retrieved.


Returns:


Environment Object


A qualified name can include as many Domain names as is necessary to uniquely identify the Environment. If the Environment name is unique within the Domains to which the invoking user has access, then no qualification is necessary. Only if there is more than one Environment with the same name (in different accessible domains) will it be necessary to qualify the Environment name with the domain in which it is located.


Examples:


1) Retrieve an Environment.


set uatenv = getEnvironment("UAT_Env1");


2) Retrieve an Environment specifying the enclosing domain:


set uatenv = getEnvironment("Project1.UAT_Env1");


See Also:

getApplication(), getComponent(), getcredential(), getserver(), getuser(), getusergroup()