Changes to the Project Control File Related Batch scripts for Homonyms support

Problem

What changes are required to the Project Control File (PCF) for the project related Batch Refresh Process (BRP) scripts?

Resolution

One of the main items added to Enterprise Analyzer (EA) for version 3.5 was homonyms support.

The primary way for referencing objects within a workspace is via its name. With the introduction of homonyms support, the object name may no longer be unique. To be able to identify a particular object, the directory to the object can also be used. With the directory and name it is possible to identify a specific object.

This means that the following three BRP scripts have been modified to accept a PCF where the object name has been qualified with the directory where that object has been registered in the workspace.

• ApplyPCF.bj
• CreatePCF.bj
• SetProject.bj

New layout of the PCF

MODEL <Path to File>\\File Project

The scripts will still accept PCF’s in the old format so that they can be used with workspaces that do not use the new homonyms support. Any workspace that has been upgraded from version 3.4, or earlier of EA will not make use of the homonyms support.

Example using a PCF in the new format with the SetProject.bj script

If the following files are registered in the workspace:

• C:\\APP_A\\PGM01.CBL
• C:\\APP_B\\PGM01.CBL
• C:\\APP_C\\PGM01.CBL

And the three projects that these are to added to are:

• Application A
• Application B
• Application C

Then an example of the PCF which is called F:\\work_area\\Set_Project_CPF\\AAssign_Homonyms_Files.pcf:

• COBOL " APP_A\\PGM01.CBL" "Application A"
• COBOL " APP_B\\PGM01.CBL" "Application B"
• COBOL " APP_C\\PGM01.CBL" "Application C"

The command line for SetProject.bj would be:

"C:\\Program Files (x86)\\Micro Focus\\Enterprise Analyzer\\Bin\\Brave.exe"

                   "C:\\Program Files (x86)\\Micro Focus\\Enterprise Analyzer\\Scripts\\BRP\\SetProject.bj"        

                   "F:\\work_area\\Set_Project_CPF\\Assign_homonyms_Log.txt"

                   "Workspace=F:\\Workspaces\\New_35_Workspace.rwp"

                  "ProjectCF=F:\\work_area\\Set_Project_CPF\\Assign_Homonyms_Files.pcf"

                 "Incremental"

This will put APP_A\\PGM01.CBL into project Application A.

This will put APP_B\\PGM01.CBL into project Application B.

This will put APP_C\\PGM01.CBL into project Application C.

Incident #2670621