==========================================================================
                              USING PS2EMM.SYS
==========================================================================

 The expanded memory manager for the IBM PS/2 80286 Memory Expansion
 Option is named PS2EMM.SYS.  This device driver conforms to the LIM
 4.0 Expanded Memory Specification (EMS).  Prior to installing this
 driver, please consult IBM's instructions for installing IBM PS/2
 80286 Memory Expansion Option boards.


   *NOTE: This driver does NOT work with the "IBM 80286 Expanded Memory
          Adapter /A", also known as the XMA board.  If you wish to use 
          the XMA board with WINDOWS 2.10, you will need to have a LIM 
          4.0 compatible Expanded Memory Manager (EMM), which is not 
          supplied with WINDOWS 2.10 or Microsoft Excel.  

          However, using the LIM EMS 3.2 driver supplied with your 
          workstation software, you can provide Microsoft Excel with 
          extra memory for creating larger datafiles.  Please follow 
          the instructions provided with the workstation software for 
          installing the LIM 3.2 driver for the XMA board.

=========================================================================
USING THE IBM PS/2 80286 EXPANSION MEMORY OPTION BOARD WITH WINDOWS
=========================================================================

 To use your IBM PS/2 Expansion Memory Option with WINDOWS 2.10 and/or 
 Microsoft Excel, you must first install the expanded memory manager 
 called PS2EMM.SYS.  Once installed correctly, WINDOWS can utilize memory 
 beyond the 640Kb memory barrier, and Microsoft EXCEL will have more 
 memory in which to store data.  PS2EMM.SYS is installed by entering the
 following line of text into your CONFIG.SYS file, and then restarting
 your computer:

    DEVICE=[drive:][path]PS2EMM.SYS [/p=xxxx] [/x=mmmm-nnnn] [/e]

    The parameters in brackets ([]) are optional, but may be important
    in correctly installing PS2EMM.SYS.

      /p=xxxx        (Page Frame Address Location)

          This parameter allows you to specify directly where the EMM
          page frame should be located in memory.  This 4 digit number
          (hexadecimal) represents the segment address where four 16Kb
          pages (also called banks) can reside.  The page frame can be
          located anywhere between segments A000 and E000.

          Once the segment address is specified, it will occupy the 
          next 64Kb of contiguous memory.  For example, "/p=C200" will
          locate the page frame between C200-D1FF.  The page frame 
          address must be an even multiple of 512 Bytes (C000, C200, 
          C400 ...).

      /x=mmmm-nnnn   (Memory Exclusion Range)

          This parameter allows you to specify a range of memory which
          will not be used for mapping expanded memory pages.  This is
          most likely to be used if other Expansion Option Board(s) 
          are installed.  If other devices utilize memory between A000 
          and E000, then there is a possibility of conflict with the 
          EMM and that device.
 
          For Example, the IBM Token-Ring Network Adapter utilizes memory
          between A000-E000 for its RAM/ROM usage.  If these addresses are
          not excluded, then there could be some contention between the
          EMM and the Token-Ring.  See the AUTOMATIC DETECTION section
          for further details.

      /e   (Small Frame EMM Option)

          This switch specifies that SMALL FRAME EMM is to be used.
          The default is LARGE FRAME EMM.

          By specifying this switch, you are in effect leaving the
          motherboard memory ENABLED (memory below 640Kb).  When enabled,
          that memory below 640Kb will not be made mappable for the EMM.
          This will conserve conventional memory used by WINDOWS under
          certain circumstances.

          By excluding this switch you are telling the driver to DISABLE
          the motherboard memory and make that memory mappable.  This
          maximizes the amount of memory available for mapping.

          The criteria you should use in determining whether to use the
          switch or not depends on the amount of memory installed in
          your machine.  If you have 3MB of memory or above, then LARGE
          FRAME EMM is best; if you have less than 3MB installed, then
          SMALL FRAME EMM is best.


          Examples:

          1.  device=c:\PS2EMM.SYS /p=C000
              * This will force the page frame to be loaded at the C000
                segment, thus occupying the ranges C000-CFFF.

          2.  device=c:\PS2EMM.SYS /x=D200-D7FF
              * This will exclude the segments between D200 and D7FF from
                being mapped by the expanded memory manager.  This option
                is most likely to be used to exclude memory being used
                by other cards (such as network cards) which need a
                particular range of memory for their own use.  The
                memory that these cards use must not be mappable.

          3.  device=c:\PS2EMM.SYS /p=D000 /x=C200-CBFF
              * This specifies the pageframe to be loaded at the address
                D000 and to occupy the next 64Kb (D000-DFFF).  The range
                C200-CBFF will not be used for mapping by the EMM.

          4.  device=c:\PS2EMM.SYS /e
              * The EMM will be installed using the small frame manager.
                This will load the pageframe at the first four 16Kb
                contiguous pages of memory.  The mother board will be
                left enabled and therefore, not be used for mapping.

          5.  device=c:\PS2EMM.SYS
              * Pageframe is loaded at first available memory.  Large
                frame EMS is used, therefore the mother board memory
                is disabled and used for mapping.  No memory is excluded.

