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.2).
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.2:
| 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)
Changes the position of the currency symbol when this is combined with the E credit indicator in ML and MR conversion codes. The default is to place the currency symbol inside the chevrons that enclose negative values (that is, after the "<" chevron). When this option is set, the currency symbol will be placed before the "<" chevron. Also applies to DataBasic format strings.
Determines whether the account logon program runs when the user logs on to Reality. If set, on completion of the user logon program, the account logon program runs; otherwise, only the user logon program runs.
See Logon Control Programs.
Note: Because this option only affects operation when a user logs on, it can only be applied through the user's profile. Changing this option with SET-ENVIRONMENT or SET-OPTION has no effect.
Allows decimal points to be used as separators in times passed to the MT input conversion code.
In the English F conversion code, reverses the order of the operands for division, remainder, subtraction and concatenation, so that these operations work as for the FS code. The relational operators ([, ], < and >) continue to operate as for the F code.
Subtly changes the relationship of heading and page number, particularly in DataBasic. The most noticeable change is that a null heading maintains pagination, but outputs no line, and that after a heading is initially defined, re-execution of the HEADING statement in DataBasic will not cause a heading to be created until the end of the current page. Also, the page number is right-adjusted in a field of four blanks, unless the PN option is used, in which case it will be left-adjusted.
Note that SYSTEM(4), SYSTEM(5) and SYSTEM(6) continue to function as though a heading is in effect with this null heading.
If set, this option allows a DataBasic application, when causing a WARN or ABORT condition, to automatically dump (save) some information about its state to a BASIC-DUMPS file. It can optionally include program variables and their contents if DUMP.BASIC.VARS is also set. AUTO.BASIC.DUMPS is clear by default.
Note If AUTO.BASIC.DUMPS is set, a program producing unexpected errors on a busy system may generate many entries in the BASIC-DUMPS file, causing it to grow rapidly. Therefore, the BASIC-DUMPS file should be monitored regularly. Also, ensure that DB.DUMP.MULTIPLE is not set.
Automatically use B{S}SELECT if {S}SELECT with output specifier; that is, makes a {S}SELECT with output specifier behave like a B{S}SELECT.
Causes null attributes to be included in the list produced by the BSELECT and BSSELECT commands. This makes it possible to iterate through such a list with, for instance, the DataBasic READNEXT statement without having to specifically process the null items.
Causes the CATALOG command to check only that any MD
Master Dictionary - the dictionary file that defines an account. It contains items that point to the code executed by all the TCL commands, to SYSTEM accounts, and to other accounts by means of Q-pointers. The MD also includes all File Definition Items for the account and other items. entry that will be overwritten is a DataBasic program definition item, but not whether it references the file and item being cataloged.
If this option is not set, CATALOG will not proceed if the MD contains any entry with the same name as the program being cataloged, unless it is a DataBasic program definition item that specifically references the program being cataloged; if set, it allows any DataBasic program definition item to be overwritten. No other types of MD entry will be overwritten.
Controls the effect of the @ function's extended cursor addressing codes that control video effects.
- If this option is not set, each code switches on or off the effect concerned and switches off all the others.
- If the option is set, each code controls only a single video effect. All the others remain unchanged.
Determines whether the user and applications executed by the user can select data case insensitivity:
- If this option is set and data case insensitivity is also enabled on the database (using the DataCaseControl database configuration parameter):
- Data case insensitivity is selected.
- Data case insensitivity can be selected and deselected using the CASE TCL command and the DataBasic CASING statement
- If this option is not set or data case insensitivity is not enabled on the database, data case insensitivity is not and cannot be selected.
See Case Sensitivity for more details.
Causes any DataBasic program initiated by the user to enter the DataBasic symbolic debugger on executing DEBUG statements within the program. This is similar to starting the program with the DEBUG command, but can be used to debug programs called from PERFORM statements and from Procs.
Programs initiated by the user are those that are started directly or indirectly from TCL. They include those initiated by a Proc or other program that was itself started directly or indirectly from TCL.
Causes identical warning or fatal run-time errors, occurring on the same port, account, user, program and line number, to be written to a BASIC-DUMPS file as multiple separate WARN or ABORT dump items.
By default this option is clear, so that multiple dump items are suppressed. Instead, a single WARN or ABORT dump item is created at the first occurrence and thereafter a duplicate count on the item is incremented each time the error recurs. For example, a WARN dump item with a duplicate count of 4 means that the same error has occurred five times. These duplicate item counts can effectively be reset by using the RELOG.DB.DUMPS program.
If set, the COPY, CP, CT, ECOPY, MOVE and QSELECT TCL commands will default to * (all items) if no item list is included. If not set, * must be specified to select all items.
Causes the DELETE-CATALOG and DECATALOG commands to delete executable items from the local dictionary or data section by default. If not set, executable items from the local dictionary or data section are not deleted by default. Provided for compatibility with other MultiValue systems.
Include DataBasic variables in DataBasic dump items. This option is used with the DataBasic application dump feature which allows a DataBasic application to dump (save) some information about its state, either automatically or on request, to a BASIC-DUMPS file. If DUMP.BASIC.VARS is set, it causes the WARN, ABORT and SOFT dump items to include program variables and their contents. If the option is clear (unset) these items do not include the program variables. DUMP.BASIC.VARS is clear by default.
Causes any DataBasic program run from External Basic to enter the DataBasic symbolic debugger on executing DEBUG statements within the program. Programs run from External Basic include file triggers and dictionary subroutines.
Allows command options to be entered in the middle of a TCL command statement.
Causes division operations in English A and F conversion codes to return 0 when dividing by 0 (normally returns dividend).
Changes the types, names and locations of the items generated by the BASIC command. If set, an executable (platform-specific) item with the same name as the source item is generated in the dictionary of the file. No deliverable (platform-independent) item is generated unless the DEL.OBJ option is also selected (in a $OPTIONS statement), or the BASIC command's (R option is used.
If you specify this option, you only need to catalog your program once. When you recompile, the executable item referenced by the command definition item is overwritten.
If set, specifies that, for indexes that were created from dictionary definitions that include output conversions, the ISELECT, ICOUNT and SELECT-INDEX commands will apply those output conversions as input conversions to the literal data specified as appropriate.
If not set, output conversions are not applied; literal data must be specified in internal format (for backwards compatibility).
Causes all warning messages generated by DataBasic programs to be treated as fatal errors. If a warning occurs, the program breaks to the DataBasic debugger to allow determination of error and possible recovery. Similar to starting the program with the F option.
If set, causes the MD conversion code to treat numeric values containing decimal points as strings rather than numbers. As a result, the precision and scaling parameters have no effect on these types of values.
If not set, MD behaves like the ML and MR codes (see Numeric Data for details).
Causes a null value generated by the English conversion processor to be passed to an ML or MR conversion as a null string. If not set, a null value is passed as the number 0. Provided for compatibility with other MultiValue systems.
Disables the ! command, so that TCL commands can be given names beginning with !. The SYS command is unaffected.
Disables the effect of preceding a command name with a tilde (~). If not set, command names that start with a tilde are looked up only in the MD of the GLOBAL.MD account; otherwise, the normal lookup sequence is used (see TCL Input Processing).
Specifies the default item-id case-sensitivity of new accounts, files and directory views. If set, these will be case-insensitive; otherwise they will be case-sensitive. Can only be set if case-insensitivity is enabled on the database; see Item-id Case-insensitivity.
Specifies that an active list is to be kept active when a non-existent TCL command is entered.
Determines whether the user and applications executed by the user are case-insensitive are regards keywords:
- If this option is set and keyword case-insensitivity is also enabled on the database (using the KeyCaseControl database configuration parameter) keyword case-insensitivity is selected.
- If this option is not set or keyword case-insensitivity is not enabled on the database, keyword case-insensitivity is not selected.
See Case Sensitivity for more details.
If set, causes a format mask containing no fill characters to return the mask text. If not set, the fill data is returned. Provided for compatibility with other MultiValue systems.
If set, allows DataBasic external subroutine and function calls and returns to be included in the Audit and Support logs. See Command Logging and the AuditTclLog and SupportTclLog database configuration parameters.
If set, allows you to use any TCL command as a logon control program. Otherwise, a logon control program must be a Proc.
The MCT conversion code normally treats the first alphanumeric character following a space, double quotation mark, left parenthesis or hyphen as the start of a word. If you set this environment option, a word starts with the first alphanumeric character following any non-alphanumeric character other than a single quote. Provided for compatibility with other MultiValue systems.
If set, causes MD, ML and MR input conversions to parse the input value up to the first non-numeric character. Subsequent characters are discarded. Provided for compatibility with earlier versions of Reality.
In a format mask, normally only the first fill character (#, * or %) encountered is used; any subsequent occurrences of either of the other fill characters are treated as literals. If set, this option causes all of these characters to be treated as fill characters wherever they occur in the mask.
Specifies that active select lists in Proc should be handled as on other MultiValue systems.
For backwards compatibility, the ^, ] and \ characters normally have special meanings when used in an English HEADING or FOOTING modifier: ^ is equivalent to the P option, ] to the L option and \ to the T option. If this option is set, ^, ] and \ have no special meanings and are treated as literal characters.
Makes the modulo parameters mandatory in the CREATE-FILE command. With this option selected, you cannot create an automatically sized data section by simply omitting the modulo, but must specify the A option.
If set, when the PQN Proc S command is used to set the buffer pointer to a parameter beyond the end of the buffer, empty parameters are inserted to allow the pointer to be set to the specified position. If the option is not set, the pointer is positioned at the end of the buffer.
Causes X in Proc to return from a subroutine, rather than exit.
Do not sanitise a numeric string if FORMAT is MASK only.
If set, automatically adds the item-id to the output of the REFORMAT and SREFORMAT commands, for compatibility with MultiValue.
If set, causes the original value to be returned by RPL if the divisor is zero; if not set, zero is returned.
If set, enables terminal independence in RPL (RPQ feature R205).
Causes SP-ASSIGN to close open print jobs only when no parameters are specified. This provides compatibility with other MultiValue systems.
Allows you to use backslashes ('\') as delimiters at TCL in addition to single and double quotes.
Note When this option is set, TCL command parameters that contain backslashes must be enclosed in quotes. This applies particularly to DIR-VIEW and T-DEVICE paths on Windows, but for these commands you can also use forward slashes (/) as an alternative to backslashes.
If set, enables error messages that warn about using the P command to call a Proc from within another Proc.
With this option set, an error occurs if there are other commands following the P command. It does not occur if:
- The P command is the last command in the Proc.
- The P command is followed by a RTN and the Proc was not called from another Proc.
Causes the names or abbreviations of names of months produced by output conversion to be all uppercase, rather than just initial capitals.
Causes the names of days produced by output conversion to be all uppercase.
Causes system messages to be displayed in all uppercase letters, rather than just initial uppercase.
$<.FORMAT