Breathing life into
legacy applications

Short Cuts:


Contact Us
Source Platforms
Outsourcing Services
Modernisation Process
Downloads

 Search:

 Login:


Username:
Password:   
Forgot password?

Brochures and Reports:



SoftwareMining Modernization Brochure

Manual Vs Automatic Translations White Paper

Business Rule Extraction White Paper

ROI and Case Studies

       Home > Translation Toolkit > Help files > Documentation Page

Documentation Page

This page is a central point to review a structure of processed COBOL programs and perform some modifications. It also allows generating documentation on processed COBOL programs.

ANALYSED PROGRAMS

This tree shows the generated programs and associated copy files. Click on different subsections - e.g. WS / Linkage / FD to see a list of top-level variables declared within the subsection. Click on the main program to see all the variables defined. Click on the ‘Programs’ node to see a flowchart of the program at the bottom-right hand side of this screen.Click to any node that represents COBOL section to see a list of top-level variables used within this section.

Create New Module. Thisbutton is helpful in breaking down of large programs into smaller ones. Under the ‘Programs’ node for the each generated programs you may see the ‘Default’ node. Initially it contains all COBOL sections contained in the processed program. To break down your program into the smaller ones you should firstly create a new module by pressing this button. Below the ‘Default’ node you’ll see a new node. Just drag those COBOL sections that you want to place to a new module and drop it to the created node. Then you may use the tree’s context menu (to view it, click on desired node with right mouse button) to rename or delete a new node. Click on the desired module to see a flowchart for it. All your modifications are stored automatically.

Translate Programs. This button allows to re-process selected COBOL programs after some manual modifications made on this page - like ignoring REDEFINES or breaking down a program into smaller ones.

Overall Connectivity. This button launches an additional dialog, which shows ‘Overall Connectivity’ flowchart. This flowchart reflects the connections between various COBOL programs being processed. Overall connectivity data are persistent so you shouldn’t process all programs in a project in one working session.

Clear Overall Connectivity. This button allows you to erase old overall connectivity data. It is essential before starting with new project.

Refresh. This button allows you to re-process the processed programs to a stage that flowchart documentation can be produced. No output files will be generated.

Generate Documentation. This button creates HTML documentation for the processed programs. This documentation is template-based, so HTML Templates directory indicated in the Setup Screen (see Directories Page) should contain a valid content. For template details, please, see Readme.txt file located in that directory.

FIELD ANALYSIS



All the 01 entries found in FD definitions, Working storage definitions, … are listed in this section.

Double click on any of the listed fields to display an expanded outline of the field or record.

You can re-adjust the redefinition of the sub-fields for the entry from the Expand FD Screen. This type of re-organization of COBOL REDEFINES variables is essential to successful migration of some Cobol applications.

Note that after modifications to any of the fields in the Expand FD Screen, all the currently selected Cobol Program modules need to be re-parsed. - See Processing Page.

The List box contains 2 columns:

Slot/Record - List of all the entities found in the parsed programs. The entities listed are of the following types:

01 FD Definition
01 WS Definition
WS Field Class
WS Group Class
Date Time Class



Program names. This is the program where the entity was found. Note that an FD item must have only one entry in this page. If the FD entity has multiple entries - this implies that the system has not managed to automatically converge the different description from the 'SELECT File ASSIGN TO FD-FILE' Section. In such circumstances you can use the Data/Printer Files Page to correct the problem.

Show All Variables. This button is very helpful if more then one COBOL program were processed in a one go. Use this button to see all top-level variables across all COBOL programs.

Expand and Map the Fields. Use this button to display an expanded outline of the field or record (see Expand FD Screen).

List Procedures for Variables. Use this button to see the list of procedures, which use selected variable. This list will be generated on fly and posted to the Log area (bottom of the window).

Flowcharts

There are two flowchart panes: primary and secondary. On the primary pane you can see a flowchart for the program node selected in the Analysed Programs tree. Click on desired flowchart box within the primary pane to see a secondary pane, which shows interaction between paragraphs of an indicated section.

Edit Main Flowchart. Use this button to launch a flowchart editor for the main flowchart pane. With its help you can modify a flowchart and then print this modification.

Edit Sub-section Flowchart. Use this button to launch a flowchart editor for the secondary flowchart pane. With its help you can modify a flowchart and then print this modification.

Show Call Types. When this button is pressed down all new generated flowcharts will contain additional labels near connection lines.

Toggle ‘Is Used’ Status. Those sections within COBOL programs, which are assumed by COBOL Translation Toolkit as unused, are shown in italic. To correct the assumption you should use this button – a selected flowchart box will change its state.

Export to SVG. Use this button to generate HTML and SVG documents for main flowchart.

Export Sub-section to SVG. Use this button to generate HTML and SVG documents for sub-section flowchart.


  For further information please contact sales@softwaremining.com



 

  © 2008 , SoftwareMining. All Rights Reserved.

- http://www.softwaremining.com