Using Batch Refresh Process with homonyms in a workspace

Your workspace can contain more than one copy of source file, program, or Java class that have the same name loaded in a workspace. Two files that have the same name, or homonym, must be differentiated within the workspace. That means they must be loaded from different folders and that their paths become a component of its identifying name.

Note: Homonyms are only supported in workspaces that have been created with COBOL Analyzer 3.5 or later. Homonyms are not supported in workspaces that have been upgraded from earlier versions of COBOL Analyzer.

If two copies of the file Dispatch.cbl exist within a new workspace, then they have to be loaded from different directories, for example:

 loadlib\dir1\Dispatch.cbl

The following is treated as a distinct and different object:

loadlib\dir2\Dispatch.cbl

Both of these files can create the same program, in this case called dispatch.

When using the Batch Refresh Process (BRP) to update or add files to a workspace, the files are placed in the PreparedSources folder which is located under the BRP folder for that workspace.

Important: The folder structure under the PreparedSources folder needs to match the folder structure used to load the original file, if the file is to be replaced.

If a new version of the file is to be added to the workspace, then this needs to go into a different folder. In addition, new files placed in the original folder structure will be added to the workspace and will not replace files that have the same name but were loaded from a different folder.

If the same version of a copybook is used by different projects, it must only be loaded and refreshed from the first folder structure. Otherwise, the workspace will have duplicate versions of the same copybook.

For example, the following file would replace one of the two previously loaded copies of Dispatch.cbl:

<BRP_folder>\PreparedSources\loadlib\dir2\Dispatch.cbl

whereas the following would be treated as new files:

<BRP_folder>\PreparedSources\loadlib\dir2\newprog1.cbl
<BRP_folder>\PreparedSources\loadlib\dir3\Dispatch.cbl