Converter Factory Settings

These settings can be used in both the converter factory settings collection and in the global converter factory settings collection. Settings in the converter factory will override the global default settings.

Setting Name

Value

UsesPrintingProtocol

This is true for all converter factories that print to the Document Conversion Service to convert the document, false for any converter factories that do not use the printer. In most cases this setting never needs to be modified.

COMRetryLaterMaxTimeout

Sets a time limit, in milliseconds, on how long to retry Office automation COM calls when automating returns the error RPC_E_SERVERCALL_RETRYLATER. Currently used only by Excel and should never need to be modified. The default value is 2000ms.

 

These settings are normally only set in the General Application Settings section of the application configuration file but can be overridden as needed in the individual converter factory settings.

Setting Name

Value

PrintSessionWaitTimeout

How long the converter will wait to get access to a printing session.

PrintSessionFirstJobTimeout

This setting is applied to the printing session used by the converter and determines how long the printing session  will wait for a job to start spooling in the printer queue after a document is printed before releasing the printing session back into the printer pool

PrintSessionAvailableTimeout

This setting is applied to the printing session used by the converter and determines how long to wait between jobs entering the queue before releasing the printing session back into the printer pool.

PrintSessionWaitOnSpoolingTimeout

How long the converter will wait for each job to start spooling in the printer queue.

PrintSessionWaitOnCompleteTimeout

This is NOT the total amount of time for the document to convert, it is the amount of idle time used to determine when to cancel a document being created. If the converter does not see any progress (pages being converted) in this amount of time the document is canceled.

MaxRetryAttempts

Controls the number of times to retry converting a document if it was not successful on printing. Minimum value is 0, meaning we will not retry, and the maximum number of retries is 5. The default is 2.  

 

Setting this value in the converter settings will override this setting if set in the The Application Pool or in the Document Conversion Service Printer Pool section.

MaxSpooledPagesAllowed

Sets the maximum number of pages that are allowed to be printed/spooled. The default value value is 0, meaning there is no limit. If a document exceeds this count, it enters an error state and no file is created. To limit how many pages to convert see the PageRange setting in General Converter Options.

 

Setting this value in the converter settings will override this setting if it is set in either Application Factory Settings or in the General Application Settings section.

 

This option can also be overridden on a per document basis using profiles as described in Creating and Customizing Profiles.

ZeroByteFiles

Determines if files with a size of zero (0 bytes) are skipped or failed when processed. When set to Fail, an error is produced. When set to Skip, the file is skipped and a message is produced instead of an error. Default behaviour is to fail the file.

 

These variables control the maximum amount of time to wait on the open and close calls to the converter to ensure the conversion threads do not blocked by the underlying application. These values is entered in microseconds (1 second = 1000 microseconds). If not specified the default value is 60000ms, and can be no smaller than 20000ms.

Setting Name

Value

DocumentOpenTimeout

The maximum amount of time to wait for the converter to open the document.

DocumentConvertTimeout*

The maximum amount of time to wait for the converter to convert the document.

DocumentCloseTimeout

The maximum amount of time to wait for the converter to close the open document.

DocumentCloseAllTimeout

The maximum amount of time to wait for the converter to close all open documents.

ApplicationCloseTimeout

The maximum amount of time to wait for the application to close.