Environment Options

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.

Changes the format of the output of the English DD, DM and DAM conversion codesto include a leading zero, if appropriate, in the day and month. Provided for compatibility with other MultiValue systems.

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.

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.

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

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.

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.

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.

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

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

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.

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.

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