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.

Folder icon domain\wpgate\gwia

Line SpacerGroupWise Internet Agent home directory

Folder icon 000.prc
Folder icon cmd
Folder icon gwwork
File icon mmddlog.nnn
File icon acct
File icon set
File icon stat
File icon proc
File icon pulse.tmp

Line SpacerInternet Agent message processing directory
Line SpacerNot currently used
Line SpacerHold directory for temporary files using during processing
Line SpacerLog files
Line SpacerAccounting file
Line SpacerSettings file for screen colors, log levels, and so on
Line SpacerStatistics file for Internet Agent operation
Line SpacerProcess lock file indicating that the Internet Agent is running
Line SpacerTemporary file to verify Internet Agent operation

Folder icon wpcsin
Folder icon 0-7

Line SpacerMTA input queue directory
Line SpacerMessage priority subdirectories

Folder icon wpcsout
Folder icon gwixxxx
Folder icon 0-7
Folder icon problem

Line SpacerMTA output queue
Line SpacerSystem-defined directory
Line SpacerMessage priority subdirectories
Line SpacerHold directory for damaged outbound messages

Folder icon gwhold
Folder icon qfiles

Line SpacerMessage hold directory
Line SpacerDelayed delivery hold directory

Folder icon gwprob

Line SpacerHold directory for damaged inbound messages

Folder icon gwchars

Line SpacerDirectory for character conversion tables

Folder icon save

Line SpacerDirectory for old configuration files from reinstalls or upgrades

File icon gwia.cfg
File icon route.cfg
File icon gwauth.cfg
File icon mimetype.cfg
File icon exepath.cfg

Line SpacerInternet Agent configuration file for startup switches
Line SpacerRoute configuration file to customize routing
Line SpacerHost authentication configuration file
Line SpacerMIME encoding configuration file for various file types
Line SpacerConfiguration file pointing ConsoleOne to the gwia.cfg file

File icon gwac.db
File icon gwac.dc

Line SpacerAccess control database
Line SpacerDatabase dictionary file used to create the access control database

File icon preamble.txt
File icon preamble.all

Line SpacerMessage for recipients who lack a MIME-compliant mail reader
Line SpacerPreamble message in various languages

File icon blocked.txt
File icon gwia.mib
File icon statusxx.xml

Line SpacerList of blocked Internet sites
Line SpacerInternet Agent Management Information Base (MIB) (NetWare only)
Line SpacerFile for customizing status messages

Folder icon gwia

Line SpacerSMTP service (daemon) home directory

Folder icon send
Folder icon receive
Folder icon result

Line SpacerOutbound hold directory for converting messages into Internet format
Line SpacerIncoming hold directory for converting messages into GroupWise format
Line SpacerSend and result files to confirm transmission

Folder icon defer
Folder icon work

Line SpacerHold directory for re-queued and deferred messages
Line SpacerSchedule files for SMTP service operations on deferred messages

Folder icon dsnhold

Line SpacerDelivery Status Notification (DSN) hold directory

Folder icon help

Line SpacerInternet Agent Web console help file directory


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 6.5 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 "Setting Up Accounting" in "Internet Agent" in the GroupWise 6.5 Administration Guide.


set file

The set file stores Internet Agent console settings such as color, log settings, and so on. For more information, see "Monitoring the Internet Agent through the 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 6.5 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

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.


wpcsout directory

The wpcsout directory is the MTA output queue as well as being the Internet Agent input queue.


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.


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 have the wrong Internet address.


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 6.5 Administration Guide.

Only the Windows Internet Agent actually uses the gwia.cfg file under the domain. The NetWare Internet Agent uses the gwia.cfg file created in sys:\system during installation. The Linux Internet Agent uses the gwia.cfg file created in /opt/novell/groupwise/agents/share during installation. On NetWare and Linux, the gwia.cfg file under the domain is just a boilerplate file with no switches set during installation.


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 6.5 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 "Configuring SMTP Host Authentication" in "Internet Agent" in the GroupWise 6.5 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 6.5 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® eDirectoryTM 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.


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 6.5 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 6.5 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 6.5 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" in "Internet Agent" in the GroupWise 6.5 Administration Guide.


gwia.mib file (NetWare only)

The gwia.mib file contains all the Trap, Set, and Get variables used for communication between the Internet Agent and SNMP management consoles. For setup instructions, see "Monitoring the Internet Agent through an SNMP Management Console " in "Internet Agent" in the GroupWise 6.5 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 6.5 Administration Guide.


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 6.5 Administration Guide.


dsnhold directory

The DSN hold 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 6.5 Administration Guide.


help directory

The help directory holds the help files that you can view from the Internet Agent Web console. See "Monitoring the Internet Agent through the Web Console" in "Internet Agent" in the GroupWise 6.5 Administration Guide.