Execution reports of the migration help function in batch mode

Three reports are generated when the batch migration help commands complete.

The comparator detects all the significant differences. So it ignores the following differences:
  • Formatting
  • Comments
  • IDENTIFICATION DIVISION
  • Pacbase constants

Its execution produces three reports that can be viewed in a spreadsheet application. These reports are generated in the directory that is specified in the --reportFolder parameter of the command line.

The following three spreadsheets are produced:
  • MigrationControlOverview.csv displays the general information about the comparison. It contains one line for each pair of compared files with the following details:
    • The name of the file that contains the full COBOL code in the first column and the locally generated file in the second column
    • The number of the differences that are found in these two files
    • The number of the differences that are found in the PROCEDURE DIVISION
    • The Pacbase constants of the two files. You can compare the two generation contexts
  • MigrationTemplates.csv displays the character strings that were replaced, inserted, or deleted in the compared files. A template number is assigned to any identical replacement, insertion, or deletion in several files.
    Example: If the same work area was inserted in more than one Program, Screen, or Server, the comparator groups these insertions under the same template number.
    To see all the Program, Screen, or Server instances that use this template, open the MigrationDiffList.csv spreadsheet, which associates the template numbers with the instance names.
    The MigrationTemplates.csv spreadsheet contains the following columns:
    • The template number of the difference
    • The number of times the template is used in all the compared files
    • The template nature (insertion, replacement, or deletion)
    • The number of the character strings that were added or deleted
    • The added or deleted character strings
  • MigrationDiffList.csv displays the contents of the lines where differences have been detected. This spreadsheet contains the following columns:
    • The line number. There are as many lines as differences in all the compared files.
    • The difference rank number for each file.
      Example: If the MigrationControlOverview.csv file indicates 16 differences for a Program, then 16 lines apply to this Program.
      The difference rank number starts again at 1 after all the differences of the Program, Screen, or Server instance have been displayed in the table.
    • The number of occurrences of the difference in the Program, Screen, or Server.
    • The number of the difference template.
    • The word Procedure if the line is part of the PROCEDURE DIVISION.
    • The names of the compared Program, Screen, or Server instances, with their local versions.
    • The corresponding COBOL lines in the two compared files.

Feedback