CL-Viz

CL-Viz is a local, browser-based visual evaluator for IBM i Control Language (CL) and RPG program analysis. It parses and evaluates program flow, then presents variables, branches, labels, subroutines, message handling, loops, multi-program execution, and data-flow views in an interactive interface.

This repository is the public distribution home for CL-Viz. Release assets are built and validated in the private development repository, then published here.

Download

Download the latest local package

The application is distributed as cl-viz-local.zip. GitHub's automatically generated "Source code" archives contain only this distribution repository; use the cl-viz-local.zip release asset to run the application.

Optional RPG analysis utilities are distributed separately:

Download the latest RPG tools package

Run locally

Windows

1. Extract cl-viz-local.zip.
2. Open the extracted cl-viz-local folder.
3. Double-click RunApp.bat.
4. Keep the terminal window open while using the application.

macOS and Linux

1. Extract cl-viz-local.zip.
2. Open a terminal in the extracted cl-viz-local folder.
3. Run python3 run-local.py.
4. Keep the terminal window open while using the application.

The launcher serves the application on http://localhost:8000/. Program data and browser storage remain on the local machine.

Optional RPG analysis tools

Download and extract tools.zip separately from the application. It contains command-line tools for RPG column mapping, assignment extraction, and Datalevin-backed lineage queries.

• The RPG source scanner requires Go.
• The packaged lineage application requires Java.
• The main browser application does not require Go or Java.

See README_TOOLS.txt inside tools.zip for examples.

Source availability

This repository currently distributes release binaries and documentation. The main application source is not currently published here. The bundled optional RPG analysis tools include their source code.

License

CL-Viz is available under the MIT License. Third-party libraries, fonts, runtimes, and other bundled dependencies remain subject to their respective licenses.

Feedback

Use this repository's issue tracker for reproducible problems with a public release. Do not attach proprietary IBM i source code, production data, credentials, or other confidential material.

IBM and IBM i are trademarks of International Business Machines Corporation. CL-Viz is an independent project and is not affiliated with or endorsed by IBM.