Environment Settings

This topic lists the settings that can be changed when maintaining an operating environment.

Environment settings are of two types: general settings and environment options. The general settings are:

Environment type (direct or synonym)
Name of referenced environment (for a synonym environment only)
Default DataBasic compiler
DOT / TCL Stacker name

The environment options are all toggle settings; that is, they can either be set (Y) or clear (N).

Unlike the general settings, environment options can be individually set with SET-OPTION or cleared with CLEAR-OPTION.

To find out which predefined environments are available and their settings, use SSM Option 4 - Define Environment Settings or the DEFINE-ENVIRONMENT TCL command to access the ENVIRONMENT CONFIGURATION screen.

General settings

An environment's general settings are displayed on the first page the ENVIRONMENT CONFIGURATION screen.

The layout of the ENVIRONMENT CONFIGURATION screen differs according to whether it is showing a pointer environment, a direct environment, or a new environment.

Environment type

Environments are of two types: direct and synonym. A direct environment is complete in itself and does not reference any other environment. A synonym environment is a pointer to another environment, which may be a direct environment or yet another synonym environment, although eventually such synonyms must resolve to a direct environment (which is the one whose settings are displayed).

Several predefined direct and synonym environments are shipped with Reality. Typically, the predefined DEFAULT synonym environment references the most recent predefined direct environment (for example, REALITY.V15.4).

A synonym environment can be converted to a direct environment (and vice versa, although this is less common).

On the first page of environment settings:

Enter T to change the type of the environment.
For a synonym environment, you are prompted:
```
Convert to Direct type, based on referenced environment (Y/N) :
```
Enter Y to confirm or N to cancel.
For a direct environment, you are prompted:
```
Enter an existing ID to reference.
```
Do one of the following:
- Enter the name of another environment.
- Enter D to reference the DEFAULT environment.
- Enter * to reference the current environment.
- Press Return to cancel.

Name of referenced environment

This applies only to a synonym environment. On the first page of environment settings:

Enter E to change the environment that the pointer environment references:

Enter an existing ID to reference.
(or 'CR' to exit. '?' for list, 'D' for default, or '*' for current)

Do one of the following:
- Enter the name of another environment.
- Enter D to reference the DEFAULT environment.
- Enter * to reference the current environment.

Default DataBasic compiler

An environment's default DataBasic compiler is the compiler that is used by the BASIC command when that environment is current. (If a default compiler is not specified in the current environment, the compiler identified by the BASIC*DEFAULT synonym entry in the BASIC-COMPILERS system file is used instead.)

On the first page of environment settings:

Enter C to change default DataBasic compiler used in this environment:

Select default DataBasic compiler, (1-10) :
 1) BASIC*15.2   2) BASIC*15.1   3) BASIC*15.0   4) BASIC*14.2   5) BASIC*14.1
 6) BASIC*14     7) BASIC*11     8) BASIC*10     9) BASIC*09   10) BASIC*08

Enter the number corresponding to the compiler you want.

The following compilers are provided with Reality V15.4:

Compiler	Reality version
BASIC*15.2	V15.2
BASIC*15.1	V15.1
BASIC*15.0	V15.0
BASIC*14.2	V14.2
BASIC*14.1	V14.1
BASIC*14	V14.0
BASIC*11	V11.0, V12.0
BASIC*10	V10.0
BASIC*09	V9.1
BASIC*08	V9.0 and earlier

DOT / TCL Stacker name

The TCL Stacker Recall command is also known as the DOT command because by default it is represented by the dot (.) character.

The operation of the command depends on the emulation mode in which it is run. The default mode is the one specified in the current environment.

On the first page of environment settings:

Enter S to set the emulation mode of the TCL Stacker Recall command:

Select stacker type, (1-7) :
 1) REALITY          2) D3             3) MVENTERPRISE    4) MVBASE
 5) UNIVERSE         6) UNIVISION      7) UNIDATA

Enter the number corresponding to the mode you want.

Environment options

The options are listed here in alphabetical order. However, the ENVIRONMENT CONFIGURATION screen lists these settings, eight to a page, in (approximately) the order in which they were added to the system; so more recent options tend to be at the end. If an option has a value in this environment that differs from its value in the reference, template or comparison environment (or vice versa), this is marked by a # character between the two values.

               E N V I R O N M E N T   C O N F I G U R A T I O N
--------------------------------------------------------------------------------
Environment Name :MY.REALITY                                               Value

Based on         :REALITY.V15.2                                      Value

Environment options:                                                 ----- -----

  1) (PROCX) Makes X command in Proc work like RTN                     N     N
  2) (ALTFCORR) Reverses order of operands in Fcorr Div, Rem, Sub ...  N     N
  3) (ALTHEADING) Subtly changes the relationship of heading and p...  N     N
  4) (UCASEDATES) Causes month output names and abbreviations to b...  N  #  Y
  5) (TCLDELIMITER) This enables the '\' as a delimiter equivalent...  N     N
  6) (KEEPLIST) This allows a process which has SELECTed a list, a...  N     N
  7) (EMBEDDED.OPTIONS) Allows options in the middle of TCL line.      N     N
  8) (UCASEMSGS) Causes output of ERRMSGS to be in upper case only.    N     N

Enter setting/option to view/change (T,C,S,1-51):

P(revious) page: (CR)/N(ext) page:
EX to exit: FD to delete:
New Item to compare with ('?' to list)

Product:	RealityVersion 15.4
Help revision:	Revision 0
Help topic:	Environment Settings (SSM)
File name:	userref_admin04+EnvOptions.htm