SETUP SCREEN

COBOL Translation and Documentation Toolkit requires the following information prior to commencement of the migration process.
Client Information Page

Client Name: Enter Your Company Name - All the generated programs will include this at top of the program.

Licence Key: Key for unlocking the system. Provide after one-off licence payments.

Pay-for-use Username/Password: After registration at www.softwaremining.com, the system will allow you to pay only for the programs that you require translating/documenting. REQUIRES INTERNET CONNECTION.

Language: Working Language of COBOLTranslation and Documentation Toolkit - Currently only English is supported.
General Page

Default Editor: If the your selected editor is not in the operating system PATH directive, then you will need to enter the full path of the editor.

Show Hints Enables/Disables Windows Hints.

Report Bugs Automatically to SoftwareMining: The system will use your Internet account to send the sequence of 20 words that was not understood by the parser. REQUIRES INTERNET CONNECTION.

View Generated programs before charging my account. Even after Pay-for-use registration, the system allows you to inspect the generated programs before sending charge information to SoftwareMining. For performance improvements uncheck this box.
Directories Page

Repository Directory: All COBOL programs/sub-programs require certain amount of preprocessing. This directory is where COBOL Translation and Documentation Toolkit will place your prepared files. Essentially this directory will be the repository of all the programs, which is needed to complete your translation/documentation. The repository directory may be placed on a shared drive, and multiple users setup to use the same repository directory. Then if and when any files are modified - all users will see the changes.

COBOL Copy File Directory: Typically you would work on migration of one (or a few) program at a time. COBOL Translation Toolkit will move the prepared files from the Repository directory into the WORKING directory to start the actual migration. When you start working on your next batch of programs, you are required to remove the previous files from there.

Target Output Directory: The migrated programs will be placed here.

For Delphi output the following output structure is applied:

<Output Directory>\ - Migrated Programs
<Output Directory>\sql-ddl\ - Migrated SQL Data Definition files - for building the Database
<Output Directory>\FDinc\ - Object Wrappers for File Definitions
<Output Directory>\idata\ - Object Wrappers for WS/Printer/Screen Definitions
<Output Directory>\templates\ - html templates for servlets

For Java output (assuming that Java Package is set to com. yourcompany. test – see Target Language Settings page) the following output structure is applied:

<Output Directory>\com\yourcompany\test\ - Migrated Programs
<Output Directory>\com\yourcompany\test\sql-ddl\ - Migrated SQL Data Definition files - for building the Database
<Output Directory>\com\yourcompany\test\FDinc\ - Object Wrappers for File Definitions
<Output Directory>\com\yourcompany\test\idata\ - Object Wrappers for WS/Printer/Screen Definitions
<Output Directory>\com\yourcompany\test\templates\ - html templates for servlets


DataGen and BRE Templates: Directory that contains COBOL templates for DataGen utility (see Projects Page) and sample code generation templates for Business Rule Extraction tool.

Report Templates: Directory that contains HTML templates to use for documentation of COBOL programs.

Help Directory: Directory that contains the help files.

Log Directory: Directory that contains translation log files.
COBOL Settings Page

COBOL Platform: COBOL Translation Toolkit can detect most of the differences between the supported compilers automatically. However, you should select the correct settings in this field.

Column Settings: If your COBOL compiler uses different setting then you will need to readjust these parameters. Note that the columns are zero based.

Keep Comments In Original Source: When selected, this causes COBOL Translation Toolkit to transfer the original comments into the translated code. Note that not all the comments will be transferred.

Reduce Array Sizes. Programs with large array sizes can have an adverse effect on memory requirement of the application. This is because the system have to map the entire array out in order to be able to establish what happens when you move one variable onto another (think of all different funny things you can do REDEFINing those array sizes). Large arrays could crash the toolkit.
If 'Reduce Array Size' is checked - the system will automatically reduce all the size of OCCURS on all the items which do not REDEFINE anything, are not subject to other redefinitions, or do not contain child items which contain REDEFINES, or are subject to other redefitions.

Unix to Dos Conversion.Introduces CR LF where only CR is available.

