Rational Programming Patterns

Execution reports of the migration help function in batch mode

Three reports are generated when 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 specified in the --reportFolder parameter of the command line.

The three spreadsheets are as follows:
  • MigrationControlOverview.csv, which 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 found in these two files
    • The number of the differences found in the PROCEDURE DIVISION
    • The Pacbase constants of the two files. You can compare the two generation contexts
  • MigrationTemplates.csv, which displays the character strings which have been 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 has been 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 which have been added or deleted
    • The added or deleted character strings
    .
  • MigrationDiffList.csv, which 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 detected by the comparator in all the compared files.
    • The difference rank number for each file.
      Example: If, in the MigrationControlOverview.csv file, 16 differences are indicated for a Program, this column displays 16 lines which 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 times the difference has been detected 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 codes of the compared Program, Screen, or Server instances, with their local versions
    • The corresponding COBOL lines in the two compared files

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)