         


                           WWW/LX

 
               Internet communication module
                             for

             HP 100LX / 200LX / 700LX / 1000CX




WWW/LX and Post/LX were developed entirely on the HP 200LX.
WWW/LX and Post/LX are commercial products by D&A Software, Inc.
(c) D&A Software Inc., 1996, 1997, 1998, 1999, 2000

WWW/LX User Guide
June 7, 2000
Prepared and edited by Avi W. Meshar, D&A Software, Inc.



=================
WWW/LX USER GUIDE


=================
TABLE OF CONTENTS

-- The Fine Print to Satisfy Our Lawyers
1. WWW/LX - Introduction
2. ABOUT THIS MANUAL - a review of the the manual's content
3. Quick Start Guide
   3.1 Installing WWW/LX - How to put WWW/LX on the Palmtop
   3.2 Quick Starting WWW/LX - Simple directions to start the
       program
4. WWW/LX - Connecting to the Internet
   4.1 WWW/LX Setup - How to setup WWW/LX
   4.2 Starting WWW/LX - How to start the program
   4.3 Command Line Parameters for WWW/LX - change
       parameters
   4.4 Configuration of WWW/LX - Configuration file contents
   4.5 Password Encryption - How to obtain the encrypted form
         of the Password
   4.6 Configuration File - WWW.CFG
         [Global] Section - Global settings for WWW/LX
         [Setup] Section - Names and descriptions of setups
         [Script] Section - Names and descriptions of scripts
         [setupname] Section - [CIS] Setup is shown and
           explained
         Scripts Sections - Details on what the scripts are,
           and how they work 
         Script Example - the [CIS_Script] is shown and
           explained
         Script Commands - Reference to the commands used in 
           scripts
   4.7 Using An Ethernet Card
   4.8 Using The Infrared Port and IrDA
5. Troubleshooting WWW/LX - Guidance on Problem Resolution
   5.1 Problems/Solutions - Pairs of problem/solution 
         describe most prevalent problems
   5.2 General Problem Determination and Resolution Approach
         How to solve problems
6. Glossary - Some definitions of terms used in this document

==============
THE FINE PRINT

As in most manuals, we have to start out with the stuff for
the lawyers. While we must ask that you read this section, in
general this is what it all means:

WWW/LX belongs to us, not you. What you bought was a right to
use WWW/LX. You can use it on as many computers as you'd like,
but each person that uses WWW/LX must pay for a copy.

You agree that you use WWW/LX at your own risk. We are not
responsible for anything that happens as a result of your use
of this software.

