Help Contents
Contents

Overview

Functionality

Foray PPP Client Workstation Package

Registering Foray PPP Client

How to Register Foray

A Note About Electronically Distributed Software

License Agreement

Install Reference

Path Selection

Group Selection

Uninstall Options

Menu Command Reference

Actions Menu

Options Menu

Setup Menu

Help Menu

Reference

Advanced Driver Setup

AUTOEXEC.BAT Install Modifications

Automatic Dial Option

Autoset Driver Variables

Baud Rate

Default Remote server Option

Dial Timeout Setup

Driver Setup

Remote server Setup

Modem Dial Prefix

Modem Dial Suffix

Modem Init string

NET.CFG Install Modifications

Password Setup

Permanent Virtual Swapfile

Phone number Setup

PROTOCOL.INI Install Modifications

Saving the Password

Scriptfile Setup

Selecting a Modem

SYSTEM.INI Install Modifications

User ID Setup

User Location Setup


Functionality

The Foray PPP Client allows remote workstations running Windows 3.x and Windows for Workgroup 3.11 to access corporate resources through a PPP communications server.

Creates Remote Windows Workstation

·	Provides standard Microsoft Windows interface

·	Includes an easy to reference phonebook

·	Offers an autodial feature...

·	Arrives preconfigured for most 19.2 and 28.8 modems

·	Supports deferred connection under Windows

·	Supports server callback

·	Supports API for writing programs to the control dialer

Provides Multiprotocol PPP Driver

·	Supports PAP  for user authentication

·	Sustains TCP/IP and IPX/SPX sessions, separately or concurrently.

·	Supports most  third-party TCP/IP protocol stacks

·	Supports dynamic IP address allocation for Microsofts TCP-32 and Novells Lan Workplace stack

·	Includes Van Jacobson TCP/IP  header compression

·	Includes IPX header compression

Command Line Parameter for Foray PPP Client

ewuserw [-i]

The optional "-i" command line parameter will cause Foray PPP Client to read the default user, modem and phonebook values in EWUSER.INI file and pass them to EWPPP.  The Control Panel exits after completing this operation.


Foray PPP Client workstation software components
Foray PPP Client Workstation Package

The Foray PPP Client Workstation,  in its uncompressed format, contains the following files:

README.1ST	The README file included in the Foray PPP Client bundle just before it is posted on our ftp site. It contains an overview of the install process , a summary of the licensing agreement, and a list of  files which should be included in this Foray PPP Client bundle.

LICENSE.TXT	The complete Foray PPP Client licensing and registration agreement for evaluation users.

DISCLAIM.TXT	A legal liability statement from TechSmith about the Foray PPP Client: if you do not register, we take no responsibility for its effect on your system.

QCKSTART.TXT	A summary of the README and INSTALL files which outlines the install process and the potential system conflicts for the expert user.

INSTALL.TXT	A copy of the system requirements, install and configuration instructions for Foray PPP Client.

FEEDBACK.TXT	A form which you can use to send us your feedback about the Foray PPP Client.

SUPPORT.TXT	A customer survey about how well our support and documentation serves you.  Please fill it out and return it to us.

CATALOG.TXT	A convenient catalog of other TechSmith products.

4APPPCLN.DOC	The Foray PPP Client manual in Word 2.0 format.  If you would like a postscript or text document, email techdoc@techsmith.com.

REGISTER.INI	For preregistered versions only, a file which contains the registration number of the software. (This file is normally generated by the registration utility included with  the evaluation version Foray PPP Client.)

VENDOR.DIZ	A special file for vendors containing product information in ascii text and standard tools for electronic distributors.

SETUP.EXE	The installation program for installing an Foray PPP Client workstation from Windows.

SETUP.INS	Supporting file for Windows setup.

CHK16550.EXE	Utility program to check the workstation's serial port for a 16550 UART.

EWCMD.EXE	A workstation command-line interface for operating the workstation communications driver.

EWCONFIG.EXE	Foray PPP Client configuration dynamic link library, used by the Windows based Control Panel.

EWMODEM.INI	File containing default modem strings for Foray PPP Client workstations; accessed by Foray PPP Client Control Panel.

EWPPP.EXE	The Foray PPP Client ODI-compliant workstation driver, which loads as a TSR.

EWUSER.EXE	The Foray PPP Client Control Panel program, for configuring and operating the Foray PPP Client workstation software.

EWUSERW.EXE	Windows-based Foray PPP Client Control Panel program, for configuring and operating the Foray PPP Client workstation software.

EWUSERW.HLP	Help file for Windows-based Foray PPP Client Control Panel program.

EWVXD.386	Provides some protected-mode services to EWPPP, to improve performance under Windows.

SAMPLE.SCR	Sample script file.

NTDIRECT.SCR	Script file which allows a direct connection with an NT Server.

