The value of the environment variable COPYPATH is used by AcuBench (and the ACUCOBOL-GT compiler) to search for COBOL COPY
files. When AcuBench (or the compiler) needs to access a COPY file, it searches, from first to last, the directories specified
in COPYPATH.
You can define COPYPATH to specify one or more relative or absolute directory paths. By default, COPYPATH is set to the relative
paths of the project's screen, COPY, resource, report, and FD folders (%screendir%, %copydir%, %resdir%, %reportdir%, and
%layoutdir%). It also includes the absolute path to the sample directory that contains ACUCOBOL-GT .def COPY files (C:\microfocus\Acucbl800\AcuGT\sample\def).
You can change the value of COPYPATH in one of two ways:
- Use the Environment tab of the Project Settings dialog box.
- Add new paths as you add new source files to your project.
The exact method by which new paths are added when you add source files to your project is determined by the settings that
you have chosen in the Environment > Miscellaneous category of the Tools > Options dialog box, discussed in Customize Your Working Environment. If both Automatically modify COPYPATH options are selected:
- When you add a new source file and select the Automatically parse program for COPY files option, COPYPATH is updated each time a new COPY file directory is identified.
- When you use the Copy Path button in the Add/Remove Files dialog box to indicate a new COPY file location, that path is added to the COPYPATH definition.
Special Notes on Changing COPYPATH
- Use caution when changing the value of COPYPATH. Changing the value of COPYPATH can potentially affect every source file in
the project. For example, if you change the definition of COPYPATH to remove a path that holds a COPY file needed by the project,
some files may no longer compile.
- If you add a path that holds a COPY file that has the same name as a COPY file in another directory that is also defined in
COPYPATH, the COPY file used is the first COPY file found (the paths are searched from first to last).
- If you have a file or set of files that need a special COPY directory setting that you do not want to add to the definition
of COPYPATH, you can specify that path on a file-by-file basis using the Directories to be searched for COPY (Sp) option in the Source Options catalog of the Project Settings dialog box.