Heirloom Enterprise PL/I — User Documentation¶

Version 1.0 | March 2026

A comprehensive guide to the Heirloom PL/I Compiler and Runtime for modernizing IBM mainframe PL/I applications to the Java platform.

About This Documentation¶

This documentation covers the complete Heirloom PLI Platform, including:

• PLI Compiler — PL/I to Java transpilation
• PLI Runtime — Java runtime library providing PL/I semantics
• Manifold Enhancement — Compile-time code enhancement
• EBP — Elastic Batch Platform for job execution
• Build Integration — Gradle and Maven configuration
• Real-World Examples — Practical examples from enterprise applications

Quick Navigation¶

For New Users¶

• Getting Started — Quick start guide with examples
• Introduction & Overview — Platform architecture
• Real-World Examples — Practical examples

For Developers¶

• Compiler Reference — Complete compiler documentation
• Runtime Reference — Runtime library and built-in functions
• Build Integration — Gradle and Maven setup

For CICS Developers¶

• CICS Support — CICS transaction processing
• SQL Support — Database integration
• Troubleshooting — Solutions to common issues

For Batch Developers¶

• EBP (Elastic Batch Platform) — Job scheduler
• JCL Integration — JCL syntax and execution
• Best Practices — Recommended patterns

What's New¶

Documentation Structure¶

The documentation is organized into 16 parts plus appendices:

1. Part 0 — Getting Started
2. Part 1 — Introduction and Overview
3. Part 2 — PL/I Compiler Reference
4. Part 3 — Manifold Enhancement ⭐ NEW
5. Part 4 — PL/I Runtime Reference
6. Part 5 — PL/I Language Reference
7. Part 6 — CICS Support
8. Part 7 — DB2/SQL Support
9. Part 8 — IBM MQ Support
10. Part 9 — File and I/O Operations
11. Part 10 — Condition Handling and Diagnostics
12. Part 11 — Migration and Compatibility Guide
13. Part 12 — EBP (Elastic Batch Platform) ⭐ NEW
14. Part 13 — Real-World Examples ⭐ NEW
15. Part 14 — Build Integration ⭐ NEW
16. Part 15 — Troubleshooting ⭐ NEW
17. Part 16 — Best Practices ⭐ NEW
18. Appendices — Reference tables and quick lookups ⭐ ENHANCED

Support¶

• Support Portal: https://support.heirloom.cc
• Website: https://heirloom.cc

© 2026 Heirloom Computing. All rights reserved.