==========================================================================
AUTOMATIC DETECTION
==========================================================================

 The PS2EMM.SYS driver detects the following boards which utilize memory
 between A000-E000:

      o  IBM Token-Ring Network Adapter.
      o  IBM 3270 Emulation Adapter.
      o  Ungermann-Bass Network Adapter.

     To save you the trouble of determining what memory addresses to
     exclude, or where to load the page frame, PS2EMM.SYS searches
     between A000 and E000 to find addresses used by these adapters.
     It then excludes these addresses, making them non-mappable.  Once
     it finds a contiguous block of memory, it loads the page frame
     segment.


     Example:  You have the IBM Token-Ring Adapter, using address range
               C800-CFFF, installed in your machine, and the following
               line in your CONFIG.SYS file:

               DEVICE=C:\PS2EMM.SYS

               * When PS2EMM.SYS installs, it searches for non-mappable
                 segments which are occupied by other devices.  In this
                 case C800-CFFF.  The page frame would then be loaded
                 at D000 to avoid conflict with the other device.  The
                 addresses C800-CFFF would be excluded.  This is the
                 same as having typed the following in the CONFIG.SYS

                 DEVICE=C:\PS2EMM.SYS /p=D000 /x=C800-CFFF



     *NOTE: Take care in setting up the Expansion Option Board's
            memory ranges.  The board can occupy memory ranges which
            would inhibit the PS2EMM.SYS driver from finding four
            contiguous 16Kb pages for the page frame.  If you are not
            getting a full 64Kb page-frame, then follow IBM's instructions
            on installing/configuring Memory Expansion Option Boards.  To
            solve these problems, you may need to relocate the address
            ranges of your board to accommodate the page frame.


==========================================================================
ERROR MESSAGES
==========================================================================


    Message:  The system memory was disabled by someone before us.
              Driver will not be installed.

Explanation:  Motherboard memory was disabled before an attempt was made
              to load PS2EMM.SYS.

     Result:  Since the driver must use the motherboard memory, 
              installation of PS2EMM.SYS was abandoned.

   Solution:  Determine what disabled the motherboard memory.  Re-enable
              the motherboard memory before attempting to load PS2EMM.SYS.

---------------------------------------------------------------------------

    Message:  Not enough pages of expanded memory available for this 
              driver.

Explanation:  PS2EMM.SYS needs at least 41 pages (656K) if /E option is not
              specified.  The expanded memory board has less than this.

     Result:  PS2EMM.SYS was not loaded.

   Solution:  Try installing with the /E option.

--------------------------------------------------------------------------

    Message:  There is not enough RAM to initialize this driver.

Explanation:  Too little memory was available to load PS2EMM.SYS into the
              lower 640Kb of RAM.
 
     Result:  PS2EMM.SYS was not installed.

   Solution:  Free some memory in the lower 640Kb.  Check your CONFIG.SYS
              file for unnecessary device drivers.  Reduce the number of
              buffers specified by the "buffers=" command line in 
              CONFIG.SYS.

--------------------------------------------------------------------------

    Message:  ERROR: Bad command line.

