fujitsu-mainframe

Fujitsu Mainframe Analyzer

Analyze and migrate Fujitsu mainframe systems (FACOM, BS2000/OSD, OSIV, NetCOBOL, PowerCOBOL, Fujitsu JCL, SYMFOWARE) to modern Java/cloud platforms.

Core Capabilities

1. Fujitsu COBOL Analysis

Extract NetCOBOL/PowerCOBOL programs, Fujitsu-specific verbs, proprietary file organizations (SAM/PAM/ISAM), SYMFOWARE embedded SQL, screen handling (ACCEPT/DISPLAY with CRT STATUS).

2. Fujitsu JCL Analysis

Parse JOB statements, STEP definitions, ASSIGN/FILEDEF statements, conditional execution, cataloged procedures, resource allocation.

3. BS2000/OSD System Analysis

Analyze ENTER statements, system commands, file handling (PAM, SAM, ISAM), job variables, SDF processing.

4. SYMFOWARE Database Migration

Extract embedded SQL, schemas, stored procedures, transactions. Migrate to PostgreSQL, Oracle, or SQL Server.

5. Migration to Modern Platforms

Generate Spring Boot microservices, REST APIs, cloud-native apps (AWS, Azure, GCP), containerized deployments (Docker, Kubernetes), CI/CD pipelines.

Workflow

Step 1: Discover Assets

find . -name "*.cbl" -o -name "*.CBL" -o -name "*.cob"  # COBOL
find . -name "*.ncb" -o -name "*.NCB"  # NetCOBOL
find . -name "*.fjcl" -o -name "*.jcl"  # JCL
find . -name "*.cpy" -o -name "*.CPY"  # Copybooks
find . -name "*.sdf" -o -name "*.SDF"  # SDF files

Step 2: Analyze Structure

Extract divisions, data structures, file definitions, screen definitions, embedded SQL, Fujitsu-specific extensions. Key features:

• File organization: SEQUENTIAL, RELATIVE, INDEXED
• Screen handling: CRT STATUS, screen control
• Database: SYMFOWARE SQL
• Fujitsu verbs: ACCEPT OMITTED, INSPECT extensions
• Error handling: FILE STATUS, DECLARATIVES

Step 3: Map Dependencies

Build graphs: CALL hierarchies, copybook usage, file dependencies (FACOM), database access (SYMFOWARE), JCL sequences, screen definitions.

Step 4: Create Migration Strategy

Document architecture, Fujitsu-specific features, Java/cloud design, data migration, roadmap. Load references/migration-strategy.md for detailed framework.

Fujitsu-Specific Features

NetCOBOL Extensions

• Windowing, GUI support (PowerCOBOL)
• Enhanced ACCEPT/DISPLAY with positioning
• Object-oriented: CLASS definitions
• Extended exception handling

SYMFOWARE Database

• Embedded SQL: SELECT, INSERT, UPDATE, DELETE
• Cursors: DECLARE, OPEN, FETCH, CLOSE
• Transactions: COMMIT, ROLLBACK
• Migration: SYMFOWARE → PostgreSQL (cost), Oracle (enterprise), SQL Server

File Systems

Quick Patterns

COBOL → Java Spring Boot

Load references/migration-patterns.md for detailed examples. Quick overview:

Fujitsu COBOL:

SELECT EMPFILE ASSIGN TO "EMPDATA"
    ORGANIZATION IS INDEXED
    ACCESS MODE IS RANDOM
    RECORD KEY IS EMP-ID

Java JPA:

@Entity
@Table(name = "employees")
public class Employee {
    @Id
    private Integer empId;
    private String empName;
    private BigDecimal empSalary;
}

JCL → Shell + Kubernetes

Fujitsu JCL:

//STEP010  EXEC PGM=VALIDATE
//STEP020  EXEC PGM=PROCESS,COND=(0,EQ,STEP010)

Shell:

./validate && ./process

Load references/migration-patterns.md for Kubernetes CronJob examples.

Data Type Mappings

Load references/data-mappings.md for comprehensive tables. Critical mappings:

Migration Strategies

Strangler Fig Pattern (Recommended)

Gradually replace functionality. Lower risk, learn and adjust. Load references/migration-strategy.md for detailed steps.

Big Bang

Complete rewrite, single cutover. Higher risk, clean architecture. For smaller systems.

Hybrid

Core services modernized first, periphery later. Balanced risk/reward.

Output Requirements

Analysis Report Structure

1. Executive Summary - Overview, business impact, recommendation
2. Current State - Inventory, architecture, technology, dependencies
3. Fujitsu Features - NetCOBOL/PowerCOBOL, SYMFOWARE, file systems, screens, JCL
4. Target Design - Architecture, tech stack, microservices, data model, APIs
5. Migration Plan - Approach, timeline, resources, risks, costs
6. Technical Appendix - Code samples, mappings, utilities, testing

Load references/migration-strategy.md for complete frameworks and templates.

Critical Best Practices

1. ALWAYS use BigDecimal for COMP-3 and decimals (NEVER float/double)
2. Preserve business logic - understand before changing
3. Test with production data - validate conversions
4. Document Fujitsu extensions - proprietary features need special handling
5. Plan parallel run - compare outputs before cutover
6. Automate testing - regression suite for validation
7. Monitor everything - logging, metrics, alerts
8. Security first - authentication, authorization, encryption

Common Challenges & Solutions

Fujitsu-Specific Features → Custom adapters, equivalent libraries, re-implementation Screen Handling → User requirements gathering, modern UX design File Processing → ETL tools, Spring Batch Performance → Caching (Redis), async processing, DB optimization Transactions → Spring @Transactional, Saga pattern

Reference Files

When detailed information needed:

• references/migration-patterns.md - Complete code examples for all migration patterns
• references/data-mappings.md - Comprehensive type mappings, REDEFINES, dates, best practices
• references/migration-strategy.md - Full framework: assessment, design, testing, cutover, costs

Load these files for in-depth guidance on specific topics.