Environment Options

This topic lists the options that can be set when defining an operating environment.

Note: Those marked with an asterisk (*) cannot be set with SET-OPTION or cleared with CLEAR-OPTION.

To find out which predefined environments are available and in which a particular option is set, use SSM option 4 (Define Environment Settings) or the DEFINE-ENVIRONMENT TCL command.

$<.FORMAT
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.
2DIGIT.DATE
Changes the format of the output of the English DD, DM and DAM conversion codes to include a leading zero, if appropriate, in the day and month. Provided for compatibility with other MultiValue systems.
ACCOUNT.LOGON

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.

ALT.MT
Allows decimal points to be used as separators in times passed to the MT input conversion code.
ALTFCORR
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.
ALTHEADING

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.

SYSTEM(4), SYSTEM(5) and SYSTEM(6) continue to function as though a heading is in effect with this null heading.

BSELECT.NULL
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.
CATALOG.COMP

Causes the CATALOG command to check only that any MD 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.

CURSOR.ATTRIBUTES

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.
DATA.CC

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.

DB.DEBUG

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.

DEFAULT.TO.ALL
If set, the COPY, CP, CT, ECOPY 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.
DEL.FILE.EXEC
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.
DOT/Stacker *

Sets the mode of operation for the TCL Stacker Recall Command. The following modes are available:

1 REALITY – Do not emulate another MultiValue system (default).

2 D3

3 MVBASE

4 MVENTERPRISE

EB.DEBUG
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.
EMBEDDED.OPTIONS
Allows command options to be entered in the middle of a TCL command statement.
ENGDIVIDE
Causes division operations in English A and F conversion codes to return 0 when dividing by 0 (normally returns dividend).
EXEC.BASIC.OBJ

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.

EXTERNAL.KEY

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).

FATAL.WARNINGS
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.
INT.MD.ONLY

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).

INHIB.MLMR
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.
INHIBIT!SYS
Disables the ! command, so that TCL commands can be given names beginning with !. The SYS command is unaffected.
INHIBIT~
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).
INSENS.CREATE.FILE
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.
KEEPLIST
Specifies that an active list is to be kept active when a non-existent TCL command is entered.
KEY.CC

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.

LITERAL.MASK
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.
LOG.BASIC
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.
LOGON.PROGS
If set, allows you to use any TCL command as a logon control program. Otherwise, a logon control program must be a Proc.
MCT.SQUOTE
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.
MD.ICONV.ALWAYS
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.
MFILL.FORMAT
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.
MVPROCSELECT
Specifies that active select lists in Proc should be handled as on other MultiValue systems.
NOOLDHEADER
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.
OLD.CREATEFILE
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.
PQN.ABS.S
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.
PROCX
Causes X in Proc to return from a subroutine, rather than exit.
RPLDIVIDE
If set, causes the original value to be returned by RPL if the divisor is zero; if not set, zero is returned.
RPLTERM
If set, enables terminal independence in RPL (RPQ feature R205).
SPASSIGN
Causes SP-ASSIGN to close open print jobs only when no parameters are specified. This provides compatibility with other MultiValue systems.
TCLDELIMITER

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.

TRAP.EMBEDDED.PROC

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.
UCASEDATES
Causes the names or abbreviations of names of months produced by output conversion to be all uppercase, rather than just initial capitals.
UCASEDAYS
Causes the names of days produced by output conversion to be all uppercase.
UCASEMSGS
Causes system messages to be displayed in all uppercase letters, rather than just initial uppercase.
WHO.FORMAT
If set, causes the WHO command and user exit U50BB to behave as appropriate for the selected MutliValue environment (set with the DOT/Stacker environment option).

Go to top button