SET ENVIRONMENT VARIABLE

version 11 (Modified)

SET ENVIRONMENT VARIABLE (varName; varValue)

The SET ENVIRONMENT VARIABLE command allows you to set the value of an environment variable under Mac OS X and Windows. It is meant to be used with the SET CGI EXECUTABLE or LAUNCH EXTERNAL PROCESS commands.

Pass the name of the variable to define in varName and its value in varValue.

• To get the general list of environment variables and possible values, please refer to the technical documentation of your operating system.

• To see the list of environment variables available with the SET CGI EXECUTABLE command, please refer to the Using CGIs section in the "Web Server" chapter.

• To see the list of environment variables available with the LAUNCH EXTERNAL PROCESS command, please refer to the documentation for this command. Note that three specific environment variables are available for use in this context:

_4D_OPTION_CURRENT_DIRECTORY: Used to set the current directory of the external process to be launched. In varValue, you must pass the pathname of the directory (HFS type syntax on Mac OS and DOS on Windows).

_4D_OPTION_HIDE_CONSOLE (Windows only): Used to hide the window of the DOS console. You must pass "true" in varValue to hide the console or "false" to display it.

_4D_OPTION_BLOCKING_EXTERNAL_PROCESS: Used to execute the external process in asynchronous mode, in other words, non-blocking for other applications. You must pass "false" in varValue to set an asynchronous execution.

These variables are valid in the current process for the next call to LAUNCH EXTERNAL PROCESS.

Refer to examples 7 and 8 of the LAUNCH EXTERNAL PROCESS command.

LAUNCH EXTERNAL PROCESS, SET CGI EXECUTABLE, Using CGIs.