FAQ

How do I preview a trail in Trail Viewer without saving it?

Open Trail Viewer and load the file. Preview does not write to Workspace → Snapshots. Save only when you want the analyzer to keep the events. Supported formats are .trail, .json, .trm, and native OpenLegacy XML — not generic XML.

How does workspace screen discovery and model mapping work?

Screen discovery names and merges screens from snapshots (AI identification plus your edits). Model mapping attaches field/model structure to those screens so later operations and Hub flows have named fields. Prefer multiple snapshots per screen so DYNAMIC regions and mapping stay accurate.

What is an operation definition versus an operation instance?

A definition is the start/end/reset trigger set you activate. An instance is one completed run of that definition against captured traffic. Definitions live under operation design; instances appear under Runtime → Operations. Flow → Hub needs instances, not definitions alone.

What is a map ScreenFlow versus a Hub terminal Screens Flow?

A Next map ScreenFlow is a recorded (or AI-generated) flow with declared I/O that runs and debugs against converted map programs — legacy code on the JVM — and can be exposed as OpenAPI. A Hub terminal Screens Flow automates a live 3270/5250 session. Do not use Next Screen Flows for RPC (use the RPC player). See [[feat

Which import source should I use — RSE, JT400, CoreIQ, Hub Planner, or file upload?

Use RSE or JZOS for live z/OS source, CICS CMCI for program discovery, JT400 for IBM i libraries (QRPGSRC and the like), CoreIQ or Hub Planner when those catalogs already hold the estate, and file upload or a .atq export when you have no live link. Switch AtomIQ to AS/400 platform mode when the estate is IBM i so z/OS-

How do I import BMS/MFS map descriptors and expose a map ScreenFlow as OpenAPI?

Import BMS or MFS descriptors in the console or via ol-refactor map-descriptor. Then record, author, or AI-generate a ScreenFlow with named fields and AID keys. Expose that ScreenFlow as OpenAPI. This is a map ScreenFlow — not a Hub terminal Screens Flow.

Can OpenLegacy create APIs from COBOL running on x86?

OpenLegacy can assess COBOL on x86, especially Micro Focus/Rocket, but the API approach depends on whether the app exposes RPC services or screens.

Can OpenLegacy CDC support BMC AMI Storage IAM (VSAM IAM) files?

Learn whether OpenLegacy CDC can support BMC AMI Storage IAM files, including expected compatibility and the key z/OS catalog caveat to validate.