When Redefining Field more than ... If a memory position/variable is redefined a lot of times - then it is probably used to reduce the memory consumption. In such cases the system can automatically remove the redefinitions. The system can be set to
- do nothing (don't remove the REDEFINITIONS),
- Confirm with user if the excessive REDEFINES should be removed
- Automatically remove such REDEFINITIONS.


Business Rule Extraction Page

Trace Variable Usage thru flow-logic - additional flag for Data-Filtering.

Report on 01 Usage in Extracted Rule - Shows all the top level variables (01 Entries in COBOL - Class Definitions in java/C#) referenced in the extracted business rule. The Associated Data Wrappers are shown in the "Data Items used In Code" Section.

Recursive Filtering - This functionality is best described using an example. Consider the following code:


if (export-status == 'false' )
{
  // then
  invoice-value = invoice-value x local-tax;
}

If we use 'export-status'  as a  filter - then the BRE module will show only statements referencing  export-status i.e. : 

if (export-status == 'LOCAL' )
}

The statements within the IF statement have not been show as they do not reference the selected data-filter.

The Recursive-Filtering will remedy this situation, and all the the statements within the block will be displayed. For IF statements - THEN and ELSE statements will be shown.

 

Include Related Vars On Auto Bre. The system allows import of Variables associated With the specified Data-Filters. Please see Import Associated Data Items for further details.

Clone Business Rule Extraction Frame. This button creates a clone of current Business Rule Extraction screen. Initially the cloned BRE screen has the same filter conditions as its ancestor, but then these screens are absolutely independent.

  

Target Language Settings Page

Target Language. Allow selection of the Target language for the migration process.

Java / C# Package. The base package when generating Java applications.

Additional Java / C# Import File. Using this option you can specify an additional imports to be inserted at top of every generated java program.

Filler Number Prefix. The prefix is used to differentiate between variables of the same name - within the same group.

Generate Separate Classes for WS/LK 01 Entries . By default the system will generate a single data-container class (iData) for the Working Storage section. If the Working storage section references COPYFILES which start at "01" level, then the system will also generate separate data-container classes for these.  However, if the Working Storage section only contains many 01 entires, and none-of the copy-files start at 01 level, then there will be only a single data-container (iData) class generated. 

Setting this check-box will create a single data-container file for each 01 entry.

Use Logger instead of Unformatted Screen Outputs. Redirects COBOL Display statements to a logger (e.g. Log4J) .

Use Sun Coding Standards. COBOL variable/Procedure names typically in  "ABC-DEF" format. The system can  translates these either to "abc_def" format, or use Sun coding Standards: "abcDef" .

 Add Logger Debug lines to generated Methods. COBOL variable/Procedure names typically in  "ABC-DEF" format. The system can  translates these either to "abc_def" format, or use Sun coding Standards: "abcDef" .

Target is  JSP / ASP . Check this box to generate JSP/ASP pages that correspond to original COBOL screens. Alternatively an XML Servlet version is generated If the check box is not ticked.  

 Generate Simple Beans. Generate data-containers (beans) which do not use SoftwareMining framework. These beans are written out to idata.beans or persistence.beans directory. They can be used for external communication via XML .

 Normalize FD's with Multiple 01 Entries. Break a File Definition with multiple 01 entries into multiple records/classes. Please note that generated code will require manual touch up.   

 Convert 88 Variables to methods. By default - the generated code will compare 88 varaibles either by using "equals" method - or by using methods on RangeItem class.  By ticking this check box - the system will generate additional wrapper methods such as 'is88Variable(variabele)', use them in the business logic code. Advantage is that the business logic code becomes more legible, disadvantage is that the generated data-wrapper classes become larger .   

Obfuscate Code. Obfuscate the Original cobol code - changing variable names, and string. The obfuscated code cannot be used for compilation and running. But it can help when a  sensitive code fails in  parsing / code generation. The obfuscated version of  can be  send to SoftwareMining.

Java Defaults

Use this page to specify different initialization for java variables.


FD Wrapper Directory. Using this field you can change the default name for folder where generate FD wrappers to. See Target Output Directory.

WS Wrapper Directory. Using this field you can change the default name for folder where generate WS wrappers to. See Target Output Directory.


Screen Directory. Screen Beans are placed into this folder.

 

Screen Directory. Screen Beans are placed into this folder.
Java Persistnece

Use this page to specify target database for translation of VSAM/ISAM files.

 

 



Top | Index | Glossary