Skip to content

Introduction to Natural modernization

This page will guide you through the creation of a new Natural modernization project.
Creating a Blu Age modernization project will transform your legacy code into a language understandable by any developer. It will also enhance your team productivity by :

Natural Project Creation

To create a new BluAge Natural Modernization project, use the following steps :

  1. Right-click on the Explorer view;
  2. Select the menu entry New -> Other;


  1. Select Natural Reverse Project in the BLU AGE Reverse Modeling -> Natural Project folder;


  1. Enter a project name and click Next;


  1. The following screen will appear :


  1. First step is to find the location of your Natural legacy inputs. They can be imported either from a folder or from an archive file. Select the appropriate format as shown in (1) and then browse the location accordingly;
  2. You can then select Natural inputs character encoding, as shown in (2);
  3. Set the value of DC attribute of Natural inputs with (3) combo box;

  4. When you import configuration is correct, you can click on Finish.

The extraction process will start. It might take several minutes if the number of programs imported and/or their size is significant.

Natural Project Structure

Once the extraction process has finished, a new project is added to the package explorer view. Then, if not already done, you may want to build it.

  • All inputs successfully extracted will produced a DSL file dslnat;
  • Your files will be parsed against the BluAge Natural parser and parsing issues will be displayed in the Problems view of the IDE.


  1. The input (1) folder contains your Natural legacy inputs;
  2. The extractionReport.xml (2) file contains BluAge Natural extractor execution report
    1. Extraction summary
    2. Unresolved dependencies, it might be kind to resolved all of these before modernization starts
    3. Errors details
  3. The programDependencyCartography.csv (3) file summarizes project dependencies
  4. The output (4) contains all dslnat files from BluAge Natural extractor organized by source types
    1. DDMs : Database table descriptors
    2. Data Areas : Local, global and parameter data's description
    3. Text
    4. Helproutines : Messages or screen helping users
    5. Maps : Screen specifications
    6. Reports : Batch report specification
    7. Subprograms
    8. Subroutines
    9. DictionaryEntries : Extracted entries of Dictionary, these files can be used in Maps or Reports validation rules
    10. Dictionary
    11. Programs : Main application source code files
    12. Copycodes : In legacy, Copycodes are injected in other files. Natural extraction make with some artificial Subprograms the others are injected like legacy

Knowledge Base Creation

In order to begin the modernization process, a BluAge Knowledge Base project must be present in the workspace. It will help you sharing many information on your modernization project such as annotations on your COBOL files, artifacts, scripts,...

For more information about the creation and usage of a BluAge Knowledge Base project, please refer to the Knowledge Base project page.