Z-em@il Software Manual

Installation	3
From Windows 95...	3
From Windows 3.1 or earlier...	3
From DOS...	3
Launching Z-Em@il...	4
Setting up Z-Em@il	4
Information required to set up Z-Em@il	4
To set up Z-Em@il	5
SMTP Server IP Address	5
POP3 Server IP Address	6
POP User ID	6
POP Password	6
Your Name	6
Your E-Mail Address	6
Reply To Address	7
Speed (bps)	7
Port	7
Line Type	7
Redial	7
Volume	7
Detect	7
Hardware Flow Control	8
Parity, Data Bits, Stop Bits	8
Modem String	8
Creating an instant e-mail address book using the information already in your Zaurus	10
Viewing the Status of Your Server Connection	10
How to create an e-mail message	10
Attaching a file	11
Addressing your e-mail message	11
Sending your message	13
Receiving and Responding to Messages	14
To receive messages	14
Responding to your e-mail	14
Reply to Sender: Z-Em@il	15
Reply to All:	15
Forward Message:	15
Saving attachments:	15
Viewing attachments:	15
Managing your messages	16
Check the status of a message:	16
Tag a message:	16
Review or edit a message:	16
Delete a message:	16
Delete all tagged messages:	17
Delete all the messages in the active folder:	17
Browse through the details of each message:	17
Count the total number of messages:	17
Copy a message as a Zaurus document:	17
Referencing your e-mail	17
Troubleshooting	19
I can’t connect to my Internet provider.	19
My Zaurus memory is full.	19
The program dials but the terminal window never appears.	19
The program dials, the terminal window appears, but the login fails.	20
The program dials, but the terminal window does not close.	20
I am unable to send messages.	20
Communications stop and I do not connect with my POP3/SMTP server.	20
I do not get past ‘PPP Negotiation…’	20
When receiving mail, communication ends and the Comms Check window shows ‘Mail login Error’.	21
Sending / Receiving mail fails, and the Comms Check window shows a TCP communications error.	21
Sending / Receiving mail fails, and the Comms Check window show File Error.	21

Installation 

Note: You can load the program into your Zaurus’s Main memory, or onto an SRAM or Flash ROM PC card.

1. To begin, connect the Zaurus to your PC with a PC link cable or an infrared adapter
    (CE-IR2, CE-IR3, or CE-IR4 only). Make sure your Zaurus is unlocked before 
    installing by touching the TOOLS accessory button and selecting Secret.

2. Touch the TOOLS accessory button, then touch the PC Link icon and Select.
    Touch either the Cable or Wireless icon and OK. Your Zaurus display will show
    that the PC Link is ready.

3. Insert the program diskette into your PC and follow the instructions below that
    apply to your computer operating system.

From Windows 95...

Select Run from the Start menu, then type a:install or b:install and click OK. Follow the instructions on your PC screen. 

From Windows 3.1 or earlier...

For best results, type Alt-F4 to quit Windows and get a DOS prompt. Then follow the instructions for installing from DOS below. Or if necessary, select Run from the File menu. Then type a: install or b:install and click OK.

From DOS... 

a. Type A: or B:, then <Enter> to get the DOS prompt of the drive where the disk
    resides.

b. Type INSTALL and <Enter>. Then follow the instructions on your PC screen. 

Launching Z-Em@il...

Touch the MORE accessory button on your Zaurus, then touch the Z-Em@iI icon twice to run the program. 

Setting up Z-Em@il 

To set up the Z-Em@il program, you will need to know all of the information listed in the table below. You may wish to fill in the table before you begin the setup process. To find out this information, try one of three methods:

• Use a ping, host, or nslookup program to find your POP3 and/or SMTP IP 
  addresses. For example, entering ping internic.net returns an address of 
  198.41.0.9. (Note: IP addresses are required by Z-Em@il -- names are not
  supported.)

• Open the PC program you use to log on to your internet provider, and
              browse through the setup sections of the program to find the information you
              need. 

• Contact your internet provider or MIS representative to get the necessary
               information. 

Information required to set up Z-Em@il 

1. Do you have a POP3 mail server? (Required to run Z-Em@il): ___________

2. What are your server IP addresses? (e.g. 123.456.78.9) 

SMTP: __________________

            POP3:____________________

3. What is your user ID?__________________________

4. What is your password? ________________________

5. What is your e-mail address?_____________________

6. The speed (bps) of the modem connected to your Zaurus: __________

7. Type of modem — 15-pin or card: ____________

8. Phone line you will use — tone or pulse: ____________

