How Do You Link cc:Mail and Telemail?
=====================================

This document provides instructions on exchanging mail with Telemail(R)
using cc:Mail Router(TM) Release 5.1 or later.  This release of cc:Mail 
Router does not require a separate purchase of cc:Mail Telelink(TM). 

cc:Mail Router enables cc:Mail(TM) users to exchange messages on their
LANs with Telemail users.  Conversely, Telemail users can create
messages and send them to cc:Mail users.

Messages from cc:Mail users to Telemail users are handled in the
following manner:

1.      The messages are stored in a dedicated mailbox in a
        cc:Mail post office waiting for a connection with Telemail.  

2.      cc:Mail Router, running on a PC with a modem and telephone line, 
        connects to Telemail using cc:Mail Telelink.

3.      cc:Mail messages are forwarded to Telemail.

Messages from Telemail users to cc:Mail users are handled in the
following manner:

1.      Telemail messages are stored in a special Telemail mailbox.

2.      cc:Mail Router connects to Telemail and exchanges the messages.

3.      The messages are forwarded to the cc:Mail recipients. 

Hardware requirements:

        o IBM PC/XT/AT, PS/2, or a compatible computer
        o 380KB of available RAM (for DOS Router)
        o Hayes-compatible modem

Software requirements:

        o cc:Mail Desktop (previously known as LAN Platform Pack)
        o cc:Mail Router Release 5.1 or later (DOS or OS/2)
        o MS-DOS or PC-DOS Release 3.1 or later releases (for DOS Router)
        o OS/2 Release 1.3 or later releases (for OS/2 Router)

Telemail login requirements:

        o Telemail login information (for example, username and password)
        o Dial-up access number for Telemail

The login and dial-up information should be obtained from the Sprint(R)
representative who set up your Telemail account.

	
What Are the Important Concepts and Terms?
==========================================

Describing a Telemail Message

A Telemail message is the basic unit of communication in Telemail.  
The message corresponds to the cc:Mail message.  Messages are exchanged 
between cc:Mail Telelink and Telemail users the same as standard 
Telemail-to-Telemail message exchange.  Telemail doesn't support sending 
or receiving attachments.

Describing a Telemail Post Office

The Telemail post office is a Telemail userid that is a temporary 
repository for messages on the Telemail system.  The post office

        o stores Telemail messages sent to cc:Mail users until 
          cc:Mail Telelink calls to down load the messages to a LAN.

        o receives messages from cc:Mail.

	o forwards the received cc:Mail messages to the specified 
          Telemail users.

Obtain the required Telemail login information as well as the dial-up 
access numbers from the Sprint account representative who set up your
Telemail account.

Using a Script with cc:Mail Router

The script is an ASCII text file.  cc:Mail Router uses this file
once the dial-up connection has been established to 

	o provide the login information.

	o successfully interact with the Telemail login interface.

	o invoke the exchange of messages.

	o log out of Telemail.

This document includes a sample script.  See "How Do You Build the
Telelink Script" section below.  It may be necessary to modify the
sample script to exchange mail using your Telemail account.


How Do You Build the Telelink Script?
=====================================

Building the Telelink Script

The Telemail system is serviced by the Sprint communications network.
The dial-up lines to this network are designed to be accessed by a
person interacting with a series of prompts.  cc:Mail Router allows you
to automate this process by using a script file.

cc:Mail script files have 3 components, which allow this interaction
with a series of prompts to occur and make it easy for the user to
customize.

1.      The first field in the script is reserved for the time
	interval in seconds.  The number of seconds indicated must
	expire before the next fields are evaluated or acted on.

        You may need to modify this field depending on the speed of
	your modem connection to the network.

2.      The second field in the script is ignored and used only as a
	place holder unless exact-prompt matching is turned on.  This
	is done using the cc:Mail key words PROMPT ON that indicate
	to cc:Mail Router to look for exact matching of the text in
	the second field of the script before the next field will be
	evaluated or acted upon.  This means that the text must match
	the text that Telemail is using to prompt you for login
	information.

        Exact prompt matching can be turned off using the cc:Mail
	key words PROMPT OFF, causing the second field in the script 
	to be treated as a place holder.

        If you are using exact-prompt matching and you receive the
	cc:Mail error "prompt string not matched," then you may want
	to manually call the network using a communication application
	that allows manual interaction.  This allows you to verify the
	text that Telemail is using to prompt you for information and
	identify the discrepancy in the script file. 

3.      The third field in the script file is reserved for two purposes.

        First, it holds the characters that you want sent to the 
        interface.  For example, in this field, you can place your
	login userid and the control character that emulates the
	carriage return (^m) required by Telemail.  This information
	is sent in response to one of the Telemail prompts.  It is
	equivalent to typing your userid and pressing the carriage
	return.

        Second, it is reserved for cc:Mail key words.  cc:Mail Router 
	documentation contains full descriptions of key words and their
	associated tasks.  

        The following key words are specifically used with Telemail:

	Key Word	Meaning

        DIAL	  	Sends Hayes(TM) reset and then the command
			Attention Dial Tone (ATDT) followed by the
			dial-up telephone number found in the address
			field of the Telemail post office entry.

        USERID		Obtains the userid from the address of the
			Telemail post office entry and sends it to the
			Telemail interface.

        PASSWORD  	Obtains the password from the address of the
			Telemail post office entry and sends it to the
			Telemail interface.

        TELELINK  	Invokes the message exchange with Telemail.

Within a script line, control characters are represented in standard 
Ctrl-key format with the carat character (^) representing the Ctrl key
as follows:

        Control Character       Indicates

        ^m                      A carriage return

        ^@                      Do not wait for a return line feed
                                from the system

Using the Sample Script File

The script file in this document is a sample communications network 
script for instructing cc:Mail Router how to access the Telemail system.  
Modify the sample script file in the following way:

	Rename the script file with the first eight characters of the
        Telemail post office name you entered in the cc:Mail Directory 
        (for example, TELEMAIL). 

        If you prefer to have a unique script file name, specify
	"/s=filename" in the address field of the Telemail post office
	entry.

cc:Mail Telelink also creates two temporary files when exchanging 
messages with a Telemail post office.  These files, named TMLINK.IMP 
and TMLINK.EXP, are created in the current directory.  

If you are upgrading an existing Telelink gateway to take advantage of
the new Telemail user-list addressing feature, you need to modify any
existing script file to meet your network requirements.  As before, the 
script file name should be renamed with the same first eight characters 
of the Telemail post office name.

See "Adding a Direct Telemail User-Connections List in the cc:Mail
Directory" for more information. 

The following script file is suitable for standard Telemail users.  

	1 zzz DIAL
	1 zzz @^@
	1 zzz ^m^@
	PROMPT ON
	5 TERMINAL= ^m^@
	5 @ mail^m^@
	10 name? USERID!^m^@
	10 Password? PASSWORD^m^@
	PROMPT OFF
	10 zzz TELELINK
	1 zzz LOGOFF^m^@

Each line of the sample script is explained in detail as follows:

        o The script in line 1 tells Router to wait 1 second; then,
          the key word DIAL sends the Hayes command ATDT and the
	  telephone number in the address field to the modem.

        o The script in line 2 tells Router to wait a maximum of 
          1 second; then, send an @ and do not wait for a 
          line-feed response from the system.

        o The script in line 3 tells Router to wait a maximum of 
          1 second for the prompt; then, send a carriage return and
	  do not wait for a line-feed response from the system.

        o The script in line 4 turns on exact-prompt matching.

        o The script in line 5 tells Router to wait a maximum of 
          5 seconds for the prompt "TERMINAL="; then send a carriage
          return and do not to wait for a line-feed response from the
	  system.

        o The script in line 6 tells Router to wait a maximum of 
          5 seconds for the prompt "@"; then, send the characters "mail" 
          followed by a carriage return and do not wait for a line-feed 
          response.

        o The script in line 7 tells Router to wait a maximum of 
          10 seconds for the prompt "name?"; then, send the userid from
          the cc:Mail Directory, an exclamation mark, and a carriage
          return.  The exclamation mark instructs Telemail not to
          display any information messages upon login.

        o The script in line 8 tells Router to wait a maximum of 
          10 seconds for the prompt "Password?"; then, send the
	  password from the cc:Mail Directory followed by a carriage
	  return.

        o The script in line 9 turns off exact-prompt matching.

        o The script in line 10 tells Router to wait a maximum of 
          10 seconds; then, initialize cc:Mail Telelink code and connect 
          and exchange messages with the Telemail system.

        o The script in line 11 is an epilogue that tells Router to
          immediately find the prompt "Command?"; then, input LOGOFF,
          followed by a carriage return.  

          You can add additional lines as an epilogue if you must
          exit the Telemail network after LOGOFF is executed by
          cc:Mail Telelink.

How Do You Get Started Right Away?
==================================

Setting Up the Telemail Post Office Userid 

Have a Telemail representative create a new userid on the Telemail 
system to be the interface with the cc:Mail post office on the LAN.  If 
possible, have the userid match the name of the cc:Mail post office as 
closely as possible (for example, TELEMAIL).  Record the userid, password, 
and telephone number for later use.

Adding Telemail as a Post Office in the cc:Mail Directory

After the Telemail representative has created the Telemail post office 
userid, add a name for the Telemail system in the cc:Mail Directory with 
the cc:Mail ADMIN program.  To add Telemail as a post office in the 
cc:Mail Directory, follow the same procedure you use when you add other 
remote post offices.

A typical cc:Mail Telelink directory entry is as follows:

      Name         Loc     Address
      TELEMAIL     P       TELELINK 9,1-800-123-4567 my_id;org_name password

The address must contain the key word TELELINK and must be followed by
the telephone number to connect to the Sprint network.

"My_id" is where you input your actual Telemail userid.  You can also
include your organization name, separated from your Telemail userid 
by a semicolon.  Include a space after your organization name.  
Enter your password last. 


How Do You Add Telemail Users to the cc:Mail Directory?
=======================================================

This section applies only if you want to include the names of Telemail
users in your cc:Mail Directory.  Methods of addressing messages to 
Telemail users who are not contained in the cc:Mail Directory are 
described in the section "Sending and Receiving Messages Using cc:Mail."

There are two ways to add the names of Telemail users to the cc:Mail
Directory.  The first way to add names involves:

1.      Add the actual userids of the Telemail users as names in the
        cc:Mail Directory.  

2.      Add the name of the Telemail post office for the corresponding
        cc:Mail address.

        This entry would be similar to the following example:

                Name            Loc             Address
                123456          r               TELEMAIL

The second way to add names involves:

1.      Add the real name of the Telemail user in the cc:Mail Directory.

2.      Add the Telemail userid after the Telemail post office name
        in the cc:Mail address.

        This second alternative is useful when the user's full name is
        desired.  

        This entry would be similar to the following example:

                Name            Loc             Address
                Smith, Bob      r               TELEMAIL 123456

In either case, to add Telemail users to the cc:Mail Directory, run
the ADMIN program and follow the same procedure you use when you add
users on a remote post office to the cc:Mail Directory. 

If the userid of the Telemail user was added as the name in the cc:Mail
Directory, no additional information is required.  If, however, the
Telemail user's real name was added in the mail Directory, add the
user's userid following the Telemail post office name (for example,
TELEMAIL BJONES).  The userid may be 

        o a Telemail userid.

        o a Telemail nickname (if the Telemail administrator installed
          a nickname file on the post office userid). 

        o a compound Telemail userid (for example, userid/node). 

Adding a Direct Telemail User-Connections List in the cc:Mail Directory

A list of direct Telemail user connections can be entered in the cc:Mail 
Directory along with the Telemail post office name and Telemail user
names.  The list enables cc:Mail to 

        o automatically log in each listed user with Telemail.

        o send messages from each listed user to Telemail. 

        o receive messages addressed to each listed user from Telemail.

To create a direct Telemail user-connections list in the cc:Mail
Directory complete the following steps:

