Name:         MailLink for PowerTalk MS
Version:      1.6
Released:     October 18, 1995
Description:  A personal gateway for PowerTalk users that will allow
              users to send and receive mail into the StarNine  Mail
              system or, as formerly known, Microsoft Mail for AppleTalk
              system.  Please refer to the Read Me for complete information.

The enclosed file is a self-extracting archive. To use, download, double-click the downloaded file (this decompresses it).

From the Read Me inclued in this archive:

Mail*Link for PowerTalk/MS  1.6

Mail*Link PT/MS for PowerTalk is a personal e-mail gateway for PowerTalk users. This gateway will allow PowerTalk users to send and receive mail into the StarNine  Mail system or, as formerly known, Microsoft Mail for AppleTalk system. Mail can be sent and read with any PowerTalk mail-enabled application.

This release of Mail*Link¨ for PowerTalkª/MS is the first release of this gateway by Apple Computer Inc. This gateway is functionally equivalent to version 1.0.0. Future versions of this software will be modified and enhanced. 

This software is licensed to you under the Macintosh System 7.5 license agreement.  All terms and conditions of this license must be followed. 

Note: If you are upgrading from version 1.0.0 it is VERY IMPORTANT that you follow the instructions in the Upgrading Section below.

The installation and upgrade procedure for this software will still install the StarNine demonstration key files (which were part of the 1.0.0 release). However the 1.6 release of the gateway has been modified to ignore the key files and thus will never expire.

To use the PT/MS gateway you must have the Microsoft Mail Extension installed in the Extensions folder of your System folder. The Microsoft Mail Extension is part of Microsoft Mail for AppleTalk. Please refer to the PT/MS User Guide for more information.

======================== ITEMS OF NOTE ========================

¥ Power PC: If you are using a Power PC, turn off the modern memory manager before installing PT/MS.  After you have completed the gateway configuration described in Chapter 2 and are sure that the gateway is working properly, turn the modern memory manager back on.  See "Power PC issues" on page 52 of the manual for related information.

¥ Gateway Operation: When you activate the  PT/MS gateway, it uses the MS Mail extension to log in to the MS Mail Server specified in the Key Chain configuration window.  It then sends pending mail from your Out Tray to the Server and transfers mail from your account on the Server to your PowerTalk In Tray at regular specified intervals until you deactivate the gateway or turn off your Macintosh.  This process all takes place in background.  While the MS Mail extension is actively communicating with the MS Mail Server, your Macintosh is temporarily unavailable for other tasks.  This translates into slight freezes from time to time as you are going about your normal tasks as PT/MS logs into the server, with more significant hangups lasting a couple of seconds during large file transfers between the local disk and MS Mail Server.  If the MS Mail Server is on a physically remote network or a large, busy network, the process of logging in to the Server will take longer.  Increasing the interval at which you contact the MS Mail Server will mitigate hangups (An interval less than three or four minutes will hang your machine up in continual PowerTalk processing leaving no time for your machine to do anything else.  We recommend a connection interval of at least five minutes).

======================= INSTALLATION INSTRUCTIONS =======================

For new installations only:

We recommend that you install this software via the installer script.

1.	Double click on either the "Installer" icon.
2.	Select the drive on which you wish to install this software and click Install.
3.	Reboot the system after the software has been properly installed.

===================== UPGRADE INSTRUCTIONS =====================

If you are upgrading from a previous release of Mail*Link PT/MS for PowerTalk, you should follow these instructions:

1.	Install the software as instructed in the section "GETTING STARTED - Installing Mail*Link PT/MS".
2.	After the system has rebooted, open the "PowerTalk Key Chain".
3.	Open the PT/MS personal gateway in the key chain. 
The installation procedures change the file-id that PowerTalk uses to locate the Mail*Link PT/MS file. Opening and closing the PT/MS Service configuration window will cause the new file-id to be written into the PowerTalk configuration file.
4.	Close the key chain. 
You will be told that you must reboot the system before PowerTalk will activate the gateway.
5.	Reboot the system.

If you have trouble with the gateway after upgrading please re-install by following the instructions in the Clean Upgrade Install section below.

============================= CONFIGURATION =======================

¥	Creating your PT/MS personal gateway

Once you have installed the software and rebooted the system (as described above), follow these instructions to create your PT/MS personal gateway.

1.	Open the ÒKey ChainÓ located on your desktop.
2.	Press the ÒAddÓ button.
3.	You will be presented with a list of services that are available. Select ÒMicrosoft Mail ServiceÓ.
4.	A new item with the server name of ÒNot ConfiguredÓ and a service type of ÒMicrosoft Mail ServiceÓ will appear in your ÒKey ChainÓ.
5.	Proceed to the ÒConfiguringÓ section below.

¥	Configuring your PT/MS personal gateway

Before configuring, make sure that you have selected your MS Mail server in the Chooser. If you do not select this the PT/MS gateway will not be able to connect.

