7.4 Internet Agent Queue Directory

The following directories and files are found under the \domain\wpgate\ structure for the Internet Agent after the software has been installed and the Internet Agent has processed messages.

  • GroupWise Internet Agent home directory
  • Internet Agent message processing directory
  • Not currently used
  • Hold directory for temporary files used during processing
  • Log files
  • Accounting file
  • Settings file for screen colors, log levels, and so on
  • Statistics file for Internet Agent operation
  • Process lock file indicating that the Internet Agent is running
  • Temporary file to verify Internet Agent operation
  • MTA input queue directory
  • Message priority subdirectories
  • MTA output queue
  • System-defined directory
  • Message priority subdirectories
  • Hold directory for damaged outbound messages
  • Message hold directory
  • Delayed delivery hold directory
  • Hold directory for damaged inbound messages
  • Directory for character conversion tables
  • Directory for old configuration files from reinstalls or upgrades
  • Internet Agent configuration file for startup switches
  • Route configuration file to customize routing
  • Host authentication configuration file
  • MIME encoding configuration file for various file types
  • Configuration file pointing ConsoleOne to the gwia.cfg file
  • Foreign domain name configuration file
  • Anti-spam configuration file
  • Access control database
  • Database dictionary file used to create the access control database
  • Message for recipients who lack a MIME-compliant mail reader
  • Preamble message in various languages
  • List of blocked Internet sites
  • File for customizing status messages
  • SMTP service (daemon) home directory
  • Outbound hold directory for converting messages into Internet format
  • Incoming hold directory for converting messages into GroupWise format
  • Send and result files to confirm transmission
  • Hold directory for re-queued and deferred messages
  • Schedule files for SMTP service operations on deferred messages
  • Delivery Status Notification (DSN) hold directory

7.4.1 domain\wpgate\gwia directory

The domain\wpgate\gwia directory is the GroupWise Internet Agent home directory where Internet Agent configuration files and queue directories are located. The name is established when you install the Internet Agent. The default is wpgate\gwia in the domain directory. You can change the location using the /home startup switch in the Internet Agent configuration file (gwia.cfg).

000.prc directory

The Internet Agent uses the 000.prc directory to process messages.

gwwork directory

The gwwork directory stores temporary files created by the Internet Agent as it converts and builds messages for transfer across the Internet.

mmddlog.nnn file

The mmddlog.nnn files hold error and status messages about the functioning of the Internet Agent. The Internet Agent creates a log file each day with a unique name, where mm is the month, dd is the day, and nnn is a sequential number indicating the sequence of log files in a single day. For more information log files, see Using Internet Agent Log Files in Internet Agent in the GroupWise 7 Administration Guide.

acct file

The acct file contains information about the messages the Internet Agent sends each day. It is e-mailed to the accounts each day at midnight. For more information about the accounting files, see Tracking Internet Traffic with Accounting Data in Internet Agent in the GroupWise 7 Administration Guide.

set file

The set file stores Internet Agent console settings such as color, log settings, and so on. For more information, see Using the Internet Agent Server Console.

stat file

The stat file stores statistics about the Internet Agent’s functioning. For information about the statistics provided by the Internet Agent, see Statistics in Internet Agent in the GroupWise 7 Administration Guide.

proc file

The proc file is the lock file for the Internet Agent process. The proc file is opened and locked when the Internet Agent starts. This prevents multiple Internet Agents from being started for the same domain.

pulse.tmp file

The pulse.tmp file is re-created by the Internet Agent every time it completes a cycle (after an idle loop). If you are not at the Internet Agent console but need to know if the Internet Agent is running, you can delete the pulse.tmp file. If the Internet Agent is running, it re-creates the file.

wpcsin directory

For a mapped/UNC link, the Internet Agent places inbound messages in one of the wpcsin priority subdirectories (0-7). Most messages go in the 4 directory, although some administrative and status messages might go in other directories. The Message Transfer Agent retrieves the messages and delivers them to the proper destinations.

For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by transferring message files. For a comparison, see Section 4.0, Message Delivery to and from the Internet.

wpcsout directory

For a mapped/UNC link, the wpcsout directory is the MTA output queue as well as being the Internet Agent input queue.

For a TCP/IP link, the Internet Agent and the MTA communicate by way of TCP/IP rather than by transferring message files. For a comparison, see Section 4.0, Message Delivery to and from the Internet.

gwixxxx directory

The gwixxxx directory is a system-defined directory, where gwi represents the first three letters of the Internet Agent object name as defined during installation and displayed in ConsoleOne, and xxxx is a randomly-generated string. Here, the Message Transfer Agent places outbound messages in the appropriate 0-7 priority subdirectory for the Internet Agent to retrieve and process.

problem directory

The problem directory holds messages that the MTA cannot process.

You should check this directory periodically for problem files, resolve the problem, then place the files back into the appropriate queue for continued processing. For assistance, see Message Is Dropped in the problem Directory in the Domain in Strategies for Message Delivery Problems in the GroupWise 7 Troubleshooting 2: Solutions to Common Problems.

gwhold directory

The gwhold directory holds messages that are scheduled for delayed delivery.

qfiles directory

The qfiles directory holds messages that cannot be sent during the current Send/Receive cycle. The messages are queued to this directory until the next cycle.

The delayed delivery messages waiting in the qfiles directory remain in encrypted format until the Internet Agent transfers them to the send directory for processing by the SMTP service.

gwprob directory

The Internet Agent uses the gwprob directory for messages it cannot process. These are usually messages that have been damaged during transmission or that contain incorrectly formed MIME data.

These messages cannot be recovered. You can delete them to conserve disk space.

gwchars directory

This directory contains conversion tables that the Internet Agent uses to convert message attachments between character sets.

save directory

