Starting the migration help
The rpp --automaticMigration command automatically starts the migration help. However, you can also start the migration help independently. This function migrates the COBOL code of a Program, Screen, or Server that was generated in Pacbase. It copies the Pacbase COBOL code into your workspace and generates it again locally. The COBOL code that is obtained after the local regeneration is then compared with the initial COBOL code. You can ensure that the local regeneration conforms to what is expected. You can start the migration help function in a batch or interactive mode.
Before you begin
- Extract the Pacbase models with the MIBA or MIBR procedure. Convert their Pacbase design to the PDP design by importing the file that is produced by these procedures into your workspace.
- If the instance calls Macros, you must generate these Macros in Pacbase with the MIMA procedure. Import the resulting .cblgen file into your local workspace with the Macro dispatching function. After this step, the sources of all the Macros are assigned to the corresponding Macros of the various projects in your local workspace.
- Run the MIA1 (for Programs), MIA2 (for
Screens), MIA3 (for TUI clients), or MIA4 (for
Servers) procedure. These procedures produce two .cbl files:
- A file that contains the generation of the instance in Pacbase. It contains the complete COBOL (code generated from the design and specific code) of the instance.
- A control file that contains the code generated from the design. This code is followed by annotated lines that correspond to the generation of the Macros and of the micropatterns (WE or WF for example). All these lines are non-specific lines. This file does not contain any specific code added in Pacbase.
Procedure
You can start the migration help in two different ways:
- In batch mode, enter an rpp –migrationHelp command line from a command prompt or a command file. With this mode, you can compare many files, with all the options available for the migration help. Three execution reports are generated.
- In interactive mode, right-click an instance in the Design Explorer
view and select Migration help. A wizard opens.
This mode must be reserved for few comparisons. Only a limited number of options are available. No execution report is generated.