The Post Office Directory Structure

The information store is entirely contained in the post office directory and its subdirectories. If you have more than one post office, your information store spans post offices, with each local store containing items particular to the users belonging to that post office. Figure 4.1 shows a post office directory.

Figure 4.1. The post office directory structure as viewed through Windows Explorer

There are four types of directories relevant to the discussion of the GroupWise information store:

• Input and output queues

• The OFUSER and OFMSG directories

• The OFFILES directories

• The GWDMS (GroupWise Document Management System) directory structure

These are discussed in the sections that follow.

How Input and Output Queues Are Used

There are three queue directory structures in a GroupWise post office: WPCSIN, WPCSOUT, and OFWORK. These queues store message files that are coming into the post office from another location, or that are outbound to another location.

The WPCSIN Directory

The WPCSIN directory, whether you see it at the post office level or under a domain directory, always does the same thing. It is the input queue for a GroupWise MTA (see Figure 4.2).

Figure 4.2. The WPCSIN directory under a GroupWise post office

The 07 directories under WPCSIN hold message transport files that need to be transferred to another location (domain, post office, or gateway). This means all the files here are outbound messages, from the perspective of the post office.

Note

The naming convention is a holdover from the old WordPerfect Office days. This directory name is really an abbreviation for WordPerfect Connection Server INput.

Tip

The queue directories were named from the perspective of the MTA. So no matter at which level you see the WPCSIN or WPCSOUT directories, think of their functions from the perspective of the MTA. Hence, the WPCSIN directory at the post office level is the MTA's input queue, and the WPCSOUT directory is the MTA's output directory.

Aside from the 07 queues, you will see a PROBLEM directory. This directory contains files that could not be processed for some reason, with the exception of files that could not be processed because a link was down. These files go into a holding queue elsewhere.

Following is an explanation of the subdirectories of WPCSIN. Each of these numbered directories serves a different purpose:

0:	Live, interactive request messages (busy searches, remote library queries, and agent restart)
1:	GroupWise remote mode (mailbox synchronization requests, shared folder and shared address book replication messages)
2:	Administration updates and high-priority mail messages
3:	Status messages from high-priority mail
4:	Normal-priority mail messages
5:	Status messages from normal-priority mail, low-priority administrative request
6:	Low-priority mail messages, low-priority administrative request
7:	Status messages from low-priority mail

You will find these directories in many places on the GroupWise system. Everywhere you find them, the queue assignments for each directory remain the same.

The WPCSOUT Directory

The meaning behind the name of the WPCSOUT directory is WordPerfect Connection Server OUTput. This directory, as shown in Figure 4.3, contains things that the MTA (long, long ago known as the connection server) has transmitted to the post office. This directory contains messages that are inbound for the post office.

Figure 4.3. The WPCSOUT directory under a GroupWise post office

There are four subdirectories in the WPCSOUT directory: ADS, CHK, OFS, and PROBLEM. The ADS and OFS directories contain the familiar 0-7 queues. The CHK directory is new with GroupWise version 6 and later. It has only directories 03 and the DEFER directory. Following is a short explanation of the messages that are queued to these directories:

• ADS: Administration updates.

• CHK: GWCHECK jobs sent to the POA (Post Office Agent).

• OFS: Information store updates (user email, notes, tasks, and so on).

• PROBLEM: Where problem messages go.

Remember, though, that these are queues. User email does not exist in the OFS/07 structure for very long. These files are dropped there by the MTA, or by the POA's MTP thread, and then the POA processes these items further.

The OFWORK Directory

The only directory in the OFWORK directory is the OFDIRECT subdirectory. The OFWORK\OFDIRECT directory is used by the GroupWise remote client. Queue directories are created for each remote user, and these directories serve as input and output queues for remote requests, which then move through the WPCSIN\1 or WPCSOUT\OFS\1 directories for processing.

Note

The GroupWise 6.5 and 7 versions use the OFWORK\OFDIRECT directory much less now when the GroupWise client is in remote mode. Updated remote technology (live remote) bypasses this directory most of the time, which facilitates much quicker access for remote users. The only time the OFWORK\OFDIRECT queues are used is when the GroupWise client is using an older batch remote mode to communicate with the post office.

The Function of the OFUSER and OFMSG Directories

The core of the GroupWise information store is found in the OFUSER and OFMSG directories. These directories contain the user and message databases in which all mail items are stored as database records. The section of this chapter titled "The Core of the Messaging System" covers the user and message databases.

The Purpose of the OFFILES Directories

In most GroupWise systems, the majority of the disk space (often up to 80%) that is used by the information store is actually used by attachment files and BLOB files (Binary Large OBjects) in the OFFILES directory structure. The OFFILES directory has up to 255 subdirectories, hexadecimally numbered. Figure 4.4 shows a portion of an OFFILES directory structure.

Figure 4.4. The OFFILES directory structure found under a GroupWise post office

Storing Libraries in the GWDMS Directory Structure

The GWDMS directory and its subdirectories are the home for any GroupWise libraries that have been created under this post office. Figure 4.5 shows one library created under this post office's GWDMS directory.

Figure 4.5. The GWDMS directory structure found under a GroupWise post office

In Figure 4.7, shown later in this chapter, the GWDMS directory structure has been expanded to illustrate the deeper structure. More discussion about the GroupWise Document Management System is found in the section "The GroupWise Document Management System."

Figure 4.7. The library directory name is reflected in the name of each of the files contained therein