Defining the Batch Parameters

Before running a batch from the Batch Monitor, you must define the parameters to be applied for the selected batch.

  1. Optional: To get help from the Batch Monitor window:

    • From any tab and with no batch selected in the list, select Help > Batch Monitor Help: the general online documentation on the Batch Monitor opens.
    • In the Utilities tab, select a batch in the list then select Help > Batch Monitor Help (or right-click a batch in the list then select Batch Monitor Help): the batch-specific online documentation opens.

      When no batch is selected in the list, the Batch Monitor Help command opens the general online documentation.

    • Click in the top-right corner of the corresponding batch interface: the batch-specific online documentation opens.

    Important: You cannot use F1 to access contextual help.

  2. To access the desired batch interface:

    • Double-click the batch of your choice from the list.
    • Right-click the batch from the list then select New parameter file.
    • Click the batch from the list then select File > New parameter file.

  3. Depending on the location of the objects to be converted, click:

    Warning: Appropriate licenses are required to access objects in the provider you are connected to.

  4. Set the batch parameters as explained in the corresponding documentation.

  5. Specify the report directory either by entering its path directly in the Report directory box, or by clicking to browse your filetree.

    The Report directory box contains the path of the directory where the reports and the processed documents will be stored.

    Important: This box is mandatory. By default, it is initialized with the current or temporary directory, depending on your configuration and on the write access.

  6. Enter the name of the report that will be generated in HTML format.

    The default report name depends on the batch you are running but you can replace it by the name of your choice if needed.

    This report is a global report dealing with all the documents that have been processed. In addition to this global report, the batch also creates an individual report for each processed document in the report directory.

  7. Optional: Use the Suffix for object report box to enter a string to be added at the end of each report name.

  8. Click Save to save your batch parameters in an XML file.

    By default, it is saved in a temporary folder.

    The file is named "BatchParameters" suffixed with the hour at which the batch was run (for instance, "BatchParameters_14.41.25.xml" to indicate that the batch was run at 14.41.25 PM).When saved, this file can be edited manually and used later on to run the batch directly without having to re-access the batch interface.

    Important: It is recommended to open the XML file in a text editor, other than Internet Explorer. As the Parameters.dtd file is not located in the same folder than the XML file being validated, the file may not open. To open the file in Internet Explorer, copy the Parameters.dtd file from intel_a\resources\batchdesc to the folder of the XML file.

    You can now either click Run to run the batch from the interface of the selected batch or click Cancel to close the batch window and go back to the Batch Monitor window (if you want to start other batches for instance).

  9. In the Batch Monitor, access the Start tab.

    The name and location of the XML file containing the batch parameters you defined in the previous steps (as well as the name of the host computer if you run the batch in remote mode) are displayed:

  10. Optional: If you have not already run the batch, select File > Run (or right-click the batch to run then select Run).

    Important: The Start tab lets you instantiate another batch while the current batch is running. It also lets you delete a batch from the list by selecting it from the list then choosing Edit > Delete (or by right-clicking then selecting Delete).

  11. Optional: From the batch interface, click Open Main HTML Report which is activated as soon as a report has been generated:

    This opens directly the global report in HTML format.

    You can also visualize the report by opening the result file from the directory where it has been saved.

    Note: If a GlobalResults.htm file already exists, it is automatically replaced by the new one.

  12. Access the Processes tab to display information on the batch execution:



    The following batch-related information is displayed:

    • Name of the batch.
    • Name of the parameter file used to run the batch.
    • Name of the host computer (if you run the batch on a remote computer).
    • Status of the batch ("Ended", "Running", etc.).
    • Feedback on the batch completion in the "Progress" column. "100%" is displayed when the batch is ended.
    • Start and end time, respectively in the "Beginning at" and "Ending at" columns.
    • Return code: "0" means that the batch executed correctly ; a code other than zero means that the batch has failed. For more information, see Generic Batch Monitor Error Codes and Generic Batch Error Codes.
    • Result of the batch execution (either "Succeeded" or "Failed").
    • Batch identification number.

    Note: The Processes tab also lets you interrupt the batch execution. To do so, right-click the desired batch from the list then select Interrupt. You can also delete a batch from the list by right-clicking the corresponding line then selecting Delete.

  13. To display the report of the batch execution, double-click the desired batch in the list to display the Results:



    This window indicates the beginning and end date and time of the batch execution as well as the name and path of the documents that have been processed.

    You can then:


    • Click Save to save your results in the folder of your choice. The file formats available are .txt and .xml. Note that this file is different from the one you save from the batch interface: the Save button in the Batch Monitor window lets you save the batch results (i.e. the data displayed in the Results window displayed above) whereas the Save button available in the batch interface lets you save the batch parameters.
    • Click Close to close the window and go back to the Batch Monitor window.

  14. To read the reports generated by the batch execution, access the folder c:\temp\batchID.

    Three files are created:

    • A report in text format named batchIDLOG.txt
    • A report in XML format named batchIDLOG.xml
    • A log containing the output named batchIDOUTPUT.xml.

    where batchID is the number identifying the batch.

    You can modify the default storage location of these files by exporting the following variable:

    set BATCH_HOME=new_path

    where new_path is the path of the new storage location.

  15. Select File > Exit to exit the Batch Monitor.