List Environment Variables

Description

Populates a dataset with the names and values of a specified type of environment variable. The data can then be extracted from the dataset using other actions such as Loop Dataset or Dataset to Cells.

Declaration

<AMLISTENVIRONMENTVARIABLES RESULTDATASET="text" TYPE="text [options]" />

Example

<AMLISTENVIRONMENTVARIABLES RESULTDATASET="EnvrmtVarDataset" TYPE="USER" />

General Tab Parameters

Environment variable scope: Specifies the scope of the environment variable. The available options are:

  • User - The environment variable is stored or retrieved from the HKEY_CURRENT_USER\Environment key in the Windows operating system registry. When the user creates the environment variable in a set operation, the operating system stores the environment variable in the system registry, but not in the current process. If the user starts a new process, the operating system copies the environment variable from the registry to that process. When the process terminates, the operating system destroys the environment variable in that process. However, the environment variable in the registry persists until the user removes it using a program or by means of an operating system tool.

  • Machine - The environment variable is stored or retrieved from the HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment key in the Windows operating system registry. When a user creates the environment variable in a set operation, the operating system stores the environment variable in the system registry, but not in the current process. If any user on the local computer starts a new process, the operating system copies the environment variable from the registry to that process. When the process terminates, the operating system destroys the environment variable in that process. However, the environment variable in the registry persists until a user removes it using a program or by means of an operating system tool.

  • Process - The environment variable is stored or retrieved from the environment block associated with the current process. The user creates the environment variable in a set operation. When the process terminates, the operating system destroys the environment variable in that process.

Text [options], Optional - Default "User"
MARKUP: TYPE="USER"

Create and Populate Dataset: Specifies name of the Automated Workflow dataset that should be populated with the names and values of the environment variables.

Text [dataset name], Required
MARKUP: RESULTDATASET="datasetname"