OEMSETUP.INF	Information file for installing and configuring Windows for Workgroups.

RNBAPIW.DLL	Foray PPP Client Applications Programming Interface dynamic link library, used by Windows-based Foray PPP Client Control Panel.


Actions Menu

Connect...

Hangup

Exit


Connect...

Displays the Connection dialog box, with the default user, modem and phonebook parameters.  You may dial using these default parameters, select an alternative phonebook entry, or type in another number not in the phonebook.  You may also change user parameters (ID, password and location) on this screen, if desired.

Changes made in the Connection dialog box are temporary, and are not saved to the EWUSER.INI file.  If you wish to add permanent entries to your phonebook, see Phonebook....

This menu item is not available if the workstation driver program is not loaded.


Hangup

Hangs up the telephone line for the current Foray PPP Client connection.

This menu item is not available if there is no active Foray PPP Client connection.


Exit

Exit Foray PPP Client.


Options Menu

Clear Status Window

Small Window

Always on Top

Autoset Driver Variables


Clear Status Window

Clears previous message from the status window under the Foray PPP Client menu.


Small Window

Toggles the Foray PPP Client application window between a larger window displaying more connection status information and a smaller window displaying less information.


Always on Top

If this menu item is checked, the Foray PPP Client -- whether maximized as a window or minimized as an icon -- will always be in view.

In Windows, this option toggles the Foray PPP Client Control Panel display to stay in the foreground of the Windows desktop, regardless of  other applications that may be active. If this menu item is checked, the Foray PPP Client Control Panel display, or its icon, will always be in view. This option does not appear on the DOS version menu.

You will not usually need to change this option. When the Foray PPP Client Control Panel is loaded and iconized, it always notifies the user of connection changes that the user did not initiate. If this happens, the Foray PPP Client Control Panel icon will come to the foreground in Windows and flash until you click once on the icon to acknowledge the change.


Autoset Driver Variables

Toggles whether Foray PPP Client will automatically update the workstation driver variables when there is no connection.  The driver variables updated include the following:

bitrate

dial prefix string

dial suffix string

dial timeout value

location

modem initialization string

password

phone number

user id

Foray PPP Client uses the default parameters (configured from the setup options for User, Modem, and Phonebook) to update the workstation driver.  If a connection exists, Foray PPP Client will wait until the connection terminates before updating the driver with the default parameters.


Setup Menu

User...

Modem...

Phonebook...

Drivers...


User...

Brings up the User Setup dialog box and allows the user to enter default values for the following connection parameters:

Related Topics:

User ID

Password

User Location

"Allow password to be saved in setup file" checkbox


User ID

A user identification utilized to connect to an Foray PPP Client remote servers.  This information is logged by the remote server upon connection.


Password

The password associated with the user ID, utilized to connect to an Foray PPP Client remote server.  If the remote server requires password security, the user ID / password pair will be validated by the remote server to grant access.


User Location

A description of the users location.  This information is logged on the Foray PPP Client remote server. Here, you can indicate the location you are calling from, so the network administrator knows where your remote workstation is located, i.e. Bobs Jacuzzi in Los Angeles.  This entry is optional.


"Allow password to be saved in setup file" checkbox

Check this box to allow the password to be saved as a plain text string in the EWUSER.INI file.  If you choose to have your password saved, you will not have to type it every time you dial-into the remote server.


Modem...

Brings up the Modem Setup dialog box and allows the user to enter default values for the following connection parameters:

Related Topics:

Modem

Init string

Dial Prefix

Dial Suffix

Baud RateSelect Modem


Modem

The name of the modem used on the Foray PPP Client workstation.  The modem name can be manually entered.  It also can be automatically entered by selecting from a list of modems contained in the EWMODEM.INI file.  This list is accessed by pressing the Select Modem button.


Init string

This is the modem initialization string used by the workstation modem.  It can be automatically entered by selecting from a list of modems contained in the EWMODEM.INI file.  This list is accessed by pressing the Select Modem button.   The initialization string can also be manually configured by the user.

If the desired modem does not appear in the modem list and you need assistance in configuration, please refer to the Modem Setup Guidelines in the Foray PPP Client Installation and Reference Guide.


Dial Prefix

This is the dial prefix string used by the workstation modem.  It is automatically set to the default value when selecting a modem from a list contained in the EWMODEM.INI file.  This list is accessed by pressing the Select Modem button.  The dial prefix string can also be manually configured by the user.

If the desired modem does not appear in the modem list and you need assistance in configuration, please refer to the Modem Setup Guidelines in the Foray PPP Client Installation & Reference Guide.


Dial Suffix

This is the dial suffix string used by the workstation modem.  It is automatically set to the default value when selecting a modem from a list contained in the EWMODEM.INI file.  This list is accessed by pressing the Select Modem button.  The dial suffix string can also be manually configured by the user.

