SYSTEM-SWITCH

switch_name switch_setting

switch_name

An item in SYSTEM.SWITCHES

switch_setting

One of the values in attribute 13 of the item.

NOTE

Changing the setting this way does not update the SYSTEM.SWITCHES file. Attribute 14 - the current setting - does not get altered. Use the following command from TCL to determine the current setting of a switch:

System Switch

Description

Parameters

Default Setting

SET-BACKSLASH

Refers to the backslash character being used as a TCL delimiter. The default setting is OFF, and it will not be allowed as a delimiter. Change attribute 14 to ON to enable the backslash as a TCL delimiter.

NOTE: If set to ON, TCL commands using DOS file names may not function. For example, SET-TAPEFILE C:\TEMP\TMP.VTF sets the virtual tape file to C:. SET-TAPEFILE C:\TEMP aborts with an uneven number of delimiters, such as single quote ('), double quotes (") and backslash (\).

ON, OFF

OFF

SET-CAPTURING

Sets whether the BASIC EXECUTE CAPTURING clause behaves using MENTOR standard or R91 standard.

MENTOR, R91

MENTOR

SET-EXECUTE

Determines whether the mvBASIC EXECUTE statement uses the R91 or MENTOR functionality with regard to select lists.

R91, MENTOR

R91

SET-FOREIGN-CHARSET

Determines whether or not to enable foreign character sets. Default is OFF, and foreign character sets are not enabled. Change attribute 14 to ON to enable foreign character sets, and handle characters X’80’ to X’FF’. (Refer to the Mentor SP04 patch.)

OFF, ON

OFF

SET-INCSAVE

Enables/disables incremental saves. Not using incremental saves may enhance system performance. Incremental saves are allowed with the default ON setting. If set to OFF and an incremental save is attempted, a full save will be executed instead. Setting to OFF still allows an INCR-SAVE without a warning.

ON, OFF

ON

SET-INPUT-ELSE

Determines whether or not the mvBASIC compiler accepts an optional ELSE clause in the INPUT statement. With the default setting of OFF, the ELSE clause is not accepted.

OFF, ON

OFF

SET-LIST-BY

Determines whether the LIST BY switch acts in similar fashion to the SORT-BY command.

OFF, ON

OFF

SET-NAMED-COMMON

Determines whether NAMED-COMMON variables are initialized to unassigned or zero. Default is UNASSIGNED, and all NAMED-COMMON variables are initialized to unassigned. Change attribute 14 to ZERO to initialize all NAMED-COMMON variables to ZERO.

UNASSIGNED, ZERO

UNASSIGNED

SET-PRINTER-CLOSE

Determines whether or not print jobs created by the EXECUTE statement in BASIC are closed when BASIC is exited.

OFF, ON

OFF

SET-PROC-STON

Determines whether or not a carriage return must be placed in the stack to return control to a Proc after a select-list is invoked. The OFF setting means that the carriage return IS required.

OFF, ON

OFF

SET-RTNLIST

Determines whether the mvBASIC EXECUTE statement returns a select list or a dynamic array when the RTNLIST clause is used.

LIST, ARRAY

LIST

SET-RUNTIME-ERROR-LOGGING

This switch determines whether basic runtime errors will be logged.

ON, OFF

OFF

SET-WRITE-LOCK

Controls whether the WRITEU, MATWRITEU, WRITEVU and WRITEFU statements in mvBASIC set an item lock if an item lock is not already set.

This command allows the selection of one of two types of behavior for the WRITEU family of mvBASIC statements. The default setting is the
MENTOR behavior. This new system switch (SET-WRITE-LOCK in the BASIC class of system switches) is available via the SYSTEM-SWITCH command in the SYSPROG account.

NOTE:   At present, the WRITEBU statement only exhibits the R91 behavior regardless of this SYSTEM-SWITCH.

MENTOR DATA/BASIC will set an item lock on the WRITEU, MATWRITEU, WRITEVU and WRITEFU statements if one is not already set.

R91 DATA/BASIC will not set an item lock on the WRITEU, MATWRITEU, WRITEVU and WRITEFU statements if one is not already set.

MENTOR/R91

MENTOR

SET-U31AD

Determines whether user exit U31AD uses a two or three-digit process number.

TWO, THREE

TWO