UPDATE TO EMAIL PROGRAMS FOR ALPHA BASE COMPATABILITY MICHAEL SPALDING NORTHVIEW LABORATORIES, INC. 312-564-8181 Several changes were made to the AMUS EMAIL system to make it function properly in an Alpha Base environment. This document describes those changes and how to implement the updated EMAIL system. The EMAIL programs were changed to check whether or not Alpha Base is active, so they should be compatable with non-AB systems (I say "should be"- I haven't actually tested them). The new hash totals and version numbers are contained in the file EMAIL.DIR (created using dir/v/h/d, so you can use the VERIFY program to check for the proper hash totals and version numbers). We are running AB version 4.8D on our system with FLIP, so be careful if you are running an earlier version. You should have no problems if you're running a fairly recent version, but I won't make any guarantees. The following programs were modified: MAILON - This program now grabs the user ID from the GINDTA.SV module (if it exists). If that user ID is not a valid EMAIL user, the user is prompted for manual entry of ID. The new mail notification routine is also skipped if the program is run by an Alpha Base user because of the changes to the EMAIL program's notification routine (see below). EMAIL - The new mail notification routine was modified to support the Alpha Base message system. Rather than beeping a user who receives new mail, an AB message is sent which contains the sender's name and the title of the new mail message. AB messages are only transmitted if a user is on line; otherwise the message is held until the next time the user logs on. This is why the new mail notification routine was removed from the MAILON program. These changes were also necessary for compatability with FLIP because the way the EMAIL program was initially written will cause a system crash if a user is FLIPping while they are receiving a new mail notification message. The following programs were added: E.LIT - This program is a simple program that calls the MAILON program and the Alpha Base STRMEN program. It is used in the AB User File as the "Menu # or .CMD" (field 10) with the following format: E {Menu #} The menu # is the top (starting) menu for this user. If no Menu # is specified, the Alpha Base System Menu (1010) will be used as a default. This program was called `E' because a short name was necessary for the 6 character field in the User File. You can rename this program to any single letter if there is a conflict with another program on your system. It would have been possible to use a simple DO file in place of E.LIT, but DO files without explicit file specifications and the use of the DO.LIT program take much longer for the operating system to locate. They also cannot be loaded into system memory (which is recommended for this program for faster execution.) LOGIN - This program was created to replace the AB LOGIN program. It simply executes the MAILOF program, then chains to the AB LOGIN program. To use this program, you must first rename the AB LOGIN.LIT program to LOGINE.LIT. When this program is assembled, it will have an extension of .EML to guard against accidently copying over the AB LOGIN program before renaming it to LOGINE. You must rename this program to LOGIN.LIT before using it, and copy it to the SYS account. Usage of this program is identical to the AB LOGIN program. It is recommended that you place both LOGIN.LIT and LOGINE.LIT in system memory for faster execution. NOTE: Usage of this program is optional. You could also replace the LOGIN command string on all menus with "MAILOF\LOGIN", but if you have as many menus as we do, that is a major undertaking! Also, users logging off from the command mode with the AB LOGIN program would have to remember to execute MAILOF. This program will operate correctly even if the user was never logged onto the EMAIL system. To use this new version of EMAIL you need to do the following: 1 - Add all Alpha Base users to the EMAIL user file (see EMAIL.OPR). 2 - Rename the AB LOGIN.LIT program to LOGINE.LIT (in the SYS account). 3 - Rename the LOGIN.EML program to LOGIN.LIT and copy it to the SYS account. (Also make sure you copy E.LIT and the updated versions of EMAIL.LIT and MAILON.LIT to the SYS account). 4 - Modify your AMOSL.INI file (work on a copy of course!) to place E.LIT, LOGINE.LIT, LOGIN.LIT, MAILON.LIT, and MAILOF.LIT in system memory. You may also want to place EMAIL.LIT in system memory. (If you use the AB configurator, you must make these changes there.) NOTE: This step is optional, but recommended. 5 - Change field #10 (Menu # or .CMD) in the Alpha Base User File to use the E.LIT program (see above) for each user who will be accessing EMAIL. 6 - Add the EMAIL command to all menus (you may also add it to the FLPCTL.DIR file if you have FLIP and want to make it a FLIP executive function). 7 - Call Michael Spalding at 312-564-8181 if you have problems.