# iSiloX Command Line

iSiloX can be called with either a .ixl file to open or with options to start the conversion of the documents specified by a .ixl file.

## Usage

          Usage: iSiloX [ixlFileToOpen | options]
        Options:   -h | -?      Display this usage help information
                   -x filename  Convert document list with filename
                   -o filename  Option settings filename
                   -a path      Base application file path
                   -u           Update list status after conversion
                   -H[pse]      Hide window
                                  p   Progress dialog
                                  s   Successful conversion messages
                                  e   Conversion error messages
                   -s           Perform a scheduled conversion

## Options

-h | -?
Use either `-h` or `-?` to display the iSiloX command-line usage help information.
-x filename
Use `-x` followed by a space and then the path to a conversion list file (e.g., .ixl file) to convert the documents specified in the file. For the format of this file, see .ixl file format

Note that if you also specify `-s` to perform a scheduled conversion then only scheduled entries whose next conversion time are reached are converted. If you do not specify `-s` then all entries are converted.
-o filename
Use `-o` followed by a space and then the path to a settings file (e.g., .ixs file) to specify settings for additional options. For the format of this file, see .ixs file format If you do not specify a settings file, then iSiloX uses the saved system settings.
-a path
Use `-a` followed by a space and then the path to the application directory that contains supporting files for iSiloX. One such supporting file is the html40.css file, which specifies default HTML style settings. If the application directory is not specified or if the application directory does not have this file in its CSS subdirectory, then iSiloX uses default HTML style settings.

On platforms that support automatic queuing of converted documents for HotSync®, the application directory may contain additional files in the Palm subdirectory needed for this functionality.

Under Windows, as long as the iSiloX.exe executable file is located in the application directory, there is no need to specify the application path using the `-a` option unless you want to specify a different application directory.
-u
Use `-u` to have iSiloX update the conversion status information for each document in the list. This information includes the date and time of conversion, the resulting document size, and whether the conversion was successful or not.

Note that if you specify this option, iSiloX must be able to write to the conversion list file.
-H
Use `-H` alone to hide the conversion progress window and the conversion result messages. Note that if you use this option, you will not be able to cancel the conversion and you will not be able to see the conversion progress.

You can optionally specify additional option letters to selectively hide only certain windows. For example, specify `-Hp` to only hide the progress dialog but still display the conversion result messages. If you just want to see conversion error messages, specify `-Hps` so that only the progress and successful conversion messages are hidden. Note that if you do not manually dismiss a conversion result message, it automatically dismisses itself within 30 seconds.
-s
Use `-s` to perform a scheduled conversion.

Generally, when you perform a scheduled conversion, you should also specify the `-u` option so that iSiloX can correctly update the next scheduled conversion times. If you do not specify the `-u` option, scheduled conversions may not function correctly.

A scheduled conversion only results in the conversion of entries whose next conversion time has been reached. So if iSiloX is called to perform a scheduled conversion and no entry has a next conversion time that is due, then no conversions occur. If, however, there is at least one entry with a next conversion time that has been reached or passed, then all such entries are converted. In addition, in this case, all document entries that have an always schedule are also converted. All entries then have their next conversion times updated according to their individual schedules.

## Examples

When running iSiloX from a command-line prompt to convert a given set of files in a .ixl file, you will generally use a command line similar to the following:

        iSiloX -x MyDocumentList.ixl

In the above command line, `MyDocumentList.ixl` is assumed to be the file name of a conversion list file in the current directory. The above command line of course assumes that iSiloX is located either in the current directory or the directory in which it is located is one of the directories in the PATH environment variable.

If you use a scheduler to schedule iSiloX, you may want to have iSiloX update the last conversion status. Under Windows, you might provide to the Windows scheduler a command line similar to the following:

        "C:\Program Files\iSilo\iSiloX\iSiloX.exe" -x "C:\My Documents\iSiloWWW.ixl" -u

The double quotes around the path to the executable and the path to the conversion list file are necessary because both paths have spaces.

To simply open a .ixl file within iSiloX, specify the path to the .ixl file as the single command line argument:

        "C:\Program Files\iSilo\iSiloX\iSiloX.exe" "d:\ixl\iSiloX Favorites.ixl"