ۥ- E<  <Ӵ ݴ ^ FL\\\\#. 4DEE8D Enterprise Wide Foray PPP Client Installation and Reference Guide TechSmith Corporation 3001 Coolidge Road, Suite 400 East Lansing, Michigan 48823-6320 Phone: (517) 333-2100 Fax: (517) 333-1888 info.foray-client@TechSmith.com support.foray-client@TechSmith.com http://www.TechSmith.com/ TechSmith Corporation provides this manual as is, makes no representations or warranties with respect to its contents or use, and specifically disclaims any expressed or implied warranties of merchantability or fitness for any particular purpose. TechSmith Corporation reserves the right to make changes to the content of this manual, at any time, without obligation to notify any person or entity of such changes. The software described in this document is furnished under a license agreement. The software may be used or copied only in accordance with the terms of the agreement. Copying the software on any medium except as specifically allowed in the license agreement is prohibited. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal use, without the express written permission of TechSmith Corporation. 1991-1995 TechSmith Corporation. All rights reserved. Printed in the United States of America. Manual version 2.01 Revision 2 Trademarks: TechSmith and Enterprise Wide are registered trademarks of TechSmith Corporation. Foray is a trademark of TechSmith Corporation. Microsoftxe "Microsoft", Microsoft Windowsxe "Windows", Windows for Workgroupsxe "Windows for Workgroups", Windows 95, Windows NT and Manager are registered trademarks of Microsoft Corporation. IBM, OS/2 Warp, PC DOSxe "PC DOS" and Server are registered trademarks of International Business Machines Corporation. Novellxe "Novell", DR DOS and NetWare are registered trademarks of Novell, Inc. DigiBoard, DigiCHANNEL, PC/xe and MC/xi are trademarks of DigiBoard. All other brand and product names referred to in this manual are the trademarks or registered trademarks of their respective holders. toc \t "Chapter,1,1Heading,2,2Heading,3" Using this Manual i Chapter Summaries i Conventions ii Foray PPP Client Technical Support iii Customer Feedback iv Foray PPP Client Introduction 1-1 Your Foray PPP Client Software 1-2 Understanding How Foray PPP Client Works 1-2 Understanding the Foray PPP Client Control Panel 1-2 Foray PPP Client Features 1-2 Creates Remote Windows Workstation 1-3 Provides Multiprotocol PPP Driver 1-3 Foray PPP Client Workstation Requirements 1-3 Foray PPP Client Modem Requirements 1-4 Foray PPP Client Workstation Package 1-4 Installing the Foray PPP Client 2-7 Special Considerations for Evaluation Software Users 2-8 Overview of the Installation Process 2-8 Installation Tips: Ensuring Your Network Drivers are Installed 2-9 Novell Netware (IPX) 2-9 TCP/IP Stack 2-9 Microsoft Networking 2-9 Installing the Foray PPP Client Files 2-9 Running the Foray PPP Clients Setup Program 2-10 Selecting the Installation Drive and Directory 2-10 Selecting the Group 2-10 Configuring the Foray PPP Client 3-11 Overview of the Configuration Process 3-12 Special Tips for Performing the Modem Setup 3-12 Performing the Modem Setup 3-13 Modem Configuration 3-13 Modem Setup Strings 3-14 Special Tips for Performing the Driver Setup 3-14 Performing the Driver Setup 3-15 TCP/IP Configuration 3-15 Advanced Driver Settings 3-15 Configuration File Changes 3-16 Permanent Virtual Swap File 3-16 Special Tips for Entering User Information 3-17 Entering User Information 3-17 Phonebook Maintenance 3-17 User Setup 3-18 Making Your First Remote Connection with Foray PPP Client 3-18 Using the Foray PPP Client 4-21 Dialing Into a Remote Server with Foray PPP Client 4-22 Manual Dialing 4-22 Callback 4-22 Ending a Foray PPP Client Session 4-23 Hanging up the Phone 4-23 Unloading the Workstation Driver 4-23 Licensing the Foray PPP Client Software 5-25 Understanding Electronically Distributed Software 5-26 Registering The Foray PPP Client 5-26 Submitting REGISTER.TXT to TechSmith 5-27 Using the Foray PPP Client Control Panel 6-29 Using the Autodial Feature 6-30 Using the Command Menus 6-30 Actions Menu 6-30 Options Menu 6-31 Setup Menu 6-31 Help Menu 6-34 Understanding Control Panel Messages 6-35 Server Messages 6-35 Modem Messages 6-35 Dial-in Messages 6-36 Hang-Up Messages 6-37 Using the Command Line Interface 7-39 Running EWCMD From DOS 7-40 Command Syntax 7-40 Command Line Parameters 7-40 Running EWCMD From Windows 7-42 File 7-42 Modem 7-42 Setup 7-42 Help 7-43 Return Codes 7-43 The Foray PPP Client Scripting Language 8-45 What is the Foray PPP Scripting Language? 8-46 Creating a Foray PPP Client Script File 8-46 Command Description 8-46 Additional Notes on Preparing Foray PPP Client Scripts 8-48 Sample Foray PPP Client Script File 8-48 Dialing In Using a Foray PPP Client Script File 8-50 Special Configuration Notes 9-51 Optimizing Your Workstations Memory 9-52 Editing Your CONFIG.SYS file 9-52 Editing Your AUTOEXEC.BAT file 9-53 Editing Your NET.CFG file 9-53 Tips for Configuring Your Workstation 9-54 Using the Foray PPP Client with your NT Server 9-54 Configuring the NT Server 9-55 Tips for Using the NT Server with Foray PPP Client 9-55  PREFACE Using this Manualxe "Using this Manual:Overview" Welcome to the Enterprise Widesymbol 226 \f "Symbol" \s 10 Foraysymbol 228 \f "Symbol" \s 10 PPP Client Installation and Reference Guide. This guide is intended for workstation users who will be installing, configuring and operating a Foray PPP Client. We recommend that you review Chapters 1, 2 and 3 carefully at least once before your installationxe "installation" and configuration of the workstation. The instructions in this guide assume that you are familiar with: DOS operating system commands, MS Windowsxe "Windows" applications, and The name(s) and protocol(s) of your network operating system. If you will be using TCP/IPxe "TCP/IP", you will also need to know how your network administrator assigns IP addressesxe "IP addresses" -- or at least what the IP addressxe "IP address" of your workstation should be. For your convenience, we have also included two text files, README.1STxe "README.1ST" and INSTALL.TXTxe "INSTALL.TXT", in your Foray PPP Client software bundle. README.1ST contains additional information about the Foray PPP Client software which was not available when this manual was created. INSTALL.TXT contains a step-by step installation and configuration guide. We recommend printing and reading these instructions prior to installing the Foray PPP Client.xe "installing the Foray PPP Client" Chapter Summariesxe "Chapter Summaries" This guide contains the following chapters. Each chapter begins with a brief summary and a table of contents for the topics covered in that chapter. We have also included a comprehensive index at the end of the guide for your convenience. Preface Using This Manual This preface gives a brief overview of the manuals content and conventions. As well, it provides you with a list of ways to obtain support for the Foray PPP Client. Chapter 1 Foray PPP Client Introduction This introduction to the Foray PPP Client workstation provides an overview of Foray PPP Clients features. It also outlines Foray PPP Clients hardware and software requirements. Chapter 2 Installing the Foray PPP Client This chapter tells you how to prepare your workstation for Foray PPP Client . Then, it gives step-by-step instructions for the workstation installation procedure. Chapter 3 Configuring the Foray PPP Client This chapter guides you through the set-up of your workstation modem and of Foray PPP Clients ODIxe "ODI"-compliant driver, EWPPPxe "EWPPP". At the end of this process, it tells you how to enter your user information and make your first dial-in connection. Chapter 4 Using the Foray PPP Client This chapter explains how the parts of Foray PPP Client work together and how to use Foray PPP Client in a manual dial-in process. Chapter 5 Licensing the Foray PPP Client Software This chapter instructs you on how to register your version of Foray PPP Client and how to use your TechSmith registrationxe "registration" key. Chapter 6 Using the Foray PPP Client Control Panelxe "Control Panel" This chapter describes the Foray PPP Client Control Panelxe "Control Panel", the program you use to configure the workstation software and to automatically dial and make connections with a host. Chapter 7 Using the Command Line Interface This reference section shows you how to use EWCMD.EXExe "EWCMD.EXE", a program which allows you configure and establish your Foray PPP Client connection from a DOS command line. Chapter 8 The Foray PPP Client Scripting Language This reference section shows you how to use the Foray PPP Client workstation scripting language to control modem functions. Conventionsxe "Conventions" For ease of use and clarity, this manual uses the following conventions: File names, directory names, and acronyms appear in upper case (e.g., AUTOEXEC.BATxe "AUTOEXEC.BAT"). If you are required to press keyboard keys, they will appear in small caps. "ENTER", for example, means that you press the enter key. Whenever a plus sign (+) is used between key names, you should press the keys at the same time. For example, "Press CTRL+C" means that you press the ctrl key and hold it down while you press the c key. A comma (,) between key names means that you must press the keys in sequence. "Press alt, f" means that you press the alt key and release it, then press f. Commands that you would have to type are shown in Courier 11 point text. These might be command namesxe "command names", switches, or any other text you enter from your keyboard. The text should be entered exactly as it appears in the documentation. To perform a command, type the command name and then press the enter key. Variable informationxe "Variable information" appears in italics. For example, if you are asked to enter a parameter that calls for a filename, you must type the name of a file. System message expations often include a value of "nnnn", where "nnnn" is a number; or "xxxx" where "xxxx" is a text string. Occasionally, the syntaxxe "syntax:command" of a command will allow you to make mutually exclusive choices. These are enclosed in parentheses, separated from each other by a vertical bar or pipe symbol (|). To enter the optional information, type only your choice, not the parenthesis or pipe symbol. For example: diag = (0|1) means that you enter either: diag = 0 or diag = 1 Examplesxe "File Examples:syntax" of actual files are listed in Courier 8 point. Foray PPP Client Technical Supportxe "Technical Support" If you need help installing or operating Foray PPP Client, TechSmith offers the following electronic support options: Send us email at support.foray-client@TechSmith.com; View the Foray Client FAQsxe "FAQs" at our Webxe "TechSmith Website" site at http://www.TechSmith.com; Download the current versionsxe "Current versions of the software" of the Foray PPP Client software and FAQs at ftp.TechSmith.com /pub/products/4apppcln; Included in the Foray PPP Client software bundle is a Technical Support problem reporting form named SUPPORT.TXTxe "SUPPORT.TXT". This form can be completed and sent by FAX to Foray Client Support at (517) 333-1888. TechSmith Corporation is constantly updating its support resources through development and testing efforts. If you encounter difficulties of any kind and would like more information, we encourage you to contact us. Customer Feedbackxe "Customer Feedback" We appreciate your interest in our product and your opinion is important to us. We encourage you to give us your comments, recommendations and criticisms about the Foray PPP Client. For your convenience in supplying your opinions, we have included a customer survey text file, FEEDBACK.TXTxe "FEEDBACK.TXT". The completed form can be forwarded to us, electronically or in printed form, at the following locations. If you wish to contact us electronically, you can reach us by email or at our website. emailxe "email:TechSmith": sales.foray-client@TechSmith.comxe "Foray-Server@TechSmith.com" WWW: http://www.TechSmith.comxe "www.TechSmith.com" If you wish to contact us with a printed form, you can reach us by FAX or by mail. FAX: 517-333-1888 Mail: xe "Mail:TechSmith"TechSmith Corporationxe "TechSmith Corporation" 3001 Coolidge Road, Suite 400 East sing, MI 48823-6320 Chapter 1 xe "workstation\:introduction"Foray PPP Clientxe "Foray PPP Client:Introduction" Introduction The Foray PPP Client software is an easy to install and easy to use PPP driver designed for remote workstationsxe "remote workstations" which run Microsoftxe "Microsoft" Windowsxe "Windows" 3.x or Windows for Workgroupsxe "Windows for Workgroups" 3.11. Using the Foray PPP Client, you can access -based TCP/IPxe "TCP/IP" and Novellxe "Novell" Netwarexe "Netware" resources from a dial-in connection. To protocol stacksxe "protocol stacks", the Foray PPP Client behaves like a standard ODIxe "ODI"-compliant card driver. However, the Foray PPP Client dials-in to a standard PPP serverxe "PPP server" and supports both TCP/IPxe "TCP/IP" and IPXxe "IPX"/SPXxe "SPX" protocols over the same connection. Setting up the Foray PPP Client is a two part process: installing the Foray PPP Client on your workstation, as outlined in Chapter 2, and configuring the Foray PPP Client to work with your network stacksxe "network stacks", as outlined in Chapter 3. The network environment which your workstation uses will dictate the setup which Foray PPP Client uses. Topics Your Foray PPP Client Software Page 1-2 Understanding How Foray PPP Client Works Understanding the Foray PPP Client Control Panelxe "Control Panel" Foray PPP Client Features Page 1-2 Creates Remote Window Workstation Provides Multiprotocol PPP Driver Foray PPP Client Workstation Requirements Page 1-3 Foray PPP Client Modem Requirements Page 1-4 Foray PPP Client xe "workstation\:files"xe "Foray PPP Client\:workstation software"xe "files\:workstation"Software Package Page 1-4 Your Foray PPP Clientxe "Foray PPP Client:Product description" Software The Foray PPP Client workstation software replaces the network driverxe "network driver" you would use if your workstation were directly attached to a network. The client intercepts messages from your workstation to the network then redirects them through your serial port to the PPP serverxe "PPP server". The client also receives messages the network sends through the PPP serverxe "PPP server" to your workstation, and presents them to the local application. From a users perspective, Foray PPP Client is completely transparent. Applications work just as though the PC were connected directly to the network. Understanding How Foray PPP Client Works Your DOS system file, AUTOEXEC.BATxe "AUTOEXEC.BAT", will automatically load the Foray PPP Client component in your workstations memory. EWPPPxe "EWPPP", the Foray PPP Client workstation communications driver, takes the place of the network card driver which you would use for local network access. Once loaded, EWPPPxe "EWPPP" remains inactive until you need a network resource. Having EWPPP loaded ( but not active) will not normally affect other programs on the workstation. Understanding the Foray PPP Clientxe "Foray PPP Client:Control Panel" Control Panelxe "Control Panel" The Foray PPP Client Control Panel configures system files to work with the Foray PPP Client and initiates your connection to a PPP serverxe "PPP server". The Control Panelxe "Control Panel" is used to specify the baud rate, modem strings, PPP serverxe "PPP server" phone number, and user information that EWPPPxe "EWPPP" requires to make a successful network connection. Driver Setupxe "Driver Setup" in the Control Panelxe "Control Panel" configures the network and communications driversxe "communications drivers". In addition to changing the EWUSER.INIxe "EWUSER.INI" file, Driver Setup changes the AUTOEXEC.BATxe "AUTOEXEC.BAT", SYSTEM.INIxe "SYSTEM.INI", PROTOCOL.INIxe "PROTOCOL.INI", and NET.CFGxe "NET.CFG" files. The Control Panelxe "Control Panel" program writes the connection parameters to the EWUSER.INIxe "EWUSER.INI" file. Each time you run the Control Panel, it reads this file, and automatically sets the driver parameters to the stored values. Foray PPP Clientxe "Foray PPP Client:Features" Features The Foray PPP Client allows remote workstationsxe "remote workstations" running Windowsxe "Windows" 3.x and Windows for Workgroupsxe "Windows for Workgroups" 3.11 to access corporate resources through a PPP communications server. Creates Remote Windowsxe "Windows" Workstation Provides a standard Microsoftxe "Microsoft" Windowsxe "Windows" interface Supports network services through Windowsxe "Windows" for Workgroupsxe "Windows for Workgroups" on Novellxe "Novell" and Microsoftxe "Microsoft" s Arrives preconfigured for most 14.4 kbs and 28.8 kbs modemsxe "modems" Supports deferred connection under Windowsxe "Windows" Includes an easy to reference phonebookxe "phonebook" Offers an autodialxe "autodial" feature Supports server callbackxe "callback" Supports APIxe "API" for writing programs to the control dialer Provides Multiprotocol PPP Driver Supports PAPxe "PAP" for user authenticationxe "user authentication" Sustains TCP/IPxe "TCP/IP" and IPXxe "IPX"/SPXxe "SPX" sessions, separately or concurrently. Supports most third-party TCP/IPxe "TCP/IP" protocol stacksxe "protocol stacks" Supports dynamic IP addressxe "IP address" allocationxe "dynamic IP address allocation" for Microsofts TCP-32xe "TCP-32" and Novells Workplacexe "LAN Workplace" stacks Includes Van Jacobsonxe "Van Jacobson Header Compression" TCP/IPxe "TCP/IP" header compression Includes IPXxe "IPX:Header Compression"xe "IPX" header compression Foray PPP Client xe "workstation\:requirements"xe "hardware requirements\:workstation"xe "software requirements\:workstation"Workstation Requirements The Foray PPP Client requires the following hardware and software on the workstation: For acceptable performance under Windowsxe "Windows", the workstation PC should have at least a 386SX 20MHz CPU and 4 MB of RAMxe "RAM". The workstation PC must be running MS DOSxe "MS DOS" or PC DOSxe "PC DOS" 5.0 or above. Foray PPP Client does not support alternative operating systems such as DR-DOSxe "DR-DOS". The command shell must be COMMAND.COMxe "COMMAND.COM". Foray PPP Client will not run with any other DOS command shell replacements or enhancers like NDOS.COMxe "NDOS.COM", 4DOS.COMxe "4DOS.COM". Windowsxe "Windows" 3.1 or above, or Windows for Workgroupsxe "Windows for Workgroups" 3.11 or above, must be installed on the workstation PC. A serial port with a 16550A UARTxe "UART" is highly recommended for optimal performance with Foray PPP Client. For internal modemsxe "modems", the serial UART is part of the modem card. To assist you in determining your UART status, we have included a UART diagnostic utility, CHK16550.EXE. Foray PPP Client xe "modem requirements\:workstation"xe "workstation\:modem requirements"xe "requirements\:modem"Modem Requirements Foray PPP Client will perform best if you use high-speed V.32 V.32bis or V.42 V.42bis modemsxe "modems" on both the -based server and the workstation. Foray PPP Client requires at least a 2400 bps modem with an effective throughput of 2400-4800 bps. This minimum level of performance will not be satisfactory with some applications. Foray PPP Client Workstation Packagexe "Foray PPP Client Workstation Package"xe "files, Foray PPP Client" The Foray PPP Client Workstation, in its uncompressed format, contains the following files: README.1STxe "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.TXTxe "LICENSE.TXT" The complete Foray PPP Client licensing and registrationxe "registration" agreement for evaluation users. QCKSTART.TXTxe "QCKSTART.TXT" A summary of the README.1STxe "README.1ST" and INSTALL.TXTxe "INSTALL.TXT" files which outlines the install process and the potential system conflicts for the expert user. LANINSL.TXT Installation and configuration instructions for workstations using LAN WorkPlace as a protocol stack with Foray PPP Client. MSINSL.TXT Installation and configuration instructions for workstations using TCP/IP as a protocol stack with Foray PPP Client. FEEDBACK.TXTxe "FEEDBACK.TXT" A customer survey regarding how well our documentation and support serves you. Please fill it out and return it to us. FAQ.TXT A text file which contains the update FAQ's files from the few fabulous fellows from TechSmith's Support Department. SUPPORT.TXTxe "SUPPORT.TXT" A Technical Support form which you can use to send us detailed information about problems you need help resolving. INDEX.TXT A description of the .ZIP bundles currently placed in this directory of TechSmiths FTP site. CATALOG.TXTxe "CATALOG.TXT" A convenient catalog of other TechSmith products. 4APPPCLN.DOCxe "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.INIxe "REGISTER.INI" For preregistered versions only, a file which contains the registrationxe "registration" number of the software. (This file is normally generated by the registration utility included with the evaluation version of Foray PPP Client.) VENDINFO.DIZxe "VENDINFO.DIZ" A special file for vendors containing product information in ASCII text and standard tools for electronic distributors. VENDOR.DIZxe "VENDOR.DIZ" Another file for vendors containing product information. xe "SETUP.EXE"SETUP.EXE The installation program for installing a Foray PPP Client workstation from Windowsxe "Windows". xe "SETUP.INS"SETUP.INS Supporting file for Windowsxe "Windows" setup. SETUP RAS.LIB The library file for the Foray PPP Client setup process. RASSETUP.INS The Foray PPP Client file which organizes the setup process. xe "CHK16550.EXE"xe "utilities\:CHK16550.EXE"CHK16550.EXE Utility program to check the workstation's serial port for a 16550 UART. EWAPI.386 The Foray PPP Client protected-mode services for the Foray PPP Client Control Panel under Windows. EWCMD.EXExe "EWCMD.EXE" A workstation command-line interface for operating the workstation communications driver. EWCONFIG.EXExe "EWCONFIG.EXE" Foray PPP Client configuration file, used by the Windowsxe "Windows" based Control Panelxe "Control Panel". xe "EWMODEM.INI"EWMODEM.INI File containing default modem strings for Foray PPP Client workstations; accessed by Foray PPP Client Control Panelxe "Control Panel". xe "EWPPP.EXE"EWPPPxe "EWPPP".EXE The Foray PPP Client ODIxe "ODI"-compliant workstation driver, which loads as a TSR. EWPPP.INS The Foray PPP Client install driver description for Netware. EWUNINST.INS The Foray PPP Client Uninstall program. xe "EWUSER.EXE"EWUSER.EXE The Foray PPP Client Control Panelxe "Control Panel" program, for configuring and operating the Foray PPP Client workstation software. EWUSER.INI The Foray PPP Client file which stores settings for the Foray PPP Client Control Panel. (Does not exist until Foray PPP Client is run for the first time.) xe "EWUSERW.EXE"EWUSERW.EXE Windowsxe "Windows"-based Foray PPP Client Control Panelxe "Control Panel" program, for configuring and operating the Foray PPP Client workstation software. xe "EWUSERW.HLP"EWUSERW.HLP Help file for Windowsxe "Windows"-based Foray PPP Client Control Panelxe "Control Panel" program. xe "EWVXD.386"EWVXD.386 Provides some protected-mode services to EWPPPxe "EWPPP", to improve performance under Windowsxe "Windows". LSL.COMxe "LSL.COM" Novellxe "Novell" link support layer network file. NTDIRECT.SCRxe "NTDIRECT.SCR" Script file which allows a direct connection with an NT Server. xe "NETCFG.TXT"SAMPLE.SCR Sample script file. IPCONFIG.PIF Windows program information file used to activate MS TCP/IP DHCP. xe "NU_STAT.EXE"OEMSETUP.INF Information file for installing and configuring Windowsxe "Windows" for Workgroupsxe "Windows for Workgroups". xe "RNBAPI.DLL"RNBAPIW.DLL Foray PPP Client Applications Programming Interface dynamic link library, used by Windowsxe "Windows"-based Foray PPP Client Control Panelxe "Control Panel". UNINST.ICO The icon file for the Foray PPP Client Uninstall program. Chapter 2 Installing the Foray PPP Clientxe "Installing the Foray PPP Client" This chapter will lead you through installing the Foray PPP Client, which involves copying the Foray PPP Client files onto your hard drive. (Configuring the Foray PPP Client for your workstation is explained in Chapter 3.) The chapter begins with an overview of the installation processxe "installation process" followed by useful installation tipsxe "installation tips" about setting your network stacksxe "network stacks". Then, a set of instructions for the actual installation process is given in sequential order. The instructions in this chapter assume that you are familiar with the version of Windowsxe "Windows" currently installed on your workstation. Topics Special Considerations for Evaluation Software Users Page 2-8 Overview of the Installation Process Page 2-8 Installation Tips: Ensuring Your Network Stacks are Installed Page 2-9 Novell Netware TCP/IP Stack LAN Workplace Installing the Foray PPP Client Files Page 2-9 Running Foray PPP Clients Setup Program Selecting the Drive Path and Installation Directory Selecting the Icon Group Special Considerations for Evaluation Softwarexe "Evaluation Software" Usersxe "Special Considerations for Evaluation Software Users" We welcome your interest in our Foray PPP Client product and would like to make your experience with it positive and productive. The evaluation copy is a fully functional version of our client software. The only difference between it and the registered version is a restriction on connect time: the unregistered clientxe "unregistered client" will only support 15 minute sessions. For your convenience, the registrationxe "registration" processxe "registration process" is outlined in Chapter 6 of this manual and an automated registration program have been provided under the Foray PPP Client Control Panelxe "Control Panel" menu option Help. The installation processxe "installation process" primarily copies files onto your hard drive. The process of configuring the software correctly for your workstation environment occurs later. If you do not yet have network software installed or a server to connect to, you can still install the Foray PPP Client on your workstation and configure it later. The configuration program is not initiated until the first time you run Foray PPP Client. We appreciate the time and effort that you have taken to evaluate our product, and your opinion is important to us. We encourage you to give us your comments, recommendations and criticisms about the Foray PPP Client. For your convenience in supplying your opinions, we have included a customer survey text file, FEEDBACK.TXTxe "FEEDBACK.TXT". Overview of the Installation Processxe "Overview of the Installation Process"xe "Installation Process, Overview" A successful install process is usually the result of good planning and attention to instruction. Your Foray PPP Client installation is no exception. Please review the following overview of the steps involved in the Foray PPP Client installation processxe "installation process". (Detailed step-by-step instructions are provided later in this chapter.) This overview gives you a chance to consider whether you presently have the knowledge and resources to complete the installation process on your own. If you have any questions about what you will need to know or what you will need to have during the installation process, now would be a good time to review the list and to seek additional resources. Determine which of the supported protocols you will be using; IPXxe "IPX", TCP/IPxe "TCP/IP" or a combination of the two. If applicable, ensure you have installed your network stacksxe "network stacks" and Novellxe "Novell" Netwarexe "Netware" on your workstation. Run the installation program from the directory in which your Foray PPP Client software is located. If applicable, install Microsoftxe "Microsoft" TCP/IPxe "TCP/IP", Workplacexe "LAN Workplace" -- or another supported TCP/IP stack -- on your workstation before you configure and run Foray PPP Client for the first time. Installation Tipsxe "Installation Tips": Ensuring Your Network Drivers are Installedxe "Ensuring Your Network Drivers are Installed" In order to properly install the Foray PPP Client, you must also set up the appropriate network drivers, software which makes your workstation behave as if it were on a local network. The drivers you use will be determined by the network protocol(s) you intend to support. The Foray PPP Client supports IPXxe "IPX", TCP/IPxe "TCP/IP" or a combination of the two. Novellxe "Novell" Netwarexe "Netware" (IPXxe "IPX") If you have not already done so, you should set up your Novellxe "Novell" Netwarexe "Netware" driver before you proceed with the installing Foray PPP Client. When you set up Novellxe "Novell" Netwarexe "Netware", your choice of drivers will be irrelavent. Foray PPP Client will replace the driver you have choosen during its set up process. TCP/IPxe "TCP/IP" Stack If you have not already done so, you should also setup your Workplacexe "LAN Workplace" stack before you proceed with the installation of Foray PPP Client. If you are installing the Microsoftxe "Microsoft" TCP/IPxe "TCP/IP" stack (instead of using Workplacexe "LAN Workplace"), you must do it before you proceed with the configuration processxe "configuration process" outlined in Chapter 3. Microsoftxe "Microsoft" Networkingxe "Microsoft Networking" If you are running Windowsxe "Windows" for Workgroupsxe "Windows for Workgroups" and Netwarexe "Netware", you must install Novellxe "Novell" Netware drivers before you run the Windows Network Setup. When you run Windowsxe "Windows" Network Setup, you may see the error message, Unable to get the ODIxe "ODI" Driver Name during setup. This message occurs when the ODI drivers are not in memory. You can ignore this message. Foray PPP Client will provide the appropriate ODI driver when you run driver set up. Installing the Foray PPP Client Files A minimal amount of information is required to actually install the Foray PPP Client files on your workstation. Knowledge about your server, modem or memory requirements is not required at this stage. Running the setup program copies files contained in the Foray PPP Client bundle onto your hard disk and makes it possible to run the Foray PPP Client from Windowsxe "Windows". You can cancel the process at any point. Running the Foray PPP Clients Setup Programxe "Running the Foray PPP Clients Setup Program" Foray PPP Client comes with an installation program which will automatically copy its files into a directory. To begin this program, you will need to access it through your Windowsxe "Windows" Program Manager. Using the File menu from your Program Manager, choose the Run option. Run the SETUP.EXE from the drive and directory in which your Foray PPP Client software resides. For example, in the Run dialogue box, you would type the following: C:\TEMP\SETUP.EXE (Hard drive, TEMP directory) or A:SETUP.EXE (Floppy drive) Select OK. Selecting the Installation Drive and Directoryxe "Selecting the Installation Drive and Directory" The Select Path dialogue box instructs you to choose a drive and directory to which you would like to install Foray PPP Client. If you do not want the Setup program to install Foray Client in the default directory shown, change the selections in Install To. Check the Space Required and Target Drive Status statistics to insure that you have enough room to install Foray PPP Client on the drive you have chosen. Click on Next. Before the Setup program actually copies the Foray PPP Client files into its target directoryxe "target directory", it will give you the option to go back and change your choice of drive and directory. If you choose to continue, you can also cancel the file installation processxe "installation process" at any point in the copying process by clicking on Cancel. Selecting the Groupxe "Selecting the Group" Once the Foray PPP Client files have been installed, the Setup program will prompt you to choose a place where you would like the Foray PPP Client icons to go on your Windowsxe "Windows" desktopxe "Windows desktop". If you would like the client to have its own Program Manager groupxe "Program Manager group", choose the default, EW Foray PPP Client. If not, choose an existing group from the list provided. After this final stage in the installation processxe "installation process", you will be given the option to open the README.1STxe "README.1ST" file which is bundled with the Foray PPP Client. Since the README.1ST file provides information about the client which may not be in the manual, we strongly recommend that you read it. Chapter 3 Configuring the Foray PPP Clientxe "workstation\:EWPPP"xe "workstation\:driver\:See EWPPP" You cannot proceed with configuring the Foray PPP Client until you have set up network stacksxe "network stacks" on your workstation. Without these, your remote workstation will not be able to use Foray PPP Client. The network stacks enable your workstation to behave as part of your network, while, by communicating with a PPP serverxe "PPP server", Foray PPP Client acts as a link to that network. Once you have set up your network stacksxe "network stacks" and installed Foray PPP Client, you are ready to configure your client workstation. In order to configure your workstation to work properly with your server, you must set up both its hardware and software components. The instructions in this chapter assume that you are familiar with the version of Windowsxe "Windows" on your workstation, your network software, your server and the communication protocol it uses. This chapter walks you through how to set up your modem, drivers, and user information and how to make your first remote connection. Topics Overview of the Configuration Process Page 3-12 Special Tips for Performing Modem Setup Page 3-12 Performing the Modem Setup Page 3-13 Modem Configuration Modem Setup Strings Special Tips for Performing the Driver Setup Page 3-14 Performing the Driver Setupxe "Driver Setup" Page 3-15 TCP/IPxe "TCP/IP" Configuration Advanced Driver Setupxe "Driver Setup" Permanent Virtual Memory Swap Special Tips for Entering User Information Page 3-17 Entering User Information Page 3-17 User Setup Phonebook Maintenancexe "Phonebook Maintenance" Making Your First Remote Connection with Foray PPP Client Page 3-18 Overview of the Configuration Processxe "configuration:overview"xe "Overview of the Configuration Process"xe "Configuration, Overview" The following is an overview which will help you perform tasks in sequence and gather useful information in order to set up your workstation. Like the overview at the beginning of the installation processxe "installation process", this overview gives you a chance to consider whether you presently have the knowledge and resources to complete the remote workstation configuration on your own. If you have any questions about what you will need to know in order to configure the Foray PPP Client for your workstation, now would be a good time to review the list and to seek additional resources. Optimize memory allocation. If you are not already using a memory manager and you are finding that your workstation is slow, you can change your system files to load Foray files high. For instructions, turn to Chapter 9 on Special Configuration Notes. Start the configuration processxe "configuration process". The configuration process will begin automatically when you select the Foray PPP Client icon for the first time. The Foray PPP Client Control Panelxe "Control Panel" will automatically initiate the configuration process based on the settings it finds. Before you can proceed, the Control Panel will ask you to verify that your network drivers and your protocol stackxe "protocol stack"(s) are in place. Set up your modem. Choose the model, speed and location of your workstation modem from the list which TechSmith provides under Setup/Modem options. Select the protocol stackxe "protocol stack" your remote workstation will use. This step will initiate automatic changes to your workstation configuration files. Implement Permanent Virtual Memory Swapxe "Permanent Virtual Memory Swap". If you are not currently using a Permanent Swap File, the Foray PPP Client setup program will lead you through the steps of creating one in Windowsxe "Windows" Setup. System reboot. Reboot your system to implement the changes which Foray PPP Client has made to your configuration files. Entering information about your workstation. This is where you have the option of entering the workstation name, i.e., Bills Laptop. You will also be asked to provide the phone number and name of your dial in server. When all of this information is entered, you can go ahead and make your first dial-up connection using Foray PPP Client. Special Tips for Performing the Modem Setupxe "modem:setup"xe "Special Tips for Performing the Modem Setup"xe "Modem Setup, Tips" Prior to setting up your modem, we would like to make the following recommendations. These have been developed as a result of interactive modem testing with the Foray PPP Client software. Foray PPP Client expects to find your modemxe "modem" on COM portxe "COM port:modem" 2. This is done to accommodate the majority of Windowsxe "Windows" users who have installed their mouse on COM portxe "on COM port:mouse" 1. If your modem is not on COM port 2, Foray PPP Client will not function properly. If you do not find your modem on the list provided in the Select Modemxe "Select Modem" screen and you are using a Hayes compatible modem, choose the Generic Modemxe "Generic Modem" option. If you do not choose one of the other modemsxe "modems" from our list, the setup program will use the string for Generic Modem, the default option. Performing the Modem Setupxe "modem:setup"xe "Performing the Modem Setup"xe "Modem Setup" The Foray PPP Client Setup program will not allow you to continue to with setup until you choose a modem string. A list of modemsxe "modems" is provided in the Foray PPP Client Control Panelxe "Control Panel" program under the Setup/Modem menu option. If you click on the Select Modemxe "Select Modem"... button on the Modem Setup dialogue box (or press alt+m), you will see a list of the modemsxe "modems" for which TechSmith Technical Supportxe "TechSmith Technical Support" has developed strings. When you select a modem from the list, the strings associated with this modem will appear in the Modem Setup boxxe "Modem Setup box". The default modem optionxe "default modem option" is Generic Modem. The default baud ratexe "default baud rate" is 19.2. Modem Configurationxe "Modem Configuration"xe "configuration, modem" The modemsxe "modems" that appear in the Select Modemxe "Select Modem" dialogue box are those for which TechSmith has developed workstation strings. If the modem you will be using appears in this list, select it and click on the OK button. If your modem does not appear in this list, press the Cancel button to return to the Modem Setup boxxe "Modem Setup box", where you will need to enter your modem name and an init string. The default dial prefix string is ATDT and the default dial suffix stringxe "suffix string, modem" is ^M. If your prefix and suffix are different, you will need to enter those as well. In Foray PPP Client workstation modem strings, you can use the following special commands: A caret followed by the letter M (^M) causes a carriage returnxe "carriage return", followed by a one second pause. A tildexe "tilde" (~) causes a one-half second pause. These commands are used for indicating the length of a pause to a device, like a modem. Placed at the end of a modem string, the special charactersxe "special characters, modem strings"xe "special characters, modem", ~ and ^M, tell the device how much time it has to respond to a message sent by another device. A one second pause is standard. Only special hardware requirements would warrant the use of a tilde. Refer to Modem Setup Strings for information about preparing modem strings for use with the Foray PPP Client workstation software. Modem Setup Stringsxe "Modem Setup Strings"xe "modem:strings" The Foray PPP Client Control Panelxe "Control Panel" reads the list of modemsxe "modems" and associated strings from the EWMODEM.INI file in the PPP Client workstation directory. If you are using a modem that does not appear in Foray PPP Client Control Panelxe "Control Panel" list or need to customize an existing string, do so in the Modem Setup boxxe "modem:setup box"xe "Modem Setup box" of the Foray PPP Client Control Panel. Your customized settings will be saved to the EWUSER.INIxe "EWUSER.INI" file, which contains all of the Foray PPP Client workstation defaultsxe "defaults". Do not edit the EWMODEM.INIxe "EWMODEM.INI" file to include additional or custom modem strings. TechSmith replaces this file with an updated version as a part of every future release, and any changes you have made to the file will be lost. If you have problems setting up your modem, contact Technical Support as outlined in the Preface under Foray PPP Client Technical Support. You have a problem using any of the modem strings supplied for use with Foray PPP Client. You wish to use a modem which is not listed with Foray PPP Client. Special Tips for Performing the Driver Setupxe "Driver Setup"xe "Special Tips for Performing the Driver Setup" TechSmith would like you to know about special situations which we have discovered in testing before you attempt to configure your Foray PPP Client workstation. The following tips will increase your understanding of software and memory requirements that apply to the Foray PPP Client. Know your TCP/IP stack. In its first release, Foray PPP Client supports the Workplacexe "LAN Workplace" and Microsoftxe "Microsoft" TCP/IPxe "TCP/IP" stacks. If you are using another stack, you should know your IP addressxe "IP address" before you start the Driver Setupxe "Driver Setup" process. Preserve Conventional Memory.xe "Memory.:Required" Before entering Windows, you must have 480K of conventional memory free to use the Foray PPP Client. For information on optimizing your use of workstation memory, please refer to TechSmiths FAQ on Loading High. Use only the Microsoft Windows communciations drivers. Foray PPP Client requires the original Microsoftxe "Microsoft" Windowsxe "Windows" communications driversxe "communications drivers". Some PCMCIAxe "PCMCIA" vendors (PC Card vendors) reconfigure Windows to load their own drivers in SYSTEM.INIxe "SYSTEM.INI" instead of the Microsoft drivers. In general, these drivers are not 100% compatible with Microsoft's drivers. The Foray PPP Client driver setup process removes those substitute drivers it recognizes, but vendors may release new drivers at any time. If a substitute driver is inadvertently left in, Windows will give a 'Virtual device ID conflict' message at startup. To solve the conflict, you must hand edit your SYSTEM. INIxe "SYSTEM. INI" FILE and remove the reference to the PCMCIA driver listed as causing the conflict. Performing the Driver Setupxe "Driver Setup" The Foray PPP Client Driver Setupxe "Driver Setup" prepares your workstations configuration files to work with Foray PPP Client.xe "EWPPP" When you perform Driver Setup, it modifies all the network drivers, adapters and protocols. This process, called the driver configuration, will add lines to the contents of your DOS, Windowsxe "Windows" and network configuration files. The Foray PPP Client will automatically back up these files prior to changing them. The Driver Setup process also makes it possible for other communications programs to use your workstation modifies. TCP/IPxe "TCP/IP" Configuration The Driver Setupxe "Driver Setup" asks you to specify the type of IP configuration which your TCP/IPxe "TCP/IP" stack uses to communicate with your PPP serverxe "PPP server". From the IP Configurationxe "IP Configuration" list provided, choose the TCP/IPxe "TCP/IP" stack installed on your workstation. Foray PPP Client has been tested with the Lan Workplacexe "LAN Workplace" and Microsoftxe "Microsoft" TCP/IP stacks. If you are using any other alternative TCP/IP stack, 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 an alternative TCP/IPxe "TCP/IP" stack, you must obtain a specific IP addressxe "IP address" (from your network administrator) before you proceed. Advanced Driver Settingsxe "Advanced Driver Settings" The Advanced Driver Settingsxe "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/IPxe "TCP/IP:Compression"xe "TCP/IP" Compression box allows you turn Van Jacobsonxe "Van Jacobson Header Compression" Header Compression on or off. If your workstation is having trouble negotiating with the PPP serverxe "PPP server", it may help to turn Van Jacobsonxe "Van Jacobson Header Compression" Header Compression off. Doing this will slow your transmission times, but may resolve the issue. Van Jacobsonxe "Van Jacobson Header Compression" Header Compression compares packets to a previous transmissions. You can change how many packets are compared by changing the number in the Slotsxe "Slots" box. The IPXxe "IPX" Compression box allows you turn IPX Header Compression on or off. Again, if your workstation is having trouble negotiating with the PPP serverxe "PPP server", it may help to turn IPXxe "IPX" Header Compression off. IPXxe "IPX" Header Compression compares packets to a previous transmissions. You can change how many packets are compared by changing the number in the Slotsxe "Slots" box. The PPPxe "PPP:Definition" box specifies the parameters for Point to Point Protocol on your workstation. The Maximum Receive Unitxe "Maximum Receive Unit" limits the size of the packet (in bytes) your workstation can receive from the PPP serverxe "PPP server". The default is 1500 Bauds, the size of one Ethernet Packet. The Character Mapxe "Character Map" escapes out characters which otherwise would be read as control characters by your PPP serverxe "PPP server". Configuration File Changesxe "Configuration File Changes" Based on your choice of protocol stacks, the Foray PPP Client Control Panelxe "Control Panel" will make changes to your workstation configuration files. Your AUTOEXEC.BATxe "AUTOEXEC.BAT" file will have lines added to it, so that Foray PPP Client specifications can be initiated when you power up your machine. Your SYSTEM.INIxe "SYSTEM.INI" and PROTOCOL.INIxe "PROTOCOL.INI" files will be reconfigured, so Windowsxe "Windows" operates effectively with your network setupxe "TCP/IP". Your NET.CFGxe "NET.CFG" file will be changed to suit the network drivers which Foray PPP Client uses. The Foray PPP Client Control Panelxe "Control Panel" will allow you to view these changes and compare the new file Foray PPP Client has created with your old ones, if you wish. Permanent Virtual Swap Filexe "Swap File:Creation" If you do not have a permanent swapfile, the Foray PPP Client Control Panelxe "Control Panel" prompts you to create a Permanent Virtual Swap File. Since the Foray PPP Client uses the Permanent Swap File to work with the Windows communication driver, we strongly recommend that you respond by clicking on the Yes option. If you click on Yes, the Foray PPP Client Control Panelxe "Control Panel" will initiate the Windowsxe "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 Memoryxe "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 (C: is the default) 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. Special Tips for Entering User Informationxe "User Information:Special Tips" The Foray PPP Client has the following restrictions with regard to its Phonebook User Information and User Setup utilities. Use a comma between special digits in your Phone number. If you must put a 9 in front of your phone number to dial-out of a switchboard, you should put a comma between the the 9 and the phone number e. g. 9,7638348. Check the Allow passwords to be saved in setup file box. Using the save option will ensure that your password is automatically saved in the Foray PPP Client setup file. Change your User Setup when you are dialing to a new PPP serverxe "PPP server". You can only input one user name and password in User Setup. If you are dialing into different PPP servers which each require a different user name and password, you will need to change your User Setup-- either in the User Setup or the Connection box -- before attempting a connection. Entering User Informationxe "User Information:Entering" Preparing your workstation for connecting to a PPP serverxe "PPP server" involves giving it specific user information, i.e., a phone number and user name. Here we guide you through this final stage of setting up your Foray PPP Client workstation. Phonebook Maintenancexe "Phonebook Maintenance" The Foray PPP Client Control Panelxe "Control Panel" will prompt you to input Phonebook information. Click on the Yes option, and the Control Panel will present the Phonebook Maintenancexe "Phonebook Maintenance" box. In the PPP serverxe "PPP server" name boxxe "PPP server name box" you can enter the name of the PPP server which you will be dialing-in to. The PPP server name is the key to the phonebookxe "phonebook" entries; the other information entered for each phonebook entry is associated with the PPP server name. In the Phone number box, enter the phone number which Foray PPP Client must dial to establish a connection. a company switchboard, these digits can be included in this number. In the Dial Timeout box, you can specify, in seconds, how long the Foray PPP Client will wait before it terminates a connection if the server does not respond. The default is 60 seconds. In the Scriptfile box, you can give the name of a Foray PPP Client scriptfile which you would like the Phonebook to use when it negotiates with the PPP serverxe "PPP server". You can turn on the Automatic dialxe "Automatic dial" option by clicking on its checkbox. The Automatic dial option allows you to work off-line until you open a network application. If you have turned on the Automatic dial option, the Foray PPP Client will automatically call the PPP serverxe "PPP server" when you open a network application. When you activate an Automatic dial process, the Foray PPP Client will use the Default PPP Server phone number. The Default PPP Serverxe "Default PPP Server" option allows you to specify a single phonebookxe "phonebook" entry as the default. If you do change the number you would like to dial, Foray PPP Client will use the Default option. User Setupxe "User Setup:Parameters" The Foray PPP Client Control Panelxe "Control Panel" will prompt you to input User (Setup) information. Click on the Yes option, and the Control Panel will present the User Setup box. In the User ID box, you must enter the user identification which allows you to logon to the remote network server. In the Passwordxe "Password" box, you must enter the password which you use to login to the remote network server. The password itself will not appear in the box. You will only see asterisks (*) indicating thepresence of a password. In the User Location box, you can indicate the location you are calling from, so the network administrator knows where your remote workstation is located, i.e. Coastal Office in Los Angeles. This entry is optional. In the Scriptfile Password box, you can enter the password which you would like a Foray PPP Client Scriptfile to use. If you are not using a scriptfile or you are using a scriptfile which does not require a password, this entry is optional. The Allow passwords to be saved in setup the file option lets you choose whether you want to save your password in a setup file or not. If you choose to have your password saved, you will not have to type it every time you dial-into the PPP serverxe "PPP server". Making Your First Remote Connection with Foray PPP Client When you are finished entering your user information, the Foray PPP Client will present the Connection box which shows all the Phonebook and User Setup information, just as you have typed it in. To make your first connection, click on the Dial button. Chapter 4 Using the xe "workstation\:using"xe "workstation\:introduction"Foray PPP Client Youve installed and set up the Foray PPP Client on your workstation, and now its time to establish a connection. This chapter explains the basic operational functions of the Foray PPP Client. Topics Dialing into a Remote Server with Foray PPP Client Page 4-20 Manual Dialing Callback Ending a Foray PPP Client Session Page 4-21 Hanging up the phone Unloading the Workstation Driver Dialing Into axe "LAN gateway\:dialing in from a workstation"xe "workstation\:dialing in to a LAN gateway"xe "dialing in" Remote Server with Foray PPP Client Foray PPP Client makes working with a dial-in connection as easy as using a workstation on the network. In Windowsxe "Windows", simply start the Foray PPP Client Control Panel and initiate a connectionxe "Control Panel". If your connection parameters are already set correctly and xe "autodial"autodial is enabled, you can minimize the Control Panelxe "Control Panel" and work as you normally do. The Control Panel automatically dials-in to the Default Remote server and makes the network connection when you try to login to the network or access any network service. When your application first requests network services and prompts Foray PPP Client to autodialxe "autodial", it will have to wait for a response while Foray PPP Client dials the phone and connects to your network. While this is happening, many applications will display a message advising you that the application failed to complete the action you requested. Generally, you can ignore these messages. When Foray PPP Client has established a connection, you can continue to work as you normally would. Manual Dialingxe "Manual Dialing" From the Foray PPP Client Control Panelxe "Control Panel", you can dial-in manually to the PPP serverxe "PPP server". Select Connect... from the Actions drop-down menu. You will see the Connection dialogue box. When you select Dial, the driver will attempt to dial using the current parameters. Callbackxe "Callback" Your companys security policy may require that the PPP serverxe "PPP server" call the workstation back at a pre-determined number before it will allow you to access the network. If this is the case, when you attempt to connect to the PPP serverxe "PPP server", you will see the Callback dialogue box, indicating that the workstation is waiting for the PPP server to call back. If you enter a phone number and select OK, the PPP serverxe "PPP server" will terminate the connection and call the workstation at tbe number you enter. If you select Cancel, you can continue to work over the existing connection if the PPP serverxe "PPP server" allows it. To terminate the connection with callback, select Hang Up. Ending a Foray PPP Clientxe "Foray PPP Client:Ending a Session" Sessionxe "LAN gateway\:ending a workstation session" When you are finished using network services, terminate the Foray PPP Client session by hanging up the phone. (Details about the Hang Up option are given below.) You should log off the network before hanging up; hanging up while logged in may cause workstation or server errors. After you hang up, the driver remains loaded in memory, ready to be used again, until you unload it or reboot. Hanging up the Phonexe "Hanging up the Phone"xe "Control Panel\:hanging up the phone" To hang up from within Windowsxe "Windows", start the Foray PPP Client Control Panelxe "Control Panel". Select Action from the menu. Select Hangupxe "Hangup". (If you are running Windowsxe "Windows" with the Control Panelxe "Control Panel" program minimized, click on the phone icon to display a menu with the Hangup option on it.) When you select Hangup, the icon will change to a phone with the receiver on-hook. Unloading the Workstation Driverxe "Unloading the Workstation Driver"xe "EWPPP\:unloading"xe "unloading EWPPP" It is not usually necessary to unload the workstation communications driver after hanging up the phone. It remains in memory but inactive when not in use. However, if you need to recover the memory EWPPPxe "EWPPP" is using, you may be able to unload it from the workstations memory. You will only be able to do this if you did not load any other programs after loading EWPPP, or if you can first unload all of the other programs loaded on top of it. To unload EWPPP, enter: ewppp u at the DOS prompt. Chapter 5 Licensingxe "Licensing:Foray PPP Client" the Foray PPP Clientxe "Foray PPP Client:Licensing" Software Once you have reached a decision to purchase the license for the Foray PPP Client, you will need to know your licensing options and the licensing process. TechSmith has made this process quick and easy. xe "Server software license"Here we explain how to license your evaluation copy of the Foray PPP Client and how to use your TechSmith registrationxe "registration" key to enable the full functionality of your software. Topics Understanding Electronically Distributed Software Page 5-23 Licensing Foray PPP Client Page 5-23 Submitting REGISTER.TXT to TechSmith Page 5-24 Understanding Electronically Distributed Softwarexe "electronically distributed software" The Foray PPP Client is electronically distributed software. Electronic distribution gives users an opportunity to acquire software and 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.TXTxe "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. Registering The Foray PPP Client The electronically distributed evaluation copy of the Foray PPP Client is a fully functioning copy of the software that has a 15 minute connection time limit. To remove this connection time limitation, you must obtain a software license and registrationxe "registration" key from provided by TechSmith. To obtain a Foray PPPxe "PPP" Client software licensexe "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 registrationxe "registration" program as part of the Help menu on your Control Panelxe "Control Panel"xe "ORDER.TXT". 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 registrationxe "registration" program will appear. When you select Begin Registrationxe "Begin Registration" from the Help menu, the registrationxe "registration" program will provide a form for your to fill out and generate a text file called REGISTER.TXT. This file must be edited to include details about about quantity and price. When TechSmith receives the information you provide in REGISTER.TXT, we will generate a personalized registrationxe "registration" key and send the key back to you. When you select Finish Registrationxe "Finish Registration" from the Help menu, you will be prompted to enter your personalized registrationxe "registration" key. To enable your Foray PPP Client with your personalized key, you must input your registrationxe "registration" key exactly as it isown and then reboot your system. For multi-user licencesxe "licenses:multi-user", subsequent installations must include the same company informatin for the registrationxe "registration" key to valid. Submitting REGISTER.TXTxe "REGISTER.TXT:Submitting" to TechSmith You can submit your registrationxe "registration" form, REGISTER.TXT, electronically or in printed form. If you wish to submit your registrationxe "registration" electronically, you can send REGISTER.TXT to us by email or, as of October 1, 1995, register at our website. email: sales.foray-client@TechSmith.comxe "Foray-Server@TechSmith.com" WWW: http://www.TechSmith.comxe "www.TechSmith.com" If you wish to submit your registrationxe "registration" in printed form, you can reach us by FAX or by mail. FAX: 517-333-1888 Attention: Foray Client Sales Mail: TechSmith Corporationxe "TechSmith Corporation" 3001 Coolidge Road, Suite 400 East sing, MI 48823-6320 Chapter 6 Using the Foray PPP Clientxe "Foray PPP Client:Control Panel" Control Panelxe "Control Panel" Foray PPP Client Control Panelxe "Control Panel" is your interface with the Foray PPP Client on the workstation. Once you load the Foray PPP Client workstation communications driver, all normal remote user operations are handled through the Control Panel. Foray PPP Client Control Panelxe "Control Panel" allows you to define and perform most basic communication functions of your workstation. These include: Set defaults for user, modem, and phonebookxe "phonebook" parameters that the workstation communications driver will use to establish a connection. Temporarily override those defaults for a particular session while maintaining your default parameters. Your permanent defaults are stored in EWUSER.INIxe "EWUSER.INI", an initialization file created by the Foray PPP Client Control Panelxe "Control Panel". Determine if the driver is loaded, and dynamically change its operating parameters to use values other than the defaults. Manually control the attached modem. Topics Using the Autodial Feature Page 6-28 Using the Command Menus Page 6-28 Actions Menu Options Menu Setup Menu Help Menu Understanding Control Panelxe "Control Panel" Messages Page 6-33 Server Messages Modem Messages Dial-in Messages Hang-up Messages Using the Autodialxe "Autodial" Feature To prepare the workstation to autodialxe "autodial", run the Windowsxe "Windows" version of the Foray PPP Client Control Panelxe "Control Panel" program (EWUSERW.EXExe "EWUSERW.EXE") with the Automatic dialxe "Automatic dial" box checked. (You select this feature on the Control Panels Setup/Phonebook dialogue box). We suggest, for your convenience, that you put EWUSERW.EXE in your Windows Start-up group so that it will run automatically every time you start Windows. When Foray PPP Client detects a login attempt or a request for network resources, it will automatically dial the phone, using the parameters set in the Control Panel, and establish a connection. There are circumstances in which you cannot use Foray PPP Clients autodialxe "autodial" feature, and will need to manually request a dial-in from the Foray PPP Client Control Panelxe "Control Panel": You cannot use the autodialxe "autodial:Exceptions"xe "autodial" feature for remote access to Microsoft Network Server network services. You cannot autodialxe "autodial" from a workstation that is using the Novellxe "Novell" NetWare NETX shell. Only workstations loading NetWare VLMs can autodial. If an attempt to autodialxe "autodial" fails, or the user aborts the dial, the Control Panelxe "Control Panel" will discard any autodial attempts that occur within 1 second. If another autodial attempt is made within 1 second, EWUSERW ignores the request and resets this time interval to disregard 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 redial. Using the Command Menusxe "Command Menus:Using" The menu options and dialogue boxes available from the Foray PPP Client Control Panelxe "Control Panel" are the same for both the DOS and Windowsxe "Windows" versions, except for two window oriented selections on the Options menu that appear only in the Windows version. Actions Menuxe "Actions Menu" Connect... Displays the Connection dialogue box, with the default settings for the userxe "Foray PPP Client Control Panel\:setting default user parameters"xe "user parameters\:setting in Foray PPP Client Control Panel", modemxe "communication parameters\:setting in Foray PPP Client Control Panel"xe "modem parameters\:setting in Foray PPP Client Control Panel"xe "Foray PPP Client Control Panel\:setting modem parameters" and phonebookxe "phonebook" parameterxe "Foray PPP Client Control Panel\:phonebook"xe "phonebook\:in Foray PPP Client Control Panel"s. You have the option to dial using these default parametersxe "Foray PPP Client Control Panel\:dialing in to a LAN gateway"xe "workstation\:dialing in to a LAN gateway using Foray PPP Client Control Panel", select an alternative phonebookxe "phonebook" entry, or enter a number that is not in the phonebook. You may also change user parameters (ID, password and location) on this screen. (To change your password from the workstation, your network administrator must have enabled this feature on the PPP serverxe "PPP server"). To specify a NetWare preferred server other than the default for this session, enter your UserID followed by an "@" symbol and the name of the NetWare preferred server in the UserID field. Note: Changes made in the Connection dialogue box are temporary, and are not saved to the EWUSER.INIxe "EWUSER.INI" file. To add new entries to your phonebookxe "phonebook", or to save your changes to existing entries, see Phonebook under Setup Menu.... This menu item is not available unless EWPPPxe "EWPPP" is loaded. xe "Foray PPP Client Control Panel\:hanging up the phone"xe "hanging up the phone\:from Foray PPP Client Control Panel"xe "phone\:hanging up from Foray PPP Client Control Panel"xe "workstation\:ending an Foray PPP Client session"xe "Foray PPP Client Control Panel\:actions menu\:hangup"Hangup Hangs up the telephone line for the current Foray PPP Client connection. xe "Foray PPP Client Control Panel\:actions menu\:exit"Exit Exits Foray PPP Client Control Panelxe "Control Panel". Options Menuxe "Foray PPP Client Control Panel\:menu commands\:Options menu"xe "Options menu\:Foray PPP Client Control Panel" xe "Foray PPP Client Control Panel\:options menu\:clear status window"Clear Status Window Clears old status messages from the message line under the Foray PPP Client Control Panelxe "Control Panel" menu. xe "Foray PPP Client Control Panel\:options menu\:small window"Small Window In Windowsxe "Windows", this option toggles the Foray PPP Client Control Panelxe "Control Panel" display between a large window, displaying more connection parameter and status information, and a smaller window showing less information xe "Foray PPP Client Control Panel\:options menu\:always on top"Always on Top In Windowsxe "Windows", this option toggles the Foray PPP Client Control Panelxe "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. You will not usually need to change this option. When the Foray PPP Client Control Panelxe "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 Windowsxe "Windows" and flash until you click once on the icon to acknowledge the change. xe "Foray PPP Client Control Panel\:options menu\:autoset driver variables"Autoset Driver Variables Toggles whether the Foray PPP Client Control Panelxe "Control Panel" should monitor the connection parameters stored in EWUSER.INIxe "EWUSER.INI" (user, modem, and phonebookxe "phonebook" defaults) and pass them to EWPPPxe "EWPPP" for use in automatic dialing situations. When this menu item is checked, Foray PPP Client Control Panel will maintain the default parameters in the driver unless there is a current connection. If there is a current connection, Foray PPP Client Control Panel will wait until that connection is completed before passing it default parameters. Setup Menu xe "Foray PPP Client Control Panel\:setup menu\:user..."xe "Foray PPP Client Control Panel\:user setup dialog box"User... Brings up the User Setup dialogue box, where you can enter default values for the following connection parameters xe "Foray PPP Client Control Panel\:entering user ID"xe "user ID\:entering in Foray PPP Client Control Panel"User ID Your User ID for theForay PPP Client PPP serverxe "PPP server" in the Phonebook. This parameter is logged on the Foray PP Client PPP server. xe "Foray PPP Client Control Panel\:entering password"xe "password\:entering in Foray PPP Client Control Panel"Password The password, if any, associated with your User ID for the Foray PPP Client PPP serverxe "PPP server" designated as the PPP server in the phonebookxe "phonebook". If the Foray PPP Client PPP server uses password security, this password must exactly match the password associated with your User ID on the PPP server. xe "Foray PPP Client Control Panel\:entering user location"xe "user location\:entering in Foray PPP Client Control Panel"User Location The remote location which is logged on the Foray PPP Client PPP serverxe "PPP server". Scriptfile Password The password that the script file processor will send when a script file uses the SEND "password" command. It differs from the regular Foray PPP Client security password in that it is used to respond to password prompts that the workstation encounters before it connects to the Foray PPP Client PPP serverxe "PPP server". xe "Foray PPP Client Control Panel\:entering user location"xe "user location\:entering in Foray PPP Client Control Panel"xe "Foray PPP Client Control Panel\:saving password"xe "password\:saving in Foray PPP Client Control Panel"Allow password to be saved in setup file checkbox Check this box to allow your password to be saved as an encrypted text string in the EWUSER.INIxe "EWUSER.INI" file, and passed automatically to the workstation communications driver when it dials in to the PPP serverxe "PPP server". If this box is not checked, you must enter a valid password in the Connect dialogue box before each dial-in. You can only use the Foray PPP Client automatic dialing feature if this box is checked. xe "Foray PPP Client Control Panel\:setup menu\:modem..."xe "Foray PPP Client Control Panel\:modem setup dialog box"xe "communications parameters\:setting in Foray PPP Client Control Panel"Modem... Brings up the Modem Setup dialogue box, where you can enter default values for the following connection parameters: xe "Foray PPP Client Control Panel\:selecting a modem"xe "selecting a modem\:from Foray PPP Client Control Panel"xe "modem\:selecting from Foray PPP Client Control Panel"Modem The name of the modem used with the Foray PPP Client workstation, either selected from the list of modemsxe "modems" accessed by pressing the Select Modemxe "Select Modem" button, or entered by the user if the desired modem does not appear in the list. If you need to create setup strings for a modem that is not in the. xe "Foray PPP Client Control Panel\:entering modem intialization string"xe "modem\:initialization strings\:entering from Foray PPP Client Control Panel"xe "communications parameters\:modem initialization string"Init string The modem initialization string which the Foray PPP Client workstation will use to dial-in to the PPP serverxe "PPP server". When you select a modem from the Select Modemxe "Select Modem" list, an appropriate initialization string is entered here automatically. If your modem is not on the list, you can enter a string for your modem in the box. See Modem Setup Strings. xe "Foray PPP Client Control Panel\:entering dial prefix"xe "modem prefix\:entering from Foray PPP Client Control Panel"xe "communications parameters\:entering modem prefix"xe "dial prefix\:entering from Foray PPP Client Control Panel"Dial Prefix The dial prefix which the Foray PPP Client workstation will use to dial-in to the PPP serverxe "PPP server". When you select a modem from the Select Modemxe "Select Modem" list, an appropriate dial prefix is entered here automatically. If your modem is not on the list, you can enter a prefix for your modem in the box. Default value is ATDT. xe "Foray PPP Client Control Panel\:entering dial suffix"xe "modem suffix\:entering from Foray PPP Client Control Panel"xe "communications parameters\:entering modem suffix"xe "dial suffix\:entering from Foray PPP Client Control Panel"Dial Suffix The dial suffix which the Foray PPP Client workstation will use to dial-in to the PPP serverxe "PPP server". When you select a modem from the Select Modemxe "Select Modem" list, an appropriate dial suffix is entered here automatically. If your modem is not on the list, you can enter a suffix for your modem in the box. Default value is ^M. xe "Foray PPP Client Control Panel\:setting baud rate"xe "baud rate\:setting from Foray PPP Client Control Panel"xe "communications parameters\:setting baud rate"Baud rate The maximum throughput for the Com port which the Foray PPP Client modem will use. To set this parameter, select the button corresponding to the correct baud rate. If you selected a modem from the Select Modemxe "Select Modem" list, Foray PPP Client assigns a default value that should be appropriate for your modem. xe "Foray PPP Client Control Panel\:setup menu\:phonebook..."xe "Foray PPP Client Control Panel\:phonebook maintenance dialog box"Phonebook... Brings up the Phonebook Maintenancexe "Phonebook Maintenance" dialogue box, where you can store phonebookxe "phonebook" entries for Foray PPP Client PPP servers. The information entered for each PPP serverxe "PPP server" includes the following connection parameters: xe "Foray PPP Client Control Panel\:entering PPP Server name"xe "PPP Server\:specifying in Foray PPP Client Control Panel" PPP Server Name The name of the PPP serverxe "PPP server". The PPP server name is the key to the phonebookxe "phonebook" entries; the other information entered for each phonebook entry is associated with the PPP server name. xe "Foray PPP Client Control Panel\:entering phone number"xe "phone number\:entering in Foray PPP Client Control Panel"xe "communications parameters\:entering phone number"Phone number The phone number you dial to access the PPP serverxe "PPP server". You can enter the phone number with or without hyphens. xe "Foray PPP Client Control Panel\:specifying dial time out"xe "dial time out\:specifying in Foray PPP Client Control Panel"xe "communications parameters\:specifying dial time out"Dial Timeout The dial timeout value is the time, in seconds, that the workstation driver will wait for validation of a connection with the PPP serverxe "PPP server" before terminating the dialing process. In general, the default value of 60 seconds should be fine. xe "Foray PPP Client Control Panel\:using a script file"xe "script\:selecting in Foray PPP Client Control Panel"Scriptfile The name of the script file, if any, that Foray PPP Client will use when dialing this PPP serverxe "PPP server". The default extension for Foray PPP Client script files is .SCR. To choose from a list of existing scriptfiles, click on Select scriptfile. This will display the Add Scriptfile dialogue box, where you can select from a list of files in the current directory. You can change the directory searched or the file extension, if necessary. To display the file text in the view window, highlight the file name and click on View. The Add button inserts the script file name into the PPP server phonebookxe "phonebook" definition. xe "Foray PPP Client Control Panel\:enabling autodial"xe "autodial\:enabing in Foray PPP Client Control Panel"xe "communications parameters\:autodial"Automatic dialxe "Automatic dial" checkbox Checking this box in the Windowsxe "Windows" Control Panelxe "Control Panel" enables the Foray PPP Client automatic dialing feature. When the remote workstation executes an application requiring services, EWPPPxe "EWPPP" will automatically initiate a connection with the PPP serverxe "PPP server" using its current connection parameters. You can only use the Foray PPP Client automatic dialing feature if the xe "Foray PPP Client Control Panel\:saving password"xe "password\:saving in Foray PPP Client Control Panel"Allow password to be saved in setup file checkbox box is selected. xe "Foray PPP Client Control Panel\:specifying default PPP Server"xe "default PPP Server\:specifying in Foray PPP Client Control Panel"Default PPP Server checkbox If this box is checked, this is the default phonebookxe "phonebook" entry stored in EWUSER.INIxe "EWUSER.INI". If the Autoset Driver Variables option (on the Option menu) is checked and you use an application on the workstation that requires services, this is the PPP serverxe "PPP server" xe "EWPPP"will dial. Help Menuxe "Foray PPP Client Control Panel\:menu commands\:Help menu"xe "Help menu\:Foray PPP Client Control Panel"xe "help\:from Foray PPP Client Control Panel"xe "Foray PPP Client Control Panel\:connection dialog box" Index Foray PPP Client Control Panelxe "Control Panel" help index. Use the TAB key to move the cursor between index headings, and press enter to display information about the highlighted heading. For context-sensitive help, press F1 from any menu or dialogue box. About About box, containing version and copyright information for Foray PPP Client Control Panelxe "Control Panel". Understanding Control Panelxe "Control Panel" Messages The following Control Panelxe "Control Panel" messages occur in response to requested and ongoing Foray PPP Client activities. Server Messagesxe "Messages:Server"xe "Server Messages" You may see one of the following messages after the workstation dials the phone, while it is attempting to connect to the PPP serverxe "PPP server": Invalid user ID or password! The Password Authentication Protocol failed. Enter the correct password and user ID in the Control Panelxe "Control Panel". No carrier after dialing. The workstation dialed successfully but did not detect an answer within the dial timeout period. Verify that the phone number entered in the Control Panelxe "Control Panel" is correct. Negotiation with PPP Server failed The workstation parameters conflict with the server parameters: the two devices cannot communicate. Modem Messagesxe "Messages:Modem"xe "Modem Messages" You may see one of the following messages after the workstation sends the modem initialization string: Carrier detected - should be off. Possible incorrect init string The workstation detected carrier after it sent the modem initialization string. Carrier should be off, since the modem has not yet dialed the phone. Verify that your modem initialization string specifies the carrier detect option (usually &C1). Modem returns ERROR, check initialization string The modem returned an error to the workstation. DSR not asserted. Modem turned off or error in init string If you receive this message you need to check that your modem initialization string is set DSR (Data Set Ready) on (usually &S0). CTS not asserted. Modem turned off or error in init string If you received this message, you need to check that your modem initialization string enables CTS (Clear TO Set) hardware flow control. Dial-in Messagesxe "Dial-in Messages"xe "Messages:Dial-in" You may see one of the following messages after the modem dials the phone, while it is waiting for carrier: Timed out -- host busy or not answering The workstation did not establish a connection during the dial timeout period. Verify that the phone number entered in the Control Panelxe "Control Panel" is correct. Lost DSR -- Modem turned off? After dialing the phone, the modem dropped DSR (Data Set Ready) while waiting for carrier. Hang-Up Messagesxe "Messages:Hang-Up"xe "Hang-Up Messages" You may see one of the following messages after the workstation tries to hang up a connection: User Hangup User requested a disconnect through the Control Panelxe "Control Panel". Hangup failed! DCD still high The workstation tried to disconnect, failed and is indicating DCD (Data Carrier Detect). Make sure your modem string is correct. Chapter 7 Using the Command Line Interfacexe "workstation\:command line interface"xe "Foray PPP Client\:workstation command line interface" The Foray PPP Client workstation software includes a program that you can use to interface with the Foray PPP Client. The Command Line Interface program, EWCMD, can be used from either the DOS command line or from within your Windowsxe "Windows" environment. You can use the Command Line Interface to perform the following functions: Permanently configure the workstation driver for your modem and PPP serverxe "PPP server" or temporarily override the default dial-in configuration. Determine whether the driver is loaded and dynamically alter its operating parameters. Manually control the attached modem. EWCMD duplicates many of the operations that you can perform from the Foray PPP Client Control Panelxe "Control Panel". Unlike the Control Panel, the configuration options that you enter in EWCMD are not saved. They affect only the current session. Topics Running EWCMD from DOS Page 7-37 Command Syntax Command Line Parameters Running EWCMD from Windowsxe "Windows" Page 7-40 File Modem Setup Help Return Codes Page 7-41 Running xe "EWCMD\:running from DOS"xe "workstation command line interface\:running from DOS"EWCMD From DOS To run EWCMD.EXExe "EWCMD.EXE" from the DOS command line, enter the following command: ewcmd [command] [param1 param2] Command xe "syntax\:EWCMD"xe "command line\:EWCMD"xe "EWCMD\:syntax"xe "workstation command line interface\:syntax"Syntax The command line parameters, described below, are not case-sensitive. The -l and -s commands require additional parameters. If you enter EWCMD without parameters, or with an invalid command option, you will see a status screen, similar to the example below, giving the workstation communications drivers status, and its current operating parameters. EWCMD Version 2.0 User Interface - Enterprise Wide (R) Foray TM PPP Client Utility Prog Copyright (C) 1991-1995 TechSmith Corporation. All Rights Reserved. EWPPPxe "EWPPP" is enabled EWPPPxe "EWPPP" is not connected to the Remote server Version Number : 2.00 User Id : Location : 79 Phone Number : Modem Init String : AT&F^MATE0&SF1X4&S0^M Dial Prefix : ATDT Dial Suffix : ^M Com Port : 1 Bit Rate : 57600 Remote server Msg : No Error When using the command line interface to change driver parameters, you will see a message like the one below confirming that your change has been accepted. EWCMD Version 2.0 User Interface - Enterprise Wide (R) Foray TM PPP Client Utility Program Copyright (C) 1991-1995 TechSmith Corporation. All Rights Reserved. EWPPPxe "EWPPP" Parameter : connectmsg New Value : hello Command Line Parametersxe "command line parameters\:EWCMD"xe "command line\:EWCMD\:parameters"xe "EWCMD\:command line parameters"xe "workstation command line interface\:command line parameters" -d Dial: Initiates dialing using parameters stored in the driver. (To change the phone number or other parameters, see -s, below.) -h Hang-up: Causes the modem to disconnect. -l [path\]scriptname Logon: Executes the script file whose name you have supplied as an argument. You can look up more on creating logon scripts in Chapter 9 of this guide, Using the Foray PPP Client Scripting Language. -s parm newvalue Set Parameters: Allows the user to set various internal operating parameters in the driver. This command uses parm and newvalue as command line arguments. The following is a list of available parm values and the descriptions of corresponding valid entries for newvalue. BITRATE Specifies the new baud rate the modem will use. COMPORT Specifies the new COM port setting to use. CONNECTMSG Returns the connect message from the modem each time the driver makes a phone call. DIALPREFIX Defines the string that is sent to the modem to initiate dialing. DIALSUFFIX Defines the string that is sent to the modem immediately following the phone number. DIALTIMEOUT Designates the length of time the modem should wait for a response before assuming a connection is unavailable. LOCATION Specifies the location code from which the connection is being established. The location is written to a log file on the PPP serverxe "PPP server" PC. MODEMINIT Defines the first string that is sent to the modem each time the driver makes a phone call. PHONENO Defines the phone number that you want EWPPPxe "EWPPP" to call. PASSWORD Provides your user password. If the PPP serverxe "PPP server" you are dialing maintains user password security, you must enter a valid password and user ID. USERID Provides your user identification code to the connected PPP serverxe "PPP server". -? Help: Displays the following screen of help information, which includes all the commands listed above. EWCMD Version 2.0 User Interface - Enterprise Wide (R) Foray TM PPP Client Utility Copyright (C) 1991-1995 TechSmith Corp. All Rights Reserved. USAGE: EWCMD [-d | -h | -q | -s PARM NEWVALUE ] -c = change password currentpassword newpassword -d = Dial phone using current phone number -h = Hang up phone -l = Process logon script -s = Set a parameter to a new value Current parameters are: MODEMINIT USERID DIALPREFIX LOCATION DIALSUFFIX PASSWORD COMPORT BITRATE PHONENO DIALTIMEOUT -? = "Help" mode - Display this list of commands Running xe "EWCMD\:running from Windows"xe "workstation command line interface\:running from Windows"xe "Windows\:running EWCMD"EWCMD From Windowsxe "Windows" EWCMD can also be run from your Windowsxe "Windows" environment. To run EWCMD from within Windows, select File/Run from the Windows Program Manager drop-down menu bar. In the dialogue box that appears, enter EWCMD in the command line field, and then select OK. The EWCMD window will open and will display the current EWPPPxe "EWPPP" parameters. The EWPPP menu bar allows you to perform actions in the following areas; File, Modem, Setup and Help. Your choices in each area are shown below. File Run Run a customized script file. Exit Exits the EWCMD Windowsxe "Windows" utility only. EWPPPxe "EWPPP" remains loaded in memory. Modem Dial Causes the modem to dial, using the modem strings, calling information, and password entered under the Setup options. Hangup Causes the modem to hang up, ending your Foray PPP Client session. Setup Modem Strings Allows you to enter the modem initialization string, dial prefix, and dial suffix you want the driver to use for this session only. If you want to save these values to use again later, enter them in the Foray PPP Client Control Panelxe "Control Panel" instead of EWCMD. Calling Information Allows you to enter the User ID, Location, Password, and Phone number you want to use for this session only. If you want to save these values to use again later, enter them in the Foray PPP Client Control Panelxe "Control Panel" instead of EWCMD. Help About EWCMD Displays information about your version of EWCMD, the workstation communications driver, and the APIxe "API" version.xe \r "bk0" "EWCMD"xe \r "bk1" "workstation command line interface" Return Codesxe "EWCMD\:return codes"xe "return codes\:EWCMD" At termination, EWUSER.EXE returns an exit code to DOS. The DOS error level is returned as follows: 0 Successful connection 1 No connection 2 Workstation driver not loaded Chapter 8 The Foray PPP Client xe "Foray PPP Client\:using a script file"Scripting Languagexe "Scripting Language" Script files allow you to customize your modem sessions. With script files you can send special characters to the modem, and designate when and why information is sent. In a dial-in process, script commands can also be used to display connection status messages on your workstation. Foray PPP Client has a scripting language which you can use to automate special dialing situations. You will not need to use the scripting language in ordinary remote access situations. Examples of when you might want to use a script file include: Dialing out through a PBXxe "PBX" that requires a password or special characters to obtain an outside line. Dialing into CompuServexe "CompuServe" and other networks that require you to select the services you want when you make the connection. This chapter introduces you to the Foray PPP Client scripting language. It contains a features overview, help on creating a script file, and a sample application. Topics What is the Foray PPP Scripting Language? Page 8-44 Creating a Foray PPP Client Script File Page 8-44 Additional Notes on Preparing Foray PPP Scripts Sample Foray PPP Client Script File Dialing in Foray PPP Client Script File Page 8-47 What is the Foray PPP Scripting Language? The Foray PPP Client scripting language is a set of commands that can be used to instruct the Foray PPP Client software. Here are some simple guidelines that will help you understand and use our scripting language: A Foray PPP Client script file is essentially a DOS text file. Building a script file is no more complicated than creating a file with a text editor. A Foray PPP Client script file does not require any special formatting. You can enter scripting language commands in any combination of upper and lower case characters. Placing comments in your script file is as simple as inserting a semicolon and writing your comment after it. Any text following a semicolon, on the same line, is considered to be a comment by the Foray PPP Client. Creating a Foray PPP Client Script Filexe "script\:creating"xe "creating script files"xe "dialing scripts\:creating"xe "workstation\:creating dialing scripts" When you create a script file to use with the Foray PPP Client, you can use the table below to help you identify and use commands. On the left is the exact syntax of each command, and, on the right, is a description of the command and its possible uses. Command Description ; comment Any text following a semicolon on a line is considered a comment. beep Beeps the PC speaker. You can use this to get the workstation users attention. delay nnn Pauses script file execution for nnn milliseconds. dial nnn-nnnn Sends the following to the modem, in sequence, initiating a dial up session: The modem initialization string loaded in the workstation communications driver. The modem dial prefix loaded in the workstation communications driver. The phone number nnn-nnnn specified in the dial command. (If you do not specify a number to dial, it sends the default phone number from the Foray PPP Client Control Panelxe "Control Panel" or EWCMD.) The modem dial suffix loaded in the workstation communications driver. dial override Dials the number that is selected in the Foray PPP Client control panel when the script is run. If the user enters a new number, the script will dial that number instead. display xxx Displays the quoted text xxx on the screen. displayln xxx Displays the quoted text xxx on the screen and issues a new line command. This places the text from the next display command on a new line. exit Terminates script file execution at this point. gatemsg xxx Sends the string xxx as a text message to the PPP serverxe "PPP server". The PPP server then writes the message to the ACS.LOG file, and displays the first 38 characters of the message in the Log window of the PPP server console display. If logging is enabled on the PPP server, the message is also written to the DIAG.LOG file. A script can only execute this command after the client receives an ACS Connect message from the PPP server, confirming a successful connection. Executing this keyword before the client receives the ACS Connect message results in an error. goto label Searches for label in the script, and continues processing from that point. If label occurs more than once in the script file, it continues processing from the label closest to the end of the script file. hangup Disconnects the phone line connection. elseif string goto label A conditional statement that compares string to the next line of text received through the serial port from the host. The comparison is performed when a carriage return or line feed terminates the line, or after three seconds have elapsed without a line feed. If the text received matches string exactly, processing proceeds from the label specified in the goto statement. Otherwise, processing continues with the line following this command. The comparison is not case sensitive. prompt xxx Displays the text xxx as a prompt on the screen, and waits for a response from the user. It also displays the users response on the screen as it is typed. It then sends the response to the modem, without a carriage return, when the user presses the enter key. password xxx Displays the text xxx as a prompt on the screen, and waits for the user to enter a password. The user response is not echoed back to the screen as it is typed, for security reasons. When the user presses the enter key, the string is sent to the modem without a carriage return. send xxx Sends the string xxx to the modem. To send a control character, use a carat (^) before the character. Each send command must end with a carriage return (^M). send "password*" Send a script file password. Instead of the password* keyword, the script processor will substitute the script file password stored in encrypted form in the EWUSER.INIxe "EWUSER.INI" file. To enter or change a script file password, open User Setup in the Foray PPP Client Control Panelxe "Control Panel". set dtr [off|on] Controls the state of the RS232 Data Terminal Ready (DTRxe "DTR") signal. Setting DTR on indicates that the workstation communications driver is ready to communicate. For some PBXs or other devices, you may need to toggle DTR off and on to signal that you are ready to begin communicating. set timeout nn Determines the maximum wait, in seconds, used by the waitfor command. The default value is 10 seconds. waitfor xxxx Pauses execution until the modem receives the characters in the quoted string, or until time specified by the set timeout command has elapsed. The match is not case sensitive, that is, ABC matches abc. If the modem does not receive matching characters within the timeout period, the script terminates. Used to allow the script to wait for a host prompt. Additional Notes on Preparing Foray PPP Client Scriptsxe "script\:preparation notes"xe "dialing scripts\:preparation notes" There is a 32-character limit for script file command lines. Lines longer than 32 characters will generate an error during script processing. The first line of a Foray PPP Client script is intended to be a header line, so it is not executed. We recommend using this line as a comment to avoid confusion. Sample Foray PPP Client Script Filexe "Script File:Sample" xe "scripts\:example" The workstation software includes an example that illustrates how you can use dialing scripts. The following script file, CNSPAD.SCR, shows how to dial-into an X.25 PAD, and shows how you can use conditional processing in a script that prompts users for responses to host logon procedures. ; CompuServexe "CompuServe" Network Services Dialing Script ; ; Set the timeout. set timeout 20 ; ; Hangup the modem. hangup ; ; Wait for the modem to hangup. delay 500 ; display "Dialing into " displayln "Compuserve..." ; ; Dial the phone number selected in the Control Panelxe "Control Panel". dial "override" ; ; Wait for the connection to settle down. delay 500 ; ; Send a CR to get PAD's attention. send "+^M" ; ; Wait for Host Name prompt. waitfor "Host Name: " ; display "Sending Host " displayln "Name..." ; ; Send the CompuServexe "CompuServe" host name followed by CR, "XXXX" in ; this example. ; NOTE: Replace XXXX with your appropriate host name. delay 500 send "XXXX^M" ; ; Test for type of prompt you receive ; and jump to the appropriate section ; uicpmt: waitfor "UIC: " ; ; Prompt user to enter User ID, and return on . delay 500 prompt "Enter User ID: " send "^M" ; Send CR to end User ID string. ; Check to see if a correct UIC was entered ; if "? An Incorrect UIC" goto uicpmt elseif "Password: " goto passwd ; ; Wait for Password prompt from CompuServexe "CompuServe". ; wpasswd: waitfor "Password: " passwd: ; ; Prompt user to enter Password, and return on . delay 500 password "Enter Password: " send "^M" ; Send CR to end Password string. ; Test for invalid password. Reenter if invalid ; if "? An incorrect password" goto wpasswd ; ; wait for the host to acknowledge the connection waitfor "acs connect" ; display "Successful connect " displayln "to the communications PPP serverxe "PPP server"." exit Dialing In Using a Foray PPP Client Script File You can use the Control Panelxe "Control Panel" to run axe "dialing in\:using a script file"xe "script files\:using"xe "LAN gateway\:dialing in using a script file " script file. To use a script file, select Phonebook... from the Setup drop-down menu. In the Connection dialogue box, enter the file name in the Script file field, or click on the Select Script file button to display a list of selectable script files. If the script uses the Send Password command to respond to password prompts encountered before connecting to the PPP serverxe "PPP server", enter your script file password in the Script file Password field. (You will not need to do this if you have already entered your script file password in the User Setup dialogue box and allowed your passwords to be saved in your setup file.) Then select the Dial button at the bottom of the window. The driver will immediately attempt to dial using the current parameters. Chapter 9 Special Configuration Notesxe "Special Configuration Notes" In this chapter, we have provided developers notes about configuring your workstation in special circumstances. These instructions and tips have come out of the testing process for Foray PPP Client. Topics Optimizing Your Workstations Memory Page 9-50 Editing Your CONFIG.SYS file Editing Your AUTOEXEC.BAT file Editing Your NET.CFG file Tips for Configuring Your Workstation Using the Foray PPP Client with Your NT Server Page 9-52 Configuring the NT Server Tips for Using the NT Server with the Foray PPP Client Optimizing Your Workstations Memoryxe "Configuring:Workstation Memory"xe "Optimizing Your Workstations Memory" If you are not running a memory managerxe "memory manager" and your workstation produces insufficient memory messages when you execute programs, you can edit your workstations configuration files to make your pcs use of memory more efficient. If you do not have enough memory to run your DOS editor, you must unload some files from memory before you begin. We suggest that unloading two files, VLM.EXE and IPXODI.COM, from conventional memory will help solve this problem. To unload these files from conventional memory, type the name of each file, a space and a u at the DOS prompt: c:\>vlm.exe u c:\>ipxodi.com u Editing Your CONFIG.SYS filexe "CONFIG.SYS file" In your CONFIG.SYS file, you can add lines which will tell workstation to load certain application files high or above the level of conventional memoryxe "conventional memory". If you are not already using a memory manager, the following lines must be present to allocate memory high: dos = high,umb device = c:\dos\himem.sys device = c:\dos\emm386.exe noems To change your memory allocationxe "memory allocation", follow these steps. Change to your root directory by typing c: at the DOS prompt. Open your CONFIG.SYS file with your DOS editor by typing edit config.sys Add the necessary lines to the text. Save your changes. Exit the file. Reboot the machine to effect this change. Editing Your AUTOEXEC.BAT filexe "AUTOEXEC.BAT file" Once your workstation allocates high memory, you must specify, in your AUTOEXEC.BAT file, which files you want loaded high. We suggest loading xe "loading high" these files high from the Foray PPP Client bundle: LSL.COMxe "LSL.COM" IPXODI.COMxe "IPXODI.COM" VLM.EXExe "VLM.EXE" NETX.EXExe "NETX.EXE". Please note that attempting to load EWPPP.EXE high does not improve use of memory on your workstation. To load files into high memory, edit your AUTOEXEC.BAT in the following way: Change to your root directory by typing c: at the DOS prompt. Open your AUTOEXEC.BAT file with your DOS editor by typing edit autoexec.bat. Find each program file listed above. Insert the load high command and a space in front of the program file you want to load high. For example, when you find the program file c:\foray\lsl.com change the syntax to lh c:\foray\lsl.com Save your changes. Exit the file. Reboot the machine to effect this change. Editing Your NET.CFG filexe "NET.CFG file" If editing your CONFIG.SYS and AUTOEXEC.BAT does not free up enough conventional memory, you can also edit NET.CFG. We suggest that you find the Netware DOS Requesterxe "Netware DOS Requester" section of this file and add two lines to it: load low conn = off load low ipxncp = off These lines will load IP and IPX stacks into high memory. To edit your NET.CFG file, follow these steps. Change to the directory in which your active NET.CFG file resides. If you have not installed Novell before using the Foray PPP Client, the NET.CFG will be in your FORAY directory. Open your NET.CFG file with your DOS editor by typing edit net.cfg Find the Netware DOS Requester section in the file. Add the following lines under the Netware DOS Requester heading: load low conn = off load low ipxncp = off Save your changes. Exit the file. Reboot the machine to effect this change. Tips for Configuring Your Workstation IFSHLP.SYSxe "IFSHLP.SYS" is a device driver that is needed for Microsoft Networking under Windows for Workgroups (but not in Windows 3.1). When the user runs Network Setupxe "Network Setup", Network Setup fails to install IFSHLP.SYS in some circumstances. You are missing this file in your CONFIG.SYS, if you receive the following message in a dialogue box: " The Windows for Workgroups network was not started. Check your configuration, or run Setup again to set up Windows for Workgroups properly. The Windows for Workgroups network driver was unable to load." To add IFSHELP.SYS to your CONFIG.SYS file, open the CONFIG.SYS with your DOS editor and add the following line at the bottom of the file text: device = c:\windows\ifshelp.sys Reboot the machine to effect this change. Using the Foray PPP Client with your NT Serverxe "NT Server:Configuring" If you will be using your Foray PPP Client to access a Microsoft Windows NT Serverxe "Windows NT Server:Configuring", there are several server settings that should be enabled, if the Foray PPP Client is to perform effectively. Configuring the NT Server The NT server settings you will need to change have a common Windows NT configuration path: Open Control Panel. Open Network. Select Remote Access Service in the Installed Network Software window. Select Configure. Select Network... From the Network... window; Select IPX and Configure. This will display the options to Allow Remote Clients to Request IPX Node Numbers and to Assign Same Network Number to All IPX Clients. Select both of these options. Select OK to close the Configure and IPX windows. Select Encryption Settings. This will display the option to Allow Any Authentication Including Clear Text. Select this option. Select OK to close the Encryption Settings window. You will be prompted to perform a system Reboot, so the changes that you have made can take effect. Select OK. Prior to making you Foray PPP Client connection, it will also be necessary to create a valid user account on the NT Server. Your NT Server is now ready for Foray PPP Client remote access. Tips for Using the NT Server with Foray PPP Client When using automatic IP address assignment for MS TCP/IP against a Foray or NT server, you will also get a Domain Name Serverxe "Domain Name Server"( DNSxe "DNS") address, if the server is configured to send it to the workstation. This DNS address will be used if the workstation does not have a statically configured DNS address. I IP applications that use DNSxe "DNS" servers generally get the DNS address when they are first loaded. If you use autodial, there will not be a DNS address available. Therefore, IP applications will fail on autodials. To resolve this conflict you can use one of the following approaches: one, statically assign your DNS address; two, exit the application after the connection is established, and run it again; or, three, do not use autodial with automatic DNS address assignment. If you are having problems accessing NT serversxe "NT servers" using Microsoft's TCP/IP stack, install a Windows Internet Name Serverxe "Windows Internet Name Server" (WINS Serverxe "WINS Server") on an NT server on the network. This will make NT servers visible across network routers (like a PPP gateway). For more information, see the Windows NT Resource Kit. On the workstation, enter the addresses of the primary and secondary WINS serverxe "WINS server" on the network. If there is only one WINS server, enter its address as both the primary and secondary servers. These addresses can be set from Windows Network Setup program. Select the 'Drivers' button, highlight 'Microsoft TCP/IP-32' and press the 'Setup' button. This will bring up a dialog box where these settings can be entered. Be certain you are running version 3.11a or newer of the Microsoft TCP/IP stack. The version number can be checked by running the Windows Network Setup program, and looking at the Drivers box. If the TCP/IP stack is listed as 'Microsoft TCP/IP-32 3.11' with no letter after the version '3.11', you will need to obtain a newer version. It is not possible to browse the list of servers from a workstation running Windows for Workgroups with Microsoft's TCP/IP-32 and no other protocols. This is due to a shortcoming in Windows for Workgroups. It is possible to browse the list of servers if Microsoft's IPX with Netbios protocol is installed in addition to TCP/IP. index \h "A" \c "2"  4 4APPPCLN.DOC, 4 4DOS.COM, 3 A Actions Menu, 28 Advanced Driver Settings, 15 API, 3, 41 Autodial, 3, 20, 28 Exceptions, 28 Autodial:enabing in Foray PPP Client Control Panel, 32 AUTOEXEC.BAT, ii, 16 AUTOEXEC.BAT file, 51 Automatic dial, 18, 28, 32 B Baud rate:setting from Foray PPP Client Control Panel, 31 Begin Registration, 24 C Callback, 3, 20 Carriage return, 13 CATALOG.TXT, 4 Chapter Summaries, i Character Map, 16 CHK16550.EXE, 5 COM port Modem, 12 Command line parameters:EWCMD, 38 Command line:EWCMD, 38 Command line:EWCMD:parameters, 38 Command Menus Using, 28 Command names, ii COMMAND.COM, 3 Communication parameters:setting in Foray PPP Client Control Panel, 28 Communications drivers, 2, 14 Communications parameters:autodial, 32 Communications parameters:entering modem prefix, 31 Communications parameters:entering modem suffix, 31 Communications parameters:entering phone number, 32 Communications parameters:modem initialization string, 31 Communications parameters:setting baud rate, 31 Communications parameters:setting in Foray PPP Client Control Panel, 30 Communications parameters:specifying dial time out, 32 Compuserve, 43, 46, 47 CONFIG.SYS file, 50 Configuration Overview, 12 Configuration File Changes, 16 Configuration process, 9, 12 Configuration, modem, 13 Configuration, Overview, 12 Configuring Workstation Memory, 50 Control Panel, ii, 1, 2, 5, 8, 12, 13, 14, 16, 17, 18, 20, 21, 24, 27, 28, 29, 32, 33, 34, 35, 37, 40, 44, 45, 46, 47 Control Panel:hanging up the phone, 21 Conventional memory, 50 Conventions, ii Creating script files, 44 Current versions of the software, iii Customer Feedback, iii D Default baud rate, 13 Default modem option, 13 Default PPP Server, 18 Default PPP Server:specifying in Foray PPP Client Control Panel, 32 Defaults, 14 Dial prefix:entering from Foray PPP Client Control Panel, 31 Dial suffix:entering from Foray PPP Client Control Panel, 31 Dial time out:specifying in Foray PPP Client Control Panel, 32 Dial-in Messages, 34 Dialing in, 20 Dialing in:using a script file, 47 Dialing scripts:creating, 44 Dialing scripts:preparation notes, 46 DNS, 53 Domain Name Server, 53 DR-DOS, 3 Driver Setup, 2, 11, 14, 15 DTR, 46 Dynamic IP address allocation, 3 E Electronically distributed software, 24 Email Techsmith, iii Ensuring Your Network Drivers are Installed, 9 Evaluation Software, 8 EWCMD, 1117 EWCMD.EXE, ii, 5, 38 EWCMD:command line parameters, 38 EWCMD:return codes, 41 EWCMD:running from DOS, 38 EWCMD:running from Windows, 40 EWCMD:syntax, 38 EWCONFIG.EXE, 5 EWMODEM.INI, 5, 14 EWPPP, ii, 5, 15, 21, 29, 32, 38, 39, 40 EWPPP.EXE, 5 EWPPP:unloading, 21 EWUSER.EXE, 5 EWUSER.INI, 2, 14, 27, 28, 29, 30, 32, 45 EWUSERW.EXE, 5, 28 EWUSERW.HLP, 5 EWVXD.386, 5 F FAQs, iii FEEDBACK.TXT, iii, 4, 8 File Examples Syntax, iii Files, Foray PPP Client, 4 Files:workstation, 1 Finish Registration, 24 Foray PPP Client Control Panel, 2, 27 Ending a Session, 21 Features, 2 Introduction, 1 Licensing, 23 Product description, 2 Foray PPP Client Control Panel:actions menu:exit, 29 Foray PPP Client Control Panel:actions menu:hangup, 29 Foray PPP Client Control Panel:connection dialog box, 32 Foray PPP Client Control Panel:dialing in to a LAN gateway, 28 Foray PPP Client Control Panel:enabling autodial, 32 Foray PPP Client Control Panel:entering dial prefix, 31 Foray PPP Client Control Panel:entering dial suffix, 31 Foray PPP Client Control Panel:entering modem intialization string, 31 Foray PPP Client Control Panel:entering password, 29 Foray PPP Client Control Panel:entering phone number, 32 Foray PPP Client Control Panel:entering PPP Server name, 31 Foray PPP Client Control Panel:entering user ID, 29 Foray PPP Client Control Panel:entering user location, 30 Foray PPP Client Control Panel:hanging up the phone, 29 Foray PPP Client Control Panel:menu commands:Help menu, 32 Foray PPP Client Control Panel:menu commands:Options menu, 29 Foray PPP Client Control Panel:modem setup dialog box, 30 Foray PPP Client Control Panel:options menu:always on top, 29 Foray PPP Client Control Panel:options menu:autoset driver variables, 29 Foray PPP Client Control Panel:options menu:clear status window, 29 Foray PPP Client Control Panel:options menu:small window, 29 Foray PPP Client Control Panel:phonebook, 28 Foray PPP Client Control Panel:phonebook maintenance dialog box, 31 Foray PPP Client Control Panel:saving password, 30, 32 Foray PPP Client Control Panel:selecting a modem, 31 Foray PPP Client Control Panel:setting baud rate, 31 Foray PPP Client Control Panel:setting default user parameters, 28 Foray PPP Client Control Panel:setting modem parameters, 28 Foray PPP Client Control Panel:setup menu:modem..., 30 Foray PPP Client Control Panel:setup menu:phonebook..., 31 Foray PPP Client Control Panel:setup menu:user..., 29 Foray PPP Client Control Panel:specifying default PPP Server, 32 Foray PPP Client Control Panel:specifying dial time out, 32 Foray PPP Client Control Panel:user setup dialog box, 29 Foray PPP Client Control Panel:using a script file, 32 Foray PPP Client Workstation Package, 4 Foray PPP Client:using a script file, 43 Foray PPP Client:workstation command line interface, 37 Foray PPP Client:workstation software, 1 Foray-Server@techsmith.com, iii, 25 G Generic Modem, 13 H Hanging up the Phone, 21 Hanging up the phone:from Foray PPP Client Control Panel, 29 Hangup, 21 Hang-Up Messages, 35 Hardware requirements:workstation, 3 Help menu:Foray PPP Client Control Panel, 32 Help:from Foray PPP Client Control Panel, 32 I IFSHLP.SYS, 52 INSTALL.TXT, i, 4 Installation, i Installation process, 7, 8, 10, 12 Installation Process, Overview, 8 Installation tips, 7, 9 Installing the Foray PPP Client, i, 7 IP address, i, 3, 14, 15 IP addresses, i IP Configuration, 15 IPX, 1, 3, 8, 9, 15 Header Compression, 3 IPXODI.COM, 51 L LAN Workplace, 3, 8, 9, 14, 15 LICENSE.TXT, 4, 24 Licenses Multi-user, 24 Licensing Foray PPP Client, 23 Loading high, 51 LSL.COM, 5, 51 M Mail Techsmith, iv Manual Dialing, 20 Maximum Receive Unit, 16 Memory allocation, 50 Memory manager, 50 Memory. Required, 14 Messages Dial-in, 34 Hang-Up, 35 Modem, 33 Server, 33 Microsoft, 1, 2, 3, 8, 9, 14, 15 Microsoft Networking, 9 Modem, 12 Setup, 12, 13 Setup box, 14 Strings, 14 Modem Configuration, 13 Modem Messages, 33 Modem parameters:setting in Foray PPP Client Control Panel, 28 Modem prefix:entering from Foray PPP Client Control Panel, 31 Modem requirements:workstation, 4 Modem Setup, 13 Modem Setup box, 13, 14 Modem Setup Strings, 14 Modem Setup, Tips, 12 Modem suffix:entering from Foray PPP Client Control Panel, 31 Modem:initialization strings:entering from Foray PPP Client Control Panel, 31 Modem:selecting from Foray PPP Client Control Panel, 31 Modems, 3, 4, 13, 14, 31 MS DOS, 3 N NDOS.COM, 3 NET.CFG, 2, 16 NET.CFG file, 51 NETCFG.TXT, 5 Netware, 1, 8, 9 Netware DOS Requester, 51 Network driver, 2 Network Setup, 52 Network stacks, 1, 7, 8, 11 NETX.EXE, 51 Novell, 1, 3, 5, 8, 9, 28 NT Server Configuring, 52 NT servers, 53 NTDIRECT.SCR, 5 NU_STAT.EXE, 5 O ODI, ii, 1, 5, 9 On COM port Mouse, 12 Optimizing Your Workstations Memory, 50 Options menu:Foray PPP Client Control Panel, 29 ORDER.TXT, 24 Overview of the Configuration Process, 12 Overview of the Installation Process, 8 P PAP, 3 Password, 18 Password:entering in Foray PPP Client Control Panel, 29 Password:saving in Foray PPP Client Control Panel, 30, 32 PBX, 43 PC DOS, 1, 3 PCMCIA, 14 Performing the Modem Setup, 13 Permanent Virtual Memory Swap, 12 Phone number:entering in Foray PPP Client Control Panel, 32 Phone:hanging up from Foray PPP Client Control Panel, 29 Phonebook, 3, 17, 18, 27, 28, 29, 30, 31, 32 Phonebook Maintenance, 11, 17, 31 Phonebook:in Foray PPP Client Control Panel, 28 PPP, 24 Definition, 16 PPP server, 1, 2, 11, 15, 16, 17, 18, 20, 28, 29, 30, 31, 32, 33, 37, 39, 45, 47 PPP server name box, 17 PPP Server:specifying in Foray PPP Client Control Panel, 31 Program Manager group, 10 Protocol stack, 12 Protocol stacks, 1, 3 PROTOCOL.INI, 2, 16 Q QCKSTART.TXT, 4 R RAM, 3 README.1ST, i, 4, 10 REGISTER.INI, 4 REGISTER.TXT Submitting, 25 Registration, ii, 4, 8, 23, 24, 25 Registration process, 8 Remote workstations, 1, 2 Requirements:modem, 4 Return codes:EWCMD, 41 RNBAPI.DLL, 5 Running the Foray PPP Clients Setup Program, 9 S Script File Sample, 46 Script files:using, 47 Script:creating, 44 Script:preparation notes, 46 Script:selecting in Foray PPP Client Control Panel, 32 Scripting Language, 43 Scripts:example, 46 Select Modem, 13, 31 Selecting a modem:from Foray PPP Client Control Panel, 31 Selecting the Group, 10 Selecting the Installation Drive and Directory, 10 Server Messages, 33 Server software license, 23, 24 SETUP.EXE, 4 SETUP.INS, 4 Slots, 15 Software requirements:workstation, 3 Special characters, modem, 13 Special characters, modem strings, 13 Special Configuration Notes, 49 Special Considerations for Evaluation Software Users, 8 Special Tips for Performing the Driver Setup, 14 Special Tips for Performing the Modem Setup, 12 SPX, 1, 3 Suffix string, modem, 13 SUPPORT.TXT, iii, 4 Swap File Creation, 16 Syntax Command, iii Syntax:EWCMD, 38 SYSTEM. INI, 14 SYSTEM.INI, 2, 14, 16 T Target directory, 10 TCP/IP, i, 3, 8, 9, 11, 14, 15, 16 Compression, 15 TCP-32, 3 Technical Support, iii Techsmith Corporation, iv, 25 Techsmith Technical Support, 13 Techsmith Website, iii Tilde, 13 U UART, 3 Unloading EWPPP, 21 Unloading the Workstation Driver, 21 Unregistered client, 8 User authentication, 3 User ID:entering in Foray PPP Client Control Panel, 29 User Information Entering, 17 Special Tips, 17 User location:entering in Foray PPP Client Control Panel, 30 User parameters:setting in Foray PPP Client Control Panel, 28 User Setup Parameters, 18 Using this Manual Overview, i Utilities:CHK16550.EXE, 5 V Van Jacobson Header Compression, 3, 15 Variable information, iii VENDINFO.DIZ, 4 VENDOR.DIZ, 4 Virtual Memory, 16 VLM.EXE, 51 W Windows, 1, 2, 3, 4, 5, 7, 9, 10, 11, 12, 14, 15, 16, 20, 21, 28, 29, 32, 37, 40 Windows desktop, 10 Windows for Workgroups, 1, 2, 3, 5, 9 Windows Internet Name Server, 53 Windows NT Server Configuring, 52 Windows:running EWCMD, 40 WINS Server, 53, 54 Workstation command line interface, 11 Workstation command line interface:command line parameters, 38 Workstation command line interface:running from DOS, 38 Workstation command line interface:running from Windows, 40 Workstation command line interface:syntax, 38 Workstation:command line interface, 37 Workstation:creating dialing scripts, 44 Workstation:dialing in to a LAN gateway, 20 Workstation:dialing in to a LAN gateway using Foray PPP Client Control Panel, 28 Workstation:driver:See EWPPP, 11 Workstation:ending an Foray PPP Client session, 29 Workstation:EWPPP, 11 Workstation:files, 1 Workstation:introduction, 1, 19 Workstation:modem requirements, 4 Workstation:requirements, 3 Workstation:using, 19 Www.techsmith.com, iv, 25  Foray PPP Client v2.02 Preface - Page page iv Foray PPP Client v2.02 Chapter 1 - Page page 3 Foray PPP Client v2.02 Chapter 2 - Page page 10 Foray PPP Client v2.02 Chapter 3 - Page page 19 Foray PPP Client v2.02 Chapter 4- Page page 23 Foray PPP Client v2.02 Chapter 5 - Page page 27 Foray PPP Client v2.02 Chapter 6 - Page page 37 Foray PPP Client v2.02 Chapter 7 - Page page 43 Foray PPP Client v2.02 Chapter 8- Page page 50 page 52 Foray PPP Client v2.02 Chapter 9 - Page page 61 - Page  u} uz} u}uuuwut  $%@A  ) * 6 7 ` a s t v t A 4WY¾@@@@ 0000!##0000:Y[c1^D>ikmw>Q{}_v $%DEGefXY\def45@@@@@@P5FGjkz{notR{" M Y!!"7""""""""###N#O#a#b##$ $$=$>$L$$$$$$$CL$M$$$$$$%n%y%z%%%%%%+&,&=&>&B&D&&&&&&&@'A'G'a'f'''''''((3(4(7(9(h({(((((t)y))))))))) **i*m*w*{****         $$$$$E********5,7,?,@,Y,Z,y,,,,,,,,?-A-w-y---------------.. ..,.-...... / / /d/=0O0P0f0g0i0$$$$$$$$$$>)>*>>>>>x??????????n@o@~@@@@@@@@@@%A&A0A1AtAEtAuAAAAAAAAAAA(B)B8B9BeBfBwBxBBBBBBBBBBBBBBBBCC{U{V{W{c{d{g{o{p{q{{{{{{{{{{{{{<|=|@|D|E|F|}8}~~~~~~~  <$$$$A<=? $PSӀր2BR[]`ÁŁɂقuyكڃ˅̅υׅ؅م>?Y$$$$$$$$$$$$$$$$@YZpDETU?@WY|}܈݈ωЉ߉=>APQR{Bȍɍ |0$D)*EGqs^_xy &'(ГѓĔՔ[tux)*-KLM $$$$$$$$$00A wΘ <>TUWABLMYZmn GHSTΜϜߜ$$$$$$$$$$$$$$$$$$=ڝ۝ 2>?BOPQTŸ۟ܟ*=>VXqrt~acӡԡ¿$$$$$$$ ByzqsϣУڣۣݣޣWXۤܤ&(;<TVhikƦǦ$uvԧէabqrƨǨʨ̨$$$$$$$C̨-&L-/`acڬ۬  hixyح٭ڭݭȮ/03=>?GHKSTUlm$$$$$$$B űƱ67HIKlm~βϲٲڲʴ˴ܴݴ !,-\]lm|ĵŵеѵ$$$$$$$$$$@ѵ!./ABCGPQT^_`ag #5ƷǷҷӷIabzǹӹԹ bcrsκ$$$$$Dκ"-.RSf ,Bżȼɼ̼мѼҼ)*-BCDEvwĿſǿ%&wx)*;<MNuvyOPbcbcuv$$$$$$$$$$?vNQnq!=K^lmp).>LR3l&'678\u$$$$$$Iuv9<ijxy^h-.1@ABky/0?@|$$$$$$$$$B :;IJ"#dg'014=>?$$ +-78OQopFUX$$$$$$H()XZ125=>?&'9:hivw*+/VWij!%f$$$$$$$$$$$$$$@fno|}z{*-=>MNSZ]vwZaauv%&39T$$$$$$$$$$$$$$$$$$$$$%%%%%#&$&&&)&^&_&`&g&&&&&'' ''''''''''''K(L(N(Q((((())))8)D)E)H)U)V)W)****J*K*M*P*****=*****++++n+o+~+++++++++p,q,r,u,,,,,,,,,"-#-%-(-b-c-d-q-----..... .!...../// /B/C/E/H/>H/u/v/w//H0T0U0X0e0f0g00001111G1H1I1U1y1z1111111'2(27282h2i2j2m22222222233%3&3Z3[3i3j333334444>4P4Q4S4V4444444445555U5V5X5[555555555k6l6{6|66666777!7U7V7W7c77777Q8b8z88x9|99999999999@9:::":V:W:Y:\:::::::::::::::::::;;;;;;;;;;Y<Z<]<<<<<<<<===R=S=U=X=======>>>>>>,>->6>N>>>>>>>>>>??E?G?u?w???????@ @@@@@PAQAcAdAgAAAAAAAAAA#B2B3BGBIB]B^B`BBBBB$$$$$$$$$$$$$$$$$$$$$$$:BBCCCCCCCLDMD_D`DoDDDEEEE/E0E2EEEFG6GrGG1HHHHHHHHHgIIIJJ,J-JRPRRRRRRRRRRRRRSTTTTTTTT@VVWWWWWWWXX7X9X\X^XX~$$$$$$$$$0$$$$$$$$$$$$$$$$0XXXXYY%Y0YRYUYfYmY0Z2Z3Z@ZAZPZZZZZ[[E[M[P[Q[X[[[[[.\:\\\\\\\v]~]^^^^&^/^^^^^^^^^"_#_2_3_______``h`k`dddd¿$$0$$JdeeDeFeaebeteuexeeeeeeeeeeeeeeeWf\fffffffug|ggggggggggggggh hhhhhhhiiiiiijjj0$$$!$$$$$$$$$$$$$?jjj kkkkkkkkkkkkkkkkkkkkkl l!l"l$lllllllll%m&m'm9m:mQmRmTmiooooooopphp qqqqrrrr000$$$$$$$$$>rBr:uaubuwuyuuuuuuuuvvvwFwJwwwwwwwwww9xxxyyyyyyzzzzzzzzzz{{c{j{{{{{{{{{{|||~ ~~~%~b~g~$$$$$$$$$$$$$Fg~~~~~&+RXMSy/2#-01EHKQThk„)*<=@PwÆmxf$$$$$$  J@AXYZ[pqsΌόэҍ"#IR2OPbclmp$$$$$$$$$$$2ݒޒߒ #(DNx bcrs{78:HƗUW|}˘̘Ϙ  *Kgh|}12()lНIНҝOmn,-mnz{͟Ο͠  աg>?YZ"$ͥ#JVWfg¿$$$$$$$$$$$>@m  ./+5<H]dǫѫګݫ?EsϬ1^hiq{abyzWX`$$$$$$I`aTUdeβϲܲݲִ޵ 27qvhs}M]05ivDCH[`\ar /4:I:0S:ezar$^c49ty<Mqrsu}D$$$$$$$$$$$$$HDEJKMNRyz!"$%)PQVWYZ^_efhik¾$$$$$$$$$$$$$$$$$$$$$$$$3B$?Wmt"CP j 6 v N ź `PP `@@ `PP6 ! J t A [ m 4[Ac~1M^ D_>mĿ24I`w'3>Q5_*Jv G*L{Ŀ~yt  `PP-tR}" O Y!!"7""##$$$n%%%B&&'7()*5,,,?-w--.d/=0i0 2e222P3d3333[4537888D9h999::þ#)"8:::;&<<_==>>x??@fABC DD,E}EFhFFF G7G|GGGQHH_IIJJKKOLMMNgOPP-Qº}uup   # l,-QQR8S TTUU-VV)WzWX%YYZZZ&[q[[h\\n]^^^__b`"aa2b~bbcaccdddd eQeghChshhhiiijjlrnoGp ss#ttquukw%h$hAkwwKx y$yyz{{}8}~?]R`ŁG͂j|†{Ž}xssg[ '& ' ( )  && ' ( ) #Bz V{”YuTΘWR*tm.Mƣ(k$ʨ  '& ' ( ) /ʨLcƮKqIvPǿd-\UŽzuphhhhh(3P1\U $ -FXZ||||w)(,/f6]a*KqYTz Nk98}xxppppkk+**8}*+8;Y Qk9q^     !*tH½zzz  -, .<> O8 N !!"m$%g&'(*+p,q-./0h2234556c79:<==>?@gAA#B`BBCCCoDDD2EE   8EEFG6GrGG1HHHgII)49BW}U3DSgty)<Mh}[ [}"?Vqruwy{}@PR')\^kh`h`Etoc 9ChapterBylineTitle Body TextAddressBody1Heading3HeadingBullet1Indent IndColumnList header left header right footer left footer right1Step IndBulletStep UserInput2Heading ColumnList FileListingWideColumnListTopicBox TopicTitleChapter3CompTextChapter4Chapter5Chapter7Chapter8toc 9 TopicTitle1 TopicBox1 TopicTitle2 TopicBox2 TopicTitle3 TopicBox3 TopicTitle4 TopicBox4 TopicTitle5 TopicBox5 TopicTitle6 TopicBox6 TopicTitle7 TopicBox7 Ind 2 col18 TopicTitle8 TopicBox8index 8index 9index 8index 9toc 9index 8index 9A$F g$0= $ &C$ G C C$ C$ C$ C C G G C$ C$ C$ G G C$ G C$   g0= G g0= g0= g0= g0=               G   !x!!! !X!!!hxx8x8x8x 8xX8x8x8x!! < < < < <<<<<!@  (h X< xXzdd(  dd dd dd \ \ dd  8 8ddppddddd(   dd 8  dd+   p0&)')()))  &)')()))  (hdd  (h  (h  (h   (h!!@"  &)')()))+#   p0&)')()))$  &)')()))+%   p0&)')()))&  &)')()))+'   p0&)')()))(  &)')()))+)   p0&)')()))*  &)')()))++   p0&)')())),  &)')()))+-   p0&)')())).  &)')()))+/   p0&)')())),0 pxHX (#d1  &)')()))+2   p0&)')()))3x@84x85x@86x87!@8x@89x8Y  "#$%&'()*+,-./012Pk2}caJWkns3<qH~":<8^ Tms Rmn `Symbol Helv 0CourierTimes New Roman Arial MS Serif MS Sans SerifTimes Helvetica System0Courier New 0ModernRoman Marlett WingdingsBook AntiquaMonotype Sorts0MS LineDraw PAlgerian Arial Rounded MT BoldBookman Old StylePBraggadocio Britannic Bold@Brush Script MT Century Gothic PColonna MT PDesdemonaFootlight MT Light Impact PKino MT Wide Latin@Matura MT Script Capitals PPlaybill AvantGarde Bk BT AvantGarde Md BTZapfCalligr BT@Comic Sans MS AvantGarde Bookman Helvetica-NarrowNewCenturySchlbk PalatinoZapfChanceryPZapfDingbats @Script MS Dialog0LinePrinter CG Times Univers Univers Condensed Antique Olive Garamond CG Omega Albertus Medium Albertus Extra BoldClarendon Condensed @Coronet0Letter Gothic @MarigoldFIBox FIBoxBBFILCD Frame Font Frame5 Font US-Bats@American UncialAmericana BTAmericana XBd BTAmericana XBdCn BT Arial Narrow Arial SuperPBauhaus Md BTPBauhaus Hv BTPBauhaus Lt BTBembo Extra BoldBernard MT CondensedArrus Blk BT Arrus BTBodoni Bd BTBodoni BdCn BTBodoni Bk BT Bodoni BTBotanical MT Calisto MTCalligraph810 BT Carleton CasablancaAntiqueCaxton Bk BTCaxton Lt BTCentury SchoolbookEgyptian505 BTEgyptian505 Lt BTEgyptian505 Md BTEngravers MT EnviroFelix Titling MT Fences Fenice BT Flareserif821 Lt BT Flareserif821 BTGalliard BTGarmdITC Bk BTGarmdITC BkCn BTGoudy MT Extra BoldGoudy Old Style HaettenschweilerPImprint MT ShadowLapidary333 Blk BTLapidary333 BT @Libra BT@Lucida BlackletterLucida Bright@Lucida Calligraphy Lucida Fax@Lucida Handwriting Lucida Sans0Lucida Sans Typewriter @Lydian BT@Lydian Csv BT Mirarae BTModern No. 20@Monotype Corsiva MT ExtraNewBskvll BT News Gothic MTOld English Text MTPerpetua Titling MT ProseAntiqueRevival565 BT RockwellRockwell Extra BoldSeagull Lt BTSeagull Hv BTSeagull Md BTSouvenir Lt BTTiffany Lt BTTiffany Hv BTTiffany HvIt BT VikingPWestminster Windsor BTWindsor El BTWindsor Lt BTWindsor LtCn BT ZapfHumnst BT ZapfHumnst Dm BT ZapfHumnst Ult BT AHD Symbol Sans AHD Symbol Lucida Sans Unicode0OCR A Extended Abadi MT Condensed Light Copperplate Gothic Bold Copperplate Gothic Light0Lucida ConsoleBlack Chancery Albertus (W1) Albertus Xb (W1) Antique Olv (W1) CG Omega (W1)CG Times (W1)Clarendon Cd (W1)@Coronet (W1)0Courier (W1)Garmond (W1)0Letter Gothic (W1)@Marigold (W1) Univers (W1) Univers Cd (W1)SaintFrancis Crackling Riverside Chopin Rechtman  '(v2 99.47djl  :@Cpvy"),2!!!!!!!!!!!#bk1bk0bk01bk02bk11bk12bk03gKgKkk3?j,j3"3EDWFE{D"Enterprise Wide* Foray* PPP Client Paul Madigan Paul Madigan