Resolutions for Common DocConverter Error Codes
Resolutions for more commonly encountered error codes.
- See the DocConverter API manual for a list of of Doconverter result status codes.
-5 Cannot open the specified file.
The file path is likely invalid.
Make sure the path to the file is valid and accessible.
-11 There was a remote call or multi-threading issue.
- The wrong server IP address or wrong server port address may have been used.
- The server may have a firewall preventing inbound calls over TCP.
- Check the server IP address and port address used in the remote call.
- Ensure that your firewall allows inbound calls over TCP.
-12 The NDN Proxy is not running.
The NDN Proxy service may have crashed or may have been stopped and not restarted. If not running, local and remote will both fail.
Restart all ActivePDF services.
A port number other than 52525 is used with a COM application.
Use Port Number 62625.
-99 File-Specific Conversion Hangs
While converting documents from multiple sources, specific documents hang and do not convert completely. The system attempts to display dialog boxes on the main console which, in some cases, may not be readable.
The APConv.log indicates that the processor application could not be started:
WD23 3924 02/11/2008 11:23:46 Unable to launch application. Error code : -2146959355 ()
NOTE: While the error code -2146959355 is referenced in other articles, they do not apply to this particular situation.
The log file may also display following error message:
SRV 3708 02/08/2008 18:24:57 Process hung (). Killed and restarted. C:\Documents and Settings\Administrator\Desktop\DCInput\TestDoc1.doc moved to C:\Documents and Settings\Administrator\Desktop\DCError\TestDoc1.doc
ActivePDF DocConverter's particular usage of Microsoft® Word does not allow for an interactive interchange with Word during the conversion process. Therefore, DocConverter may hang if Word is requesting a user response or intervention, as evident from the attempted display of dialog boxes.
Word provides additional capabilities for certain files that implement Microsoft online templates, requiring the Microsoft installation discs to be made available during conversion, so the associated .dll/.exe can be loaded. Once the files have been added, Word offers the user the option to make use of the added assistance or resources associated with using Microsoft online templates.
NOTE: While the activation of Intelligent PDF or incorrectly defined signatures may cause similar symptoms, changes to these did not resolve this issue.
In order to resolve the conversion application (i.e., MS Word) issue, the default DocConverter user account needs to first be replaced with a new Local Administrator account. Under this account, you will be able to change the application settings necessary to prevent specific documents from experiencing hangs and/or failed conversions. Perform the following steps to resolve the issue:
To change the default DocConverter Local Administrative account
- Click Start, then Run. Type mscand click OK.
- Right-click ActivePDF DocConverter and select Properties.
- Click Log On and replace the default DocConverter user account with an appropriate Local Administrator account (e.g., ".\Local_Admin") with password.
- Click OK and then exit the Services window.
To resolve the requirements of Word by responding to input requests
- Logon using the newly created Local Administrator account and launch Microsoft Word.
- Respond to all requested actions (e.g., provide requested installation discs).
- Open a file that is causing a hang in conversion to confirm that it can be opened in Word without issue.
- If a dialog box is displayed, perform the necessary action to prevent Word from displaying the dialog during conversion (typically, this means selecting No, Do not ask again, or something similar).
- Close Word and run a DocConverter application to confirm reliable operation. The dialog boxes should no longer display during conversion.
-201 An exception occurred while processing an API request.
This is usually a failure to upload the file to the processing server.
Check permissions that might prevent the successful copying of the file.
-204 System.Security.SecurityException error
A System.Security.SecurityException error was encountered while waiting for the Print to PDF conversion to complete. This error also occurs when the API is unable to create the OutputDirectory.
Enable DebugMode in the DocConverter API by setting dcObj.DebugMode = true. Doing so creates the DocConverterUserObj.log, which contains more information.
-208 Exception error creating the OriginalsDirectory in .NET.
NOTE: To view the error message details, enable DebugMode in the DocConverter instance to create the user object log in c:\\Progamdata\ActivePDF\Logs
- Invalid path in .NET
- Blank or null path in .NET
Ensure that the path to the Originals directory is valid and that it is not blank.
-209 Generic exception, usually in the DocConverter API.
- The wrong IP Address or Port have been provided.
- The server has a firewall.
- Services are not running.
- Authentication issues in .NET (No credentials are used in COM.)
- Ensure that the correct IP Address and Port are provided.
- Change permissions for the firewall.
- Ensure that all services have been started. Restart all ActivePDF services and make sure they are all running.
- Ensure authentication is set up appropriately.
-215 Exception/Error in the API while attempting to move the input file to the errors directory.
This error occurs when a temporary copy of the input file is locked in the converter and cannot be moved by the API.
Call MoveToErrors, specifying a maximun timeout (in seconds) to move the file to the Errors folder. The function waits, then attempts to move the file until successful, or until the maximum timeout is exceeded. To handle the move asynchronously, use BeginMoveToErrors and EndMoveToErrors in the .NET API.
-244 Failed PDF Conversion.
NOTE: This is a general error that handles all failures directly related to the conversion to PDF, not the opening of the PDF.
- Microsoft®Office failed during a call to Export to PDF due to:
- permissions issues
- missing desktop folder
- memory exceptions
- The converter failed to process a Print to PDF conversion due to:
- incorrect settings
- job data not found during print job
Before proceeding, check the DCHOST.LOG for more information about the error.
- If the conversion fails on the same file type again and again, Microsoft® Office may be unable to use the location C:\Windows\System32\config\systemprofile\Desktop because the folder does not exist. Manually create the folder path C:\Windows\System32\config\systemprofile\Desktop, and then retry the conversion.
- Otherwise, review the DCHost for exception data caught during the error -244. Search the Knowledgebase for additional information, depending on the exception found.
-299 General timeout occurred.
Incorrect DCOM settings. This can also be caused by the DocConverter printer not being set as the default printer.
See Setting DCOM Permissions for step by step instructions.
Set the DocConverter printer as the default printer.
-10099 Timeout when attempting a conversion.
This error typically occurs when attempting to convert a large file and there is not enough time alotted for the conversion to complete. Either the timeout value set in the ActivePDF Configuration Manager for Watch Folders is not lengthy enough, or the Status timeout set in the API with the StatusTimeout property has expired.
To increase the timeout in the Configuration Manager
- From the Start menu, select All Programs > ActivePDF> ActivePDF User Interface.
- Click the DocConverter
- Click DocConverter Watch Folders.
- Double-click a watched folder in the list of folders.
- Click Input Agent Settings
- Increase the Timeout.
- Click Save and Close.
To increase the timeout with the API:
Change the value in seconds of the StatusTimeout property.
Syntax: object.StatusTimeout = setValue
-10147 Requested job has failed to find an agent (after submitting a PDF generation request)
The requested job failed to find an available application to perform the operation. This error typically occurs if the ports used by the ActivePDF software are blocked by the system's firewall.
ActivePDF products require that certain assigned ports remain open and available to the software services in order to generate PDF output. On some systems, a firewall can prevent these ports from being accessed and cause requested operations to fail. In order to correct this issue, the firewall should be modified to permit the necessary ports.
NOTE: The process for adding permissions/exceptions may vary if using a firewall other than Windows Firewall.
To change permissions for Windows® Firewall
- Click Start, then select Control Panel. Double-click Windows Firewall.
- Select the Exceptionstab, and then click Add Port.
- Enter the Name and Port number for the port to be allowed through the firewall. The ports to be added will depend on your installed product(s):
- All Products
- 53536 (ActivePDF Agent Service Port)*:Used to receive Agent registration messages (UDP) and status verification messages (TCP).
- 11100 (First Aid Service Port)**:Used by First Aid agent to perform job requests.
- 11101 (First Aid Message Port)**:Used by First Aid to process UDP/TCP communications.
- 54545 (ActivePDF Core Service Port)*:Used for Remote .NET calls to the Core Services (both from API and intra-job processing).
- 58585 (ActivePDF NotDotNet Proxy Port)*:Used for Remote non-.NET calls to the Core Services (from API).
- ActivePDF Server
- 10800 (ActivePDF Server Agent Service Port):Used by the Server Agent to perform job requests (PSToPDF, ImageToPDF, etc…).
- 10801 (ActivePDF Server Agent Message Port):Used by the Server Agent to process UDP/TCP communications.
- ActivePDF WebGrabber (Enterprise/Cluster Editions)
- 11000 (ActivePDF WebGrabber Agent Service Port)**:Used by the WebGrabber Agent to perform job requests (DoPrint, ConvertHTML, etc…).
- 11001 (ActivePDF WebGrabber Agent Message Port)**:Used by the WebGrabber Agent to process UDP/TCP communications.
- ActivePDF DocConverter
- 10900 (ActivePDF DocConverter Agent Service Port)**:Used by the DocConverter Agent to perform job requests (Submit, Hot Folder conversion, etc…).
- 10901 (ActivePDF DocConverter Agent Message Port)**:Used by the DocConverter Agent to process UDP/TCP communications.
- All Products
- Select TCPas the protocol and click OK.
* Denotes ports which, in a clustered environment, only require access on the Cluster Controller machine.
** Denotes ports which, in a clustered environment, only require access on the Node machine(s).
Note: Once you have added the necessary ports, you may need to restart the corresponding Agent Services for the changes to take effect.
-10241 Submit Failed.
If you opted out of installing LibreOffice during a clean DocConverter installation, the Support Tools test of DocConverter will return the following error: "Submit Failed. Return code (-10241)."
The DocConverter Test in Support Tools attempts to convert a text document. On a clean installation of DocConverter, the ".TXT" extension signature is associated with the Default converter. If the ".TXT" signature is associated with Default, and LibreOffice is not installed, the DocConverter Test fails with an error in Support Tools. NOTE: This is an issue because DocConverter is unable to find an appropriate converter to perform the text conversion in Support Tools. However, this does not mean that other conversions in DocConverter are not working properly.
If Microsoft Office is installed on your system, remove ".TXT" from the Default converter signature, then add it to the Word converter signature using the following procedure:
- From the Start Menu, select ActivePDF > ActivePDF User Interface. The Common User Interface opens.
- Click ActivePDF DocConverterin the navigation pane.
- Click DocConverter Signatures.
- Double-click Defaultin the list of signatures. The Default - DocConverter Signature window opens.
- Remove .TXT; from the Signature Data
- Close the Default - DocConverter Signature window.
- Click Yes when prompted to save changes.
- Double-click Word in the list of signatures. The Word - DocConverter Signature window opens.
- Add ;.TXTto the end of the Signature Data
- Close the Word - DocConverter Signature window.
- Click Yes when prompted to save changes.
- Close the Common User Interface window.
- Restart the DocConverter services.
The Support Tools DocConverter Test should run without incident.
This error indicates that the application is busy, most likely this is due to a dialog box being displayed in the application.
Ensure that no system messages or messages from applications (Microsoft Word, Microsoft PowerPoint, etc.) are open.
This error is likely found on a 64-bit server when the DCOM permissions are not set up properly in the 32-bit dcomcnfg.
Use the command "mmc comexp.msc /32" to force dcomcnfg to open in 32-bit mode. Review the DocConverter log files to determine the CLSID of the application that must be configured. Note that the settings may look correct, but all must be changed and saved to correct the issue. Even if the information is already present, enter it again and save. For additional information, see Setting DCOM Permissions.