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
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 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.