rpp --automaticMigration

This command produces a command file that can be used to run a complete migration: import, Macro dispatch and migration help. You can indicate an option for general and z/OS projects to generate the COBOL sources in different projects and separate the metadata files.

Syntax

rpp.bat --automaticMigration [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
--from Name of the folder that contains the files required for the migration: MIA1.txt, MIA2.txt, MIA3.txt, MIA4.txt, MIBR.ta2, and MIMA.cblgen Their names cannot be changed. Yes  
--location This parameter is used to replace the name of the target location for the import commands with the required value. It is also used to name the file produced by the automatic migration command: location.txt. Yes  
--separateCobolProject Option available on general and z/OS projects.

If this option is indicated, the COBOL sources will be generated in a separate project that is named after the project of its model instance, with a _COB suffix.

No  
--cobolProjectType Type of the project that will contain the COBOL sources:
  • G for general projects
  • Z for z/OS projects
No G
--separateMapFolder Option to migrate Screen maps into a specific folder No map
--separateMetadataFiles Option to separate the metadata files No  
--pdpRootPath Path name of the pdp metadata file No pdp
--scmtoolsEntriesFile Path and name of the script file that contains the SCM commands, to upload data to the Rational Team Concert server No scmtools_entries.bat in the .metadata folder of the workspace
Note:
For the --from parameter, the folder must have the following structure:
  • MIBR.ta2
    Note: The Pacbase version number is included in the .ta2 file. If the version in this file is not compatible with the current version of Rational Programming Patterns, the import is not run and an error is generated. The control does not go down to the subversion level (Y09A for example).

    Other .ta2 files with other names can exist in the folder. Such is the case, for example, if you customized the migration with the MIBU procedure. All the .ta2 files are then taken into account by the automatic migration.

  • MIMA.cblgen

    Other .cblgen files with other names can exist in the folder. Such is the case, for example, if you changed the source code of a Macro manually. All the .cblgen files are then taken into account by the automatic migration.

  • MIA1.txt
  • MIA2.txt
  • MIA3.txt
  • MIA4.txt
  • COBOL_MIA1.txt for the sources that contain the complete COBOL of Programs. These sources are produced by MIA1.
  • COBOL_MIA2.txt for the sources that contain the complete COBOL of standard Screens. These sources are produced by MIA2.
  • COBOL_MIA3.txt for the sources that contain the complete COBOL of TUI clients. These sources are produced by MIA3.
  • COBOL_MIA4.txt for the sources that contain the complete COBOL of Servers. These sources are produced by MIA4.
  • CONTROL_COBOL_MIA1.txt for the sources that contain the control COBOL of Programs. These sources are produced by MIA1.
  • CONTROL_COBOL_MIA2.txt for the sources that contain the control COBOL of standard Screens. These sources are produced by MIA2.
  • CONTROL_COBOL_MIA3.txt for the sources that contain the control COBOL of TUI clients. These sources are produced by MIA3.
  • CONTROL_COBOL_MIA4.txt for the sources that contain the control COBOL of Servers. These sources are produced by MIA4.
The automatic migration produces the following elements:
  • A COBOL_FOLDER folder and a CONTROL_COBOL_FOLDER folder. These folders both contain four directories that correspond to the four patterns (pacprogram or MIA1, pacscreen or MIA2 for example). Each of these four directories contains a subdirectory for each Library. The .cbl files are stored in the subdirectory that corresponds to the initial Library of the generated instance.
  • A location.txt command file (where location is the name of the location). You must then run the rpp.bat --commands command with this file as an option.

Example

rpp.bat --automaticMigration --data C:/usr/WKSFD2 --from C:/usr/Tests/WorkItemRTC/WI6382bis/ --location TESTON --separateCobolProject --separateMapFolder --separateMetadataFiles --scmtoolEntriesFile

Feedback