ChangeTraffic.bj

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 Enterprise 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:
  1. Click here.
  2. 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.
  3. Run the executable to install diff.
  4. Go to its installation directory. By default this is: C:\Program Files (x86)\GnuWin32\bin.
  5. Copy diff.exe into the EA bin directory. By default this is: C:\Program Files (x86)\Micro Focus\Enterprise Analyzer\Bin.

Once diff has been placed in the EA 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 EA.

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.
Parent topic: Using Batch Scripts