If the desired modem does not appear in the modem list and you need assistance in configuration, please refer to the Modem Setup Guidelines in the Foray PPP Client Installation & Reference Guide.


Baud Rate

This is the maximum baud rate (DTE speed) for the workstation modem.  It can be automatically set by selecting from a list of modems contained in the EWMODEM.INI file.  This list is accessed by pressing the Select Modem button.  The baud rate can also be manually entered by the user.


Select Modem

This button displays the Select Modem dialog box which contains a list of modems from the EWMODEM.INI file.  The user should choose the modem that matches the one in use on the workstation.

If the desired modem does not appear in the modem list and you need assistance in configuration, please refer to the Modem Setup Guidelines in the Foray PPP Client Installation & Reference Guide.


Phonebook...

Brings up the Phonebook Maintenance dialog box and allows the user to enter phonebook entries for Foray PPP Client gateways.  The information entered for each gateway includes the following connection parameters:

Related Topics:

Remote server

Phone number

Dial Timeout

Scriptfile

"Automatic dial" checkbox

"Default Remote server" checkbox


LAN Gateway

The name of the remote server.  The remote server name is the "key" to the phonebook entries; the other information entered for each phonebook entry is associated with the remote server name.


Phone number

The phone number to be dialed to access the remote server.  The phone number may be entered with or without hyphens.


Dial Timeout

The dial timeout value is the length of time, in seconds, that the workstation driver will wait for validation of a connection with the remote server before terminating the dialing process.  In general, the default value of 60 seconds should be fine.


Scriptfile

The name of the Foray PPP Client script file, if any, that will be processed when dialing this remote server.  The default extension for Foray PPP Client script files is .SCR.


"Automatic dial" checkbox

If this box is checked, the Foray PPP Client automatic dialing feature is enabled.  When Windows applications requiring network services are executed on the remote workstation, the workstation driver will automatically initiate a connection with the remote server using its current connection parameters.

There are circumstances in which you can not use Foray PPP Client's autodial feature and will need to manually request a dial-in from the Foray PPP Client:

You cannot use the autodial feature for remote access to LAN Manager network services. You will need to dial the gateway, issue a "net start workstation" command to start the workstation, and log in to the network before you start Windows. (On a Windows for Workgroups workstation, you do not need to start the workstation but you must still connect to the gateway.) You can, however, use autodial successfully to access a Lotus Notes server on a LAN Manager network, using NetBIOS from a Windows or Windows for Workgroups workstation.

You can not autodial from a workstation that is using the Novell NetWare NETX shell. Only workstations loading NetWare VLMs can autodial.

If an attempt to autodial fails, or the user aborts the dial, the Control Panel will discard any autodial attempts that occur within 1 second. If another autodial attempt is made within 1 second, EWUSERW fails the request and resets this time interval to fail any subsequent autodial attempts. This prevents EWUSERW from dialing continually if there is a problem. If this happens, the user should correct the problem, and manually initiate a dial.


"Default LAN Gateway" checkbox

If this box is checked, this is the default phonebook entry stored in EWUSER.INI.  When the "Autoset Driver Variables" option (on the Option menu) is activated, this is the Remote server that will be dialed when an automatic dial is initiated.


Drivers...

Driver Setup

Advanced Driver Setup

Configuration File Changes...

Permanent Virtual Swapfile


Driver Setup

The Foray PPP Client Driver, EWPPP,  is a program which prepares the Control Panel to negotiate your workstations interaction with a remote server.  When you perform driver setup, EWPPP  sets all the network drivers, adapters and protocols.  This process, called the driver configuration, will  add lines to the  contents of your DOS , Windows and network configuration files.  The Foray PPP Client will automatically back up these files as it changes them.

The Driver Setup asks you to specify the type of IP configuration which your TCP/IP stack uses to communicate with your remote server.

·	From the IP Configuration list provided, choose the TCP/IP stack you installed on the workstation before you entered Foray PPP Client Setup.  Foray PPP Client has been tested with the LAN Workplace and Microsoft TCP/IP stacks.  If you are not using either of these, choose the Other option. If you are not using a TCP/IP stack, choose the None option.

·	Choose the Automatic option from the Address Assignment box, unless you know that your network administrator has assigned a specific address to your workstation.  If you are using a TCP/IP  stack which is not supported, you must obtain a specific IP address (from your network administrator) before you proceed.


Advanced Driver Setup

The Advanced Driver Settings allow you to change some of the data transfer functions which Foray PPP Client performs automatically.  Unless you have specific reason to change these settings, you should not do so.

The TCP/IP Compression box allows you turn Van Jacobson Header Compression on or off.

·	If your workstation is having trouble negotiating with the remote server, it may help to turn Van Jacobson Header Compression off.  Doing this will transmission slower.

