Rational Developer for System z
COBOL for Windows, Version 7.5, Programming Guide


Compiler environment variables

The COBOL compiler uses several environment variables.

COBCPYEXT
Specifies the file extensions to use in searches for copybooks when the COPY name statement does not indicate a file extension. Specify one or more three-character file extensions with or without leading periods. Separate multiple file extensions with a space or comma.

If COBCPYEXT is not defined, the following extensions are searched: .CPY, .CBL, and .COB (or their lowercase or mixed-case equivalents).

COBLSTDIR
Specifies the directory into which the compiler listing file is written. Specify any valid drive and path. To indicate an absolute path, specify a leading drive letter or backslash. Otherwise, the path is relative to the current directory. A trailing backslash is optional.

If COBLSTDIR is not defined, the compiler listing is written into the current directory.

COBOPT
Specifies compiler options. To specify multiple compiler options, separate each option by a space or comma. For example:

SET COBOPT=TRUNC(OPT) TERMINAL

Default values apply to individual compiler options.

COBPATH
Specifies paths to be used for locating user-defined compiler exit programs that the EXIT compiler option has identified.
DB2DBDFT
Specifies the database for compiling programs that have embedded SQL statements.
DB2PATH
Specifies the directory in which DB2 is installed.
LANG
See the related reference about runtime environment variables below for details.
library-name
If you specify library-name as a user-defined word, the name is used as an environment variable, and the value of the environment variable is used as the path to locate the copybook. For example:

SET MYLIB=C:\CPYFILES\COBCOPY

If you do not specify a library-name, the compiler searches the library paths in the following order:

  1. Current directory
  2. Paths specified by the -Ixxx option, if set
  3. Paths specified by the SYSLIB environment variable

The search ends when the file is found. For more details, see the documentation of the COPY statement in the related reference below about compiler-directing statements.

NLSPATH
See the related reference about runtime environment variables below for details.
SYSLIB
Specifies paths to be used for COBOL COPY statements that have text-names that are unqualified by library-names. It also specifies paths to be used for SQL INCLUDE statements.
TEMPMEM
Specifies whether compiler work files are stored in memory files or on disk. Using memory files (TEMPMEM=ON) can significantly reduce compilation time.

In some cases with very large source programs, insufficient memory errors can occur. In this event, set TEMPMEM to null.

text-name
If you specify text-name as a user-defined word, the name is used as an environment variable, and the value of the environment variable is used as the file-name and possibly the path name of the copybook.

To specify multiple path names, delimit them with a semicolon (;).

For more details, see the documentation of the COPY statement in the related reference below about compiler-directing statements.

related concepts
DB2 coprocessor

related tasks
Using SQL INCLUDE with the DB2 coprocessor

related references
Runtime environment variables
cob2 options
Compiler options
Compiler-directing statements


Terms of use | Feedback

Copyright IBM Corporation 1996, 2008.
This information center is powered by Eclipse technology. (http://www.eclipse.org)