Post Office Agent Error Messages
201
Action: Check the existence, integrity, and rights of the POA startup file specified in the 
command to start the POA. See “Using POA Startup Switches” in “Post Office 
Agent” in the GroupWise 2012 Administration Guide.
Possible Cause: The POA cannot view its log file.
Action: Check the existence, integrity, and rights of the POA log file. See “Using POA 
Log Files” in “Post Office Agent” in the GroupWise 2012 Administration Guide.
GWPOA: Host refused connection
Source: GroupWise Post Office Agent; message transfer protocol.
Explanation: The POA is configured to communicate with the MTA by way of TCP/IP. The 
server where the MTA is located has refused the POA’s request for a connection.
Action: Check the TCP/IP configuration of the server to which the POA must connect.
GWPOA: HTTP port nn is already in use
Source: GroupWise Post Office Agent.
Explanation: The HTTP port the POA is trying to use for its Web console is already in use by 
another program.
Action: Configure the POA to communicate on a different HTTP port. See “Using the 
POA Web Console” in “Post Office Agent” in the GroupWise 2012 Administration 
Guide.
GWPOA: Internal UDP port is unusable
Source: GroupWise Post Office Agent; TCP agent.
Explanation: The POA is configured for TCP/IP communication but it cannot access the UDP 
port of the server where it is trying to run.
Possible Cause: TCP/IP is not set up correctly on the server where the POA is running.
Action: Make sure TCP/IP is set up correctly.
GWPOA: Listen port already in use
Source: GroupWise Post Office Agent; TCP agent.
Explanation: The POA is configured for TCP/IP communication, but the port it is configured 
to listen on is already in use by another program.
Action: See “8555 Port in use” on page25.
GWPOA: Low disk space for QuickFinder indexing
Source: GroupWise Post Office Agent.
Explanation: The POA requires at least 20 MB of free disk space to perform QuickFinder 
indexing. This warning appears when disk space drops below 30 MB. The POA 
performs QuickFinder indexing as specified by the QuickFinder Update Interval 
setting on the POA Agent Settings page in ConsoleOne or as specified using the 
--qfinterval switch.
Pdf first page thumbnail - SDK Library service:C# PDF Thumbnail Create SDK: Draw thumbnail images for PDF in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
www.rasteredge.com
Pdf first page thumbnail - SDK Library service:VB.NET PDF Thumbnail Create SDK: Draw thumbnail images for PDF in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Support Thumbnail Generation with Various Options for Quick PDF Navigation
www.rasteredge.com
202
GroupWise 2012 Troubleshooting 1: Error Messages
Action: Free up disk space on the server where the POA is running to eliminate the 
warning. See “Managing Database Disk Space” in “Databases in the GroupWise 
2012 Administration Guide.
GWPOA: Machine appears to have TCP/IP incorrectly configured
Source: GroupWise Post Office Agent; TCP agent.
Explanation: The POA is configured for TCP/IP communication but it is unable to determine 
the IP address of the server where it is trying to run.
Possible Cause: TCP/IP is not set up correctly on the server where the POA is running.
Action: Make sure TCP/IP is set up correctly, including assignment of an IP address.
GWPOA: Not enough disk space for QuickFinder indexing
Source: GroupWise Post Office Agent.
Explanation: The POA requires at least 20 MB of free disk space to perform QuickFinder 
indexing. A warning appears when disk space drops below 30 MB. This error 
appears when free disk space drops below 20 MB. The POA performs 
QuickFinder indexing as specified by the QuickFinder Update Interval setting 
on the POA Agent Settings page in ConsoleOne or as specified using the 
--qfinterval switch.
Action: Make sure sufficient free disk space is available on the server where the POA is 
running by the next time the POA needs to perform QuickFinder indexing.
GWPOA: Not enough memory to complete operation
Source: GroupWise Post Office Agent.
Explanation: Not enough memory is available for the POA to function properly.
Possible Cause: If the POA cannot start, you might be trying to run the agent in an environment 
where too few system resources are available. For information about POA 
memory requirements, see “GroupWise System Requirements in “Installing 
GroupWise Agents” in the GroupWise 2012 Installation Guide.
Action: Stop some other programs on the server to free up memory for use by the POA.
Action: Add memory to the server to accommodate the POA along with other existing 
programs.
Action: Select a different server to run the POA on, where adequate resources are 
available.
Possible Cause: If the POA starts successfully, then encounters a memory error later during 
otherwise normal processing, some other program on the server, or another 
agent thread, might have temporarily used a large quantity of memory.
Action: Wait to see if the memory problem resolves itself. The POA will retry its 
operations and should succeed at a later time, when the other program has 
released some memory.
Action: You can reduce the number of POA threads, which reduces the memory 
requirements for the POA. You can make the change in ConsoleOne by reducing 
the Message Handler Threads and/or TCP Handler Threads settings in the POA 
SDK Library service:VB.NET Image: Program for Creating Thumbnail from Documents and
are supposed to read VB.NET Imaging: Get Started first! document and image formats, such as PDF, TIFF, GIF server space, which results in slower web page loading
www.rasteredge.com
SDK Library service:How to C#: Preview Document Content Using XDoc.PowerPoint
Project. RasterEdge XDoc.PowerPoint provide you with APIs to get a thumbnail bitmap of the first page in the PowerPoint document file.
www.rasteredge.com
Post Office Agent Error Messages
203
Agent Settings page. See “Adjusting the Number of POA Threads for Message 
File Processing” and “Adjusting the Number of Connections for Client/Server 
Processing” in “Post Office Agent” in the GroupWise 2012 Administration Guide.
Action: If the POA starts successfully but frequently encounters memory errors during 
later processing, treat the situation as if the POA cannot start and see the 
recommended actions above.
GWPOA: One or more connections to a remote storage area have been lost and 
could not be reestablished
Source: GroupWise Post Office Agent.
Explanation: The POA has lost its connection to the server where a document storage area is 
located.
Possible Cause: The server where the document storage area is located is down.
Action: Wait for the server to come back up. The POA will reconnect automatically when 
the server is available again.
Action: Contact the administrator of that server.
GWPOA: Physical connection table full
Source: GroupWise Post Office Agent; TCP agent.
Explanation: The POA is configured for TCP/IP communication and it has run out of physical 
connections.
Possible Cause: The POA is very busy.
Action: Increase the number of physical connections configured for the POA. See 
Adjusting the Number of Connections for Client/Server Processing” in “Post 
Office Agent” in the GroupWise 2012 Administration Guide. Then exit and restart 
the POA
GWPOA: Possibly damaged blob in database
Source: GroupWise Post Office Agent
Explanation: During indexing, the POA has encountered a BLOB file that it could not process.
Possible Cause: The BLOB file is damaged
Action: Restore the BLOB file from backup.
Action: If the damaged BLOB file cannot be restored, you can delete it to eliminate the 
error.
GWPOA: Possibly dangerous message; temporarily suspending dispatcher
Source: GroupWise Post Office Agent
Explanation: No additional message file processor threads will be started until processing of 
the current message file has completed. The current message file is flagged as 
having caused the POA to shut down in a previous processing attempt.
Possible Cause: The current message file is damaged.
SDK Library service:How to C#: Preview Document Content Using XDoc.Word
Programming Project. RasterEdge XDoc.Word provide you with APIs to get a thumbnail bitmap of the first page in the word document file.
www.rasteredge.com
SDK Library service:C# Word - Render Word to Other Images
String inputFilePath = Program.RootPath + "\\" 1.docx"; DOCXDocument doc = new DOCXDocument(inputFilePath); // Get the first page of Word file.
www.rasteredge.com
204
GroupWise 2012 Troubleshooting 1: Error Messages
Action: If all existing message file processor threads successfully process their message 
files, the POA will resume normal processing. No action is necessary.
Action: If processing of a message file causes the POA to shutdown, do not put message 
files from the 
post_office/wpcsout/problem
directory back into the POA 
input queue. Restart the POA.
GWPOA: Reached inbound connections limit
Source: GroupWise Post Office Agent; message transfer protocol.
Explanation: The POA is configured to communicate with the MTA by way of TCP/IP. The 
POA has reached the maximum number of inbound connections.
Action: None. Connections are automatically released and reopened as processing 
continues.
GWPOA: Running the agent with conflicting effective users
Source: GroupWise Post Office Agent for Linux.
Explanation: You are starting the POA as a user that is different from the user the POA is 
configured to run as. The user specified in the 
uid.conf
file does not match the 
user specified in the 
uid.run
file.
Possible Cause: The user specified in the 
uid.conf
file has been manually edited.
Possible Cause: The 
uid.conf
file has been deleted.
Action: Verify that the 
uid.conf
file specifies the desired user, then delete the 
uid.run
file. For more information, see “Running the Linux GroupWise Agents as a Non-
root User” in “Installing GroupWise Agents” in the GroupWise 2012 Installation 
Guide.
GWPOA: StartServiceCtrlDispatcher failed when attempting to start 
Windows_agent service
Source: GroupWise Post Office Agent for Windows.
Explanation: The Windows POA cannot start its dispatcher thread.
Possible Cause: The Windows server is not functioning properly.
Action: Reboot the Windows server.
GWPOA: The Windows_agent service fails to set service status; service stopped
Source: GroupWise Post Office Agent for Windows.
Explanation: The Windows POA cannot start as a service.
Possible Cause: The Windows POA cannot communicate with the service control manager 
(SCM).
Action: Reboot the Windows server.
SDK Library service:C# powerpoint - Render PowerPoint to Other Images
String inputFilePath = Program.RootPath + "\\" 1.pptx"; PPTXDocument doc = new PPTXDocument(inputFilePath); // Get the first page of PowerPoint file.
www.rasteredge.com
SDK Library service:C# Word - Insert Blank Word Page in C#.NET
page inserting library control toolkit allows developers to specify where they want to insert (blank) Word document page (before the first page or after the
www.rasteredge.com
Post Office Agent Error Messages
205
GWPOA: The Windows_agent service fails to initialize memory system; service 
stopped
Source: GroupWise Post Office Agent for Windows.
Explanation: The Windows POA cannot start as a service.
Possible Cause: The Windows POA has insufficient memory resources.
Action: Reboot the Windows server. 
Action: Run fewer programs on the server. 
GWPOA: Timed out waiting for end-of-file confirmation
Source: GroupWise Post Office Agent; message transfer protocol.
Explanation: The POA is configured to communicate with the MTA by way of TCP/IP. The 
MTA has stopped responding in the middle of a communication.
Possible Cause: The MTA is running on an overburdened server, so it cannot respond to the POA 
in a timely manner.
Action: Add resources to the MTA server so that the MTA can function properly.
Action: Move the MTA to a different server where more resources are available. See 
Moving the MTA to a Different Server” in “Message Transfer Agent” in the 
GroupWise 2012 Administration Guide.
Possible Cause: The server where the MTA is running has gone down.
Action: Check the status of the MTA server. Reboot if necessary.
GWPOA: Transport header build failed
Source: GroupWise Post Office Agent; message transfer protocol.
Explanation: The POA is configured to communicate with the MTA by way of TCP/IP. The 
POA was unable to create a packet of information to send to the MTA.
Possible Cause: Insufficient memory.
Action: See “GWPOA: Not enough memory to complete operation” on page202.
GWPOA: Unable to add additional message handler; maximum reached
Source: GroupWise Post Office Agent.
Explanation: The maximum number of message handler threads for the POA is 32. You 
cannot create any more message handler threads for this POA.
Action: You can run another POA for the post office on the same server if the server has 
sufficient resources.
You can run another POA for the post office on a different server if your network 
can handle the additional traffic. 
See “Configuring a Dedicated Message File Processing POA (Windows Only)” 
in “Post Office Agent” in the GroupWise 2012 Administration Guide.
SDK Library service:C# Raster - Image Save Options in C#.NET
Tiff Edit. Image Thumbnail. Image Save. Advanced Save Options. Save Image. VB.NET How-to, VB.NET PDF, VB.NET Word to icon file, false: just save the first page to
www.rasteredge.com
SDK Library service:C# PowerPoint - Insert Blank PowerPoint Page in C#.NET
page inserting library control toolkit allows developers to specify where they want to insert (blank) PowerPoint document page (before the first page or after
www.rasteredge.com
206
GroupWise 2012 Troubleshooting 1: Error Messages
GWPOA: Unable to change all configuration options
Source: GroupWise Post Office Agent.
Explanation: POA configuration settings have been changed in ConsoleOne, but some cannot 
be put into effect until the POA is restarted.
Action: Exit and restart the POA.
GWPOA: Unable to load viewer
Source: GroupWise Post Office Agent for Windows.
Explanation: The POA cannot run the program used to view agent log files or edit agent 
startup files.
Possible Cause: The viewer program is not available on the current path or is incorrectly 
specified.
Action: The default viewer used by the POA is Notepad, which is typically available. 
You can change the viewer specification by selecting View Log Files in the 
Windows POA server console or Web console and changing the information in 
the Viewer field. Check the viewer and path specified under View Log Files in the 
POA server console or Web console.
GWPOA: Unable to remove document storage area
Source: GroupWise Post Office Agent.
Explanation: The POA cannot delete the document storage area.
Possible Cause: The library database (
dmsh.db
) is damaged, so that the POA cannot read the 
information necessary to delete the storage area.
Action: Repair the library. See “Maintaining Library Databases and Documents in 
Databases” in the GroupWise 2012 Administration Guide.
GWPOA: Unable to start IMAP because SSL is not configured
Source: GroupWise Post Office Agent.
Explanation: The POA cannot start because it is configured to use SSL for its IMAP connection 
and SSL is not correctly configured.
Possible Cause: The SSL certificate or key file is missing
Action: Configure SSL for IMAP See “Supporting IMAP Clients” in “Post Office Agent” 
in the GroupWise 2012 Administration Guide.
GWPOA: Unable to start SOAP because SSL is not configured
Source: GroupWise Post Office Agent.
Explanation: The POA cannot start because it is configured to use SSL for its SOAP connection 
and SSL is not correctly configured.
Possible Cause: The SSL certificate or key file is missing
Action: Configure SSL for SOAP. See “Supporting SOAP Clients” in “Post Office Agent” 
in the GroupWise 2012 Administration Guide.
SDK Library service:C# Image: Quick to Navigate Document in .NET Web Viewer
Navigation Throw Thumbnial Image. The first method recommended can be called from any document page object for formed documents, like Word and PDF, will contain
www.rasteredge.com
SDK Library service:C# Word - Table Cell Processing in C#.NET
Create a Table for document ITable table = doc.CreateTable(3, 3); //Get all rows in table List<ITableRow> rows = table.GetRows(); //Get first row ITableRow row
www.rasteredge.com
11
Message Transfer Agent Error Messages
207
1 1
Message Transfer Agent Error Messages
 “GWMTA: Access denied” on page209
 “GWMTA: Admin database for domain cannot be recovered” on page209
 “GWMTA: Administrator record not found in database” on page209
 “GWMTA: Authentication failure for the above object” on page209
 “GWMTA: Cannot attach to server or volume” on page210
 “GWMTA: Cannot create a new receiver thread” on page210
 “GWMTA: Cannot create/read/write files/directories” on page210
 “GWMTA: Cannot find domain database” on page211
 “GWMTA: Cannot find startup file” on page211
 “GWMTA: Cannot move files” on page211
 “GWMTA: Cannot proceed; insufficient memory available” on page211
 “GWMTA: Cannot read domain database; insufficient memory” on page211
 “GWMTA: Cannot read post office database; insufficient memory” on page212
 “GWMTA: Cannot route message(s); out of memory” on page212
 “GWMTA: Cannot start server; insufficient memory available” on page212
 “GWMTA: Closed for inbound traffic” on page212
 “GWMTA: Command line parameter /home is required” on page212
 “GWMTA: Could not launch the editor” on page213
 “GWMTA: Database language has been updated; please rebuild this database” on page213
 “GWMTA: Disk full; disk logging turned off” on page213
 “GWMTA: Domain database error; circular transfer domain link” on page213
 “GWMTA: Domain database error; transfer domain not found” on page214
 “GWMTA: Domain database open failed” on page214
 “GWMTA: Domain database read error” on page214
 “GWMTA: Domain now closed” on page214
 “GWMTA: Domain open failed” on page214
 “GWMTA: Error initializing HTTP” on page215
 “GWMTA: Error validating post office members” on page215
 “GWMTA: Expired en route to destination” on page215
 “GWMTA: File create error; disk logging turned off” on page215
 “GWMTA: File write error; disk logging turned off” on page216
 “GWMTA: File not found” on page216
 “GWMTA: Gateway now closed” on page216
208
GroupWise 2012 Troubleshooting 1: Error Messages
 “GWMTA: Gateway open failed” on page216
 “GWMTA: Host refused connection” on page216
 “GWMTA: IDomain now closed” on page217
 “GWMTA: Incompatible GWENV1A.DLL; GWMTA cannot continue” on page217
 “GWMTA: Insufficient disk space” on page217
 “GWMTA: Insufficient memory” on page218
 “GWMTA: Insufficient memory to read/process startup file” on page218
 “GWMTA: Insufficient resources to accept inbound connection” on page218
 “GWMTA: Insufficient system resources” on page218
 “GWMTA: Internet mail to address is undeliverable because no default GWIA is configured” on 
page219
 “GWMTA: Invalid /log parameter” on page219
 “GWMTA: Invalid /work parameter” on page219
 “GWMTA: Link or transport down” on page219
 “GWMTA: Logging permanently suspended; insufficient memory” on page220
 “GWMTA: Login not completed; timeout” on page220
 “GWMTA: Login to directory failed” on page220
 “GWMTA: Maximum number of inbound connections reached” on page220
 “GWMTA: No agent record found” on page221
 “GWMTA: No domain record found” on page221
 “GWMTA: No path configured” on page221
 “GWMTA: No post offices found” on page221
 “GWMTA: No response from peer” on page222
 “GWMTA: No sender IDomain; Internet address lookup not attempted” on page222
 “GWMTA: Path to domain database (/home) is invalid or blocked” on page222
 “GWMTA: Post office database open failed; insufficient memory” on page223
 “GWMTA: Post office database read error” on page223
 “GWMTA: Post office now closed” on page223
 “GWMTA: Post office open failed” on page223
 “GWMTA: Received unsupported request; request ignored” on page223
 “GWMTA: Running the agent with conflicting effective users” on page224
 “GWMTA: StartServiceCtrlDispatcher failed when attempting to start Windows_agent service” 
on page224
 “GWMTA: Target queue temporarily locked” on page224
 “GWMTA: The Windows_agent service fails to set service status; service stopped” on page224
 “GWMTA: The Windows_agent service fails to initialize memory system; service stopped” on 
page225
 “GWMTA: Timed out waiting for end-of-file confirmation” on page225
 “GWMTA: Unable to initialize message log database” on page225
 “GWMTA: Unable to open connection; no response” on page225
 “GWMTA: Unable to register with SNMP agent” on page225
Message Transfer Agent Error Messages
209
 “GWMTA: Unable to retrieve TCP/IP address” on page226
 “GWMTA: Undefined link” on page226
 “GWMTA: Unknown connection header received” on page226
 “GWMTA: Unknown destination” on page226
 “GWMTA: Waiting for busy listen socket to become available” on page227
NOTE: This guide does not include a comprehensive list of all possible GroupWise agent error 
messages. It lists error messages for which solutions are readily available from GroupWise engineers 
and testers. You can search the Novell Support Knowledgebase (http://www.novell.com/support) to 
locate additional solutions documented by Novell Support as specific customer issues have been 
resolved.
GWMTA: Access denied
Source: GroupWise Message Transfer Agent; last closure reason.
Explanation: A domain or post office is closed because the MTA cannot access the database 
(
wpdomain.db
or 
wphost.db
) at the location.
Possible Cause: An MTA is already running against the domain database.
Action: Do not try to run more than one MTA for a domain.
GWMTA: Admin database for domain cannot be recovered
Source: GroupWise Message Transfer Agent; admin thread.
Explanation: An attempt to recover the domain database (
wpdomain.db
) has failed.
Possible Cause: The domain database requires repair beyond what can be done while in use.
Action: Rebuild the domain database. See “Rebuilding Domain or Post Office 
Databases” in “Databases” in the GroupWise 2012 Administration Guide.
GWMTA: Administrator record not found in database
Source: GroupWise Message Transfer Agent; admin thread.
Explanation: The MTA admin thread can send a message to an administrator in case of 
database errors. However, no administrator has been designated. 
Possible Cause: No GroupWise administrator has been set up yet.
Action: Set up a GroupWise administrator to receive messages about database errors. 
See “Notifying the Domain Administrator” in “Message Transfer Agent” in the 
GroupWise 2012 Administration Guide.
Action: Use the --noerrormail switch when starting the MTA to turn off administrator 
messages.
GWMTA: Authentication failure for the above object
Source: GroupWise Message Transfer Agent; admin thread.
Explanation: The MTA admin thread attempted to process a record that has the wrong 
authentication key for the current GroupWise system.
210
GroupWise 2012 Troubleshooting 1: Error Messages
Possible Cause: The record did not originate in the current GroupWise system, which is a 
possible security violation.
Action: Someone is trying to tamper with your GroupWise system. Check your system 
security measures.
GWMTA: Cannot attach to server or volume
Source: GroupWise Message Transfer Agent; last closure reason.
Explanation: A domain or post office is closed because the Windows MTA cannot access the 
server or volume where the domain or post office is located.
Possible Cause: The domain or post office is located on a different server from where the MTA is 
running and the MTA has not been configured with user information to enable it 
to log in.
Action: Make sure the MTA startup file includes the /user and /password  switches, so 
the MTA can log into the remote server. Make sure the user and password 
information is correct and current. Make sure the information is formatted 
correctly. In some configurations, you might need to specify a distinguished 
name (for example, user.org_unit.org) for the /user switch, rather than just a 
simply user ID. In some configurations, you might need to include the type (for 
example, .CN=user.org_unit.org).
GWMTA: Cannot create a new receiver thread
Source: GroupWise Message Transfer Agent; message transfer protocol.
Explanation: The MTA cannot create a new receiver thread.
Possible Cause: Insufficient memory.
Action: See “GWMTA: Insufficient memory” on page218.
GWMTA: Cannot create/read/write files/directories
Source: GroupWise Message Transfer Agent; last closure reason.
Explanation: A domain or post office is closed because the MTA cannot write files into its 
output queue in the closed domain or post office.
Possible Cause: The MTA cannot write message files across a mapped or UNC link into the MTA 
input queue in a closed domain (
domain/wpcsin
directory) or a closed post 
office (
post_office/wpcsout
directory) because the directory is inaccessible or 
damaged.
Action: Make sure the input queue directory exists and that the MTA has sufficient 
rights to create files there. If necessary, and if the input queue subdirectories are 
empty, you can rename the original input queue directory and then manually 
recreate it, along with its required subdirectories.
Possible Cause: The server where the closed domain or post office is located does not have 
sufficient disk space for the MTA to create message files.
Action: Free up disk space. 
Possible Cause: The name of the domain directory contains more than 8 characters.
Action: Rename the domain directory. The MTA currently does not support long names. 
Also update the domain directory path in ConsoleOne.
Documents you may be interested
Documents you may be interested