Skip to content

Add COBOL codebase analysis documentation for modernization planning - #209

Open
devin-ai-integration[bot] wants to merge 2 commits into
mainfrom
devin/1781281124-cobol-codebase-analysis
Open

devin-ai-integration[bot] wants to merge 2 commits into
mainfrom
devin/1781281124-cobol-codebase-analysis

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Jun 12, 2026

Copy link
Copy Markdown

Summary

Adds four comprehensive markdown documents under docs/ from static analysis of the entire CardDemo COBOL codebase — intended to orient modernization planning before any code migration begins.

What was analyzed: 44 COBOL programs (25 online CICS + 19 batch), 41 copybooks, 42 JCL jobs, 21 BMS maps, 2 assembler modules, across core + 3 optional modules (Auth/IMS/MQ, Tran Type/DB2, VSAM-MQ).

Documents produced:

  1. APPLICATION_INVENTORY.md — Complete catalog of every artifact with classifications by processing mode (online/batch), business domain, technology stack (VSAM/DB2/IMS/MQ), and optional module membership.

  2. DATA_DICTIONARY.md — All 16 business entities extracted from copybook PIC clauses: Customer, Account, Card, Transaction, etc. Each field includes COBOL PIC clause, Java-equivalent type, byte length, and business description. Includes PII/PCI sensitivity annotations (SSN, card numbers, plaintext passwords) and an entity relationship diagram.

  3. DEPENDENCY_MAP.md — Three views of program dependencies:

    • Online call graph (XCTL navigation tree from COSGN00C through all menu paths)
    • Batch call graph (CALL relationships, IMS DL/I, MQ operations)
    • File access matrix showing which programs read/write which VSAM files, DB2 tables, and IMS segments
    • JCL job sequencing from Control-M scheduler definitions (daily/weekly/monthly/yearly cycles)
  4. HOTSPOT_REPORT.md — Top 10 modules ranked by composite score (complexity 40%, risk 35%, business impact 25%). Key findings:

No source code was modified."

Link to Devin session: https://partner-workshops.devinenterprise.com/sessions/f2ec55ddb4014b7295f02562fccbad5c
Requested by: @DhrovS


Open in Devin Review

…ap, hotspot report

Static analysis of the entire CardDemo COBOL mainframe codebase producing
four comprehensive documentation artifacts for modernization planning:

- APPLICATION_INVENTORY.md: Catalogs all 44 programs, 41 copybooks, 42 JCL
  jobs, 21 BMS maps, and assembler modules with classifications
- DATA_DICTIONARY.md: Extracts 16 business entities from copybook PIC clauses
  with data types, lengths, and PII/PCI sensitivity annotations
- DEPENDENCY_MAP.md: Call graph (XCTL/CALL), file access matrix, JCL job
  sequencing, and batch data flow diagrams
- HOTSPOT_REPORT.md: Top 10 modules ranked by complexity, risk, and business
  impact with migration sequencing recommendations
@devin-ai-integration

Copy link
Copy Markdown
Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

devin-ai-integration[bot]

This comment was marked as resolved.

- COBOL Programs (Core): 30 → 31 (17 online + 14 batch)
- Copybooks (Optional): 13 → 11 (9 Auth/IMS/MQ + 2 DB2)
- BMS Copybooks: 19 → 21 (17 core + 4 optional)
- JCL Jobs (Core): 34 → 38 (17 data mgmt + 13 batch + 8 utility)
- Total: 174 → 179
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant