----------------------------------------------------------------------------
Proxy README file                                                   10/25/93
----------------------------------------------------------------------------

This file contains information that is not covered in the Proxy Installation Guide:

	
*	Instructions for installing Proxy for shared network access, and 
	for automating the setup of host workstations.

*       Version information for IPX and VIPX files contained in the NOVELL
        subdirectory of the Proxy Upgrade diskette

*       A description of the PROXYRES.EXE program, which can be used on 
        heavily loaded Windows systems to reserve the low memory that the 
        Proxy Master requires.


**************  INSTALLING PROXY FOR SHARED NETWORK ACCESS  ****************

The installation instructions in the Proxy Installation Guide describe how to 
separately install the Proxy Master and Proxy Host software for each 
authorized user or workstation.

If you are using Proxy in a larger installation, it may be more convenient to 
have all authorized users run Proxy from a shared directory on a file server.     

To install Proxy into a shared directory on your file server:

1	Create a shared directory called PROXY on the server, and copy the 
	contents of the MASTER and HOST directories of the Proxy Upgrade
	diskette into this directory.

2	Set the current directory to the shared PROXY directory and type:

		PHOSTNET   

	This will create the file PHOST.NET.  The existence of PHOST.NET 
	marks the directory as the shared Proxy Host directory, and prevents 
	the personal configurations of different users from being stored in 
	this directory.

Creating Shared Windows Drivers
-------------------------------
In order for a workstation to operate as a Proxy Host while Windows is 
running, special Proxy drivers for the display, keyboard, and mouse must be 
available to each host PC.  These Proxy drivers are created based on the 
actual Windows display, keyboard, and mouse drivers.  The Proxy drivers are 
loaded prior to and envelop the actual Windows drivers.  

Optionally, you can use the PHDRIVER program to create these drivers in the 
shared Windows System directory on the network, for use by all host PCs.  It 
is not required that you do so; if a driver is not available in the shared 
Windows System directory, that driver will automatically be created in the 
user's personal Windows directory by PHOSTWIN (see "Setting Up a Host 
Workstation" below).  

The purpose of using PHDRIVER to create shared drivers is twofold: to save 
disk space, and to simplify upgrading to future releases by insuring that all 
program files are kept in shared directories.

To create shared Proxy drivers:

1	Run Windows.

2	Use the Program Manager's File Run command to run the program 
	PHDRIVER.EXE from the shared Proxy directory on the server.

	PHDRIVER will list each display, mouse, or keyboard driver that it 
	finds in the Windows System directory.

