RPGLE Analyzer

Professional-grade VS Code extension for RPGLE analysis — from AST-powered parsing to inline diagnostics, cross-file /COPY resolution, and scope-aware code completion.

RPGLE Analyzer keeps the built-in Outline structural and adds separate views for semantic, impact, and graph analysis.

Version 0.11.2 — Fix de estabilidad en Hover para fuentes complejos, Data Flow Visual webview unificado, toggle legacy views, EXSR tracking, Graph Explorer SVG, Smart Preview virtual scroll, Hover unificado con gutter decorations.

What It Gives You

Supported Scope

Main Views

Outline

Use the standard VS Code Outline when you want structure first.

• Procedures stay grouped and readable
• Local definitions stay inside their procedure
• DS fields appear nested under their parent structure
• Optional reference lines can be shown under declarations

Go to Definition & Hover

Press F12 or Ctrl+click on any symbol to jump to its declaration. Hover over symbols to see kind, scope, and detail information. Scope-aware: resolves local variables before globals.

Diagnostics

Errors and warnings appear inline as you type (debounced) and on save:

• ⚠️ Warning: declared variable never used
• ❌ Error: procedure/subroutine/block without matching close
• ⚠️ Warning: prototype without matching procedure or CALLP

Semantic Insights

Use RPGLE: Open Semantic Insights when you want variable-level analysis. (redirige a Data Flow Visual si useLegacyTreeViews: false)

• Groups variables by scope
• Shows Read, Write, and Read/Write counts
• Detects legacy opcodes: MOVE, MOVEL, Z-ADD, ADD
• Detects SQL INTO :var as write
• Supports partial-text filtering
• Lets you jump to declarations and relevant references

Data Flow Visual

Use RPGLE: Open Data Flow Visual (o cualquiera de los comandos legacy de Semantic Insights, Data Flow Analysis o Impact Explorer, que redirigen aquí) cuando quieras un panel unificado con análisis completo de data flow.

• File I/O Graph — Operaciones I/O agrupadas por archivo, con íconos de lectura/escritura y navegación a línea
• Read/Write Analysis — Tabla de variables con reads/writes por opcode, scope, file I/O, dependencias entre variables, y advertencias de variables no leídas/no escritas
• Impact Propagation — Severidad direct/indirect/transitive + field origins con cadena de origen hasta el archivo

Toggle legacy: Si prefieres las vistas de árbol antiguas, activa rpgleOutline.useLegacyTreeViews: true en la configuración.

Cross-file /COPY

/COPY and /INCLUDE directives are resolved recursively:

• Searches includes/, include/, <library>/, and source directories
• Supports extensions: .rpgle, .rpgleinc, .inc, .cpy
• Merged symbols are marked with includedFrom showing origin
• Cache with 10s TTL, invalidated on save

Code Completion

Triggered by . (dot) — provides:

• Keywords: 40+ RPGLE keywords (dcl-s, if, dow, monitor, callp, etc.)
• Snippets: 8 block templates (dcl-proc...end-proc, monitor...on-error...endmon, if...endif, etc.)
• Variables: scope-aware (globals + locals + from /COPY)
• Subfields: after DS_NAME.
• Procedures: after callp / call

Impact Explorer

Use RPGLE: Open Impact Explorer when you want invocation flow from a selected root.

• Works on the active file
• Supports root selection
• Shows outgoing impact and basic incoming callers
• Supports partial-text filtering

Graph Explorer

Use RPGLE: Open Graph Explorer when you want a more conceptual local map.

• Invocation flow
• File interactions
• LikeDS data-shape relations

Recommended Commands

Installation

Install the extension from the VS Code Marketplace when available, or from a provided .vsix package.

Short version:

1. Open Extensions in VS Code.
2. Choose Install from VSIX... if you received a package file.
3. Open an .rpgle, .rpg, or .sqlrpgle member.

More detail: INSTALL.md

Configuration

{
  "rpgleOutline.enableDSpecVariables": true,
  "rpgleOutline.enableKListFields": true,
  "rpgleOutline.showReferencesInOutline": true,
  "rpgleOutline.maxReferencesPerSymbol": 20,
  "rpgleOutline.outlineSortMode": "alphabetical",
  "rpgleOutline.enableLiveBlockNavigator": true,
  "rpgleOutline.showLiveBlockStatus": true,
  "rpgleOutline.useLegacyTreeViews": false
}

Performance

ANTLR cold start is skipped for fixed-format files via heuristic detection.

Notes

• The extension is now stable (v0.11.0+).
• Analysis is intentionally conservative to reduce false positives.
• Most deeper analysis is local to the active file, not whole-workspace.
• Diagnostics and code completion require a running VS Code extension host.

Links

• CHANGELOG.md
• INSTALL.md
• SUPPORT.md