Environment Options

The table below 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.

Refer to Predefined Environments for details of which of these options are set in which predefined environment.

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

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.

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.

FATAL.WARNINGS
Causes all warning messages generated by DataBasic programs to be treated as fatal errors. 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 a numeric values containing decimal points as string 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.

KEEPLIST

Specifies that an active list is to be kept active when a non-existent TCL command is entered.

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.

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.

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.

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.

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 '\' to be equivalent to ' " ' at TCL.

Note: WIth this option set, you cannot use backslashes in DIR-VIEW directory paths. Use forward slash (/) instead.

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.

Go to top button