3	Select each driver for which you'd like a Proxy driver to be 
	available.  You can select as many drivers as you want -- all of 
	them if you like.  (There's no harm in selecting too many.)

4	Click Create Drivers to create the Proxy drivers.

The Windows drivers for which you've created corresponding Proxy drivers 
will be identified with check-marks.  You can, at any time, create or remove 
Proxy drivers by selecting them and clicking Create Driver or Remove Driver.

PHDRIVER also copies two additional shareable program files -- PHOSTDRV.DLL 
and PHOSTMON.EXE -- to the shared Windows System directory when you create 
Proxy drivers.

By default, the PHDRIVER program searches files with extension .DRV in the 
Windows System directory of the current Windows session for display, 
keyboard, and mouse drivers.  To create Proxy drivers in a different Windows 
System directory on the network, edit the "Directory" field and press 
[Enter].  To scan for Windows drivers with extensions other than .DRV, edit 
the "Template" field and press [Enter].

Note that the Windows drivers are not affected in any way when you create or 
remove Proxy drivers.

Setting Up a Master User
------------------------
The Proxy Master is ready to run right from the shared PROXY directory.  All 
you need to do for a new user is set up a Proxy icon:

1	Run Windows.

2	From the Program Manager menu, select File, then select New.

3	Create a new program item, setting the command line to the pathname 
	for the PROXY.EXE program.  For example, if you installed Proxy in a 
	shared directory called F:\APPS\PROXY, set the command line to:

		F:\APPS\PROXY\PROXY.EXE

Setting Up a Host Workstation
-----------------------------
Each workstation you'd like to use as a Proxy Host must be separately set up.  
The setup process involves:

*	running PHSETUP to select a Personal Proxy Directory, and to set the 
	station name that will identify this workstation to Proxy Masters;

*	running PHOSTWIN from Windows to set up the Proxy drivers that 
	permit the workstation to operate as a Proxy Host while Windows is 
	running.

The Personal Proxy Directory is the directory that will contain the Proxy 
Host configuration information for the workstation (the station name, rules 
for access, etc.).  This information is contained in a single file, 
PHOST.INI.

The Personal Proxy Directory should be on the path, or should be current 
when the PHOST TSR is loaded.  You can, if you like, create a separate 
directory, or you can use an existing directory that is already on the path, 
such as the user's home directory or DOS directory.  

The Personal Proxy Directory may be on the workstation's local drive or on 
the server.  By placing it on the local drive, you insure that no matter who 
uses the workstation or how they logged in, the Proxy Host configuration 
information remains the same.

The instructions that follow describe how to set up a host workstation.  For 
the sake of argument, it is assumed that Proxy has been installed in a 
shared network directory called F:\APPS\PROXY.

1	At the DOS prompt, run the PHSETUP program from the shared Proxy 
	Host directory:

		F:\APPS\PROXY\PHSETUP   

	and follow the directions on screen.

	You will be asked to supply the name of the Personal Proxy Directory.  
	PHSETUP will create the directory if it does not already exist.

	You will then be asked to enter a "station name".  Assigning a name 
	is very important.  The name you assign identifies this PC to a 
	Proxy Master that may want to connect.  You should make sure that 
	the name you assign is different from that of other host PCs, or 
	Proxy won't be able to tell them apart.  

	[Note: You can also assign or change the station name using the Host 
	Control Panel (PHOST /C).]

If you'd like the Proxy Host software to operate while this PC is running 
Windows, continue with the following steps:

2	Run Windows.

3	Use the Program Manager's File Run command to run the program 
	PHOSTWIN.EXE from the shared Proxy Host directory on the server:

		F:\APPS\PROXY\PHOSTWIN

4	From the menu, select Configure, then select Install.

	PHOSTWIN will, if necessary, copy the Proxy Host driver files and 
	other program files into the user's personal Windows directory, and 
	will alter the files WIN.INI and SYSTEM.INI to allow the host PC's 
	Windows session to be controlled from a Proxy Master.

	Note: If the driver files have been installed into the shared 
	Windows System directory using PHDRIVER, PHOSTWIN will not have to 
	copy them into the user's personal Windows directory.  See "Creating 
	Shared Windows Drivers" above.

5	When the installation is complete, click either Restart Windows or 
	Return to DOS.  As of the next Windows session, the new Proxy Host 
	drivers will be active.

The PHOSTWIN program is the Windows version of the Host Control Panel; it is 
the equivalent of running PHOST /C from DOS.  From PHOSTWIN, the user of the 
host PC can check on current connect status, abort the current connection, 
and view or alter settings.  If you'd like PHOSTWIN to be readily available, 
you can set up an icon for it, as follows:

6	Run Windows.

7	From the Program Manager menu, select File, then select New.

8	Create a new program item, setting the command line to the pathname 
	for the PHOSTWIN.EXE program, for example:

		F:\APPS\PROXY\PHOSTWIN.EXE

Using PHSETUP to Automate Host Setup
------------------------------------
You can also run PHSETUP to set up a new host PC entirely from the command 
line.  This lets you use a batch file or login script to automate the setup 
process.

The first command line argument is the Personal Proxy Directory, the second 
argument is the station name.  For example, to set up a new host PC with 
Personal Proxy Directory F:\USERS\GEORGE and station name George's PC, use 
the following command:

	PHSETUP  F:\USERS\GEORGE  George's PC

If you are running PHSETUP from a NetWare Login Script, you can use Login 
Script variables in the command line.  For example, you might want to use 
the user's login name to select the Personal Proxy Directory and to name the 
workstations.  For example:

	#PHSETUP  F:\USERS\%LOGIN_NAME  %LOGIN_NAME's PC

************************  The NOVELL subdirectory  *************************

The NOVELL subdirectory, provided on the Proxy Upgrade diskette, contains 
recent versions of VIPX.386 and IPX. If your versions are earlier you should 
install these new ones:

        VIPX.386        version 1.11
        IPX.OBJ         version 3.10
        IPXODI.COM      version 2.10
        LSL.COM         version 2.01


******************************  PROXYRES.EXE  ******************************

When you load the first Proxy window during a Windows session, it must 
allocate a special type of memory in the lower part of the machine's address 
space in order to work properly with IPX. It is possible to run out of this 
type of memory, even though there is plenty of memory available in general. 
If this happens, you will get the following error:

        "Cannot allocate low memory for IPX use."

You are more likely to get such an error if you run a number of other 
programs prior to running Proxy, or if you use advanced desktops that 
consume more memory than Program Manager. Note that once you are running a
single Proxy window, additional Proxy windows can be opened without fear of 
getting this error.

PROXYRES.EXE is a TSR that reserves low memory for the exclusive use of 
Proxy, and will prevent this error from occurring. You can automate the 
loading and unloading of PROXYRES in one of two ways:

*       If you are using Windows 3.1 in enhanced mode, you can include 
        PROXYRES in your WINSTART.BAT file; this will ensure that it is 
        loaded whenever you run Windows, and unloaded when you exit to DOS. 
        Simply add the following line to your WINSTART.BAT file, or create a 
        new WINSTART.BAT if you don't already have one, with just the 
        following line:

                PROXYRES.EXE

        [Note: WINSTART.BAT is a batch file that is automatically run 
        whenever you run Windows (v3.1). Any TSRs loaded from WINSTART.BAT 
        are removed upon exit from Windows. WINSTART.BAT must be located in 
        your Windows directory.]

*       If you are using Windows 3.0, or Windows 3.1 in standard mode, you 
        can create a batch file such as the following:

                PROXYRES
                WIN
                PROXYRES /U

        This batch file will load PROXYRES, invoke Windows, then unload 
        PROXYRES.

Note that PROXYRES is only used with the Proxy Master, not the Proxy Host.
