====================================================================== Microsoft(R) Product Support Services Application Note (Text File) GW1034: MICROSOFT MAIL SMTPGET.EXE VERSION 3.04.6 UPDATE ====================================================================== Revision Date: 7/94 1 Disk Included The following information applies to Microsoft Mail Gateway to SMTP, version 3.0. ----------------------------------------------------------------------- | INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY | | ACCOMPANY THIS DOCUMENT (collectively referred to as an Application | | Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER | | EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED | | WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR | | PURPOSE. The user assumes the entire risk as to the accuracy and | | the use of this Application Note. This Application Note may be | | copied and distributed subject to the following conditions: 1) All | | text must be copied without modification and all pages must be | | included; 2) If software is included, all files on the disk(s) | | must be copied without modification (the MS-DOS(R) utility | | diskcopy is appropriate for this purpose); 3) All components of | | this Application Note must be distributed together; and 4) This | | Application Note may not be distributed for profit. | | | | Copyright (C) 1994 Microsoft Corporation. All Rights Reserved. | | Microsoft and MS-DOS are registered trademarks and Windows is a | | trademark of Microsoft Corporation. | |---------------------------------------------------------------------| Introduction ------------ The disk provided with this Application Note contains SMTPGET.EXE, a replacement for the SMTPGET.EXE file that is included with version 3.0 of Microsoft Mail Gateway to SMTP. This replacement file corrects the following problems: - SMTPGET incorrectly locks the incoming mail queue, causing the following error to appear in the LOG\SYSTEM.LOG file: Error: [021] Message was not delivered due to missing routing file. You must use the -md option to work around this problem. - SMTPGET 3.0 does not support the mailer disabler (-md) or mailer log (-mm) option. NOTE: You must use the -md option to resolve the file-locking problems with SMTPGET mentioned above. - Messages addressed to *SPECIAL or $SPECIAL can get stuck in the outgoing SMTP queue. These messages are used when address lists are exchanged between Microsoft Mail postoffices. - Seemingly random messages can get stuck in the outgoing SMTP queue because SMTPGET was unable to properly extract the message from the postoffice. To update your SMTPGET.EXE file ------------------------------- 1. Insert the enclosed GW1034 disk in your floppy disk drive. 2. At the MS-DOS command prompt, type the following and press ENTER copy :\smtpget.exe where is the floppy disk drive containing the GW1034 disk and is the drive and directory where your SMTPGET.EXE file currently resides. For example, if SMTPGET.EXE is located in the MAILEXE directory on drive C and the GW1034 disk is in drive A, type the following command: copy a:\smtpget.exe c:\mailexe A message will be displayed stating: 1 file(s) copied. This indicates that your SMTPGET.EXE file has been successfully replaced. NOTE: SMTPGET.EXE is typically installed on the postoffice server in the MAILEXE directory as well as on the computer running the SMTP gateway software. Make sure you update all copies of SMTPGET.EXE. Using the -md and -mm command-line options ------------------------------------------ When you start the SMTPGATE program, append the -md or -mm option to the command line. If you are using the -mr parameter on the gateway, you are not logging mail received from the gateway. To log this information, you need to add the -mr parameter to the command line for the External Mail program. Option Description ---------------------------------------------------------------------- -md Places inbound messages in the postoffice's incoming mail queue, but does not deliver the messages to their destination. When you use this option, you must be running the External Mail program to ensure that recipients receive the mail. -mm Creates a report in the LOG\MAILER.LOG file. You may need to use this report to locate a problem with the gateway. If the file already exists, new data is appended to it. NOTE: When you use the -md option, SMTPGATE offloads some of its normal processing to the External Mail program. You MUST have at least one External Mail process accessing the gateway postoffice or no incoming mail will be received by any user on the local or downstream postoffices. This option also increases the performance of the SMTP gateway by offloading some of its workload to the External Mail program's process(es).