4D Doc Center : SET ENVIRONMENT VARIABLE

Home

4D v14.3

SET ENVIRONMENT VARIABLE


SET ENVIRONMENT VARIABLE ( varName ; varValue )

Parameter	Type	Description
varName	String	Variable name to set
varValue	String	Value of the variable or "" to reset default value

Description

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 LAUNCH EXTERNAL PROCESS command. It also works with the PHP Execute command.

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 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 or "true" to set a synchronous execution (no default value can be set for this variable).
These variables are valid in the current process for the next call to LAUNCH EXTERNAL PROCESS.

Example

Refer to examples of the LAUNCH EXTERNAL PROCESS command.