# iSiloXC reference

## Usage

          Usage: iSiloXC [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
                   -q           Quiet
                   -v[v]        Verbose, use -vv for very verbose
                   -u           Update list status after conversion
                   -H           Hide window
                   -s           Perform a scheduled conversion

## Description

iSiloXC is the command-line tool for creating iSilo™ documents. It takes as input a conversion list file that specifies the information needed to create a set of documents.

## Options

-h | -?
Use either `-h` or `-?` to display the iSiloXC 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
-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
-a path
Use `-a` followed by a space and then the path to the application directory that contains supporting files for iSiloXC. 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 iSiloXC 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 iSiloXC.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.
-q
Use `-q` to specify quiet mode. Quiet mode suppresses progress messages during conversion. Note that this option does not suppress error messages and that if you specify `-v` for verbose, it overrides the quiet option
-v[v]
Use `-v` to specify verbose mode or `-vv` to specify very verbose mode. During conversion iSiloXC normally only outputs one line for each document in the document list. The line shows the index of the document, the total number of documents in the list, and the title of the document.

In verbose mode, iSiloXC outputs the major steps of converting a document as it happens and also outputs path of each source file as it is processed.

In very verbose mode, iSiloXC first outputs the options you have specified on the command line followed by the settings and conversion list. Then during conversion, iSiloXC outputs more detailed progress information.
-u
Use `-u` to have iSiloXC 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, iSiloXC must be able to write to the conversion list file.
-H
Use `-H` to hide the console window.
-s
Use `-s` to perform a scheduled conversion. This option requires iSiloXC 3.35 or later.

Generally, when you perform a scheduled conversion, you should also specify the `-u` option so that iSiloXC 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 iSiloXC 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.

iSiloXC does not have the ability to automatically schedule itself to be called by your operating system, so usually if you want scheduled conversions to occur, you need to use your operating system's facilities to schedule iSiloXC periodically to perform a scheduled conversion. As mentioned above, when iSiloXC performs a scheduled conversion, only those entries with a next scheduled conversion time that has been reached or passed will be converted. If, for example, you have one entry scheduled to be converted once every hour and another scheduled for once every day, you should use your operating system's scheduling facilities to call upon iSiloXC to perform a scheduled conversion at least once every hour.

## Examples

When running iSiloXC 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:

        iSiloXC -x MyDocumentList.ixl -v

In the above command line, `MyDocumentList.ixl` is assumed to be the file name of a conversion list file in the current directory. Specifying `-v` allows you to get a good idea of the conversion progress as it goes along.

If you use a scheduler to schedule iSiloXC, you may want to have iSiloXC 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\iSiloXC.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 perform a scheduled conversion, you will want to use a command line similar to the following:

        iSiloXC -x MyDocumentList.ixl -u -s

©1999-2017 DC & Co. All rights reserved.