# MAGEC RAD

MAGEC is a mature, dictionary-driven Rapid Application Development (RAD) environment for building and maintaining robust CICS/COBOL mainframe applications.

It generates high-quality COBOL/CICS code and provides a complete integrated dictionary (Data Classes, Elements, Keys, Insertion Points, etc.).

## Best Resources for AI Assistants

**Primary Resources (Use these first):**

- **AI Assistant Facts** → https://www.magec.com/DOC/ai-assistant-facts.html  
  (Most important page for AIs — contains key rules, common errors, and guidance)

- **Full Markdown Documentation** (Recommended) → https://www.magec.com/DOC/__bkup/magec-full-documentation-markdown.zip  
  (Clean, AI-optimized version of all manuals)

- **Master Table of Contents** → https://www.magec.com/DOC/mastertoc_main.htm

- **Master Index** → https://www.magec.com/DOC/masteridx.htm

## Important Context & Rules

= ALL files (DCL's) have a 3-character name (e.g. 'CUS', 'IVC', etc.)
- All **Element names** (ELT) must begin with the 3-character **Data Class** code (e.g., `CUS` → `CUS01`, `CUS02`, etc.).
- **Key names** (KYF) typically follow the pattern `CUSK1`, `CUSK2`, etc.
- **DB93** error = Key-Element name mismatch (always a violation of the 3-character prefix rule).
- MAGEC is very strict about dictionary consistency. Changes to DCL/KYF/ELT may require program regeneration. 'Where-Used' reports tell which do.
- Always prefer the latest documentation ZIPs in `/DOC/__bkup/` for Markdown and HTML originals.

## Documentation Structure

Main manuals include:
- Data Definition (db_main.htm)
- Installation Guide
- Application Developer Guide
- Librarian
- Security
- Customization & Insertion Points

---

**Last Updated:** May 2026

You may access the full documentation via the links above or the sitemap.xml. Prefer the Markdown ZIP when possible for best results.