rpp --migrationHelp

You must use this command to migrate the COBOL of a Program, Screen, or Server that was generated in Pacbase. This command is automatically run by the rpp --automaticMigration command. However, you can also run it independently.

Description

The migration help copies the Pacbase COBOL into your workspace and generates it again locally. The COBOL obtained after the local generation is then compared with the initial COBOL. The migration help function sets warnings on the lines where it detects differences. It excludes the differences in the formatting or comments. It generates three execution reports.

The --validationFile parameter is used to indicate the complete path of the file that contains the validation types. If you specify it, the migration help also validates the migration. It migrates the COBOL file and automatically validates its migration if it contains no difference after the application of the validation types. If the migration help command is used in a script, the next migration help commands will also complete the migration validation.

Syntax

rpp.bat --migrationHelp [options]

Parameters

Table 1. List of the available parameters
Options Comments Required Default values
--data Full path to the workspace (Rational® Developer for System z® option). Yes  
--log Log file name

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

No trace.log
--project Project name Yes
--name Name of the instance in the repository Yes  
--type Entity type Yes pacscreen, pacprogram, or pacserver
--cobolFolder Folder of the COBOL files Yes  
--controlCobolFolder Folder of the control COBOL files
Note: The control file is required, except for the Programs that are defined with a Type of COBOL code set to C, or a Type and structure set to F.
No  
--reportFolder Folder of the generation reports No  
--csvSep Separator for csv report No Semicolon
--csvTextSep Text separator for csv report No Double quotation mark
--clean Deletion of .cbl and .cblpdp files No  
--cleanTemplates Reset of the templates file No  
--flowposition (hidden option)

For a command file only

Optimization of the read and write accesses to files

No B on the first line

S on each continuation line

E on the last line

--verbose Increased verbosity of output No  

--validationFile

Complete path of the validation.xml file, which contains the validation types. This file is automatically recognized in the preferences of the migration validation. The migration validation then automatically runs at the same time as the migration help to reduce the migration time.

This parameter can be directly indicated in the automatic migration command. In this case, it is automatically carried over to the migration help.

No

 

Sample

rpp.bat --migrationHelp --project TEST01.CVI --name CUST01 --type pacprogram --cobolFolder C:/COBOL_FOLDER/CUST01/LIB --controlCobolFolder C:/CONTROL_COBOL_FOLDER/MIA1/LIB --reportFolder C:/Migration_help_batch/report --clean --cleanTemplates --verbose


Feedback