If you bought this program for use by the U.S. Government, the
Government is only allowed to use it for one person. (If we
don't include this stuff about FARS and DFARS, the Government
will assume that they can make as many copies as they would
like, and that they can do whatever they want with it. At
least they're trying to save us tax payers some money, but
sorry, we can't let them do it by pirating WWW/LX.)

_________________________
COPYRIGHTS AND TRADEMARKS

WWW/LX and the WWW/LX logo are trademarks of D&A Software Inc.
HP, HP 100LX and HP 200LX are trademarks of Hewlett-Packard
Company. All other product names are copyright and registered
trademarks/tradenames of their respective owners.

________________
LIMITED WARRANTY

WWW/LX is distributed on an "as is" basis. Neither D&A
Software Inc., nor the software author, guarantees this
program to be free from defects and may not be held
responsible for any losses caused, directly or indirectly, by
the use of this software. If you are not completely satisfied
with WWW/LX within thirty (30) days of purchase, you may
receive a refund of your purchase price, when you return all
items along with the proof of purchase to the dealer where you
bought WWW/LX. Further, since D&A Software Inc. does not have
any direct affiliation with Hewlett Packard Co., future models
of the HP Palmtop may not be compatible with WWW/LX. D&A
Software Inc. does not guarantee that updates will be
available to maintain compatibility with future HP Palmtop
models. Further, if updates are offered, an upgrade fee may be
required. Your use of this program constitutes your acceptance
of these terms.

______________________
DISCLAIMER OF WARRANTY

With the exception of the Limited Warranty stated above, D&A
Software Inc., and the software author, disclaim any and all
warranties, expressed or implied.

__________________________
USE BY THE U.S. GOVERNMENT

RESTRICTED RIGHTS: Use, duplication, or disclosure by the U.S.
Government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of the Rights in Technical Data and
Computer Software clause of DFARS 252.227-7013 or
subparagraphs (c)(1) and (2) of the Commercial Computer
Software Restricted Rights at 48 CFR 52.227-19.


========================
1. WWW/LX - Introduction

WWW/LX (pronounced "world wide web el ex" or simply "web el
ex") is a software package that allows to send and receive
Email and Newsgroups articles, and to access many other
services of the Internet, such as ftp, telnet, and IRC.

WWW/LX was written by Andreas Garzotto.

D&A Software Inc. wishes to thank the group of devoted Beta
Testers who helped make WWW/LX a high quality product. Also we
thank the PAL Group for the Palmtop Application Library (PAL),
and especially the coordinator of this effort, Mr. Gilles
Kohl. Mr. Harry Konstas creatively and patiently crafted
several icons for this product, and its logo.

Hewlett-Packard Corporation and its employees have provided
invaluable assistance and feedback during the development, and
we deeply appreciate their assistance.

There are many features built into WWW/LX.  Some of the
noteworthy features of WWW/LX are:

 Manages dialing, logging in, and scripting
 A complete TCP/IP Stack implementation
 Supports SLIP and PPP protocols as well as packet drivers
 Supports delayed login until a remote Web page is requested
  (saves online time)
 API allows other client applications to provide other
  Internet services
 Supports external modems, PCMCIA modems, or HP OmniGo 700LX
  datacards
 Supports speeds up to the maximum available on the Palmtop
  (14,400 baud on regular Palmtops, and approximately 20,000
  baud on speeded up Palmtops.) More using Ethernet cards.
 Supports IrDA infrared connections
 Requires approximately 500K on disk for programs and 
  auxiliary product files
 Easy setup and configuration
 Some additional setups and scripts are available on D&A
  Software Inc.'s Web page (http://www.dasoft.com). They
  have been tested and contributed by customers.

What is necessary to run this software:

 HP 100LX, HP 200LX, HP 1000CX, or an HP OmniGo 700LX Palmtop
  computer
 An external modem (and cables), or a PCMCIA modem, or a
  datacard, or an Ethernet card that works with the palmtop.
 An account with an Internet Service Provider (ISP) that
  supports SLIP or PPP access or a local Ethernet you can
  access.
 Free space on the disk sufficient to hold the programs
  (approximately 500K) and the downloaded information
 WWW.EXE version 3.0 or higher

To utilize Internet services such as E-mail and Newsgroups, an
application program that handles these services is needed.
Post/LX with ROBONEWS/LX provide the email and newsgroups
function for example. WWW/LX provides the connection to the
Internet for these application programs.


====================
2. ABOUT THIS MANUAL 

You may use this text file ("manual") for your own reference
in connection to your usage of the product called WWW/LX.

You may print this file for your own use only.

You may pass along a copy of this entire archive, provided it
is unchanged from the original. The most current files may be 
found on http://www.dasoft.com.

This manual contain the information necessary to use WWW/LX:

QUICK START GUIDE: Chapter 3 explains how to install WWW/LX
and how to start it.

WWW/LX - CONNECTING TO THE INTERNET: Chapter 4 explains how to
use the communication program of this product.

TROUBLESHOOTING: Chapter 5 provides a guide to resolving
problems.


====================
3. QUICK START GUIDE

_____________________
3.1 INSTALLING WWW/LX

Create a subdirectory for WWW/LX. Copy the following files
into that subdirectory on the Palmtop:

   WWWDOC.TXT     - This documentation file
   WWW.EXE        - The communication program
   WWW.ICN        - The icon for this program
   WWWSETUP.EXE   - The setup program for WWW.EXE

SETTING UP WWW/LX

To set up WWW/LX, a special program is provided, WWWSETUP.EXE.
Chapter 4.1 WWW/LX Setup, provides the specific details on
this program. WWWSETUP deals with choosing communication
parameters, and selecting ISP setups and scripts.

To run WWW/LX while IN System Manager (i.e. to have access to
the built-in applications such as Appointment Book or Memo),
install WWW/LX in the Applications Manager by running WWWSETUP, 
and let it install the application in the Application Manager 
menu. Chapter 4.1 WWW/LX Setup explains the "Install in 
AppMgr" button.

To obtain the maximum memory for running WWW/LX, it can be
run after terminating System Manager. To do that, terminate
all applications. Close all applications, then press the MORE
(or blue &...) key, then MENU, A, T, F10. This shuts down
the System Manager. (To start it up again enter the command
100 or 200 at the DOS prompt.)

Another alternative is to use MaxDOS. This program is 
available at http://www.palmtop.net/super.html. It maxmizes 
the amount of memory available for programs you run on the 
Palmtops. Our customers, beta testers, and the developer 
report very good results using this program.

_________________________
3.2 QUICK STARTING WWW/LX

After setting up WWW/LX with WWWSETUP (see previous paragraph,
and Section 4.1 WWW/LX Setup), you can start WWW/LX from the 
Application Manager screen, by selecting its icon and pressing 
the ENTER key.

To start WWW/LX from the DOS prompt, first terminate all
applications. At the DOS prompt, change the directory to the
WWW/LX directory, and enter:

   WWW

This command starts the program, connects to the ISP chosen
and establishes a SLIP or PPP connection. It then returns to
the DOS prompt and allows you to start any client, e.g.
POST/LX or TELNET/LX.

Chapter 4.2 STARTING WWW/LX, provides more information about
the command line parameters which may be used. 

To exit WWW/LX, type exit at the DOS prompt.

======================================
4. WWW/LX - CONNECTING TO THE INTERNET

________________
4.1 WWW/LX SETUP

WWW/LX must be configured before it can run properly so
that it can connect to the ISP. The information below will
be required during the setup process. All the items are
available from the ISP:  

 The phone number to dial the ISP
 Type of account with the ISP: SLIP or PPP
 The user name and password (sometimes called account name or
  login name)
 The IP address. This is not needed if your ISP supports
  dynamic IP address assignment. The great majority of ISPs 
  dynamically assign IPs during the login process.
 The IP address of the DNS (Domain Name Server) used by the
  ISP (and the secondary DNS IP address, if used.) This is not
  needed if your ISP supports dynamic DNS address assignment.
  Most ISPs assign the DNS IP addresses dynamically during the 
  login process. 
 The exact steps to dial in and establish the PPP or SLIP 
  connection (some ISPs already supply login scripts which show
  the steps involved in the login.)  

  Most ISPs use a login protocol called CHAP (or PAP). These
  login protocols (among others) are already supported by
  WWW/LX - use the CHAP script, included in WWW.CFG.

Select WWWSETUP.EXE from Filer application and press ENTER to
start it. WWWSETUP has context-sensitive help available by
pressing the F1 key.

When WWWSETUP is started you will see 4 buttons: Setup, Add
Script, Install in AppMgr, and Change Registration.

"Setup" helps you edit the entry for an ISP's Setup. To set
up other WWW/LX parameters, tab to the "Setup" button and
press ENTER or press F10. This brings up the Global Setup
dialog screen. See more below. Configuration templates for
many common ISPs are already included here.  You should first
check these and, if your ISP is included, simply enter your
own phone connection and account information here.  If your
ISP is not included, use the next button, "Add Script.

"Add Script" guides you in adding a script to the WWW/LX Plus
configuration file. 

"Install in AppMgr" installs the icon in the Application
Manager's icons menu. To install WWW/LX in the Application
Manager menu, tab to the "Install in AppMgr" button and press
ENTER, or press F8.  The dialog asks for the full path name
for WWW.EXE. The icon used is the same as appears on the
screen. 

"Change Registration" will take registration information. The
name to use and the registration code are provided when you
purchase a license for WWW/LX Plus.

If your copy of WWW/LX is not registered, it will still work
but is limited to transfer no more than 16K per session. This
allows you to evaluate the program and its abilities and
decide if you wish to purchase a license for it. You may use
the command R in POST/LX to send an encoded email to D&A
Software Inc. to purchase a license and register the program
via email. (More details are included in the accompanying
Readme file.)


GLOBAL SETUP

The first item to set up is the path and name of the program
that should be launched after WWW/LX starts up. By default,
this is COMMAND.COM, the DOS command line processor. Enter here
the exact path and program name, e.g. "C:\WWW\POST.EXE".

The next item is the name of the "address cache" file. The
default file name may be used. You must enter a pathname of an
existing subdirectory in your palmtop. 

 |  Note: Host computer names such as "www.dasoft.com" must 
 |  be translated to a numerical address ("IP address") 
 |  before they can be used. The translation is done by 
 |  "domain name servers" ("DNS") which are connected to the 
 |  Internet. WWW/LX contacts the DNS to translate a host 
 |  name to an IP address. These addresses are typically 
 |  static, i.e. a host name translates to the same IP 
 |  address. WWW/LX caches (keeps in memory) the last few IP 
 |  addresses that were requested. It saves time during the 
 |  communication because WWW/LX does not need to contact a 
 |  DNS again.  

The rest of the dialog consists of setup alternatives. The
currently active setup is marked with a diamond character ().

To select another Setup, highlight it and press the Space
Bar. To edit a Setup, highlight it and press the ENTER key.
It is a good idea to edit the Setup chosen before using it.

To add a new Setup press the Plus key (+). The new Setup
contains the same data as the currently highlighted Setup.
This helps create similar versions of the Setup without
having to enter all the information.  

To delete a Setup, highlight it, and press the Minus key (-).

Choose and highlight the Setup that is appropriate for your
ISP. Several ISPs already have a preset entry provided with
WWW/LX. If not found, D&A Software Inc.'s Web page (at
http://www.dasoft.com) may have an appropriate ISP Setup and
script. These were contributed by other customers.

When editing or adding a Setup, the dialog prompts for the
following information:  

Modem Type    Select the type of modem used. For an HP OmniGo
              700LX use "OmniGo".  

Modem         Check this box if a modem is used. Leave it blank
              if a direct serial line to an ISP is used.

Baud          Enter the baud rate for communication with the
              modem. In most cases 9600 is an appropriate 
              value, and it is the default value. In many 
              cases, 19200 may also work. (Valid values are 
              1200, 2400, 9600, 19200, 38400, 57600, and 115200
              baud). 

              | For 14400 modems, use 19200. Consult the 
              | manufacturer of PCMCIA modems to determine if 
              | the PCMCIA modem card works with the Palmtop.
              |
              | Clearly, speeds over 19200 will generally not
              | work with the Palmtop. The reason they are 
              | available is that many customers use WWW/LX on
              | their desktop machines, which are capable of 
              | very high communication speeds.
     
Communication   Select the type of account: SLIP or PPP. Most 
              ISPs use PPP. If you do not know, try PPP. 

ModemInit     Enter the string that should be used to 
              initialize modem. In many cases ATZ (reset the 
              modem) works well. AT&F also works with many 
              modems, initializing them to the "factory 
              settings".

Dial          Enter the string to be sent to the modem to dial
              up the ISP. This string usually consists of 
              "ATDT" plus the phone number. If the phone line 
              does not support tone dialing, use "ATDP" instead
              of "ATDT".

Login         Enter the login name (or user name, or user ID, 
              or account name - ISPs call this identifier by
              many names.) 

Password      Enter the password. Thes password will be 
              encrypted when the configuration file is saved. 
              Next time this dialog is entered the password 
              will be replaced by several asterisks characters
              (*) for the safety of the password.

IP            Enter the IP address. This field should be filled
              ONLY IF a fixed IP address is available (PPP 
              connections usually do not have a fixed address.)

DNS           Enter the IP address of the DNS server. If the 
              ISP supports dynamic DNS address assignment, a 
              DNS IP address is not required.  

Alternate DNS   If the ISP has provided a secondary DNS IP 
              address, enter it here, otherwise ignore this 
              field.

Dialing Script   Select the dialing script that is appropriate.
              If one of the preinstalled Setup alternatives was
              chosen, this field will already be filled 
              appropriately (e.g. CIS_Script for CIS, or
              CHAP_Script for many PPP accounts). If a custom 
              Setup is defined the new script name must be
              chosen in this field. 

              To create a new script, edit the file WWW.CFG 
              using a text editor, e.g. Memo. See the script 
              section for details about how to write scripts.

              Note: D&A Software Inc. Web page also has several
              scripts. They may be downloaded, placed on the 
              Palmtop, and included in the configuration file 
              by using the "Add Script" button in the initial
              screen of WWWSETUP.)

When the information has been filled, press F10 to accept the
change. To complete the Setup and leave WWWSETUP, press F10
again.  

WWWSETUP checks if the values are valid, and displays a
warning for each value it detects which may not be correct,
naming each one. If the warning(s) appears, restart WWWSETUP,
check and correct the values in error.


___________________
4.2 STARTING WWW/LX

To start WWW/LX from the Applications Manager screen, select
the icon and press ENTER.

To start WWW/LX from the DOS prompt, terminate all
applications first. At the DOS prompt, change the directory
to the WWW/LX directory, and enter the prompt:

   WWW

This command starts the program, connects to the ISP and
establishes a SLIP or PPP connection. Then it is ready to run
some Internet client program, e.g. POST/LX or IRC/LX.


__________________________________
4.3 WWW/LX COMMAND LINE PARAMETERS

There are two ways to configure WWW/LX. WWWSETUP, discussed
in a previous chapter, is one way. WWWSETUP makes permanent
changes to the parameters in the configuration file WWW.CFG.

To make temporary changes that affect only one execution of
the program, it can be started with command line parameters.
For example, starting WWW/LX with a different Setup then the
one chosen in the Global Setup Screen is such a temporary
change. Another example: Using the command line parameter -d
directs WWW/LX to delay dialing until such time that a Web
page is requested that is not on the Palmtop.

Setup parameters may be replaced by new values by using their
names on the command line and providing a new value for them.
For example:     

  WWW -d CIS Dial=atdt9876543210  

This command starts WWW with a delayed connection. It directs
WWW/LX to use Setup CIS, but to use the string
"atdt9876543210" to dial (a different telephone number). The
syntax for the startup command is:

   WWW [-d] [<setup name>] [!<command>] {<setup_var>=<value>}

This command line contains the following:

WWW           this the program name.

-d            [optional], delays the dialing and connection
              until a page is requested that cannot be found on
              the Palmtop. This minimizes connection time.

setup name    [optional], the name of a setup in the 
              configuration file. 
  
!<command>    [optional], directs WWW/LX to execute the 
              command in the parameter. This is useful to start
              a program other than the one entered in the 
              WWWSETUP Global Setup screen in the field "When 
              online, launch:". 

<setup_var>=<value>   [optional, multiple parameters
              allowed]. <setup_var> is replaced with a name of
              a variable from the Setup. <value> is replaced
              with a new value assigned to the variable. In
              the example above, variable "Dial" is assigned
              the new value "atdt9876543210".


___________________________
4.4 CONFIGURATION OF WWW/LX

In most cases, WWW/LX can be set up by using WWWSETUP.EXE. If
there is something special about the Internet access used,
then the configuration file WWW.CFG must be edited directly.
WWW.CFG holds the complete Setup for WWW/LX and can be edited
using any text editor, for example, PalEdit or Memo.


_______________________
4.5 PASSWORD ENCRYPTION

The password is stored in the configuration file in an
encrypted form. The password entered in the WWWSETUP Setup
Dialog screen, will be encrypted then saved in the file. To
enter the password in the file when editing manually, the
encrypted form must be used. To find the encrypted form of the
password, run WWWSETUP as follows:

   WWWSETUP <password>

The password is then encrypted and displayed on the screen.
It is also placed in the clipboard (so it can be pasted into
a file) if WWWSETUP is running under the System Manager.   

If you enter the password manually into WWW.CFG, you must
enter it EXACTLY as WWWSETUP shows it. 


______________________________
4.6 CONFIGURATION FILE WWW.CFG

The entries of this file are explained below. The
configuration file is structured in sections. Each section
has a heading that is enclosed in square brackets.

Note: The spaces surrounding the equal sign (=) are for
readability only, and are ignored.


[GLOBAL] SECTION

UserName = Your Name 
              Specifies your UserName. (See Note in RegID
              below).

RegID = 123abc456def  
              Specifies the registration code. 

              | Note: WWW/LX will function without a valid
              | UserName and Registration Code in the Demo
              | mode. In this mode, your transmission will be 
              | restricted to 16K of data only. You will have 
              | to restart the program when this limit has been 
              | reached. This allows you to connect, try some 
              | browsing, even send and receive some Email or 
              | a few Newsgroups articles. For a full,
              | unrestricted usage, you must register this
              | program and pay for the license. See the 
              | README.TXT file in this package, or refer to 
              | our Web page at http://www.dasoft.com for 
              | details.

Command = a:\www\post.exe
              Specifies which command to execute when the 
              connection is established,

Hosts = c:\www\hosts
              Specifies path and filename of the optional
              "address" file. It may hold IP address - site
              name assignments. If an assingment is found in
              that file, the IP address is taken from there
              instead of looking it up using the DNS service.

Setup = CIS   Specifies which Setup to use for the next login.
              The name provided here refers to an entire 
              section (in this example to the section [CIS]) in
              the Configuration file. The sections may be named
              as desired. There may be several Setup sections,
              each fitting a different ISP.

              | Note:  The Setup section name to be used can be
              | provided on the command line which starts WWW.
              | For example:
              |
              |    C:\WWW>WWW ISP_PPP  
              |
              | will override the choice of CIS Setup (in 
              | Setup=CIS) and use the Setup section named 
              | ISP_PPP from the configuration file.  

Log = C:\_DAT\WWW.LOG
              Directs WWW/LX to append an entry to the file 
              specified when it exits. The entry consists of 
              the date and time when WWW/LX exits, the number
              of seconds connected and the Setup that was used.
              Each line is similar to the one below:

                 96,08,18, 10,10,44,   21,"My_ISP"

              Where 96 is the year, 08 the month, 18 the day, 
              10 the hour, 10 the minutes, 44 the seconds, 21 
              the number of online seconds and My_ISP the name
              of the Setup that was used. This format can be 
              easily imported into applications such as Lotus
              123.  


[SETUP] SECTION

This section contains a list of the names and descriptions of
the each of the Setup sections. 

   name = description 

For example:

   CIS = CompuServe
   ISP_PPP = Other ISP using PPP

A Setup section contains information that describes the
connection to a specific ISP. Each name in the list above,
also appears later in the WWW.CFG as a section with parameters
describing a connection to an ISP.


[SCRIPT] SECTION

This section contains a list of the names of the scripts 
entries with a description for each script. Each entry looks
like this:

   name = description

For example:

   CIS_Script = CompuServe dial up
   ISP_PPP_Script = Generic PPP (needs to be modified)

Each script is a list of commands (actions) that WWW/LX is to
take during the process of connecting with the ISP. These
commands include sending information, waiting for certain
information from the ISP, and others. See section on 
Scripts.


SETUP SECTIONS

Each Setup named in the [Setup] Section has its own section,
describing its characteristics in detail. In the example
there were two Setups: CIS and ISP_PPP. Each will be
described in a section. For example, the [CIS] Setup is
explained below. 


[CIS] SECTION

A similar section repeats for each Setup, using the Setup name
in the square brackets ([ ]). The default values are shown
here.

Port = 1      Specifies the serial port to be used. "1" refers
              to the built-in port and "2" to a serial port on
              a PCMCIA card, e.g. a modem card. "-1" refers to
              the infrared port.

Baud = 9600   Specifies the speed to use for communication with
              the serial port.

Modem = 1     Specifies if a modem is used or a direct serial 
              line. "1" means a modem is used and "0" means a 
              direct line.

OmniGo = 0    Specify OmniGo=1 if the HP OmniGo 700LX datacard
              should be used. Otherwise, specify OmniGo=0.

PPP = 1       Tells WWW/LX if the account with the ISP uses
              SLIP or PPP. PPP=1 means PPP protocol is used,
              and PPP=0 means SLIP protocol is used.

              | NOTE:  If both connection types are supported 
              | by the ISP, we recommend SLIP for the Palmtop 
              | because it requires far less computational 
              | overhead and is less straining on the Palmtop.
              
My_IP = 0.0.0.0  Specifies the assigned IP address, if a fixed
              (static) IP address is used, otherwise WWW/LX 
              will determine it dynamically during the login
              process.

Peer_IP = 0.0.0.0 Specifies the IP address of the default
              gateway, i.e. the machine that the palmtop
              should talk to. This is only needed together
              with "Ether=1".

DNS_IP = 0.0.0.0  Specifies the IP address of a DNS. We have
              already included some of the DNS IP addresses in
              the default WWW.CFG. (See previous explanation
              for the meaning of DNS).

DNS2_IP = 0.0.0.0  Specifies and alternate DNS that should be 
              used if the primary is not running or cannot 
              resolve the address.

Ether = 1     Enables packet driver support. Instead of a
              serial port, a packet driver is used.
              
Login = username  Specifies the login name to be used by the 
              dialing script. Sometimes this is called 
              username, or account ID by the ISPs.

Password = XYZ  Specifies the password used by the dialing 
              script, along with the login name. Note that the
              password is saved in an encrypted form. Use
              WWWSETUP to modify this value.

ModemInit = ATZ  Specifies the string that should be sent to 
              initialize the modem. Some PCMCIA modems require
              AT&F (EXP modems, for example) to reset them 
              properly.

Dial = ATDT1234567  Specifies the modem command and number to
              dial to the ISP.

HTTP_Proxy=host.subdomain.domain:8080
              Use this entry if the Internet connection
              requires a proxy server. If the information
              obtained from the ISP does not refer to a proxy 
              server, this entry may be ignored.  

Script = CIS_Script  This is the script used to dial the ISP 
              and establish the connection. As with the Setup 
              entry in the [Global] section, this refers to an
              entire section in the WWW.CFG, ([CIS_Script] in 
              this example), which contains the actual script.


SCRIPTS SECTION

The script names and their descriptions are contained in the
[Script] section. Each Setup uses a script to establish the
connection. A script consists of a sequence of "send"
(directing WWW/LX to send specific information) and "wait
for" (directing WWW/LX to wait for information coming from
the modem or ISP) requests and a few other simple commands.
(In the case of CHAP Script, the script consists of only very
few commands, since the exchange of information occurs in a
standardized form of information "packets", and does not
depend on prompts.)