·	Since Van JacobsonHeader Compression compares packets to standard its transmission.  The more packets are compared, the more memory this process takes up.

·	To control how much memory Van Jacobson Header Compression uses, you can also make changes to how many packets are compared by changing the number in the Slots box.

The IPX Compression box allows you turn IPX Header Compression on or off.

·	Again, if your workstation is having trouble negotiating with the remote server,  it may help to turn IPX  Header Compression off.

·	You can also control the about of memory used by the IPX Header Compression process by changing the number in the Slots box.

The PPP box specifies the parameters for Point to Point Protocol on your workstation.

·	The Maximum Receive Unit limits the size of packet your workstation can receive from the remote server.  The unit used in this specification is bytes.  The number set here depends on the specifications of your workstation -- how fast its CPU is, how fast the modem, and what kind of network drivers you are running.

·	The Character Map limits the type of characters which can be sent to the remote server.  This specification depends on the kind of negotiation used with the remote server.


Configuation File Changes
Configuration File Changes

Changes to NET.CFG

Changes to AUTOEXEC.BAT

Changes to SYSTEM.INI

Changes to PROTOCOL.INI


Permanent Virtual Swapfile

The Foray PPP Client Control Panel prompts you to create a Permanent Virtual Swap File.  Since the Foray PPP Client needs a Permanent Swap File to operate effectively, we strongly recommend that you respond by clicking on the Yes option.

·	If you click on Yes, the Foray PPP Client Control Panel will initiate the Windows Control Panel and take you into the Enhanced memory screen.

·	In the Enhanced memory screen, click on the Virtual Memory button.

·	In the Virtual Memory screen, click on the Change button.

·	The Virtual Memory screen will extend and allow you to select New Swapfile Settings.

·	From New Swapfile Settings, choose the Drive that you would like to create the swapfile on.  This drive (likely C:) should probably be the one you are installing Foray PPP Client on.

·	From the New Swapfile Settings, choose Permanent from the Type options.  (The default is Temporary.)  Click OK.

·	When the Virtual Memory pop up box asks you to verify the changes to your virtual memory settings, click  Yes.

·	Click OK when you return to the Enhanced memory box.

Before you proceed with setting up your User Information, you should reboot your workstation, so the changes to your workstation configuration files can take effect.


Changes to AUTOEXEC.BAT

Foray PPP Client makes the following changes.

·	Adds C:\FORAY to the PATH   (i.e.  the directory in which Foray PPP Client is installed.)

·	Adds EWDIR = C:\FORAY, an environment string,  needed so that various programs can find EWUSER.INI

·	Adds C:\NWCLIENT\LSL.COM, the path to Novells Link Support Layer  which provides basic services for ODI drivers and protocol stacks

·	Adds C:\FORAY\EWPPP.EXE, our ODI compliant driver

·	Remarks out STARTNET.BAT and LANWP.BAT

·	STARTNET  is an executable file used by Novell to load the rest of their network stack.

·	LANWP.BAT is a executable file used by Novell to load their TCP/IP stack.

·	If LAN WorkPlace is the Third Party TCP/IP Package, then TCPIP.EXE can be added after EWPPP.EXE. TCPIP.EXE is the TCP/IP stack that comes with Lan Workplace


Changes to PROTOCOL.INI

Foray PPP Client makes the following changes.

·	Adds Section NWLINK

·	Adds FRAME = ETHERNET_II

Specifies which frame format to use.  The frame type listed here must match one of the FRAME statements in net.cfg.  At present, the only frame type we support is ETHERNET_II.

·	Adds BINDINGS=EWPPP

Tells Microsofts networking software which network adapter to use for networking.


Changes to SYSTEM.INI

The Foray PPP Client makes the following changes.

·	Adds Section 386Enh

·	Adds TimerCriticalSection=10000

This entry specifies a timeout period.  Novell Workstation code needs this specification in order to function properly.  The timeout value is specificied in milliseconds.

·	Adds NetHeapSize=40

This line gives the size, in 4K increments, of the data-transfer buffers that Windows 386 enhanced mode allocates in conventional memory for transferring data over the network.

·	Adds EWVXDCOMxBuffer = 128   (x = Com Port Number)

·	Add COMxBuffer = 0  (x = Com Port Number)

Disables buffering of the asynchronous communications port.  We have our own buffer.

·	Add device = *combuff

Tells Windows to load the communications port buffering routine that comes with Windows.

·	Add device = *vcd

Tells Windows to load the communications driver that comes with Windows.

·	Adds device = C:\FORAY\EWAPI.386

Enables EWUSERW and the API library to communicate with EWPPP.

·	Adds device = C:\FORAY\EWVXD.386

Provides some protected mode services to EWPPP to improve performance.

·	Adds Section boot

·	Adds secondnet.drv =

