rpp --analyzeRegeneratedFiles
This command is used to regenerate the generated files (.cbl or .map files for example) in the memory. It detects the files that are dephased, desynchronized, erroneous, or the orphan metadata files. You can then ensure the coherence of the generated files in your workspace. The Pacbase constants and the generation dates of the generated files do not cause any differences.
Syntax
rpp.bat --analyzeRegeneratedFiles [options]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. |
No | trace.log |
--listGeneratedFiles | Option to list the generated files that are present in the workspace. | No | |
--filesToIgnore | Option to prevent some files from being generated again. You must indicate the entire path to the file that contains the names of the files to be ignored. | No | |
--filesToManage | Option to select the files to be generated again. You must indicate the entire path to the file that contains the names of the files to be managed. | No | |
--dephasedFolder | Entire path to the folder that contains the dephased files. These files contain differences in comparison with their version before the regeneration. This folder contains tree structures with the files before and after the regeneration. It must exist. | No |
Example
rpp.bat --analyzeRegeneratedFiles --data C:/Workspaces/junit-workspace-Testwks --log C:\RPPBAT_LOG\trace.log --dephasedFolder C:\DephasedCobol --filesToIgnore C:\RPPBAT_LOG\IgnoredCobol.txtResult
The workspace content is not modified. The command produces an .analyzeRegeneratedFile.log file in the .metadata folder of the workspace.
- The files whose content is identical after the regeneration.
- The desynchronized generated files. These files no longer match the corresponding design. They are also displayed in the Generation manager view. You must generate them again.
- The files whose regeneration failed because of problems that can be related to the generator or to the modifications of the corresponding design. A failure can occur, for example, if some design files that are involved in the generation contain an error.
- The orphan metadata files. The extension of metadata files ends with pdp. If you deleted generated files but kept the corresponding metadata files, the local references point to files that no longer exist and the workspace is no longer coherent. You can consult the list of the orphan metadata files to know what files must be properly deleted or to retrieve, in Rational Team Concert™, the files that were wrongly deleted.
With the --dephasedFolder option, the folder that is specified in this option contains the dephased generated files. These files contain differences in comparison with their version before the regeneration. The folder contains two tree structures: BeforeRegeneration for the version before the regeneration, and AfterRegeneration for the version after the regeneration. You can open both versions in comparison tools.