Add COBOL codebase analysis documentation for modernization planning - #209
Open
devin-ai-integration[bot] wants to merge 2 commits into
Open
devin-ai-integration[bot] wants to merge 2 commits into
devin-ai-integration[bot] wants to merge 2 commits into
Conversation
…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
Author
🤖 Devin AI EngineerI'll be helping with this pull request! Here's what you should know: ✅ I will automatically:
Note: I can only respond to comments from users who have write access to this repository. ⚙️ Control Options:
|
- 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
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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:
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.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.DEPENDENCY_MAP.md— Three views of program dependencies:HOTSPOT_REPORT.md— Top 10 modules ranked by composite score (complexity 40%, risk 35%, business impact 25%). Key findings:COACTUPC(feat: Modernize COBOL CBACT01C batch program to Java 17+ #1, 4,236 LOC, 51 GO TOs, 58 copybook includes) is the dominant hotspotCOPAUA0C(feat: Modernize CBACT01C COBOL batch program to Java 17+ #6) has the highest technology diversity (CICS + IMS + MQ simultaneously)CBSTM03A(feat: Phase 0 + Phase 1 Java 17 migration of COBOL CardDemo batch programs #9) uses obsoleteALTER ... PROCEED TOdynamic GO TONo source code was modified."
Link to Devin session: https://partner-workshops.devinenterprise.com/sessions/f2ec55ddb4014b7295f02562fccbad5c
Requested by: @DhrovS