====================================================================== Microsoft(R) Product Support Services Application Note (Text File) GW0648: MICROSOFT MAIL SMTPGATE.EXE VERSION 3.0.7 UPDATE ====================================================================== Revision Date: 6/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) 1993-1994 Microsoft Corporation. All Rights Reserved. | | Microsoft and MS-DOS are registered trademarks and Windows is a | | trademark of Microsoft Corporation. | | FTP Software and PC/TCP are registered trademarks of FTP | | Software, Inc. | | IBM is a registered trademark of International Business Machines | | Corporation. | | Excelan, Exos, LAN Workplace, and Novell are registered trademarks | | of Novell, Inc. | |---------------------------------------------------------------------| Introduction ------------ Version 3.0.7 of the Microsoft Mail Gateway to SMTP requires a dedicated 80286, 80386, or 80486 IBM(R)-compatible computer as well as version 3.04.1 or later of the SMTPPUT.EXE file, which is available in Application Note GW0649. To determine your version of SMTPPUT, run it from the MS-DOS prompt with the -VER option. The disk provided with this Application Note contains SMTPFTP.EXE, SMTPLMN.EXE, SMTPNVL.EXE, SMTPXLN.EXE, and SMTPWIN.EXE, which replace the SMTPGATE.EXE file that is included with version 3.0 of the Microsoft Mail Gateway to SMTP. These replacement files correct the following problems: - The gateway does not generate greetings (HELO) that include the gateway computer host name. This problem occurs when you communicate with an IBM VM host running IBM VM SMTP V2R2. (This problem was originally corrected in the SMTPGATE.EXE 3.0.2 update.) - The gateway closes the connection after an Extended HELO (EHLO) message is received from another SMTP host as explained in RFC 1425, SMTP Service Extensions. There may still be a problem if the host sends an RSET after you refuse the EHLO message, which is recommended in RFC 1425, but is not consistent with RFC 821. (This problem was originally corrected in the SMTPGATE.EXE 3.0.2 update.) - The recipient field is constructed incorrectly whenever the friendly name information is included directly in the address of the recipient. As a result, the address is in the form: <@ ()> However, per RFC 822, the comment should not be included within the angle brackets. (This problem was originally corrected in the SMTPGATE.EXE 3.0.5 update.) - When the gateway strips non-SMTP gateway addresses from the message header, a false end-of-header marker is created in the RFC 822 portion of the message. This causes the date and subject fields, as well as the remaining recipients, to appear in the body of the message. (This problem was originally corrected in the SMTPGATE.EXE 3.0.7 update.) NOTE: Only the updates for the PC/TCP(R) Kernel from FTP Software(R), Inc., and Microsoft LAN Manager for MS-DOS are included with this Application Note. - The gateway does not allow the default character set translations to be overridden. If the two files SMTPIN.TBL and SMTPOUT.TBL exist, the gateway can do character translation for one of the following character sets instead of for the US-ASCII character set, which is used when these files do not exist: Swedish/Finnish, Norwegian/Danish, German, Latin Alphabet 1, and Code Page 850. (This problem was originally corrected in the SMTPGATE.EXE 3.0.6 update.) Updating Your SMTPGATE.EXE File ------------------------------- To update your SMTPGATE.EXE file, do the following: 1. Insert the enclosed GW0648 disk in your floppy disk drive. 2. Decide which SMTP executable file matches your configuration: Executable file | Vendor TCP/IP software --------------------------------------------------------------------- SMTPLMN.EXE | Microsoft LAN Manager for MS-DOS SMTPFTP.EXE | PC/TCP Kernel from FTP Software, Inc. SMTPNVL.EXE* | Novell(R) LAN Workplace(R) for MS-DOS (version 4.0) SMTPWIN.EXE* | Any network adapter card supported by the WIN/TCP | for MS-DOS RunTime (version 4.1) from The Wollongong | Group, Inc. with the RunTime installed SMTPXLN.EXE* | Excelan(R) Exos(R) 205T Intelligent Ethernet | Controller *NOTE: This Application Note only contains the version 3.0.7 update for the SMTPLMN.EXE and SMTPFTP.EXE files. All other executable files listed above are version 3.0.6. Please contact Microsoft Product Support Services if you need an updated SMTPNVL.EXE, SMTPWIN.EXE, or SMTPXLN.EXE file. 3. At the MS-DOS command prompt, type the following and press ENTER copy :\.exe \smtpgate.exe where is the floppy disk drive containing the GW0648 disk, is the drive and directory where your SMTPGATE.EXE file currently resides, and is the corresponding executable for your TCP/IP software vendor. For example, if SMTPGATE.EXE is located in the MAILEXE directory on drive C, the GW0648 disk is in drive A, and you are using Microsoft TCP/IP for LAN Manager, type the following command and press ENTER: copy a:\smtplmn.exe c:\mailexe\smtpgate.exe A message will be displayed stating: 1 file(s) copied. This indicates that your SMTPGATE.EXE file has been successfully replaced. NOTE: The SMTPGATE.EXE file typically resides on the postoffice server in the Mail executables directory as well as on the machine where the gateway is running. Make sure that SMTPGATE.EXE, SMTPGET.EXE, and SMTPPUT.EXE are all located in the same subdirectory where the gateway is launched from and that all copies are updated appropriately. Setting Up Character Translation for Non-US-ASCII Character Set ---------------------------------------------------------------- To set up character translation for a non-US-ASCII character set, do the following: 1. Insert the enclosed GW0648 disk in your floppy disk drive. 2. Decide which character set is desired. The following is a list of the character sets, associated filenames, and references that are located on the disk provided with this Application NOTE: Character set | Inbound | Outbound | Reference ---------------------------------------------------------------------- US-ASCII | Built in | Built in | ANSI X3.4 Swedish/Finnish | SWEDISHI.TBL | SWEDISHO.TBL| SIS 63 61 27 version 2 | | | (ISO-646-SE2) ---------------------------------------------------------------------- Norwegian/Danish | NORWEGI.TBL | NORWEGO.TBL | NS 455 version 1 | | | (ISO-646-NO) ---------------------------------------------------------------------- German | GERMANI.TBL | GERMANO.TBL | DIN 66003 | | | (ISO-646-DE) ---------------------------------------------------------------------- Latin Alphabet 1 | LATIN1I.TBL | LATIN1O.TBL | ISO 8859-1 ---------------------------------------------------------------------- Code Page 850 | Built-in | CP850O.TBL | IBM | default | | NOTE: If SMTPGATE.EXE does not find the SMTPIN.TBL and SMTPOUT.TBL files, the built-in default tables are used. 3. At the MS-DOS command prompt, type the following and press ENTER copy :\ \smtp\smtpin.tbl copy :\ \smtp\smtpout.tbl where is the floppy disk drive containing the GW0648 disk, is the drive and directory where your Microsoft Mail postoffice data files currently reside, and and are the corresponding inbound and outbound character table files. For example, if your Microsoft Mail postoffice is located in the root of drive M, the GW0648 disk is in drive A, and you are using the German translation table, type the following commands and press ENTER after each command: copy a:\germani.tbl m:\smtp\smtpin.tbl copy a:\germano.tbl m:\smtp\smtpout.tbl For each COPY command, a message will be displayed stating: 1 file(s) copied. This indicates that the translation files have been successfully installed. Make sure you have updated the SMTPGATE.EXE file to version 3.0.7; otherwise, the character translation won't take place. Translation Details -------------------- Inbound messages have the subject and text body translated based on the SMTPIN.TBL file. Friendly names are not translated. Outbound messages have the subject and text body translated based on the SMTPOUT.TBL file. Friendly names are translated based on an internal table that maps extended characters to a 7-bit equivalent. Notes - Only 7-bit characters are supported in a Microsoft Mail address, which consists of the network name, postoffice name, and mailbox ID. - The tables for national 7-bit character sets (Swedish/Finnish, Norwegian/Danish, and German) will convert characters with character codes above 127 according to Latin Alphabet 1 for inbound messages. That is, they will accept national characters (F, V, and so forth) according to both 7-bit and 8-bit standards. Gateway Operation ----------------- Informational messages are displayed on the screen and in the SMTP gateway log file when you use the -CD (debugging), -LACSY (full logging to SMTPGATE.LOG), and/or -GACSY (full logging to the SMTPGATE screen) options when you start up the gateway. If the SMTP translation files are not found, the following messages are displayed: 18:02:40 - Open File failed, No such file or directory 18:02:40 - f:smtp\smtpin.tbl table not loaded, default translation invoked. 18:02:40 - Open File failed, No such file or directory 18:02:40 - f:smtp\smtpout.tbl table not loaded, default translation invoked. If the SMTP translation file(s) are found and can be loaded, the following messages are displayed: 11:19:09 - f:smtp\smtpin.tbl table translation loaded. 11:19:09 - f:smtp\smtpout.tbl table translation loaded. If problems with a translation file are detected, the default translation message and one of the following messages are displayed: 18:02:40 - File header size invalid. 18:02:40 - File translation checksum invalid. 18:02:40 - File translation table size invalid.