ABL2DB & ABL2UML Group

Call Tree

tamhas — Thu, 01 Oct 2015 15:29:49 -0600

Build a calltree starting with a diskfile record. Only procedure calls are logged, currently (oe 11.5.1) xml-xref does not provide nodes for function calls like 'RUN' for procedures. The report has a .p extension, purpose is to provide clickable links to files. Of course the propath has to make the clickable link possible.

Contributed by Stefan Houtzager.

ABL2DB & ABL2UML Group

Change Log prior to version 1.00

tamhas — Thu, 25 Jun 2015 14:28:37 -0600

0.50 - Initial Release
0.51 - Parameterize overall log location in variable
0.52 - Clean up GetDescription logic
0.53 - Fix separator bug in BuildRunLinks.cls
0.59 - Add M support for LOB-SIZE and LOB-BYTES
       - Support TABLE-TRIGGER
       - Support N separate DBs with their own schema
       - Support DB in table links
       - Support DB Connect params (including live DBs)

Development Tools Group

Proparse Utilities

tamhas — Thu, 18 Jun 2015 15:06:25 -0600

Having started to use Proparse as a part of ABL2DB, I have created several utilities for Proparse, either to call from ABL2DB or to provide information to use in development of ABL2DB. Since these utilities might be useful to someone doing other development with Proparse, I am documenting them here. For now, they are available as a part of the ABL2DB distribution. If there was demand, I could package them separately. All are published in the com.cintegrity.Proparse package.

ABL2DB & ABL2UML Group

Unused Database Column

tamhas — Sun, 07 Jun 2015 14:31:59 -0600

In the course of evolving an application, it is not uncommon for database columns to be added in anticipation of some change that never happens or for once used column to be replaced by other schema or even for whole tables to be abandoned because the functionality they supported is no longer needed or relevant. These columns present no actual harm, but may be confusing since one assumes they are used, especially since they may contain legacy data from when they were used.

ABL2DB & ABL2UML Group

Shared Variable Usage in a Functional Unit

tamhas — Sun, 07 Jun 2015 14:26:20 -0600

One of the common tasks in modernization is replacing the use of shared variables with explicitly passed parameters or references to persistent procedures or objects.

Development Tools Group

References to an Integer DB column in programs

tamhas — Sun, 07 Jun 2015 14:21:33 -0600

With the advent of the INT64 datatype, there can be the desire to change the datatype of an existing database column of type integer to type INT64. When this is done, it is desirable to examine the code where this column is referenced to see if there are local variables which also need to be changed.

This report starts with a designated database column and finds all of the references in code where that column is used.

The ABL code and a sample report are provided. The IntRefs_James sample is from James Palmer examining the proposed change of their customer number to INT64.

ABL2DB & ABL2UML Group

Blocks in Compile Unit

tamhas — Sun, 07 Jun 2015 14:12:53 -0600

We all know how important buffer and transaction scope can be to the proper operation of an ABL program. We have COMPILE LISTING to show us these scopes, but many programmers are either unaware of the tool or seem to forget to use it to check their work. But, this information is critical to understanding many issues of many problems.

Development Tools Group

Sample Reports

tamhas — Sun, 07 Jun 2015 13:51:13 -0600

While it is possible that fancier and more sophisticated reports and inquiries will arise on top of ABL2DB over time, not the least of which is its possible role as the front end for ABL2UML, it is likely that the bulk of analytical report for ABL2DB will be specific, project oriented programs. Fortunately, they are also likely to be quite simple. Therefore, the samples presented here are not fancy works of art, but very simple little programs designed to get the desired information with as little development effort as possible.

Development Tools Group

Thank you

tamhas — Thu, 04 Sep 2014 10:16:38 -0600

This page is intended to provide recognition for people who have contributed to the development of this utility. I will probably forget someone, for which apologies are offered, but I will try.

James Palmer - testing and interaction about problems.
Simon Prinsloo - testing and interaction about problems.
Stefan Houtzager - testing, feedback on issues and actual code to fix problems and add features, and a sample report.
- ABL2DB & ABL2UML Group
read more

Questions and Answers

tamhas — Tue, 01 Jul 2014 12:41:17 -0600

This section is intended to provide information on various questions which have come up in the use of this tool.

Q: Originally, the compile phase expected the empty schema files to be available single user. This is a problem if I try to use my regular development DB. A: As of 0.59 You can change this behavior if you want by the use of the chDataBaseConnectParams variable.
- Development Tools Group
read more

Analysis & Reporting

tamhas — Sat, 21 Jun 2014 10:13:38 -0600

In addition to targeted queries related to specific enhancement or maintenance projects, we will be exploring a number of possible analysis functions including:

Impact Analysis – What code will be impacted by a change to this table? What code will be impacted by a change to this other code?
Restructuring Analysis – Natural units of code for possible services in an SOA or to consolidate functionality in a single code unit.
Structure Analysis – Overview of a function which is about to be modified.
- Development Tools Group
read more

Roadmap & Wish List

tamhas — Sat, 21 Jun 2014 10:08:45 -0600

Some of the items on the roadmap include:

Block Resolution – Map blocks to Compile SubUnits and create Run and Table Compile SubUnit Links.
Persistent Resolution – Find unresolved calls which can be resolved to persistent and super procedures.
Load Saved Dynamic Calls – Resolve fresh load from resolutions saved previously.
Unresolved Dynamic Call Report.
Manual Dynamic Call resolution.
Mapping of Symbol (variable, buffer, etc.) to Scope and Block
Tracking of non-shared symbols.
Collecting WHERE clause
Unused Code report.
- ABL2DB & ABL2UML Group
read more

Change Log

tamhas — Sat, 21 Jun 2014 10:02:30 -0600

See below for pre-1.00 log
1.01 - Initial Proparse release. Includes tracking of shared variables
1.02 - Convert to case insensitive GUID keys
1.03 - Add all shared object types - buffer, browse, dataset, frame, menu, query,
stream, temp-table, variable, and work-table.
1.04 - Change compilable test to look for XREF
1.05 - Add Proparse buffer tracking to BuildBlocks to resolve buffer names to
tables
1.06 - Bug fixes in BuildBlocks

ABL2DB & ABL2UML Group

The Driver Class

tamhas — Fri, 20 Jun 2014 13:18:58 -0600

To run ABL2DB one runs launcher_abl2db.p whose configuration is discussed in the Configuration section. it sets up the overall log (one can add additional tracking if desired for debugging), creates the Driver class, initializes the Driver class with the configuration values, and then executes the Initialize() method which tests some preconditions, and the Process() method which does the actual work.

Development Tools Group

Configuration for Site Specific Setup and Characteristics

tamhas — Wed, 18 Jun 2014 15:48:24 -0600

The primary tailoring occurs in the launch program, abl2db_launcher.p which is found at the top of the src directory. At the top of this program you will find a section of variable definitions labelled Application Specific Definitions. You need to edit the initial values for these definitions to match your application.

Development Tools Group