SCRIPT EXAMPLE

The script that dials into CompuServe and establishes a PPP
connection is reproduced below. First the full script
followed by a detailed line by line explanation:

e = Initializing modem
m = 
s = \r
w = 5 OK
d = 
s = \r
w = 75 CONNECT
@ = 1
e = Connecting to CIS
s = \003
w = 15 D:
e = Sending login
l =
s = +/GO:pppconnect\r
w = 10 word:
e = Sending password
p =
s = \r
e = Waiting for CIS to respond
w = 40 PPP

And In detail:

e = Initializing modem
              Displays (echoes) the words "Initializing modem"
              on the screen.

m =           Sends the modem initialization string as 
              specified by ModemInit in the Setup.

s = \r        Sends a carriage return ("\r"). (This is like 
              pressing the Enter key on the keyboard.)

w = 5 OK      Waits for the reply "OK" from the modem. The 
              program will wait for 5 seconds. If the string 
              does not appear after 5 seconds, the script 
              aborts.

d =           Send the dialing string as specified by the Dial
              parameters in the Setup.

s = \r        Sends a carriage return to complete the dialing
              by the modem.

w = 75 CONNECT   Waits for a maximum of 75 seconds or until the
              string of characters "CONNECT" is received from 
              the modem. If "CONNECT" is not received, the 
              script aborts the connection.

