CBLFLAGS Environment Variable

To simplify the setting of compiler options, the environment variable CBLFLAGS may be set to a list of options. These options will be used each time the compiler is run. The CBLFLAGS variable is particularly useful for setting options that you use all the time.

If you have set the CBLFLAGS variable and need to unset it temporarily, you can use the -x command-line option to ignore it for any particular run of the compiler.

You may continue to use command-line options when you use the CBLFLAGS variable. All of the options from both places are used. Note that the environment variable CBLFLAGS is examined after the command-line options.

On UNIX machines, the CBLFLAGS variable is set in the environment. This can be done with the export command of the Bourne or Korn Shell or the setenv command of the C-Shell. Under VMS, the CBLFLAGS variable is set as a symbol. Under Windows NT/2000, the CBLFLAGS variable can be created in the Control Panel System applet or for Windows 98 systems, in the autoexec.bat file with the SET command. Windows must be restarted for the new values to take effect. For more information about setting environment variables, see Environment Variables.

The @ file name abbreviation is particularly useful in the CBLFLAGS variable. For example, if you set the variable to -o /programs/@, every program you compile will have its object file placed in the /programs directory with the same name as the source file.

Note: The number of acceptable arguments in the CBLFLAGS environment variable is limited to 50. The compiler accepts the first 50 arguments set and ignores all the rest in excess of that number. File specifications are counted as separate arguments, but combined options from the same group are counted as one argument.