·	Adds Section boot.description

·	Adds secondnet.drv =

·	Adds Section network.

·	Adds SlowLanas =0

Specifes that Netbios interface #0 is slow.

·	Adds Section MSTCP

·	Adds Interfaces=EWPPP0

·	Adds deadgwdetect=1

Enables dead gateway detection.

Normally added by MS TCP/IP setup, but it does not always operate properly.  We add it to ensure a successful install.

·	Adds pmtudiscovery=1

Normally added by MS TCP/IP setup, but it does not always operate properly.  We add it to ensure a successful install.

·	Adds Section EWPPP0

 If you are using DHCP, Foray PPP Client uses the following lines.

·	Adds DefaultGateway = 0.0.0.0

·	Adds IPMASK=0.0.0.0

·	Adds IPAddress=0.0.0.0

Coding all zeros for these values tells Microsofts TCP/IP code to get the values from the gateway.

 If you are not using DHCP, Foray PPP Client uses these lines instead.

·	Adds IPMASK=255.255.255.0

See ip_netmask above.  This has the same meaning, according to Microsofts method of coding .INI files.

·	Adds IPAddress=x.x.x.x   (chosen during driver setup)

·	Adds Description= TechSmith Enterprise Wide Foray PPP Client Driver

·	Adds Binding = EWPPP

Tells Microsofts networking software which network adaptor to use for networking.


Changes to NET.CFG

The Foray PPP Client makes the following changes.

·	Adds section LINK DRIVER EWPPP

This line identifies the section in net.cfg that pertains to our driver.

·	Adds COMPORT_NUM   ___   (Chosen during the modem setup)

·	Adds IP_ADDR x.x.x.x  (Chosen during the driver setup)

For third party stacks that do not support dynamic IP address assignment, you would code the workstations IP address here

·	Adds X_25 0

Improves performance when communicating through an X.25 PAD.  Foray clients should always leave this set to zero.

·	Adds MRU 1500

This line defines the size of the largest packet which may be received by the workstation.  Unless you have a specific reason for re-defining this parameter, you  should not change it.

·	Adds R_CMAP 0x00002000

This is a 32-bit hexadecimal number that specifies which characters must be escaped as they are transmitted from the gateway to the workstation.  Escaping is a coding technique which prevents certain codes from being transmitted, except in their special role as control characters.  For example, code 0x7E is the start of frame character.  Whenever that character appears in the body of a data packet, it is encoded as a 2 byte value for transmission on the line ( 0x7D 0x5E ), to prevent the other end from falsely detecting a start of frame.

·	R_CMAP specifies which of the control characters in the range 0x00 through 0x1F should be escaped.  Here are some sample codings:

·	0x00000001	Escapes NULL, which is code 0x00

·	0x00000002	Escapes Ctrl-A which is code 0x01

·	0x00002000	Escapes Carraige return, which is code 0x0D

It is unlikely that users will ever have to change this field.7.

·	Adds R_VJ_COMP 1  (Van Jacobsen Compression)

Van Jacobson compression of TCP/IP headers proceeds in two stages.  First, the TCP/IP packet header is compressed to a Slot-Identifier.  Then, if the slot identifier is the same as for the last packet, the slot identifier itself is omitted.  R_VJ_COMP enables this latter step -- the compression of the slot identifier.

·	Adds R_IPX_HDR_COMP 4

This line specifies the number of simultaneous conversations that the IPX header compression software in EWPPP can handle simultaneously.  In the unlikely event that you start up more simultaneous conversations than is specified here (4), the data link will run a bit slower, but there will be no other effect.

·	Frame ETHERNET_II

·	Frame ETHERNET_802.3

·	Frame ETHERNET_802.2

·	Frame ETHERNET_SNAP

·	Frame PPP

Each of the FRAME statements specifies a different type of packet format that can be handled by the EWPPP driver.  However, not all of these packet formats really work.  The EWPPP driver only handles ETHERNET_II frames. The PPP frame type was added to enable dynamic IP address assignment with Lan Workplaces TCP/IP stack.  Someday, well clean this up.  For now, leave the frame type declarations exactly as shown.

·	Adds Section Protocol TCPIP

This section is needed only for Novells Lan Workplace TCP/IP stack.

·	Adds Bind EWPPP #1 PPP PPP-NET

·	Adds ip_address x.x.x.x (Chosen during the driver setup)

·	Adds Section Link Support

The Link Support section allocates resources inside the LSL.

·	MAX STACKS  8

·	MAX BOARDS  5

·	//

·	//The following section of net.cfg is read by Novells DOS file requester (VLM.EXE).  See
//Netware documentation for a description..

·	//

·	Adds Section Netware DOS Requester

·	Adds lip start size = 576

·	Adds netbios retry count = 40

·	Adds netbios commands=20