1.      Create a public mailing list where the Telemail user list is
        stored.  

        The public mailing list name must begin with a pound sign (#),
        followed by the Telemail post office name.  For example, if you
        named the Telemail post office TELEMAIL, the public mailing
        list would be named #TELEMAIL.

2.      Add the desired user names to the cc:Mail Directory as Telemail 
        login names.  

        These names are aliases for the corresponding cc:Mail user names 
        entered in the mail Directory as individual addressees.  

When you enter these aliases, the Telemail login password for each 
user must follow the user's cc:Mail name in the cc:Mail address field.  

For example, if a cc:Mail user Bob Smith has a Telemail login name
of BSMITH and a Telemail password ABCDEF, the alias name would
be added to the cc:Mail Directory as follows:

        Name            Loc             Address
        BSMITH          R               Bob Smith ABCDEF

Once the address field is added, cc:Mail will change the location 
field to "a" since the name is recognized as an alias.  

When you have completed creating these alias names, include them in the 
#TELEMAIL public mailing list.  You can also enter the aliases at the 
same time you create a mailing list.

After you have created a direct Telemail user-connections list cc:Mail 
Telelink can perform the following actions:

1.      Make a connection to Telemail as a post office.

2.      Send messages that weren't already sent by the cc:Mail users
        on the public mailing list. 

3.      Receive messages from Telemail which were waiting to be
        delivered to cc:Mail.  
	
Once the connection to Telemail is complete, cc:Mail Telelink 

1.      Connects to each Telemail user defined on the public mailing 
        list one at a time. 

2.      Sends messages from each Telemail user.

3.      Receives any waiting messages.

4.      Delivers the messages directly to each Telemail user's
        mailbox.

Adding the Telemail Post Office Name to the Call List

You need to add the Telemail post office to the call list for cc:Mail 
Router, like you would add any other remote post office.  You can use 
all the options available for setting the timing and parameters 
of such calls.  Since Telemail does not call your cc:Mail post office, 
you should set the minimum number of messages queued before a connection 
is made to zero.  

The cc:Mail ROUTER program will regularly poll the Telemail post office 
for messages to be received, even if no messages are queued for sending 
to Telemail.  In addition, you can use the cc:Mail ROUTER program 
express-calling option to call the Telemail system.  The procedure is 
identical to the one used for calling any remote cc:Mail post office.

For example, to make a call to the Telemail post office TELEMAIL in the 
express mode, you might use the following command line:

        F:\CCMAIL\ROUTER TELEMAIL M:\CCDATA SHOWLOGIN

A sample Router session might appear as follows:

        F:\CCMAIL\ROUTER TELEMAIL M:\CCDATA SHOWLOGIN

        Version 5.11  Copyright(c) 1994.  cc:Mail, Inc.  All rights
        reserved.

        Press Esc to terminate ROUTER program.
        3/1/94 1:04PM Placing call to TELEMAIL.  Initiating access 
        to Telemail.

        TERMINAL=
        @mail
        User name?  LOCALPOST!
        Password?
        0 messages sent.
        0 messages received.
        logoff.
        3/1/94 1:05PM Hanging up telephone.  On-hook.


How Do You Verify the Connection Between cc:Mail and Telemail?
==============================================================

Normally the progress of the connection between the cc:Mail post
office and the Telemail post office is not shown on the display
screen.  However, at least for the first time, the progress of the
connection should be displayed to ensure that the network script file
is correct and that the connection to the Telemail system is successful.

The progress of the connection to the Telemail system may be displayed 
by including the command-line parameter SHOWLOGIN when starting the 
ROUTER program in communication mode.  The SHOWLOGIN parameter works 
both when the connection is initiated from the call list or when an 
express connection is made.  Once the connection is functioning smoothly, 
the SHOWLOGIN parameter can be removed from the command line.


How Do You Send and Receive Messages Using cc:Mail?
===================================================

Preparing and Sending a Message from cc:Mail to Telemail

Once the Telemail users are properly added to the cc:Mail Directory, 
preparing and sending a message to Telemail is exactly the same as 
sending a message to another cc:Mail user.  

If you want to address Telemail users that aren't added to the cc:Mail
Directory, but who are accessible through a Telemail post office,
follow the steps for addressing messages to a post office.  See your
cc:Mail user's manual for more information.  

Reading Your Mail

Receiving mail from Telemail is exactly the same as receiving mail 
from other cc:Mail users.  


What Are the Other cc:Mail Telelink Functions?
==============================================

Using Unknown-Recipient Messages

If cc:Mail Telelink can't deliver a cc:Mail message to Telemail
because the Telemail recipient userid is invalid, the cc:Mail message 
author receives an unknown-recipient message.  

Conversely, while sending Telemail messages to cc:Mail, cc:Mail
Telelink may discover invalid recipients, or no recipients at all, for
a message.  cc:Mail Telelink sends any messages that contain invalid
recipients to the cc:Mail administrator for action.


What Error Messages Occur?
==========================

The following is an alphabetical listing of all cc:Mail Telelink error 
messages in the format as indicated.

** Error Message
        Likely Causes
                Suggested Solution

** Error in script file line: . . .
        The printed line either lacks the required three fields or the
        first field is non-numeric.
                Edit the script file and correct the line.

** Password not in cc:Mail address
        There is no Telemail password in the cc:Mail address for the
        Telemail post office.
                Run the cc:Mail ADMIN program and correct the post office
                address.

** Script file . . . cannot be found
        cc:Mail Router could not find the network script.
                A network script is always required.  It must have a
                name identical to the first eight characters of the
                Telemail post office name, and must reside on the same
                drive and directory as cc:Mail Router. 

** Userid not in cc:Mail address.
        There is no Telemail userid in the cc:Mail address for the
        Telemail post office.
                Run the cc:Mail ADMIN program and correct the post
                office address.
