rpp --analyzeMigrationLogs

This command can be used to analyze the results of the migration help. It is based on the execution reports of the migration help. It produces files that display the generation differences of the COBOL files (.cbl). The produced files are used by the generated OptimizeISOCode.xlsm file.

Description

The rpp --analyzeMigrationLogs command uses the execution reports of the rpp --migrationHelp migration help. These reports display the differences between the Pacbase generation and the local generation. They are produced in the directory that is indicated in the --reportFolder parameter of the migration help command line. These files are MigrationControlOverview.csv, MigrationTemplates.csv, and MigrationDiffList.csv. For explanations, see Execution reports of the migration help function in batch mode.

To start the rpp --analyzeMigrationLogs command, you must indicate the complete path to the directory that contains the relevant execution reports.

You must also indicate the complete path to the file that contains the validation types (--validationFile file). For explanations, see Migration validation preferences.

Syntax

rpp.bat --analyzeMigrationLogs [options]

Parameters

Table 1. List of the available parameters
Options Comments Required Default values
--log Log file name.

The beginning of this file reminds the parameters that were entered to run the Pacbase migration procedures.

No trace.log
--reportFolder Full path to the directory of the migration help execution reports. Yes  
--validationFile Full path to the validation.xml file that contains the validation types for the migration. Yes  

Example

rpp.bat --analyzeMigrationLogs --log C:\RPPBAT_LOG\trace.log --reportFolder C:/Migration_help_batch/report --validationFile C:/Migration_help_batch/validation

Results

This command produces the following files in the --reportFolder directory:
  • StatCobolMetaTemplates.csv and MetaTemplatesList.csv. These files are used by the macro of the OptimizeISOCode.xlsm file to complete the various sheets of the spreadsheet.
  • OptimizeISOCode.xlsm. Open this file and run the OptimizedIsoCode macro. Specify the two files that are required to run the macro. The first file is StatCobolMetaTemplates.csv and the second file is MetaTemplatesList.csv. After the files are indicated, the macro starts and completes the sheets that are present in the file:
    • listOfPrograms contains the list of programs that have differences. For each program, it indicates the number of differences for each template. These templates are represented in the columns from column D in the sheet.
    • listOfTemplates contains the list of the difference templates. The order of the list is identical to the order of the columns in the first sheet (from column D).
    • dispersionRate contains, for each difference template, the percentage of the impacted COBOL files.

Feedback