Supported Parameters and Command Line Execution

The S2I Converter can be executed on the command line in a DOS shell as well as in GUI form. It also has several parameters which can be used when running in either form

Command Line Parameters:

Some parameters can be passed in from the command line or read in from the user settings configuration file. When this overlap occurs, the value passed in on the command line temporarily overrides any value in the configuration file. The reason for this duplication is to allow command line use with settings that may differ from those in the configuration file.

e.g. In an overnight job, converting a group of included scenarios three times in three different output formats and giving each a different output directory to preserve each result.

S2I has the following command line parameters. Unless noted otherwise,

  • -s or -simmod: The directory or folder where the SIMMOD scenario directories are. If this parameter is not used, this directory is assumed to be the current directory. The -s option is required when executing in a directory other than the one where the SIMMOD scenarios are.
  • -i or -inm: The directory or folder where the INM data is written to. It is also an option on the INM Settings Tab. Not having an INM directory when converting SIMMOD data is a fatal error which is only recoverable when running the GUI.
  • -o or -output: The desired output format. It is also an option on the INM Settings Tab. If neither is set, the default is the same as the GUI default. Values for this parameter can be any variation of upper or lower case, so DBF, dBf, and dbf are all supported. The supported values are as follows:
    • tab: Spreadsheet Compatible Format (Tab Delimited File): This format is for easy input into spreadsheets, databases, or other programs.
    • dtx: INM Text File Format (WriteDbfText Ouptut Format): This format is the output of INM's WriteDbfTxt.exe. It is the equivalent of the DBF format in text form.
    • dbf: DBF Database Format. This is the format that INM expects its data to be in. It is binary.
  • -c or -conversion: The conversion setting to convert. This parameter is intended for use when running from the command line. It is required when there is no GUI.

Calling S2I from the Command Line:

To call S2I without the graphical user interface, enter

java.exe com.airporttools.apecs.s2i.s2iConverter [parameters]

The above without any parameters yields a usage comment listing the command and all available application parameters.

For example, let us assume that a SIMMOD scenario at D:\simmod\Applications\SAN_W_SOUTH (named SAN_W_SOUTH) is included in a conversion setting named san_conversion.

java.exe com.airporttools.apecs.s2i.s2iConverter -c san_conversion -s d:\simmod -i d:\inm\Examples\SAN

Converts conversion setting SAN_W_SOUTH using SIMMOD scenarios under D:\simmod. It outputs the equivalent INM data to D:\inm\Examples\SAN.

Sample scripts may be found here