Troubleshooting and Shortcuts

Common issues

• Missing connections: enable relevant app pairs in Dependencies Control Panel.
• Disabled routing: select a pair that has unrouted dependencies.
• Failed workspace load: verify backend connectivity and browser-console errors.
• Failed import: validate JSON has apps and connections arrays.
• Missing Graph Assistant or AI documentation: configure an AI provider and verify source exists.
• Missing table metadata: verify DB2 or DB400 connection settings and reload.
• Empty MFS preview: confirm the file extension is .mfs and that the message descriptor names a device format in the same member.
• Dead code finds everything or nothing: set seed = 1 on real entry programs, then refresh the analysis.
• Remote MCP client cannot connect: set OL_MCP_BASE_URL to the host URL clients should use.
• Port conflict: set APP_PORT or stop the conflicting process.
• Data missing after restart: verify the configured persistent volume.

Shortcuts

• Enter: submit a dialog or send Graph Assistant input
• Escape: close the current dialog, panel, or overlay
• R / Ctrl+R: open Route Dependencies
• G / Ctrl+G: toggle app grouping
• Enter / Shift+Enter in source search: next / previous match