9. Should your modem detect a dial tone? ______________

10. Does your modem use hardware flow control? _____________

11. What is the modem initialization string (if any)? _______________________

12. What is the login script: ___________________________________________________

To set up Z-Em@il

Z-Em@il allows you to save up to 10 different profiles so that you can access
several e-mail accounts, use different modems, or call from local or long distance locations without having to adjust the settings.

1. Touch the SETUP menu at the top of the screen and select Profiles. (Note: your
    Zaurus must be unlocked to access  Profiles. To unlock your Zaurus, touch the
    TOOLS accessory button and select Secret.

2. Make sure that Profile 1 is highlighted, then touch Rename. This will be your most
    commonly used system configuration for sending and receiving e-mail. Enter a
    name in the text box that will help you remember when to use this configuration.
    When you are finished, touch Done and you will return to Profiles. 

3. To enter the server settings for the profile you have just named, touch E-mail and
    enter the requested information in each text box of the SERVER screen. 

                               SMTP Server IP Address

This is the IP address of your SMTP (send mail) server in the format xxx.xxx.xxx.xxx (where xxx is a 1-3 digit number). You must know your server’s IP address to use Z-Em@il -- DNS names are not supported.

                               POP3 Server IP Address 

The IP address of your POP3 (receive mail) server in the same format as the SMTP server address. 

                               POP User ID

The user name you use to log onto your POP3 server.

                               POP Password

The password you use to log onto your POP3 server. (Note: Your POP3 user ID and password are often the same as your ID and password for your Internet account.)

4. Touch the IDENTITY tab at the bottom of the screen and fill in each text box.
    When you have completed all the information for both screens, touch OK and you
    will return to the Profiles Index. 

                               Your Name

The name that will be displayed on messages you send.

                               Your E-Mail Address

Your e-mail address which will appear on messages you send. Replies will be sent to this address, unless you supply a different address in the ‘Reply to address’ field.

                           Reply To Address

If for any reason you require replies to your messages to be sent to a different e-mail address than the one in the ‘Your E-Mail Address’ field, enter that address in this field.

5. To enter the modem settings for your profile, touch DialUp. First, enter the 
    information requested on the MODEM screen. 

                               Speed (bps)

The speed of your modem.

                               Port

15-pin modems connect to the Zaurus COMPUTER LINK; PC Card modems connect to the PCMCIA card slot.

                               Line Type

            Your type of phone service — tone (pushbutton) or pulse (rotary).

                               Redial

How many times the program will try to redial if the server doesn’t answer (usually because of a busy signal).

                               Volume

            The level of the modem speaker.

                               Detect 

Whether program should wait until dial tone is heard before trying to dial server.

                               Hardware Flow Control

Check this box if your modem has a flow control feature (consult your modem manual). If in doubt, leave box unchecked.

                               Parity, Data Bits, Stop Bits

            Match these settings to your provider’s requirements.

                               Modem String

If you want to customize the way your modem functions, check this box and enter the appropriate modem commands. Normally this box is not checked.

6. Second, touch the DIAL-UP tab at the bottom of the screen. Enter the phone
    number. If you are calling from an office phone system where you must dial "9" to  
    get an outside line, enter "9," in front of the phone number. This means the modem
    will dial 9 and pause for a moment, then dial the phone number.

Example: 9, 555-1234

    Below the phone number is a text box in which you must specify a script for
    logging into your Internet Service Provider. When you log in to your provider, the
    log in process consists of a series of prompts from the provider and your responses
    to these prompts. The default script provided in the text box allows you to supply
    the necessary responses in most cases. 

Note: some providers may use different prompts (i.e. "username"
 	         instead of "login". In this case, you will need to use your
 	         Zaurus’s terminal application to determine the correct login script

7. Find the initial WAITFOR command: waitfor "ogin:". This command tells 
    Z-Em@il to watch for the characters "ogin:" (part of "login:"). Just below this
    command, you will find the initial TRANSMIT command : transmit "user id^m".
    Replace "user id" with your actual user id. Be careful to leave in place the quotation
    marks and "^m" (the command for a carriage return).

8. Find the next TRANSMIT command: transmit "password^m". Replace  
    "password" with your actual password. Be careful to leave in place the quotation
     marks and "^m" . Then save the login script by touching Done.

NOTE: The easiest way to learn the information you need to create
                   	 your login script is to use the TERMINAL application on your
  	  	 Zaurus to log in with your provider. To use this application:

i. Touch the TOOLS application button on your Zaurus, then select Terminal.

ii. Touch the Setup screen button at the top of the screen and enter the dial up 
     information for your server. 

iii. Touch the LOGON screen button and your Zaurus will automatically dial
      the number. Once your Zaurus connects to your server, you should be able
      to manually enter your user ID and password.

iv. Once you have logged on, review the login script on your screen, then go
     back to the Z-Em@il program and make the appropriate corrections.

Write down the prompts from your provider and your responses. Then transfer these commands to the login script, placing "waitfor" in front of every prompt (enclosed in quotes), and "transmit" in front of every response. Every response must include ^m (the command for enter). Then this entire command must be enclosed by quotes (see the following examples).

                     Sample login sequence using the Terminal application:

                               login: user id

                               password: password

                               Therefore, our login script is:

                               waitfor "ogin:"

                               transmit "your user id^m"

                               waitfor "sword:" 

                               transmit "your password^m"

Note: Login Script commands are case sensitive -- a capital letter is
  	          interpreted differently than its lowercase equivalent. Also remember
 	          that some PPP providers require you to add an upper case "P" in
  	          front of your user name when you log in.

9. Repeat Steps 2-8 for each profile you will need. You will need a separate profile
    any time you change part of your system configuration (i.e. the type of modem you
    use, tone or pulse phone service, local or long distance dialing, etc.) When you
    have set up all of your profiles, touch Done.

Creating an instant e-mail address book using the information already in your Zaurus

Z-Em@il can use the e-mail addresses in your Zaurus Contacts or Data Files sections so that you can address your e-mail with a single touch of your Zaurus pen.

1. Touch SETUP and select Address Book.

2. Use the four menu boxes to specify whether Z-Em@il should use the information
    in your Zaurus Contacts or Data Files application to create the address book. 

3. Later, when you create an e-mail message, touch the TO button on the screen to
    instantly address the message.

Viewing the Status of Your Server Connection

When you connect to your e-mail server, you can choose to see a status bar showing the progress of your data transfer, or to monitor all the commands that are exchanged between your server and your Zaurus. Normally, you will want to see the status bar. If you do want to see the commands (i.e. for troubleshooting), touch SETUP and select Comm’s Check. When this selection is checked, you will see the server commands. 

How to create an e-mail message

1. Press NEW ENTRY on your keyboard or click on the Edit menu and select New
    Message. A blank message form will appear on the screen.

2. Touch the Subject box and type in the subject of the message. 

3. Touch the Message box, then type your message. Remember that you can cut and paste text from other Zaurus applications to create your message. To increase the size of the text box, touch the FULL screen button at the right of the screen (above the scroll bar). When you are done typing your message, touch the SMALL screen button in the upper right corner (above the scroll bar) to return to the standard screen.

4. Touch OPTION to:

• Set the priority of the message (the default setting is Normal).

• Delete the message after it is sent or save it to the SENT folder (the default
   setting is Save).

            When you are finished, press DONE.

Attaching a file

 1. Touch ATTACH to attach a file from the PC files area of your Zaurus. When you
     are finished, press DONE. 

 2. Some Zaurus models allow you to save a Zaurus file — such as a document,
     spreadsheet, or scrap book drawing — to the PC Files section. If so, you can attach
     this document to your e-mail message. If not, remember that you can cut and paste
     the document into the body of your message. 

NOTE: To attach a scrap book file:

1. Touch the Scrap Book application key on your Zaurus.

2. VIEW a scrap book entry, or create an entry and STORE it.

3. Copy the entry by pressing 2nd-C on your keyboard.

4. Touch QUIT to leave the Scrap Book application, go to the PC files area, and paste
    the scrap book entry into the index by pressing 2nd-V.

Addressing your e-mail message

1. Touch the To: screen button to address your message. The Address Message screen
    will appear. 
                                                                          
2a.If you have already set up the Z-Em@il Address Book to access the e-mail
     addresses stored in your Zaurus, touch the name of the person to whom the
     message is written.

OR

2b. Use the top of the screen to type in the name and e-mail address of the person to
      whom you are writing.

3. Touch the TO: screen button. The recipient’s name appears in the Recipients box.

4. If you wish to "Cc" or "Bcc" the message to additional people, repeat step 2a or 2b
    to enter the e-mail address, then touch the Cc or Bcc screen buttons.

5. When you have entered the addresses of all the people who will receive the
    message, touch Done. Then press ENTER to save your message.

Sending your message

1. After you have written all the e-mail messages you wish to send, return to the index
    mode by touching the INDEX button at the upper left of the toolbar, or by pressing
    ENTER. (If you are already in the index mode, you will see the VIEW button in the
    upper left corner.)

2. To send your message(s), touch MAIL and select Send Only or Send/Receive. 

3. The Send Mail window will appear. Choose a Profile and select which messages in
    the OUT folder you wish to send (currently selected message, all tagged, or all in
    folder). When you are finished, touch OK.

NOTE: If you selected Send/Receive, the Receive Mail window will
                         also appear (see next section).

4. The program will dial up your server and the terminal window will appear. Your
    script will be executed to log in to your Internet Service Provider. Should the
    terminal window not close, the log in has probably failed. An error message is
    usually displayed, telling you the cause of the failure.

HINT: If you see the window filling up with strange characters, many
                        of which are "}", this is an indication that you have made your
 	            connection but the script has not finished. Most likely, your
 	            script is waiting for a response from the server which is not
  	            being given. Check your script for possible errors, or use the
 	            Terminal function (see page 12) to access your service provider
 	            and check what happens during log in.

5. Once you have successfully logged in, the program will send and receive all 
    requested messages. When finished, the program will automatically log off, hang
    up, and display the results of the connection, including the number of messages
    sent and received, the total number of messages in your mailbox, and any
    communication errors that may have occurred. 

Receiving and Responding to Messages 

To receive messages

1. To receive e-mail, touch the MAIL screen button and select Receive Only or
    Send/Receive. 

2. When the Receive Mail window appears, you can choose to:

• Leave the messages on your server or delete them.

            • Retrieve all messages or only messages smaller than a particular size.

• By default, Z-Em@il retrieves all messages not saved in your IN folder.
  Checking this box tells Z-Em@il to retrieve only those messages that have
  never been retrieved (or checked) either with Z-Em@il or from a PC.

When you are finished, touch OK.

NOTE: Messages left on the server will not be received again if you
 		 keep them in your IN folder. Z-Em@il automatically checks
 		 these messages against those on the server, so that they are not
  		 received again.

3. The program will automatically dial up and connect to your server. After your
    messages have been downloaded, the program will automatically log off from the
    server and hang up the phone.

4. Touch the IN folder tab to see a list of all the messages you have received. To read
    a message, highlight it and press ENTER, or touch the VIEW button on the toolbar.

Responding to your e-mail

When you call up a message or highlight it in the folder, touch the EDIT screen button and you can respond to the message in one of three ways:

Reply to Sender: Z-Em@il

Automatically creates a message form containing a copy of the original message, pre-addressed with the sender’s e-mail address.

Reply to All: 

Automatically creates a message form containing a copy of the original message, pre-addressed with the e-mail addresses of the sender and any other recipients.

Forward Message: 

You can e-mail the message to another recipient.

Saving attachments: 

When you receive an attached file with your e-mail, you can save it to the PC Files area of your Zaurus by touching the ATTACH screen button (which takes you to the Message Attachments screen).

                     To save the file to the PC Files area, select DETACH. 

You can rename the file if you like, before saving it to the main memory of your Zaurus or to a PC card.  

                     Viewing attachments: 

RTF or text files can be viewed with the Zaurus "Documents" application. Excel-compatible spreadsheets can be viewed with the Zaurus "spreadsheet" application. For instructions on importing files from your PC files area, see your Zaurus manual.

To view other files, use a PC link program like RuppLynx® to transfer the file to your PC and run the appropriate PC application. 

Managing your messages 

Z-Em@il stores all of your messages in three folders:

• IN: Messages that you have received.

            • OUT: Messages that you will be sending.

            • SENT: Messages that you have mailed. 

Touch the appropriate tab to display a folder.

All of these folders allow you to...

Check the status of a message: 
            		
The icons at the left of each message point out:

    		High priority message

                     	Unread message

                     	Read message

                     	Low priority 

                     	File attached

            	Tag a message: 
	
The tag box at the left of the folder lets you highlight specific messages. 

            	Review or edit a message:
            
Touch the listed message twice. 

           	Delete a message:

Highlight the listed message and press DEL on your keyboard, or touch the Edit menu and select Delete message.

           	Delete all tagged messages:

Touch EDIT and select Delete Group. Highlight the Tagged Messages button and touch OK.

            	Delete all the messages in the active folder:

Touch EDIT and select Delete Group. Highlight the All Messages button and touch OK.

Browse through the details of each message: 

The folder lists the recipient/sender of each message, along with the subject and date.

Count the total number of messages:

The first number in the message counter at the upper right of the folder shows the number of the selected message. The second number is the total number of messages in the folder.

Copy a message as a Zaurus document: 

Touch UTILS and select Send to Documents. Z-Em@il will save the text of the message, as well as the sender, recipient, and subject of the message, as a file in the Documents section of your Zaurus. This allows you to edit the message with all the tools in the Documents application. Then if you like, you can copy and paste it to an outbound message.

Referencing your e-mail

Z-Em@il has a powerful Find function that helps you locate e-mail messages by any word contained in the body or heading of an e-mail message. To find a message:

1. Touch FIND. The Find Messages window appears.

2. Type the search word in the box titled All Entries Containing:

3. Select the folders you want to search. Then touch Done.

4. The first matching entry appears. To find the next entry that contains the search
    word, touch Next in the Find window. Continue until you find the message you
    need.

5. To go back to the previous message that contained the search word, touch Prev. To
    change the search word, touch Find String.

 

                       Troubleshooting 

This section answers questions you may have when  using Z-Em@il.

I can’t connect to my Internet provider.

                               Check the following:

                     • Modem settings.

                     • Modem connection to the unit.

                     • Modem connection to the phone line.

                     • Phone number prefix (if you are dialing from a location that needs 
                        additional numbers to access an outside line).

                     • Login script.

My Zaurus memory is full.

Delete data from the main memory (such as Documents, Notes, Contacts, Data Files, or old messages) to free up memory.

When your memory is exceptionally low, Z-Em@il may not run at all. After you free up some memory (by deleting entries from
other applications in your Zaurus), turn your Zaurus OFF and then ON. You will now be able to run Z-Em@il.

The program dials but the terminal window never appears. 

Check that you are using the correct Profile and that the phone number (in the DIAL-UP settings) is correct. If dialing from
outside your normal calling area, or when using an office phone system, you may need to add an area code, international dial                                code, or prefix. 

You can also try turning up the volume of your modem (in the MODEM setup). This helps you hear what happens when you
dial. You should hear a short number of rings, followed by the service provider reply (high pitched electronic noise). 

Or, use the Zaurus Terminal function to dial the number and see what happens during connection.
The program dials, the terminal window appears, but the login fails.

Touch Setup and select Comm’s Check, then try again. This setting displays additional information during communications. The left side of the screen shows the flow of TCP data between Z-Em@il and the server. The right side displays general communications information including all commands and responses exchanged between Z-Em@il and the server.

The program dials, but the terminal window does not close.

Your script has failed. Check your login script (found in the DIAL-UP settings of your Profile). You can use the Zaurus
terminal mode to check what your login script should do. By using terminal mode, you are making a log in via keyboard.
Simply identify the prompts and responses which should be put in your script.

I am unable to send messages.

            	Check the recipient list to ensure that the addresses are valid.

Communications stop and I do not connect with my POP3/SMTP server.

When using Comm’s Check you are likely to see a RESET message on the screen. In this case you should check that the IP address specified for your POP3 or SMTP server is correct (found in the E-Mail settings of your Profile).

I do not get past ‘PPP Negotiation…’

During PPP Negotiation, Z-Em@il and your Internet Provider decide what options and protocols to use. If PPP negotiation fails, then it is likely that your Internet Provider is not offering a set of options compatible with Z-Em@il. Contact your Internet Provider for assistance. If this doesn’t help, call Rupp technical support.

When receiving mail, communication ends and the Comms Check window shows ‘Mail login Error’.

Your User ID or Password for logging into the server was not accepted. Check your User ID and Password under the current
profile in E-mail. Or, if you had previous communication problems, your mail box may be locked and timing out. In this case, wait a while and try again. 

Sending / Receiving mail fails, and the Comms Check window shows a TCP communications error.

An error in communication occurred after access to the POP3 / SMTP server had been established. This error is also reported if you press ON to quit during this stage of communication. If this is a common problem, you should use Comm’s Check (Setup menu) to monitor what happens during communication. In particular, take note of the frequency and variation of the ‘TCP Send’ and ‘TCP Recv’ prompts, and the last command / response that was seen. Then, contact Rupp technical support with this information.

Sending / Receiving mail fails, and the Comms Check window show File Error.

Most likely you have run out of memory. This will be shown under ‘Error Description’. Remember that even sending mail requires some of your Zaurus’s memory, as a message must be spooled out before sending takes place. If a message cannot be sent, communication is stopped. You should free up some memory and then try again. Any unsent/unreceived messages will be transferred again.

This manual is Copyright © 1997 by RuppSoft, LLC. All Rights Reserved.
It may not be reproduced without the express written consent of RuppSoft, LLC.