SetEnv

The SetEnv internal function and config are used to set session based environmental variables in Business Rules!.

in a brconfig.sys file you can set a BR! environmental variable like

SetEnv FIELD VALUE

in a program you can set a BR! environmental variable like

SetEnv("FIELD","VALUE") 

you can get the value of either windows environmental variables or BR! environmental variables in a program like

Env$("FIELD")

GUIMode

There is a BR! provided GUIMode environmental variable (case insensitive). It's value is either ON or OFF depending on whether BR is in GUI mode.

x$=env$("GUIMode")

See also:

Env$ GUI Mode

Icon

The Icon environmental variable can be set during the execution of a program by use of SetEnv.

When the special Icon environmental variable is set it will change the icon which the business rules! application displays.

SetEnv("Icon","myicon.ico") sets the icon for the window and the taskbar to the icon specified by the second parameter (e.g. myicon).

00100 SetEnv('Icon','Myicon.ico')

ENVIRONMENT VARIABLE SIMULATION

The Env$( ) function, which is used to interrogate the BR environment, has been expanded to permit the simulation of setting an environment variable with configuration statements.

CONFIG SETENV SIZE '10 x 24'

This allows a program to use ENV$("Size") to retrieve the value "10 x 24", excluding the quotes. In the event SIZE was previously defined in the environment it will appear as set to the new value for the duration of the BR session.

SYSTEM SETENV( ) FUNCTION

The SetEnv internal function sets an environment variable similar to the above configuration statement. For example, SetEnv("SIZE","10 x 24") causes Env$("SIZE") to return the string "10 x 24".

Additionally, SetEnv("SCRN_SIZE_POSN") - case insensitive - will save the current screen size and position for both the new console and the command console, provided they are not minimized to the task bar. The positions of any window that is minimized (graphical window or command console) will not be saved.

SYSTEM ENV$ VALUES

System ENV$ variables cannot be set or altered by CONFIG SETENV.

See also: clipboard