@ = 1         Pauses for 1 second before proceeding with the 
              next command in the script.  

e = Connecting to CIS
              Echoes the words "Connecting to CIS" to the 
              screen.

s = \003      Sends a CTRL-C character (ASCII 003).

w = 15 D:     Waits for up to 15 seconds for the string "D:" to
              be sent back to the modem. This is the last two 
              characters in the string "User ID:" which CIS
              sends.

e = Sending login
              Echoes the words "Sending login" to the screen.

l =           Sends the login name as specified by the Login
              parameter in the Setup.

s = +/GO:pppconnect\r
              Sends a string to tell CompuServe to GO 
              PPPCONNECT, i.e. open a PPP connection.

w = 10 word:  Waits for up to 10 second for the string "word:"
              to be sent to the modem. This is the last part of
              the prompt "Password:" which CIS sends.

p =           Sends the password (unscrambled) that was
              specified by Password in the Setup. (WWW/LX will
              unscramble the password just for the purpose of
              sending it to the ISP.)

s = \r        Sends a carriage return to mark the end of the 
              password.

e = Waiting for CIS response
              Echoes "Waiting for CIS response" to the screen.

w = 40 PPP    Waits for up to 40 seconds for the string "PPP".

This is the end of the dialing script. When WWW/LX reaches this
point the PPP connection should be open.


