Morgana provides an enhanced outline view for fixed-format RPG code in Visual Studio Code. It helps you quickly navigate and understand RPGLE and SQLRPGLE files by displaying a structured overview of files, formats, indicators, fields, and usages. Designed to work seamlessly with the Code for IBM i extension, Morgana streamlines RPG development and improves productivity.
Features
Enhanced Outline View: Displays a structured outline for fixed-format RPG code (RPGLE and SQLRPGLE files), including files, formats, indicators, fields, and usages.
Seamless Integration: Works with the Code for IBM i extension for a smooth RPG development workflow.
Quick Navigation: Helps you quickly jump to definitions and usages within large RPG programs.
File Status Indicators: Shows alert icons for missing or unresolved files in the outline.
Explorer Panel Integration: Adds a dedicated "RPG Outline" section to the VS Code Explorer Panel.
Productivity Boost: Streamlines understanding and editing of legacy RPG codebases.
The server component for Morgana running on IBM i for advanced features like opening referenced display files. Please refer to the documentation provided with the server component.
Known Issues
Morgana is currently in BETA, so issues may occur. If you encounter any problems or have suggestions, please contact us at morgana@iandme.rocks.
Common Problems
The "Morgana RPG Outline" section does not appear:
Ensure the extension is enabled.
Restart Visual Studio Code.
Morgana RPG Outline shows No RPGLE file detected:
Ensure the file in the editor is an *.RPGLE or *.SQLRPGLE file.
Try the following:
Use the reload button to refresh the structure.
Switch between open .RPGLE files.
Close and reopen the file.
How It Works
Open Visual Studio Code and load your .RPGLE file using the Code for IBM i extension.
Navigate to the Explorer Panel (Ctrl+Shift+E or Cmd+Shift+E).
Click on the "RPG Outline" section to view the outline.
Example Structure
The outline structure includes the following:
Global Definitions
Files
Referenced File
Formats
Indicators
Fields
Format Usages
...
This README has been designed to provide a clear and concise overview of Morgana's features and usage. For further assistance, feel free to reach out via email morgana@iandme.rocks.
We value your feedback! Help us improve Morgana by taking a quick survey—it only takes a couple of minutes: Take the Survey
