Action
Generate
change traffic metrics. Change Traffic metrics compare the source files currently in a workspace with the source files in a
change unit:
- At the tag level, the number of new, modified, and deleted files in the change unit.
- At the object level, the number of new, modified, deleted, and moved lines in the modified files, and the number of lines
in the new and deleted files.
Important: An additional module required for generating the object level Change Traffic metrics is not included in the
COBOL Analyzer installer. It is called diff and is a source comparison tool that has been developed as an open source module using GnuWin.
As such, it is free to download, but is not something that
Micro Focus can distribute.
Diff can create metrics to show differences between two source modules. These metrics are then gathered by
ChangeTraffic.bj.
To download and install diff:
- Click
here.
- Go to the latest available version (currently it is 2.8.7.1) and select the executable to download. In this case it is
diffutils-2.8.7-1.exe.
- Run the executable to install diff.
- Go to its installation directory. By default this is:
C:\Program Files (x86)\GnuWin32\bin.
- Copy
diff.exe into the
CA bin directory. By default this is:
C:\Program Files (x86)\Micro Focus\COBOL Analyzer\Bin.
Once diff has been placed in the
CA bin directory,
ChangeTraffic.bj can be run as part of Batch Refresh Process (BRP) to compare the files that are currently in a workspace against the files
that are about to be loaded into
CA.
The change unit comprises the new and modified source files, and optionally a
change unit description file, named
Configuration.txt. Use the change unit description file to:
- List the source files to be deleted, in the form DELETED:filename.
- Assign the change metrics a date other than the date the script is executed. Specify the date in the form DATE:
YYYY-MM-DD HH24:MI:SS.
For example:
DATE: 2010-03-15 17:12:13
DELETED:MYPROG.CBL
DELETED:MYCOPY.CPY
Note: Generating or importing change traffic metrics does not physically delete source files from the workspace. Use
ProcessChangeUnit.bj with a change unit description file to delete source files from the workspace.
Syntax
ChangeTraffic UDCFolder SourceFolder XMLOutputFile ProjectName UDCName
Required Parameters
|
Description
|
UDCFolder
|
Dedicated folder for the change unit.
|
SourceFolder
|
\Sources folder for the workspace.
|
XMLOutputFile
|
Output file.
|
ProjectName
|
Name of tag for the application.
|
UDCName
|
Name of tag for the change unit. Use this argument to distinguish between change units. Enter an empty string if you do not
want to specify a change unit tag.
|