To configure the PT/MS personal gateway, ensure that the ÒKey ChainÓ has been opened.

1.	Double click (Open) the item with a service type of ÒMicrosoft Mail ServiceÓ. The PT/MS personal gateway only allows one instantiation, so there should only be one item with this type in the Key Chain window.
2.	A configuration window will be displayed. You should configure each item in this window before closing the window. Window closing is equivalent to pressing the ÒOKÓ button in a dialog. The ÒKey ChainÓ configuration windows have no ÒCancelÓ operation, so please ensure each item is properly filled in before closing the window (you can always come back and change the selections at a later date, but it is better if each item is properly filled in).
3.	Once you have entered the information in the configuration window, close the window with a mouse click in the close box or by typing Ò<command>WÓ. It may take a few seconds for the window to close. This is because PowerTalk is activating all of the personal gateway subsystems and informing them of their new configuration. Be patient.
4. Once the PT/MS configuration window is closed, close the Key Chain window.

======================= CLEAN UPGRADE INSTALLATION ====================

Use this procedure if you are experiencing problems with the gateway software.  You should not need to use this procedure for normal installs. To perform a "Clean Install" of the gateway software, use the following procedure.   

NOTE: Some gateways may remove mail from your In Tray and Out Tray when they are reinstalled.  Be sure to back up any items in your InTray and OutTray by dragging them to another folder on your hard drive.

NOTE: This will remove all services from your keychain, so be sure you have
the passwords for these services handy.  If you have personal gateways already
installed, you will need to set them up again, so be sure you write down the
setup information that is contained in each key, if necessary.  

This procedure removes all "Mail*Link" gateways.  If you have multiple
"Mail*Link" gateways installed, you will need to re-install each of the
gateways you want to use.

1. Open the Extensions folder, located inside the System Folder.  Find the
following item(s) and drag to the trash (note only the gateways you have installed will be in the Extensions folder):
  Mail*Link PT/QM
  Mail*Link PT/MS
  Mail*Link PT/INET
  
2. Open the Preferences folder, located inside your System Folder.  Find the
following items and drag them to the trash.  
	StarNine (folder)
	PowerTalk Setup Preferences
	PowerTalk Startup Preferences

3. Find the "Mail*Link Extras" folder, on the top level of your hard drive. 
Drag this folder to the trash.

4. Restart your machine.  After you have restarted, choose "Empty Trash" from
the Special menu.  

5. Double-click the installer for the desired software, and click Install at
the Easy Install screen.  After the installation is complete, your machine
will restart.  If you are installing more than one gateway, repeat this step
for each gateway.

6. Open the keychain and click "Add".  Select the gateway from the list of
choices.  A new item will be added to the Key Chain.  Open this key, and
configure the gateway as you normally would.  The gateway should now be
functioning.

=============== MANUAL INSTALLATION INSTRUCTIONS =======================

The manual installation instructions are for advanced users who wish to build their own installation process or who wish to install only portions of this gateway. Installation using this process should be conducted only after you fully understand how to use your Macintosh, and how to configure and use PowerTalk gateways.

If you must install this version manually, please follow these instructions:

1.	Place the distribution diskette in the floppy drive.
2.	Open the folder named ÒDrop Contents on System FolderÓ.
3.	Select all of the items in this folder and drag them onto the ÒSystem FolderÓ icon.
4.	You will be presented with a dialog box that indicates these files belong in special locations. Click ÒOKÓ.
5.	Close the ÒDrop Contents on System FolderÓ folder.
6.	Open the folder named ÒPlace Contents in Preferences FolderÓ.
7.	Select all of the items in this folder and drag them into the ÒPreferencesÓ folder (which is located within your ÒSystem FolderÓ.
8.	If you are presented with a dialog indicating that you will be replacing existing files, click cancel. You should perform the ÒAutomatic InstallationÓ procedure (above).
9.	Reboot the system. This is necessary because some of the software installed is only activated at boot time.

Note: With version 1.6 it is no longer required to install the key files.

=================== KNOWN INCOMPATIBILITIES ===================

¥ PT/MS and MailSwitch:  Running the MS Mail MailSwitch utility simultaneous with gateway operation has been reported producing odd behavior, particularly, PT/MS reports a -1981 error in its log on a mail message send.  A restart should cure the confusion.

¥ PT/MS and RAM-Doubler:  There have been some reports of inconsistencies running PowerTalk and PMSAMs with RAM-Doubler.

¥ When  a mail message is forwarded, the name and address of the original sender are not preserved.

¥ CE Software's QM for AOCE may be used to send mail, although you must select the AppleMail format when sending the message. This application may NOT be used as the default mail reader. If it is selected, AppleMail will be used instead.


============================ SUPPORT  ============================

If you need any additional help installing, configuring or using this gateway please call Apple Support at: 1 (800) SOS - APPL


(10/10/95)
©1995 StarNine Technologies, Inc., All rights resereved
©1995 Apple Computer, Inc. All rights reserved.
Apple and the Apple logo are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.
