CLI Reference

iPoolSuite.exe supports headless (no-window) operations via command-line flags. This page covers the Scenario Studio CLI command. For the Bid Manager CLI command (-ibd2ibdx), see the Bid Manager CLI Reference.

--convert-bat

Converts one or more legacy iPool batch files to updated batch files compatible with the current iPoolSuite, and writes a report of every change made. The output is an updated batch file (<name>_converted.bat) — it is not a Scenario Studio scenario definition.

This command uses the same conversion rules as the Convert old batch file dialog in the Scenario Studio interface.

Syntax

iPoolSuite.exe --convert-bat <file.bat> [<file.bat>...] [--convert-files] [--keep-rep] [--out <folder>] [--summary <file>]

Arguments

Argument	Required	Description
<file.bat> [...]	Yes	One or more legacy batch file paths to convert.
--convert-files	No	Also converts .bid and .mdb files referenced by the batch file to .bidx and .db format respectively, placed beside the originals. A results view shows the conversion outcome.
--keep-rep	No	Disable rule R5: keep the batch file's -rep flags as-is instead of updating them to -rep 3. Use when the batch targets an engine version that still takes -rep without a level argument.
--out <folder>	No	Output folder for the converted files. Default: beside the original file.
--summary <file>	No	Write all conversion reports to this single file.

The same file conversion happens when the "Also convert the .bid and .mdb files it uses" checkbox is ticked in the Convert old batch file dialog.

Output

For each file, two files are written to the output location:

• <name>_converted.bat — the updated batch file with replacements applied.
• <name>_converted_report.txt — a report listing every change made.

Each processed file produces two lines on stdout:

OK: <input-path> -> <output-path>
    report: <report-path>

Exit codes

Code	Meaning
0	All files converted successfully.
1	One or more files failed to convert, or bad arguments.

Example

iPoolSuite.exe --convert-bat "C:\IENERGY\WESM2610\run_2609.bat" --out "C:\IENERGY\WESM2610\converted"