rpp --importJournal

This command imports updates into Rational Programming Patterns. These updates are extracted from the Pacbase journal or from the file that is produced by the MIBU customized migration procedure. The file to be imported must have a .ta2 extension but its name must not be MIBR. This command is automatically run by the rpp --automaticMigration command for a progressive migration. However, you can also run it independently.

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).

Syntax

rpp.bat --importJournal [options]

Parameters

Table 1. List of the available parameters
Options Comments Required Default values
--data Full path to the workspace Yes  
--log Log file name

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

trace.log
--fromFile Name of the input .ta2 file. This file must not be named MIBR.ta2. Yes  
--fromDataFile Path and name of the .xml technical file to take into account for the import Yes  
--location Target location Yes  
--generatedDataFile Path and name of the .xml technical file that is generated after the import   imported_data_refer.xml in the .metadata folder, where refer corresponds to the target location
--report Import report file N/A .pacmigration.log in the .metadata folder of the workspace
--overwriteReport Overwriting of the report file N/A false - default append to the existing file
For its later use, the script file that contains the SCM commands must be completed with the following elements:
  • User code in Rational Team Concert
  • Name of the stream where the projects are uploaded to
  • Address of the Rational Team Concert server
  • Path of the folder that contains the lscm command

The .xml technical file that is created at the end of the import is required for a subsequent import. This file contains information that is not included in the Rational Programming Patterns metamodel, and the list of the instances that were previously imported.

The import report file summarizes the contents of the imported .ta2 file. It displays the following information:
  • The context of the import such as the database, user, session, Library, and date.
  • The replaced special characters.
  • The statistics of the instances that are present in the .ta2 file. These figures include the instances that were duplicated by the migration procedures.
  • The errors that were detected upon the import.
  • The Data Structures and Dialogs that were duplicated by the import.
  • The number of imported instances and the number of the instances in the .ta2 file. The number of imported instances can be lower than the number of the instances in the .ta2 file if you import a new Pacbase session into the same workspace. In this case, the instances that were not modified are not counted among the imported instances.
  • The number of modified/created/deleted design entities.

Examples

rpp.bat --import --fromFile C:/import/IMPORT1.ta2 --location IMPORT --importType ta2 --overwrite --data C:/workspaces/batchWks --log C:/import/out/trace.log --generatedDataFile C:/import/out/genData.xml
rpp.bat --importJournal --fromFile C:/import/Journal_IMPORT2.ta2 --fromDataFile C:/import/out/genData.xml --location IMPORT --data C:/workspaces/batchWks --log C:/import/out/traceJournal.log --generatedDataFile C:/import/out/genData.xml

Feedback