Map-descriptor CLI
The ol-refactor CLI generates screen descriptor JSON from BMS/MFS sources. It does not convert programs to Groovy. For the console Player, use Import maps (stores descriptors in the metadata database), then re-OPEN the Player session.
# CICS BMS + symbolic copybook
./gradlew :engine:cli:run --args="map-descriptor --backend CICS --map <map.bms> --copybook <map.cpy> --out <out.json> --overwrite"
# IMS MFS only
./gradlew :engine:cli:run --args="map-descriptor --backend IMS --map <map.mfs> --trancode <TRAN> --drain-qc-first --out <out.json> --overwrite"
| Option | Description | Default |
|---|---|---|
--backend | CICS or IMS | required |
--map | BMS or MFS source (single-map) | — |
--copybook | CICS-only symbolic copybook. Rejected for IMS | — |
--out | Output JSON path | — |
--dir / --out-dir | IMS bulk .mfs folder → output directory | — |
--trancode | IMS trancode when MFS literal is blank | — |
--drain-qc-first | IMS: drain queue-count first | off |
--overwrite | Overwrite existing output | off |
--geometry-only | CICS-only without copybook | off |
--dry-run | Print JSON; do not write | off |
Run ol-refactor map-descriptor --help for the full list.
Generate MapDescriptor JSON from BMS or MFS. Does not convert programs to Groovy.