FFAPI: COURPUT 201: Failure Submitting Message...

RESOLUTION

Network File Contention

SNADPUT.EXE or OSNADPUT.EXE must access certain files to create a message on a postoffice. Gateways that service postoffices that receive high volumes of message transfers and are serviced by the External program should consider using the mailer disabler (-md) parameter on the External command line or in the EXTERNAL.INI file.

The files accessed by SNADPUT.EXE or OSNADPUT.EXE with the -md option are: ACCESS.GLB, ACCESS2.GLB, MASTER.GLB, C850SORT.GLB, GROUP.GLB, NETWORK.GLB, CONTROL.GLB, INQUEUE3.KEY, and INQUEUE3.MBG.

The 201 error has been reproduced by locking the INQUEUE3.MBG file, and this may be the most common cause of the error. These files may be locked by other processes temporarily while in use. Postoffices located on Novell NetWare servers that operate under high traffic conditions should set the postoffice as shareable with few exceptions.

There are certain conditions that dictate that the CONTROL.GLB, TID.GLB, FLAG.GLB, and MASTER.GLB should only be accessed by one process at a time; thus, it should not be shareable.

For additional information, please see the following article in the Microsoft Knowledge Base: More information can also be found in the versions 3.2 and 3.5 Microsoft Mail for PC Networks "Administrator's Guide," page 25.

This problem can be compounded if the other External or Gateway is operating on a slow machine or over a slow link. The External option CompatV20 (-v20) will add additional file locking functionality. As a result, it increases the amount of network overhead and possibly causes additional network file contention. Additional network file contention can be created by improperly running the External program from a network drive (page 233 of the "Administrator's Guide").

Insufficient Disk Space

Insufficient disk space on the postoffice database will prevent the client from enlarging or creating postoffice files. Novell NetWare file servers can produce an insufficient disk space response to the program when the files have become ownerless or the purge file has used all available disk space.

Postoffice Directory Structure

The postoffice directory structure should consist of an initial 19 main subdirectories.

For additional information, please see the following article in the Microsoft Knowledge Base:

Insufficient Access Rights

The gateway components should be given full network access rights for the postoffice.

For additional information, please see the following article in the Microsoft Knowledge Base: More information can also be found in the versions 3.2 and 3.5 Microsoft Mail for PC Networks "Administrator's Guide."

Insufficient File Handles

Increase the number of file handles to 50 in the CONFIG.SYS file of the MS-DOS workstation running the gateway.

Network Problems

The SNADPUT.EXE or OSNADPUT.EXE program utilizes the network to effectively perform the file commands that create and manipulate each file. Network problems that interfere with the operation of these commands can cause the above error to occur.

Microsoft Mail File Format (MMFF) file problems

Ensure that the MMFF file submitted by the gateway follows either the Basic or Extended Message Format for the SNADPUT.EXE or OSNADPUT.EXE program to properly convert (definition beginning on page 50 in the FFAPI SDK).