Get Environment

Get an Environment object based on the Environment Name.

get_Environment_takes an_Environment_Name and returns the matching_Environment Object_.

Usage

get_Environment_(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 = get_Environment_(“UAT_Env1”);

2) Retrieve an Environment specifying the enclosing domain:

set uatenv = get_Environment_(“Project1.UAT_Env1”);

Further descriptions of Environment Objects are found in the high level section named DMScript Objects, in the section named Environment.

See Also

get_Application_(), get_Component_(), getcredential(), getserver(), getuser(), getusergroup()