General Application Settings

These options control the number of documents that can be converted concurrently. This is limited by your license model and your available system resources such as CPU and memory.

Setting Name

Value

NumberOfDocumentsInParallel

Number of documents that can be converted at the same time. Set to "auto" to use the system resources to automatically determine an appropriate value.

NumberOfPrinters

Controls the size of the Document Conversion Service printer pool. This value should match NumberOfDocumentsInParallel for best performance.

 

These variables control the overall behavior of the Document Conversion Service.

Setting Name

Value

RunSelfHealForCoreServices

Detects proper installation of required components and will attempt to self-heal if any components are found missing. This check is always performed by default. We do not recommend disabling this check.

RunSelfHealForOtherServices

Optional detection and self-heal of secondary components; detects proper installation and will attempt to self-heal if any components are found missing. This check is performed by default.

ThreadInitBeforeSignalRunningState

How long to wait for the converter factory threads to initialize and be ready to process documents.

MaxWaitForProcessingTimeoutInMinutes

The maximum amount of time, in minutes, to wait for a document to signal that it is being converted. The minimum timeout is 5 minutes, the default is 30 minutes.

SessionWaitForAllJobsCompletedTimeout

The maximum amount of time to wait for all documents to finish printing when shutting Document Conversion Service down.

WaitForSrv10ToClose

The Document Conversion Service uses the PNSrv10 component and cannot close until that component has exited first. The default amount of time to wait is 60 seconds, this component normally exits in  just over 30 seconds.

RestartServiceInHours

When set to the default value of 0, the Document Conversion Service is never restarted. If desired, the service can be set to be automatically restarted anywhere from every hour up to every seven days (168 hours).

 

These variables control the maximum amount of time to wait on the open and close calls to the converter to ensure the conversion threads are not blocked by the underlying application. These values are entered in microseconds (1 second = 1000 microseconds). If not specified the default value is 60000ms, and can be no smaller than 20000ms. Any marked with (*) can be overridden by the converter factory if needed (see Converter Factory Settings).

Setting Name

Value

DocumentOpenTimeout*

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

DocumentConvert*

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.

 

The following variables control the behavior of the Document Conversion Service printer pool such as how long to wait for a printer to become available. Any marked with (*) can be overridden by the converter factory if needed (see Converter Factory Settings).

Setting Name

Value

PrintSessionWaitTimeout*

How long the converter will wait to get access to a printing session. This value is entered in microseconds (1 second = 1000 microseconds).

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 before releasing the printing session back into the printer pool. This value is entered in microseconds (1 second = 1000 microseconds).

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.This value is entered in microseconds (1 second = 1000 microseconds).

PrintSessionWaitOnSpoolingTimeout*

How long the converter will wait for each job to start spooling in the printer queue. This value is entered in microseconds (1 second = 1000 microseconds).

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.

SessionWaitForAllJobsCompletedTimeout

The maximum amount of time to wait for all documents to finish printing when shutting Document Conversion Service down. This value is entered in microseconds (1 second = 1000 microseconds).

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.

MaxSpooledPagesAllowed*

Sets the maximum number of pages that are allowed to be printed/spooled. The default 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.

 

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 settings can be overridden by the individual settings for the converters in their <PluginFactory> section if needed.