·	Adds vlm= AUTO.VLM

·	Adds show defaults = ON

·	Adds use defaults=ON

·	Adds minimum time to net=1000

·	Adds

bind reconnect=ON

auto retry=0

netware protocol = BIND, NDS

·	If LAN WorkPlace is present,  adds to the Protocol TCPIP section

·	-PATH LANG   C:\lwp\LANG

Where Lan Workplace finds its message files.

·	-PATH SCRIPT   C:\lwp\SCRIPT

Where Lan Workplace finds its script files.

·	-PATH PROFILE    C:\lwp\PROFILE

·	-PATH LWP_CFG    C:\lwp\HSTACC

·	-PATH TCP_CFG    C:\lwp\TCP

·	-ip_netmask               255.255.255.0

A TCP/IP numeric address (example 199.254.220.1) is composed of a network part, and a host identifier.  In this example, the network part is 199.254.220, and the host identifier is 1.  The ip_netmask tells the LanWorkplace TCP/IP stack where to draw the line between the network part and the host part.  System administrators will tell their end users what to put into this field.

·	//

·	// The Buffers and the MemPool lines also allocate resources inside the LSL

·	//

·	If LAN WorkPlace, adds to the Link Support section

-Buffers 4 1500

-MemPool 4096


Help Menu

Index

About


Index

Displays an index to information contained in the Foray PPP Client help file.

To see the entries for a topic, click on any item you want to look up, or press TAB to select the item and then press ENTER.


About

Displays the Foray PPP Client version number, RNBAPI.DLL version number, workstation driver load status and copyright notice.


Select Path

Install From

Install To

Install Directory

Space Required

Target Drive Status


Install From

Displays the drive from which Foray PPP Client is going to install its files.  For example, if you are installing Foray PPP Client from a 31/2 inch disk and your 31/2 inch disk is called A:, the install program will display  A:  in this field.


Install To

Displays the default drive to which Foray PPP Client is going to install its files. Foray PPP Client will install itself on C: unless you specify another drive in this field.  To specify another drive, type the letter of the alternative drive. For instance, if you want to install Foray PPP Client to drive D: (instead of drive C:), type D: in this field.


Install Directory

Displays the default directory to which Foray PPP Client is going to install its files. Foray PPP Client will create the root directory \FORAYPPP and install itself there, unless you specify another directory in this field.  To specify another directory, type the path of the directory in this field.  For instance, if you would like Foray PPP Client to install itself in a directory called \CLIENT, type this alternative directory name and its path.


.Space Required
Space Required

Displays the amount of space which Foray PPP Client needs to install itself on your hard drive.   Since Foray PPP Client searches for your system specifications and installs only the files appropriate to your system, the amount of space it requires will vary from one system to another.


Target Drive Status

Displays the amount of space USED (that is, filled with already present files)  and FREE (that is, space available for use) on the specified drive (See Install To) before and after Foray PPP Client installs itself.  The install will establish what files your system  requires and calculate the amount of space these files will need.  Then, the install program will  provide information on how much space is available on your system now, before Foray PPP Client installs itself, and how much space will be available if you proceed with this install, after Foray PPP Client installs itself.

If you do not have enough space on the drive specified in the Install To field, the installation program for Foray PPP Client will not proceed.   As well, the installation program will initiate a pop up box which tells you to choose another drive.

If you do not have enough space on any drive in your system , the installation program for Foray PPP Client will not proceed.  As well, the installation program will initiate a pop up box which tells you that you do not have enough space for Foray PPP Client.


Select Group

Displays the default Program Manager group for the Foray PPP Client.  If you accept the default group ForayPPP, the Foray PPP Client installation program will create this group and place it on your windows desktop.  If you would like to specify an other name for the icon group, type an alternate name in the top field.  For instance,  if you want the Foray PPP Client icons to appear in a Program Manager group called Client, type the name Client in this field.

If you would like the Foray PPP Client icons to be part of an existing Program Manager group, pick the existing group from those listed in the bottom field.


Choose Uninstall Options

Operating System Files

Windows System Files

Network System Files


Operating System Files

Displays the date stamp on the AUTOEXEC.BAT file which your system now uses and the date stamp on the backup file which Foray PPP Client made when it was installed.

If you replace the existing AUTOEXEC.BAT with the backup file,  the system will boot with the same AUTOEXEC.BAT file which it was running before you installed Foray PPP Client.

·	If you have installed programs which load at the boot stage since you installed Foray PPP Client, the information added to your AUTOEXEC.BAT file by those programs will no longer exist.

·	You should not replace your AUTOEXEC.BAT file with Foray PPP Clients backup if there have been significant changes made on your workstation since PPP Client was installed.

·	If you do not replace the AUTOEXEC.BAT file, with either a backup file or an edited file, your system may produce report an Initialization Failure and give one or more  Bad command or file name messages as it boots up.

