Capability Demonstration Rapid System Archaeology of a Legacy COBOL Foundation
This project serves as a definitive demonstration of how Edensoft Labs recovers lost operational intent from high-consequence legacy foundations. By reconstructing the functional DNA of a complex property tax system, we proved that critical mission logic can be mapped directly from COBOL source files to provide a rigorous foundation for human interviews and knowledge recovery. This approach ensures that even when modern documentation and orchestration layers are completely absent, our engineers can gain a deep understanding of the system in a fraction of the time it would take using manual methods. This baseline of technical truth allows us to begin the sustainment process with confidence.
The Challenge: Operating in a Documentation Vacuum
​​
The target was a mission-critical property tax extension engine comprising approximately 70 COBOL programs handling billions in annual revenue. The primary hurdle for this demonstration was the total absence of JCL (Job Control Language), which is the legacy orchestration layer that traditionally defines how these programs execute and interact in production.
​
Without this instruction manual, the system functioned as a black box responsible for the following:
-
Complex Exemption Logic: Orchestrating senior freeze and homeowner benefits with decades of encoded rules.
-
Regulatory Compliance: Implementing PTELL (Property Tax Extension Limitation Law), often called "tax caps," and TIF (Tax Increment Financing) district calculations for local government.
-
Legacy Data Integrity: Coordinating transactions across IMS (Information Management System) hierarchical databases, VSAM (Virtual Storage Access Method) indexed files, and sequential extracts.
Our Approach: Building a Foundation for Knowledge Recovery
​
Rather than relying on months of manual code review, our senior engineers performed a deep-dive archaeology of the 1990s-era source code. We utilized AI-assisted analysis as a specialized tool to accelerate this discovery, allowing our team to gain understanding in a fraction of the time. These archaeological tools enabled us to rapidly map the system's true structural anatomy and identify the exact personnel needed for targeted interviews.
1. Reconstructing the Global Execution Map
We established a complete execution order by using AI-driven archaeology to analyze implicit file dependencies, matching one program's output to another's input, to identify seven distinct processing phases, such as the initial IMS Database Extracts and the final Tax Rate Making pipeline.
​
2. Flagging the Technical Debt Iceberg
The archaeology surfaced critical structural risks and undocumented "no-touch" zones that require deliberate human validation:
-
Hardcoded Maintenance Ceilings: We identified that the Senior Citizen Assessment Freeze logic in program ASHMA850 relies on hardcoded year counters that stop at 2018, requiring manual code updates to continue processing.
-
Long-Term Century Risk: We flagged a Y2K (Year 2000) windowing approach where years greater than 60 are mapped to the 1900s, identifying a terminal failure point for the year 2060.
-
Atomic Migration Clusters: We isolated a group of 15 programs with deep, tightly coupled IMS database dependencies that must be modernized as a single cohesive unit to avoid system fragmentation.
3. Surfacing Hidden Logic for Validation
Our team used archaeological tools to extract "needles" from thousands of lines of code, such as the hardcoded $75,000 threshold for Homestead Improvements (Class 288) and the specific $10,000 regulatory limits for homeowner exemptions. These findings provided the specific evidence required to interview operators and maintainers about undocumented workarounds that materially affect mission outcomes.
The Result: An Actionable Roadmap for Evolution
​
By mapping 236 file interfaces and 82 shared data structures (copybooks), we transformed a "no-touch" black box into a clear roadmap for modernization. This project proves that with senior-led archaeology accelerated by AI, organizations can safely sustain and evolve their most critical legacy foundations by replacing assumptions with verified structural data.
Refactoring Demonstration: From Legacy Logic to Modern Architecture
​
Understanding the past is the foundation for building the future. We have selected a core component of this pipeline to demonstrate how legacy business rules can be refactored into a modern, highly maintainable structure while preserving 100% of certified operational behavior. Click here to see our refactoring of the COBOL Tax Extension Engine program.