Mainframe Migration Toolkit

Python tools and runtime support for specification-led COBOL and JCL migrations to PySpark.

Installation

Install the complete runtime:

python -m pip install "mainframe-migration-toolkit[all]"

Python 3.10 or newer is required. Java 17 is required for the bundled dataset validator and is recommended when running PySpark pipelines.

Quick start

Initialize a migration workspace from its parent directory:

python -m mainframe_toolkit init-workspace .

The command creates an isolated migration/ Git repository and preserves existing source, input, and golden-dataset directories outside that repository.

Inspect the initialized workspace:

python -m mainframe_toolkit inspect migration --strict

Other commands parse JCL and copybooks, convert sequential datasets, scaffold PySpark jobs, analyze source similarity, coordinate ACP agents, and validate output against golden datasets. Run python -m mainframe_toolkit --help for the complete command list.