·	If you choose to leave the existing AUTOEXEC.BAT file as it is,  the system will still boot up. However, it will report these errors as it looks for Foray PPP Client files which will be removed by the uninstall program.

·	If you want to hand edit the existing AUTOEXEC.BAT file to avoid getting these error messages,  delete the Foray PPP Client files and move the LSL.COM (Novell driver) to a line position before the  ODI driver.


Windows System Files

Displays the date stamp on PROTOCOL.INI and SYSTEM.INI files which your system now uses and the date stamp on the backup files which Foray PPP Client made when it was installed.

Both SYSTEM.INI and PROTOCOL.INI should be replaced with either backup or edited files, since these two files are reliant on each other for network protocol messages.    Windows will still load if you do not replace these,  its system files, but it will search for Foray PPP Client files which will be removed by the uninstall program.

·	If the SYSTEM.INI file is not replaced, it will look for and report the absence of at least two Foray PPP Client files, EWVXD.386  and EWAPI.386.

·	If your ODI driver did not load properly from your AUTOEXEC.BAT file, the SYSTEM.INI file will also report an error with your MSODISUP.386 file.

·	If  the PROTOCOL.INI is not replaced, it will report errors connecting with the network.  The type and frequency of error messages will depend on the set up of your system.


Network System Files

Displays the date stamp on the NET.CFG file which your network now uses and the date stamp on the backup file which Foray PPP Client made when it was installed. If you did not have a network system when you installed Foray PPP Client, a pop box will appear when you initiate the uninstall program indicating this circumstance and  the backup field for the NET.CFG will read FILE NOT FOUND.

·	If you replace the NET.CFG with your backup file, your network drivers will be returned to the settings they used before Foray PPP Client was installed.

·	If you do not replace the NET.CFG, with either an edited file or a backup file, your network drivers will be left with the settings which Foray PPP Client uses.  These settings should not interfere with the normal operation of your network system

Related Topic:

Drivers


How to Register Foray

The electronically distributed evaluation copy of the Foray PPP Client is a fully functioning copy of the software.  The only difference between an evaluation copy and a registered copy of the software is that the evaluation copy has a 15 minute connect-time limit.  To enable your evaluation copy, you must enter a registration key number from TechSmith.

To obtain a Foray PPP Server software license, you will need to supply us with some basic customer information. As an aid in gathering this information, we have included a registration program as part of the Help menu on your Control Panel.

·	When you select the option entitled How to Register Foray PPP Client from the Help menu, a list of instructions which outlines how to operate the registration program will appear.

·	When you select Begin Registration from the Help Menu, the registration program will provide a form for your to fill out and generate a text file called REGISTER.TXT.

·	When TechSmith receives the information you provide in REGISTER.TXT,  we will generate a personalized registration key and send the key back to you.

·	When you select Finish Registration from the Help menu, the registration will prompt  you to enter personalized registration key.

To enable your Foray PPP Client with your personalized key, you must input your registration key exactly as it shown and reboot your system.


Note About Electronically Distributed Software
A Note About Electronically Distributed Software

The Foray PPP Client is electronically distributed software.  Electronic distribution gives users a chance to try software before buying it.  You may use Foray PPP Client, subject to the license agreement and warranty disclaimer, for a 30 day period.  A copy of the license agreement and warranty disclaimer,  LICENSE.TXT,  is included in the Foray PPP Client software bundle. Using this software indicates your acceptance of the terms outlined in these documents.  If you cannot accept the terms and conditions of the license and disclaimer, do not use the Foray PPP Client.  If you find the Foray PPP Client  useful and wish to continue using it beyond the 30 day trial period, you must register it.


Note to Vendors
License Agreement

The software which accompanies this license ( the "Software") is the property of TechSmith Corporation (herein "TSC"). While TSC  continues to own the Software, you will have certain rights to use the Software after your acceptance of this license.

This license applies to all users of this Software and is divided into three sections.

1)  GENERAL TERMS AND CONDITIONS apply to all users and uses of this Software.

2)  TERMS AND CONDITIONS FOR REGISTERED COPIES OF THE SOFTWARE  apply to REGISTERED copies of this Software.

3)  TERMS AND CONDITIONS FOR EVALUATION COPIES OF THE SOFTWARE apply only to users of UNREGISTERED copies of this Software.

1) GENERAL TERMS AND CONDITIONS

TITLE.  Title, ownership rights, and intellectual property rights in and to the Software and the associated documentation shall remain with TSC and/or its suppliers.  This agreement does not include the right to sublicense the Software and is personal to you and therefore may not be assigned (by operation of law or otherwise) or transferred without the prior written consent of TSC.

