SET-ENVIRONMENT

Applies an environment; that is, a named collection of environment settings that change the way in which Reality functions.

Syntax

SET-ENVIRONMENT {[environment-name || ?]}

Syntax elements

environment-name
The name of the environment to be applied. The settings in the new environment completely replace the current settings.

? Lists the environments that are available.

If neither parameter is specified, the name of the currently environment is displayed.

Note

Because environment options can be changed with the SET-OPTION and CLEAR-OPTION commands, the settings in the selected environment may not accurately reflect the currently selected options. To list the options that are currently set, use LIST CUSTOM.OPTIONS.

Restrictions

None.

Comments

Environments are maintained by using either the SSM (System Security Maintenance) command and SSM Option 4 - Define Environment Settings, or the DEFINE-ENVIRONMENT TCL command.

Since Reality V15.2, the DataBasic SYSTEM (120) function returns the name of the current environment.

Examples

:SET-ENVIRONMENT ?
The following environments are available :
   MVENTERPRISE.V15.0
   MVENTERPRISE.V14
   UNIVERSE.V15
   MVENTERPRISE.V15.1
   MVENTERPRISE.V15
   UNIDATA.V15
   MVBASE.V14.1
   MVBASE.V14.2
   UNIDATA.V14.2
   AP
   UNIVERSE
   UNIVERSE.V15.0
   UNIVERSE.V15.1
   REALITY.V11
   D3.V14.1
   REALITY.V12
   REALITY.V14.1
   D3.V14.2
   UNIVISION.V15.0
   REALITY.V14.2
   UNIVISION.V15.1
   R83
   D3
   DEFAULT
   REALITY.V14
   REALITY.V15
   D3.V14
   MVBASE.V14
   D3.V15
   PICK
   MVBASE.V15
   UNIVISION.V15
   UNIDATA
   MVENTERPRISE.V14.1
   REALITY
   UNIDATA.V15.0
   MVBASE.V15.0
   MVENTERPRISE
   MVENTERPRISE.V14.2
   MVBASE.V15.1
   UNIDATA.V15.1
   MVBASE
   D3.V15.0
   UNIVERSE.V14.2
   D3.V15.1
   REALITY.V15.0
   UNIVISION
   REALITY.V15.1
   REALITY.EXT
   REALITY.V15.2
   UNIVISION.V14.2

Displays the available environments.

:SET-ENVIRONMENT D3
:SET-ENVIRONMENT
Selected environment is D3

Selects the D3 environment and then displays the name of the currently selected environment.

:SET-ENVIRONMENT ENIGMA
[1149]Environment 'ENIGMA' is not defined.

An invalid environment was specified. The environment remains unchanged.