FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 1 README.DOC for FLASH-Gate(TM) - June 12, 1993 =============================================== Copyright (C) 1993 by Frango KB. All rights reserved. Trademarks and acknowledgments: LANtastic is a registered trademark of Artisoft Inc. Futurus TEAM is a trademark of Futurus Corporation. MHS was originally developed by Action Technologies. cc:Mail is a trademark of cc:Mail, Inc., a wholly-owned subsidiary of Lotus Development Corporation. WP Office is a trademark of Word Perfect Corporation. FLASH-Gate is a trademark of Frango KB. NICK Systems 9005 Exposition Blvd Los Angeles, CA 90034 U.S.A. Phone: (310)841-2901 Fax: (310)785-1050 MHS: SALES@COLORSHP or TECH@COLORSHP via NHUB or direct (310)841-2074 LICENSES, WARRANTIES AND DISCLAIMERS ==================================== I. The trial version of FLASH-Gate(TM) may be distributed via electronic mail or electronic BBS's and information services as long as the contents of this archive have not been modified. The trial version of the software may be included with other packages or publications only with the permission of Frango. II. The registered version of FLASH-Gate(TM) may not be redistributed, and the normal rules of commercial copyrighted software apply. III. NO WARRANTY. ANY USE BY YOU OF THE SOFTWARE IS AT YOUR OWN RISK. THE SOFTWARE IS PROVIDED FOR USE AS IS WITHOUT WARRANTY OF ANY KIND. FRANGO AND NICK SYSTEMS DISCLAIM ALL WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. FLASH-Gate(TM) Trial Version ============================ The trial version works exactly the same way as the retail package, except that the trail program will expire when the trial period is over. You can the acquire a retail package from NICK Systems and install it without loosing your existing data. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 2 INTRODUCTION FLASH-Gate(TM) is an MHS Gateway that connects LANtastic(R) Mail to MHS. It allows you to send messages between LANtastic(R) Mail programs (like LANtastic's Mail and rMail) and MHS E-mail programs (like Futurus TEAM(TM)). The gateway also lets you connect LANtastic(R) Mail servers for message interchange with each other using MHS. It also opens up the possibility to communicate with other platforms (cc:Mail, WP Office etc.) from LANtastic(R) Mail using the proper MHS gateways. ==> Features * Send message from MHS to LANtastic(R) Mail. * Send message from LANtastic(R) Mail to MHS. * Send message from LANtastic(R) Mail to other LANtastic(R) Mail server/location (remote or local) via MHS. * Supports sending of binary files from LANtastic(R) Mail to MHS as MHS attachments. * MHS messages with file attachments sent to LANtastic(R) will be broken up to several LANtastic(R) Mail messages, one for the MHS body part, and one for each MHS attachment. * MHS to LANtastic(R) Mail addressing is done via a standard MHS address with an extended part. * LANtastic(R) Mail to MHS addressing is done either via an address translation table, or the MHS address can be taken from the first line of the LANtastic(R) message. * The LANtastic(R) address (to MHS) shortname/alias can be selected from the LANtastic(R) user list. The shortname/alias in the translation table can be a group and consist of any number and type of MHS addresses. ==> System requirements FLASH-Gate(TM) requires MHS 1.5 and LANtastic(R) 3.X or later. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 3 ADDRESSING AND CONVERSIONS Parts of the following chapter are a bit technical in nature, and are more for your reference. The important parts must be read and understood are the sections "Addressing a LANtastic(R) Mail user in MHS" and "Addressing an MHS user in LANtastic(R) Mail". Before you continue reading, make sure you know how to address messages in LANtastic(R) Mail and MHS. The following chapter requires basic knowledge of MHS and LANtastic(R) Mail. ==> Sending E-mail from MHS to LANtastic(R) Mail => Addressing a LANtastic(R) Mail user in MHS The addressing of a LANtastic(R) Mail user is done via the MHS extended address part. The address is of the type: LANTMAIL @HOST {LANtastic: S=SERVER; U=USER;} Where: * "LANTMAIL" is the name of the MHS gateway that you selected during installation. (Default name is LANTMAIL). * "HOST" is the name of your MHS host/workgroup. * "SERVER" is the name of the LANtastic(R) server that the user resides on. * "USER" is the LANtastic(R) username. A typical address might look like: LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;} How you enter an address depends on your MHS E-mail package. Please consult your E-mail documentation on how to do this. => Invalid address(es) If the LANtastic(R) Mail address in the MHS message was invalid, the sender of the MHS message will get a non-delivery report stating the problem. However, the sender is responsible that the LANtastic(R) username is correct, just as when sending a message from LANtastic(R) Mail. => Conversions MHS =>> LANtastic(R) Mail All visible MHS headers (like To, From, Date, Subject, etc.) will be copied to the LANtastic(R) message together with the MHS message body. The MHS "Subject:" header will also be truncated to 47 characters and put in the LANtastic(R) Mail "Comment" field. MHS Messages with attachments will be split up into several LANtastic(R) Mail messages. The MHS headers and body will be copied to the first LANtastic(R) message, then there will be one additional LANtastic(R) message for each MHS attachment. The LANtastic(R) messages that are converted from MHS attachments will have the Voice mail flag set to FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 4 distinguish them from text files. ==> Sending E-mail from LANtastic(R) Mail to MHS => Addressing an MHS user in LANtastic(R) Mail Since there is no way of entering a more complicated address in LANtastic(R) Mail, addresses must be translated via a translation table. This translation table contains shortnames/aliases (following LANtastic(R) username conventions) and their corresponding full MHS addresses. The translation table file is named "LANTMAIL.TAB" and is located in the %MAIL%\GATES\LANTMAIL\PUBLIC (or %MV%\MHS\MAIL\GATES\LANTMAIL\PUBLIC) subdirectory. For example if you have installed MHS on the drive "F:" and kept the default FLASH-Gate(TM) gateway name "LANTMAIL", the full path of the file is: "F:\MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB" The translation table (LANTMAIL.TAB) is a standard ASCII file and consists of one line for every alias/address entry. Each line/entry has the following format: ALIAS,TYPE,MHS ADDRESS Where: * "ALIAS" is the alias/shortname to be used when sending a LANtastic(R) message. It follows the LANtastic(R) username conventions (max 16 characters), and can be picked from the LANtastic(R) user list if it has been entered as a username in NET_MGR. But the alias does not necessarily have to be entered as a LANtastic(R) username as long as it is defined in LANTMAIL.TAB. The alias must start with the characters "MHS:". * "TYPE" is the address type. 'N' stands for "normal" addresses, meaning the MHS address(es) will be picked from "MHS ADDRESS". 'O' means it is a one-off address, and the MHS address(es) will be picked up from the first line(s) of the LANtastic(R) message. * "MHS ADDRESS" is the MHS address(es) that should be used in the message instead of the alias. This can be just one address or a group with any number of addresses, as long as the total line length is less than 512 characters. Example "LANTMAIL.TAB": ****************************************************************** MHS:ONE-OFF,O,The address field is not used for ONE-OFF MHS:FRANGO-CJ,N,CJ @FRANGO MHS:FRANGO-MIKE,N,LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;} MHS:SALESGROUP,N,CJ @FRANGO, SALES @NICK, SALES @COLORSHP ****************************************************************** For example, if you pick/type the address "MHS:FRANGO-CJ" in the "Enter User to Receive Mail" field when sending a LANtastic(R) message, the gateway will convert it to the corresponding MHS address, "CJ@FRANGO". If you instead would want the address(es) to be picked from the message FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 5 itself (for example if the destination user hasn't been entered in the translation table), enter the address(es) as the first line(s) of the LANtastic(R) message. This address follows the MHS standard address format. Addresses are separated with commas (",") and can be split up on several lines by having the continuation lines begin with a space or a tab. Example LANtastic(R) message with "ONE-OFF address: ****************************************************************** CJ @FRANGO, SALES @NICK, TECH @NICK This is the first line of the LANtastic message itself. Here comes the second line... ****************************************************************** By selecting/typing "MHS:ONE-OFF" in the "Enter User to Receive Mail" field when sending this LANtastic(R) message, the message will be delivered to the three recipients "CJ@FRANGO", "SALES@NICK" and "TECH@NICK". => Invalid address(es) If the "ALIAS" you selected is not defined in the translation table, the message will remain in your "OUTgoing Mail" box and never be picked up. When the message disappears from your "OUTgoing Mail" box, you know that the message has been sent off by FLASH-Gate(TM). To be sure that your messages are successfully sent, check your "OUTgoing Mail" box periodically. => Conversions LANtastic(R) Mail =>> MHS The MHS headers are constructed from the LANtastic(R) message in the following way: MHS header Construction ------ ------------ To: will be taken from the "MHS ADDRESS" in the translation table or from the first line(s) of the message if it is a "one-off" address. From: will be constructed as your MHS address. The recipient can just reply to your message using this address and the reply will be delivered to you. Example generated "From:" address: LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;} Date: will be taken from the date/time the LANtastic(R) message was sent. Subject: will be copied from the LANtastic(R) message's "Comment" field. => Sending LANtastic(R) Mail binary or voice files FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 6 If the LANtastic(R) message you are sending is a binary file, you should select "Send Voice file". This will tell the gateway to convert the LANtastic(R) message body to an MHS attachment. If you send your binary files as text files instead of voice files, the recipient will receive a garbage message. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 7 INSTALLATION Now that you know how FLASH-Gate(TM) works, it is time to install it. Follow the steps below to complete the installation. ==> Gateway installation Take your MHS server off-line (stop the MHS program). Go the MHS server/host. (You must have a working MHS installation before you can install FLASH-Gate(TM)). Make sure the currently logged-in user has write/create directory rights/privileges to the MHS directory. The MHS server/host login must also have SuperMail (M) privilege on all the LANtastic(R) servers that it will pick up/deliver mail to/from. (Set SuperMail privilege by starting NET_MGR, select "Individual Account Management", select the MHS user/login name, move to the "Privileges" field and press "M".) Insert the FLASH-Gate(TM) diskette in the diskette drive. Type: "A:INSTALL" (or "B:INSTALL") and press ENTER Follow the onscreen instructions. When the installation is complete, you have installed the FLASH-Gate(TM) MHS gateway. ==> Address translation table LANTMAIL.TAB As explained in the previous chapters, you must enter addresses in the translation table LANTMAIL.TAB before you can send any messages to/via MHS from LANtastic(R) Mail. You can edit the table file with any kind of text editor or word processor that can read and write standard ASCII files. The full path of the table is: \MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB Enter the addresses as described in section "Addressing an MHS user in LANtastic(R) Mail". Make sure that all the aliases start with the characters "MHS:". ==> Entering "aliases" as LANtastic(R) usernames If you desire, it is possible to pick the remote (MHS) addresses from the LANtastic(R) user list when you send LANtastic(R) Mail messages. To be able to this, the aliases/shortnames for the addresses must be entered as LANtastic(R) users in NET_MGR. However, it is not necessary to do this. LANtastic(R) Mail allows you to enter addresses/usernames that are not defined on the server, and FLASH-Gate(TM) will pick up the message anyway, as long as the alias/address is defined in LANTMAIL.TAB. To enter the aliases/addresses in the LANtastic(R) user list, start NET_MGR, select "Individual Account Management" and enter the aliases/shortnames. Make sure you spell the alias exactly the same way as in LANTMAIL.TAB. Also set the "Number of Concurrent Logins" to 0 so that noone can login using these usernames. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 8 That does it! Now you are ready to try it out! Good luck and Have fun! FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 9 TROUBLESHOOTING If you are getting error messages, please check them against the proper list below and follow the recommendations. If nothing helps, send a message to NICK Systems technical support. Technical support is preferably reached via MHS as "TECH @COLORSHP" via NHUB or direct 310-841-2074. Please supply a detailed description together with your FLASH-Gate(TM) version and serial number and also your MHS version. Thanks for your patience! ==> User and addressing errors => Non-delivery of LANtastic(R) Mail message My LANtastic(R) Mail message never gets picked up by the gateway. What is wrong? * First, check that your MHS is running and has gone through a full cycle. * Secondly, verify that the MHS host/server is logged in to the LANtastic(R) server the message was sent on. * Third, check that your address is correct. The "ALIAS" that you enter in the "Enter User to Receive Mail" field must be entered in the LANTMAIL.TAB file and it also has to start with the letters "MHS:". * If this did not help, then finally check the INPOST.ERR file (as described in the section "Gateway error messages") which will hold an error message if the gateway failed. => Non-delivery of MHS message When I try to send a message to a LANtastic(R) user via MHS and FLASH-Gate(TM) I get the following message back: ****************************************************************** To: CJ @FRANGO (Carl-Johan L fstedt) From: LANTMAIL @FRANGO Subject: Non-delivery report Message-id: DB8C132C8133A0E0 Via-host: FRANGO.FRANGO Date: 7-Jun-93 18:45:31 The message you sent to: LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;} on 7-Jun-93 18:44 could not be delivered to: LANTMAIL @ FRANGO {LANtastic: S=NONEXISTENT; U=CJ;} Reason: Cannot access mail resource on LANtastic server in address. Please verify that the address is correct. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 10 Original message: ****************************************************** Date: 7-Jun-93 18:44 From: CJ @FRANGO (Carl-Johan L fstedt) To: LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;} Subject: This is a test message Application-name: MHS Message-id: 778C132C0133A0E0 This is a test message from MHS E-mail to LANtastic Mail. ****************************************************************** * This means that the message you sent didn't reach its destination because the gateway couldn't access the mail device on server "NONEXISTENT". It can be one of the following reasons for this: - the LANtastic(R) server "NONEXISTENT" does not exist - the MHS server/host is not logged in on "NONEXISTENT" - "NONEXISTENT" does not have a mail device (@MAIL) - the queue/spool area on "NONEXISTENT" is damaged or the disk is full! You can also get a non-delivery message for other reasons: ****************************************************************** The message you sent to: LANTMAIL@FRANGO {LANastic: S=SERVER1; U=CJ;} on 7-Jun-93 18:44 could not be delivered to: LANTMAIL @ FRANGO {LANastic: S=SERVER1; U=CJ;} Reason: Invalid LANtastic address in above extended address. ****************************************************************** * This means that there was something wrong in the MHS extended address part. Please refer to section "Addressing a LANtastic(R) Mail user in MHS". The problem in this case was that "LANTASTIC" was misspelled as "LANastic". Another non-delivery message can have this reason: ****************************************************************** The message you sent to: LANTMAIL@FRANGO on 7-Jun-93 18:44 could not be delivered to: LANTMAIL @ FRANGO {} Reason: Invalid address. Extended address part missing. ****************************************************************** FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 11 * This means that the MHS extended address part was completely missing. The address needs an extended part as described in section "Addressing a LANtastic(R) Mail user in MHS". ==> Installation error messages Cannot create gateway (errorcode CODE). Please run manual installation. * The installation failed. Contact NICK Systems. Cannot start MHSUSER program. Please verify your MHS installation. * The installation program cannot find the MHSUSER program. Make sure that your MV variable is correctly set. (For example, if you have installed MHS on "F:\" you should have the "SET MV=F:\" command on the workstation). Can't open INSTALL.INF on this drive! Select another drive. * The installation program cannot find the INSTALL.INF file. Your installation disk is incomplete. Contact NICK Systems. Couldn't add gateway. Try once to select another name. * Gateway name already used as a hostname in MHS. Try using another name. Invalid INSTALL.INF * Damaged file. Your installation disk is damaged. Contact NICK Systems. Invalid installation disk: "FILE" is missing on "DISK" * Your installation disk is incomplete. Contact NICK Systems. MHS is currently running. Please stop the MHS program on the MHS server. * The MHS program is running. The program must be stopped before the installation can continue. MHS requires (administrators) password. Please supply. * Your MHS has been setup with an administrators password. You need to supply that password to continue the installation. MV environment variable not defined * The MV variable has not been set at the workstation. Set MV to point to your MHS installation. (For example, if you have installed MHS on "F:\" you should have the "SET MV=F:\" command on the workstation). ==> Gateway error messages When the gateway encounters an error, the error message gets written to the INPOST.ERR file located in the gateways PUBLIC directory. (\MHS\MAIL\GATES\LANTMAIL\PUBLIC\INPOST.ERR) Cannot close mail device (LANtasticMail:Send) * The disk (that the LANtastic(R) queue/spool area resides on) is probably full. Cannot close MHS file (Message:Write) * The disk (that MHS resides on) is probably full. FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 12 Cannot delete message from [USERNAME] (Inpost:LANtasticToMHS) * Only the sender or SuperMail user can delete this message. The MHS server/host needs SuperMail privileges. See the "Installation" section. Cannot open body/text file (LANtasticMail:Read) * Cannot access queue entry/spooled file. The LANtastic(R) queue/spool area may be corrupt. Cannot open mail device on Server [SERVER] (LANtasticMail:Send) * Either the MHS Server/host is not logged in on "SERVER", or "SERVER" has no mail device. Cannot open MHS file (Message:Write) * The disk (that MHS resides on) is probably full. Cannot open source file [FILENAME] (LANtasticMail:Send) * "FILENAME" is either locked or missing. Cannot open table file [FILENAME] (AddressTable:Read) * The LANTMAIL.TAB is missing from your installation. It is supposed to be located in the \MHS\MAIL\GATES\"LANTMAIL"\PUBLIC\ subdirectory. Reinstall FLASH-Gate(TM). Cannot read message [FILENAME] (MHSToLANtastic) * Invalid (non-MHS) message! Cannot send file (Message:Send) * The disk (that MHS resides on) is probably full. Cannot send message. (Inpost:MHSNonDelivery) * Cannot send delivery report for message with invalid address. The disk (that MHS resides on) is probably full. Cannot send message from [USERNAME] (Inpost:LANtasticToMHS) * The disk (that MHS resides on) is probably full. Cannot Set queue entry (LANtasticMail:Send) * The gateway couldn't add the message to the queue. The LANtastic(R) queue/spool area may be corrupt or the disk might be full. Cannot set raw mode on mail device on Server [SERVER] (LANtasticMail:Send) * Something is wrong with the mail device. Try to send a binary message manually from the MHS server/host username/login. Cannot write. (LANtasticMail:Send) * Cannot write to the LANtastic(R) mail device. The disk (that the LANtastic(R) queue/spool area resides on) is probably full. Cannot write attachment (Message:Send) * The disk (that MHS resides on) is probably full. Cannot write to mail device on Server [SERVER] (LANtasticMail:Send) * The disk (that the LANtastic(R) queue/spool area resides on) is probably full. Invalid signature (Message:Read) FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 13 * The file/message has an invalid MHS signature and is probably not an MHS message. Invalid (too long) signature (Message:SetSignature) * The file/message has an invalid MHS signature and is probably not an MHS message. License file missing or damaged * The FLASH-Gate(TM) license file cannot be found or is damaged. Reinstall FLASH-Gate(TM). Send-to missing in message [FILENAME] (MHSToLANtastic) * The message does not have the "Send-to:" field and is invalid. Sender missing in message. (Inpost:MHSNonDelivery) * The message does not have the "Sender:" field and is invalid. Signature missing (Message:Read) * The file/message does not have an MHS signature and is probably not an MHS message. Trial package license has expired (TRIAL VERSION ONLY). * The trial period of your program is over. Contact NICK Systems for a retail package.