You acknowledge that the Software in source code form remains a confidential trade secret of TSC and/or its suppliers; therefore, you agree not to attempt to decipher, decompile, disassemble or reverse engineer the Software or allow others to do so, except to the extent applicable laws specifically prohibit such restriction.  You further agree not to modify or create derivative works of the Software.

DISCLAIMER OF WARRANTY.

The Software is provided on an "AS IS" basis, without warranty of any kind, including without limitation the warranties of merchantability,  fitness for a particular purpose and  non-infringement.  The entire risk as to the quality and performance of the Software is borne by you. Should the Software prove defective, you and not TSC assume  the entire cost of any service and repair.  TSC does not warrant that the Software will meet your requirements or that operation of the Software will be uninterrupted or that the Software will be error-free.

This disclaimer of warranty constitutes an essential part of the agreement.  Some states do not allow exclusions of an implied warranty, so this disclaimer may not apply to you and you may have other legal rights that vary from state to state or by jurisdiction.

LIMITATION OF LIABILITY.

Under no circumstances and under no legal theory, tort, contract, or otherwise, shall TSC or its suppliers or resellers be liable to you or any other person for any indirect, special, incidental, or consequential damages of any character including, without limitation, damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses.  This limitation of liability shall not apply to liability for death or personal injury to the extent applicable law prohibits such limitation. Furthermore, some states do not allow the exclusion or limitation of  incidental or consequential damages, so this limitation and exclusion may not apply to you.

EXPORT CONTROLS.

You may not download or otherwise export or reexport the Software or any underlying information or technology except in full compliance with all United States and other applicable laws and regulations.  In particular, but without limitation, none of the Software or underlying information or technology may be downloaded or otherwise exported or reexported (i) into or to a national or resident of any other country to which the U.S. has embargoed goods; or (ii) to anyone on the U.S. Treasury Department's list of Specially Designated Nationals or the U.S. Commerce Department's Table of Deny Orders.  By downloading or using the Software, you are agreeing to the foregoing terms, and you are representing and warranting that you are not located in, under the control of, or a national or resident of any such country or on any such list.

MISCELLANEOUS.

This Agreement represents the complete and exclusive statement of the agreements concerning this license between the parties and supersedes all prior agreements and representations between them.  It may be amended only by written addendum executed by both parties.  If any provision of this agreement is held to be unenforceable for any reason, such provision shall be reformed only to the extent necessary to make it enforceable, and such decision shall not affect the enforceability (i) of such provision under other circumstances or;  (ii) of the remaining provisions hereof under all circumstances.  Headings shall not be considered in interpreting this agreement.  This agreement shall be governed by and construed under Michigan law as such law applies to agreements between Michigan residents entered into and to be performed entirely within Michigan, except as governed by Federal law.  This agreement will not be governed by the United Nations Convention of  Contracts for the International Sale of Goods, the application of which is hereby expressly excluded.

2)  TERMS AND CONDITIONS FOR REGISTERED COPIES OF THE SOFTWARE

REGISTERING

By registering this Software, additional rights to this Software are granted and defined in this section.  You may use one copy of the Software on a single computer.  If you have registered for a multi-pack you may use the Software on multiple computers not to exceed the number of licenses paid for.  The connection time limit is removed for registered copies of the Software.

DISTRIBUTION

The right to distribute or redistribute this Software is expressly denied.  You may not copy, sublicense, rent, or lease any portion of the Software to another entity.

UPDATES

This Software may be updated by TSC on a  periodic basis to fix previously reported problems.  Registered users of this Software may download the updated Software and use it in place of the previous version.  The previously issued product registration key will work with updated Software.

UPGRADES

From time to time, TSC may offer for sale complete and significant upgrades of this Software.  If an upgraded license is purchased as a replacement for a previous version, all copies and use of the prior version must be destroyed, except for copies retained for archival purposes. The previously issued product registration key may no longer work with upgraded Software and a new key may be required.  Enhancements and updates, if available, may be obtained through TSC at current pricing, terms, and conditions.

The acceptance of any purchase order placed by you is expressly made conditional on your assent to the terms set forth herein, and TSC agrees to furnish the software and documentation only upon these terms and not those contained in your purchase order.

3) TERMS AND CONDITIONS FOR EVALUATION COPIES OF THE SOFTWARE

Unregistered copies of this Software may be used only for the purpose of evaluating this Software for suitability to fulfill  the customer's need.  Subject to the provisions contained herein TSC hereby grants you a non-exclusive right to use this Software free of charge if your use of the Software is for the purpose of evaluating whether to purchase an ongoing license to the Software.  You may evaluate the Software for not more than 30 days.  At the end of 30 days you must purchase a license in order to continue using the Software.

DISTRIBUTION.

You may freely distribute the unregistered Software in its entirety.  None of the files may be excluded.  The Software is protected by the copyright laws of the United States and international copyright treaties.