Start Today

← Documentation

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"
OptionDescriptionDefault
--backendCICS or IMSrequired
--mapBMS or MFS source (single-map)—
--copybookCICS-only symbolic copybook. Rejected for IMS—
--outOutput JSON path—
--dir / --out-dirIMS bulk .mfs folder → output directory—
--trancodeIMS trancode when MFS literal is blank—
--drain-qc-firstIMS: drain queue-count firstoff
--overwriteOverwrite existing outputoff
--geometry-onlyCICS-only without copybookoff
--dry-runPrint JSON; do not writeoff

Run ol-refactor map-descriptor --help for the full list.

Generate MapDescriptor JSON from BMS or MFS. Does not convert programs to Groovy.

Read more