SCRIPT COMMANDS

These commands may be used in a script section:

d =           Sends the dialing string (without a carriage
              return).

e = <string>  Echoes <string>. This is useful to see a 
              progress report as the login proceeds.

i =           Interprets the incoming string as an IP address.
              Nothing is entered after the "i =".

              | Some ISPs will send a string such as "Your IP
              | address is 111.222.333.444" to provide the 
              | assigned IP address in the current session. 
              | The following commands capture the IP assigned
              | and set it up for WWW/LX:
              |
              |   w = 5 IP address is
              |   i =
              |
              | This command sequence waits for up to 5 seconds
              | for the string "IP address is" coming from the
              | modem, and then captures the IP that follows
              | this string.

l =           Sends the login name (without a carriage return).

m =           Sends the modem initialization string (without a
              carriage return).

p =           Sends the password (without a carriage return).

q = <msg>     Prompts with the text <msg> and waits for
              keyboard input. It will send the string that was
              entered. Useful with credit card numbers, for
              example, or devices that display random
              passwords for the user to input.

s = <string>  Send a <string>.

              The string "\r" (without quotes) is translated to
              a carriage return.

              The string "\n" (without quotes) is translated to
              a linefeed.

              The string "\\" (without quotes) is translated to
              a single backslash character (\).

              The string "\ddd" (without quotes), is translated
              to the character with ASCII value ddd in decimal.