Explanation:  Parameters specified for PS2EMM.SYS in the CONFIG.SYS command
              line are incorrect.

     Result:  PS2EMM.SYS was not installed.

   Solution:  Change the parameters to conform to the usage described 
             above.

--------------------------------------------------------------------------

    Message:  No memory boards found.  Driver will not be installed.

Explanation:  No IBM Personal System/2 Expanded Memory Option board is
              installed, or the board is incorrectly installed.
              
     Result:  PS2EMM.SYS was not installed.

   Solution:  Check the installation of your IBM Personal System/2
              Expanded Memory Option board(s).

--------------------------------------------------------------------------

    Message:  Not enough memory is mappable.  Driver will not be installed.

Explanation:  PS2EMM.SYS found no mappable memory banks below 1 Megabyte
              with which it can access your expanded memory.

     Result:  PS2EMM.SYS was not installed.

   Solution:  Free some memory below 1 Megabyte by disabling some
              hardware or software devices.  Check your CONFIG.SYS
              file for unnecessary device drivers.  Remove other
              hardware boards which may be taking up memory.

--------------------------------------------------------------------------

    Message:  WARNING: Your page frame is smaller than 64K.
              Some programs that require expanded memory may not be usable.

Explanation:  The page frame found above 640K is less than 4 banks long.

     Result:  Programs written for LIM 3.2 assumed a page frame 4 banks
              long and hence will not run in this configuration.  Since
              the LIM 4.0 specification does not require a 4 bank long
              page frame the driver was still installed.

   Solution:  Free enough memory between 640K and 1 Megabyte to have a
              page frame of 4 banks.  Do this by disabling some hardware
              or software devices.  Check your CONFIG.SYS file for
              unnecessary device drivers.  Remove other hardware boards
              which may be taking up memory.

--------------------------------------------------------------------------

    Message:  WARNING: You have no page frame.
              Some programs that require expanded memory may not be usable.

Explanation:  No page frame was found above 640K.

     Result:  Programs such as Microsoft Excel written according to 
              LIM 3.2 specification won't be able to use the expanded 
              memory.

   Solution:  Free enough memory between 640K and 1 Megabyte to have a
              page frame.  Do this by disabling some hardware or software
              devices.  Check your CONFIG.SYS file for unnecessary device
              drivers.  Remove other hardware boards which may be taking up
              memory.  Consult the "Networks" section of the guide called 
              "Getting the most from your Hardware with Microsoft Excel" 
              which is included in the Microsoft Excel package for more 
              information.

==========================================================================
OTHER MESSAGES
==========================================================================

    Message:  Microsoft PS2 50/60 Expanded Memory Driver version 1.00.

Explanation:  Banner message with version number.


-------------------------------------------------------------------------

    Message:  Page frame is located at segment xxxxh.

Explanation:  Specifies the location of the page frame segment.


--------------------------------------------------------------------------

    Message:  Extended Memory available has been adjusted to nnnnK.

Explanation:  By default, IBM Personal System/2 Expanded Memory Option
              boards are configured at boot time to be extended memory.
              Because PS2EMM.SYS takes this extended memory, this message
              reports the amount of extended memory after PS2EMM.SYS takes
              this memory.


==========================================================================
GLOSSARY/TERMS
==========================================================================


 1. PAGE FRAME
    - A contiguous block of memory occupying 64Kb of memory.  It consist
      of four 16Kb pages starting on an even boundary which is a multiple
      of 512 bytes. (ex: C000, C200, D000, D800)  This is the location
      of the interface between your DOS applications and expanded memory.

 2. MAPPING
    - The process of making a logical page appear at a physical page.

  3. EMM
    - Expanded Memory Manager.  This controls the interface between
      your DOS applications and expanded memory.

 4. EMS
    - Expanded Memory Specification.  The specification which the EMM
      is derived from.

 5. BANK
    - The equivalent of a 16Kb page.

 6. PAGE
    - The equivalent of 16Kb of memory used for mapping.

 7. EXPANDED MEMORY 
    - The memory available outside of DOS's 640Kb limit.