If you reinstall or upgrade the Internet Agent, your old configuration files are copied to the save directory as a backup. If you reinstall or upgrade repeatedly, the files are overwritten each time.

gwia.cfg file

The gwia.cfg file is the Internet Agent configuration file that contains startup switches. Some switches are set during installation. You can set others as needed. For more information, see Using Internet Agent Startup Switches in Internet Agent in the GroupWise 7 Administration Guide.

NetWare:

The NetWare Internet Agent uses the gwia.cfg file created in sys:\system during installation. The gwia.cfg file under the domain is just a boilerplate file with no switches set during installation.

Linux:

The Linux Internet Agent uses the gwia.cfg file created in /opt/novell/groupwise/agents/share during installation. The gwia.cfg file under the domain is just a boilerplate file with no switches set during installation.

Windows:

Only the Windows Internet Agent actually uses the gwia.cfg file under the domain.

route.cfg file

The route.cfg file enables you to customize routing for specific hosts. For more information, see Using a Route Configuration File in Internet Agent in the GroupWise 7 Administration Guide.

gwauth.cfg file

The gwauth.cfg file enables the Internet Agent to log in to SMTP hosts that require authentication. For more information, see SMTP Host Authentication in Internet Agent in the GroupWise 7 Administration Guide.

mimetype.cfg file

The mimetype.cfg file enables you to customize MIME content-type mappings for various attachment types. For more information, see Customizing MIME Content-Type Mappings in Internet Agent in the GroupWise 7 Administration Guide

exepath.cfg file

The exepath.cfg file is used by ConsoleOne to locate the gwia.cfg file. This enables ConsoleOne to write any configuration setting changes to the gwia.cfg file or update Novell® eDirectory™ with any changes from the file. The file must contain the path to the gwia.cfg file in the sys:\system directory on NetWare, the /opt/novell/groupwise/agents/share directory on Linux, or the domain\wpgate\gwia directory on Windows.

frgnames.cfg file

The frgnames.cfg file lets you list more Internet domain names than can fit in the Foreign ID field on the Identification page of the Internet Agent object in ConsoleOne. For more information, see Configuring How the Internet Agent Handles E-Mail Addresses in Internet Agent in the GroupWise 7 Administration Guide.

xspam.cfg file

The xspam.cfg file lists “X” header fields that your anti-spam service writes to the MIME header, along with the values that flag the message as spam. The Internet Agent examines the MIME header for any field listed in the xspam.cfg file. When a match occurs, the message is marked for handling by the GroupWise client Junk Mail Handling feature. For more information, see Customized Spam Identification in Internet Agent in the GroupWise 7 Administration Guide.

gwac.db file

The gwac.db file is the access control database that stores information about the classes of service you have created. For more information, see Maintaining the Access Control Database in Internet Agent in the GroupWise 7 Administration Guide.

gwac.dc file

The gwac.dc file is the data dictionary file from which the gwac.db is created.

preamble.txt file

The preamble.txt file is an ASCII text file that is automatically included with any MIME multipart message and is displayed when the message recipient lacks a MIME-compliant mail reader. For more information, see Customizing MIME Preamble Text in Internet Agent in the GroupWise 7 Administration Guide.

preamble.all file

The preamble.all file contains the preamble text in multiple languages. For more information, see Customizing MIME Preamble Text in Internet Agent in the GroupWise 7 Administration Guide.

blocked.txt file

The blocked.txt file contains a list of Internet sites that you have added to the Prevent Messages From list for your default class of service in ConsoleOne. For more information, see Controlling User Access to the Internet in Internet Agent in the GroupWise 7 Administration Guide.

statusxx.xml file

The statusxx.xml file enables you to customize the messages that users receive regarding message delivery status. For more information, see Customizing Delivery Status Notifications in Internet Agent in the GroupWise 7 Administration Guide.

7.4.2 gwia directory

The gwia directory is the SMTP service (daemon) home directory where messages are converted between GroupWise format and Internet format. On NetWare and Linux, the default location is wpgate/gwia, the same as the Internet Agent home directory. On Windows, the default location is the Internet Agent installation directory. You can change the location using the /dhome startup switch in the Internet Agent configuration file (gwia.cfg).

send directory

The Internet Agent SMTP service places outbound messages in the send directory after they have been converted out of GroupWise format into SMTP format. The SMTP service polls the send directory and sends any messages to the destination SMTP host.

receive directory

The Internet Agent SMTP service places inbound messages in the receive directory, converts them into GroupWise format, and then passes them to the Message Transfer Agent by placing them in the wpcsin directory.

result directory

When the Internet Agent SMTP service processes the message, it builds a file, r*.*, in the result directory that contains several lines of comments and SMTP reply codes, which might indicate possible errors or confirm correct transmission. After the Internet Agent SMTP service has completed the transmission with the destination host, it moves another file, s*.* from the send directory to the result directory. The filenames for both files are identical, except for the first letter, which is either “s” or “r”. The s*.* file is the converted message file. The SMTP service looks at the “s” and “r” files in the result directory and compares the conversation. If the r*.* file contains the correct (250 OK) SMTP reply codes, the SMTP service deletes the file and sends a transferred status message to the user’s Sent Items folder in the GroupWise client.

defer directory

The defer directory holds messages that are deferred and re-queued according to the Retry Schedule. If the Internet Agent SMTP service receives a temporary error, such as Host Down, it places the message in the defer directory for a specified time, then transfers the file to the send directory for another attempt at sending to the Internet. For more information, see Configuring Basic SMTP/MIME Settings in Internet Agent in the GroupWise 7 Administration Guide.

dsnhold directory

The dsnhold directory stores header information for inbound messages that request delivery status notifications. For more information, see Using Extended SMTP (ESMTP) Options in Internet Agent in the GroupWise 7 Administration Guide.