w = <time> <string>
              Waits for <time> specified in seconds for a 
              <string> to be sent to the modem. 

@ = <time>    Pauses for <time> in seconds before proceeding
              with the next command.

;             This command line is considered a comment and is
              ignored.


__________________________
4.7 USING AN ETHERNET CARD

Starting with version 2.0 of WWW.EXE, connections by means of
an Ethernet card are supported in addition to connections
using a serial line.

In order to use WWW.EXE with an Ethernet card, the following
needs to be done:

- Make sure a packet driver is installed and running before
  WWW.EXE is launched. Note: the default interrupt for packet
  drivers is 0x62. However, the stopwatch application on the
  palmtop uses this interrupt, so 0x66 is recommended instead.
- Create a setup for access using the Ethernet card. Note that
  the settings for all modem related entries are irrelevant.
- Edit WWW.CFG using a text editor, go to the newly created
  section and add the lines:
     Ether=1
     Peer_IP=123.456.789.123
  where 123...123 should be replaced by the Internet address
  of the default gateway.
- If your IP address or the IP address of the default gateway
  are not fixed, they can also be provided to WWW.EXE by
  setting the environment variables MYIP and REMIP.
- If the network does not support the ARP protocol, you can
  specify the Ethernet address of the default gateway by
  specifying Ether=0.0.123.42.47.98 instead of Ether=1, where
  the numbers are the decimal representation of the default
  gateway's Ethernet address.
- If the network does not support the original DIX Ethernet
  protocol, but requires the IEEE 802.3 protocol, add the line
  DIX=0.

