fujitsu-mainframe

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.

Step 1: Discover Assets

```bash

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.

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

| Type | Description | Java Equivalent |

| ------ | ------------- |-----------------|

| SAM | Sequential | BufferedReader/Writer |

| PAM | Partitioned | File directory |

| ISAM | Indexed | Database with index |

| GDG | Versioned | Timestamp naming |

COBOL → Java Spring Boot

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

Fujitsu COBOL:

```cobol

SELECT EMPFILE ASSIGN TO "EMPDATA"

ORGANIZATION IS INDEXED

ACCESS MODE IS RANDOM

RECORD KEY IS EMP-ID

```

Java JPA:

```java

@Entity

@Table(name = "employees")

public class Employee {

@Id

private Integer empId;

private String empName;

private BigDecimal empSalary;

}

```

JCL → Shell + Kubernetes

Fujitsu JCL:

```jcl

//STEP010 EXEC PGM=VALIDATE

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

```

Shell:

```bash

./validate && ./process

```

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

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

| Fujitsu COBOL | Java | Notes |

| --------------- | ------ |-------|

| PIC 9(n) | int, long, BigInteger | Size dependent |

| PIC S9(n)V9(m) | BigDecimal | ALWAYS for decimals |

| PIC X(n) | String | Alphanumeric |

| COMP-3 | BigDecimal | NEVER float/double |

| OCCURS n | List | Prefer List over array |

| SYMFOWARE | PostgreSQL |

| ----------- | ------------ |

| CHAR(n) | CHAR(n) |

| VARCHAR(n) | VARCHAR(n) |

| DECIMAL(p,s) | NUMERIC(p,s) |

| TIMESTAMP | TIMESTAMP WITH TIME ZONE |

| BLOB | BYTEA |

| CLOB | TEXT |

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.

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.

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

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

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.