In most cases, all you need to do is to add Ether=1, set
Peer_IP and My_IP and WWW.EXE should be able to talk with the
packet driver for your Ethernet card.

____________________________________
4.8 USING THE INFRARED PORT AND IrDA

Starting with WWW.EXE version 2.1, WWW/LX supports the
built-in infrared port of the palmtop and can talk the IrDA
protocol. There is an increasing number of cellular phones
with built-in modems that can be used that way. 

Here is how to set up an IrDA connnection:

 - Configure a setup entry in WWW.CFG so that "Port=-1"
 - Set Baud=38400 for a double speed or Baud=19200 for a
   regular palmtop
 - Place the phone so that the IR ports face each other
 - Set the phone to IR mode
 - Start WWW.EXE

Note that the infrared hardware of the palmtop is heavily
affected by disturbances most GSM phones create, especially if
the GSM signal strength is low and the phone need to transmit
using high power levels. Therefore, you may find lower
transmission rates than with a wired connection. With some
phones, the disturbances may even be so strong that the
connection is aborted.


==================
5. Troubleshooting

Many of the questions here were raised and resolved during
the testing of the product. If the situation encountered is
not resolved by one the problem/solution pairs, the next
section describes a general approach to problem determination
and resolution.

PROBLEM: There is no script for my particular ISP. How can I
create one?

SOLUTION: Ask the ISP for detailed instructions on the login
process. The built-in DataComm application can be used to try
out the commands, and to determine response from the ISP.
Record these carefully. (DataComm cannot be used to start up
SLIP or PPP connection, but all the steps up to that point
may be done in this fashion.) The recorded interaction is the
basis for the script that must be created. (D&A Software
Inc.'s Web page contains scripts for some ISPs, which  are
not included in the configuration file. These scripts may be
downloaded and included in the configuration file. Not all
ISPs are represented, since there are thousands of ISPs
worldwide, and many implemented their own interactions and
prompts. Many ISPs are moving toward using CHAP as the
standard protocol to login. See other sections in this guide
for discussion about CHAP Protocol. The Web page is at
http://www.dasoft.com.)

PROBLEM: I get a "modem is not ready" message. 

SOLUTION: First, make sure the modem is connected. For older
or very slow modems, try adding the line "SlowModem = 1" to
the Setup section being used. This command slightly delays
outgoing characters. 

PROBLEM: "Timeout or user interrupt while waiting for..."
during connections at startup. 

SOLUTION: Pressing the CTRL key interrupts the connection
procedure, or WWW was waiting for a string that was not
received. Check the Setup! Most probably a setting is incorrect
or the dialing script is incorrect. If WWW/LX is waiting for
"OK", most probably one of the following parameters is not
set properly (in WWWSETUP): Modem checkbox, modem
initialization, PCMCIA/Internal setting. If WWW/LX stopped
while waiting for some other string, check what it is and
check the script for the line that starts with "w =" and then
that string. Something immediately before that location must
be wrong or the string itself is incorrect (uppercase and
lowercase in these strings makes a difference.)  

PROBLEM: PPP negotiation goes into a loop during the LCP
negotiation. 

SOLUTION: Add the line "@ = 2" to the end of the script. Some
PPP servers require to "have the first word". The short delay
will provide them with the opportunity to do so.  

PROBLEM: The service I use sometimes drops the line suddenly,
or seems to be extremely slow to respond. 

SOLUTION: Contact the ISP. There may be a problem with their
service.  

PROBLEM: After a while, the connection is dropped without any
apparent reason. 

SOLUTION: Try adding the line "CarrierDetect=0" to the
corresponding Setup entry in WWW.CFG. This disables carrier
detection. If this helps, the carrier signal is not carried
properly over the phone line or the modem does not handle the
carrier signal properly.  

If you run under System Manager, make sure the entry in the
Application Manager (icons menu) defeats System Manager
interference with communication. To do this, press the &...
(MORE) blue (or green) button. Highlight the WWW/LX icon, then
press EDIT (F3). the third field "Comments", should contain an
upside-down exclamation mark (). If not, tab to the field,
then press FN-! to produce an upside-down exclamation mark.
This will stop System Manager interference with the
communications port (this is true for COM1 and COM2!).

PROBLEM: Under System Manager, WWW connects, but then displays
the message "Cannot launch xxx". 

SOLUTION: Either the path for program xxx is specified
incorrectly in WWWSETUP (WWWSETUP warns about that) or, more
likely, there is not enough memory. Make sure there is at least
300k available (the Application Manager screen contains this
information) by removing unnecessary TSRs. 

PROBLEM: Under System Manager, suddenly, no site can be
accessed anymore, all communication seems to have stopped. 

SOLUTION: System Manager interferes with the serial port unless
WWW/LX starts from the Application Manager and the entry in
the Applications Manager for WWW/LX has an upside-down
exclamation mark () in the Comments field. (The upside-down
exclamation mark can be produced on the Palmtop by pressing
the FN-! keys.)

_____________________________________________________
GENERAL PROBLEM DETERMINATION AND RESOLUTION APPROACH

In the previous section there were many tips on solving
specific issues. Not all the problems can be foreseen, of
course. This section provides general guidelines on how to
determine what the problems are and how to resolve them.

D&A Software Inc.'s Web page includes several FAQ Files
("Frequently Asked Questions") with material that may help in
resolving some problems. The support personnel at the dealers
where the product was purchased are also trained to solve
many problems. Finally, posting email to D&A Software Inc.
Technical Support at the Web page (at http://www.dasoft.com)
will reach us.

1. By far, the most problematic issue for WWW/LX Plus is
available memory. Provide as much memory for WWW/LX to run
in. Many problems relate to lack of memory availability.

Many users reports excellent results with a program called 
MaxDOS. Tis program maximizes the memory available to program 
you run on the Palmtop. This program is available at 
http://www.palmtop.net/super.html.

WWW/LX and its clients make very efficient use of the sparse
memory available in the Palmtop, and can thus run within the
System Manager. However, open applications and TSRs consume
memory rapidly, and may leave insufficient memory to run WWW/LX
and some client.

   Run WWW/LX after shutting down System Manager. This
    provides additional memory.

   Remove any unnecessary TSRs.

2. Some TSRs may conflict with the management of the serial
port.

The entry for WWW/LX in the Applications Manager menu should
also include the upside-down exclamation mark () in the
Comments field. This character directs System Manager to stop
any interference with the serial port. To produce this
character in the Comments field, press the keys FN-!.

If a TSR is suspected, remove it temporarily from the
AUTOEXEC.BAT or CONFIG.SYS file, then reboot the Palmtop.
Rerun WWW/LX and observe the behavior. On rare occasions, an
interaction between TSRs can also create an error condition.
Removing TSRs one at a time is time consuming, no doubt, but
also helps point out directly where the problem occurs.

3. In some cases it is not clear if the connection is made.
In some cases the ISP may experience delays in establishing
the connection. During the trials, delays up to 40 seconds
were occasionally seen. In addition, some ISPs implement
their protocol in a non-traditional manner which may not be
accounted for by the script.

WWW/LX will display whatever is received when it times out, 
which may provide valuable clues to the nature of the problem
and how to resolve it.

==========
6. GLOSSARY 

BROWSER       A browser is a program that browses through a
              special kind of data. In this case, the data is 
              hypertext. The browser visualizes the data as a 
              hypertext and moves around in the file. HV is 
              such a browser.

HTML          HTML (HyperText Markup Language) provides a 
              simple but very powerful means of representing 
              hypertexts. The World Wide Web (WWW) consists 
              mainly of HTML documents. HTML is basically plain 
              text, with so called tags enclosed in angular
              brackets (< and >) that specify special elements. 
              For example:

              <em>Emphasized text</em>

              specifies that the text enclosed in the tags will 
              be displayed using the emphasized font.

HYPERTEXT     A hypertext is an extension to a normal text. In
              addition to the textual data, a hypertext also 
              contains links, which are references to other 
              documents or other places within the same 
              document. To read a hypertext, a special browser 
              is usually necessary.  

INDEXING      When loading a document for the first time, an 
              index is generated. Using an index improves
              access speed significantly, especially for large 
              documents. The index is computed once and the 
              results are placed into two files. Accessing the 
              same document again does not require computing 
              the index values again. The index files have the
              same name as the HTML document but have a .PAG 
              and a .LAB extension.

              If, for any reason, one of these index files is
              corrupted, the index can be rebuilt at any time 
              by choosing the "Rebuild Index" from the File 
              Menu or by pressing CTRL-I.

              Indexing takes place in the background, but HV 
              places the text "Indexing" on the title bar 
              during the process. There is no need to wait for 
              the indexing to complete, and most operations are 
              available.

INLINE IMAGES    HTML supports two ways to integrate an image
              into the WWW:  

              (1) A link points to an image (much like a link 
              pointing to a different part of the hypertext. To
              see the image, you must follow the link (by 
              highlighting the link and pushing the ENTER key.)

              (2) An Image file name is integrated into the
              currecnt page and it "floats" within the text.
              This is called also "inline image". The browser 
              (HV, in this case), will display a GIF image with 
              the text surrounding the image (GIF display
              toggle must be on, of course). HV does not
              support inline display of JPEG images (with 
              extension .JPG). 

INTERNET      The Internet is a worldwide "virtual" computer
              network. "Virtual" because it does not consist of 
              any special type of hardware (many types of 
              hardware are actually used), but instead a set of 
              standards defines how data is sent from one
              location to another. The most important among
              these standards are IP (Internet Protocol) and 
              TCP (Transport Control Protocol). The IP Standard 
              defines the structure of packets of data, and how
              they are transported from the source machine to
              the destination machine. The TCP Standard 
              ascertains that all packets arrive unchanged and 
              puts the packets together in the correct order to 
              form one stream of data. Most other Internet 
              standards are based on TCP and IP.  

ISP           Internet Service Provider. To gain access to
              documents on the WWW, the Palmtop must be
              connected to the Internet. ISPs offer the 
              connection service, most of the time using a dial 
              up telephone line and a modem.  

URL           Uniform Resource Locator. A URL identifies a 
              single document on the WWW. A typical URL may 
              have this structure:  

              http://host.name.com/my_dir/my_document
  
              The part which precedes the semicolon (:) 
              specifies the retrieval method (here http, which 
              means using the HTTP Protocol.) The part 
              following the forward slash characters (//) 
              specifies the machine where the document is 
              located (here it is host.name.com.) The remainder 
              of the URL (here /my_dir/my_document) specifies 
              the path and file name of the document on that 
              machine.  

WWW           World Wide Web. The WWW is a worldwide
              distributed hypertext that is built upon the 
              Internet. Each document seen can be located on a 
              different machine somewhere in the world. 
              Everyone may contribute a new document, which 
              then automatically becomes part of the WWW. 

