home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / desqview / emmnet1.arj / EMMNET.DOC next >
Text File  |  1991-04-11  |  9KB  |  184 lines
  1.  
  2.           From: Quarterdeck Office Systems 
  3.  
  4.           DATE:  To: DESQview network users 
  5.  
  6.           RE: EMMNET Driver for DESQview 2.3x  
  7.  
  8.  
  9.           Disclaimer 
  10.  
  11.           Quarterdeck has not announced EMMNET to the general public. 
  12.           Making this version available does not in any way constitute an 
  13.           obligation to release or ship this product or to indicate that 
  14.           the product will be released or shipped at any particular time.  
  15.           Pricing will be determined if and when release is scheduled.
  16.  
  17.  
  18.           Product Overview
  19.  
  20.           EMMNET is a Quarterdeck product under development which 
  21.           attempts to resolve possible conflicts between programs making 
  22.           IPX/SPX or NETBIOS network calls and other programs in memory 
  23.           while using DESQview 2.30 or later.
  24.  
  25.  
  26.           Technical Overview
  27.  
  28.           Some NETBIOS and IPX/SPX programs perform functions which 
  29.           "listen" to the network.  Typically, these programs pass a 
  30.           specific address in memory to the network which the network may 
  31.           access at a later time. This address may belong to a buffer 
  32.           where the program is expecting the network to place data that 
  33.           has been requested, or to a subroutine that the program would 
  34.           like the network to call when a certain condition has been 
  35.           satisfied.
  36.  
  37.           In a DESQview system in which no programs are running in 
  38.           expanded memory, these operations pose no problem.  One example 
  39.           of such a system is a DESQview environment with only one window 
  40.           open; another is a DESQview environment in which all open 
  41.           windows fit into the memory available below 640K (conventional 
  42.           memory).
  43.  
  44.           However, a problem can arise when DESQview is running some 
  45.           programs in conventional memory and some programs in expanded 
  46.           memory.  Under these conditions, DESQview is frequently 
  47.           changing the expanded memory map in order to multitask.
  48.  
  49.           A conflict can occur when a program makes a network call that 
  50.           will eventually generate a response from the network.  By the 
  51.           time the network has retrieved the information that the program 
  52.           has requested, the expanded memory map may have changed many 
  53.           times.  If the network simply shoots its data off to the 
  54.           address in memory that it was given, or calls what it presumes 
  55.           will be the program's subroutine, and the memory map has 
  56.           changed since it was given an address, it may overwrite a 
  57.           spreadsheet or a word processor in another window, or execute a 
  58.           random piece of code.  The result of such a collision is often 
  59.           a crash or, if the processor is an 80386 or higher, an 
  60.           exception error.
  61.  
  62.           The EMMNET.DVR driver solves this problem by detecting when any 
  63.           program running inside a DESQview window makes an IPX, SPX, or 
  64.           NETBIOS call.  If the call is one that may result in the 
  65.           network responding at an unfortunate time, EMMNET changes the 
  66.           address that the program is handing to the network, passing 
  67.           instead an address in DESQview's common memory, which can be 
  68.           relied upon to always occupy an address in the 0 to 1024K 
  69.           memory area.  When the network responds, DESQview is able to 
  70.           activate the program that requested the information, making 
  71.           sure that information and control are transferred to the 
  72.           appropriate addresses in memory.
  73.  
  74.  
  75.           The Drivers
  76.  
  77.           There are two versions of the network expanded memory driver. 
  78.           They are supported by DESQview 2.30 and higher.  One of the 
  79.           drivers is the standard EMMNET; the other, the "debug pokes" 
  80.           version, displays network calls that have been affected by 
  81.           EMMNET.  Both drivers are identical in all other respects.
  82.  
  83.           The "debug pokes" version lists items inside brackets along the 
  84.           bottom of the video display screen when the screen is in text 
  85.           mode. (These debug symbols will not appear if the display is in 
  86.           graphics mode.)  Each item is the ASCII symbol that corresponds 
  87.           to the number of the IPX, SPX, or NETBIOS call that EMMNET has 
  88.           diverted to DESQview's common memory.  The items are enclosed 
  89.           in square brackets ( [] ) in the case of NETBIOS calls, and 
  90.           angle brackets ( <> ) in the case of IPX and SPX calls.  You 
  91.           should use the "debug pokes" version for troubleshooting only.  
  92.           Calls that EMMNET does not divert are not poked to the screen.  
  93.            
  94.  
  95.  
  96.           Installing EMMNET  
  97.  
  98.           Copy the files into your DESQview directory, then use the 
  99.           following DOS command:
  100.  
  101.                     REN EMM.DVR EMM.OLD
  102.  
  103.           ... to save a copy of the current EMM driver.  
  104.  
  105.           Then, copy EMMNET to the name that DESQview expects.  For the 
  106.           standard version, type the following DOS command:
  107.  
  108.                     COPY EMMNET.DVR EMM.DVR  
  109.  
  110.           For the "debug pokes" version, type the following DOS command:
  111.  
  112.                     COPY EMMNET.POK EMM.DVR 
  113.  
  114.           DESQview will automatically use EMM.DVR if it is present when 
  115.           DESQview is started.  If you've installed the drivers from a 
  116.           DESQview window, it will be necessary for you to quit DESQview 
  117.           and start it again to use the features of EMMNET.
  118.  
  119.  
  120.           Troubleshooting
  121.  
  122.           If EMMNET is not giving you the desired results, first make 
  123.           sure that you are indeed using the correct versions of our 
  124.           products.  Check the DESQview directory for the date on the 
  125.           DV.EXE file; it must be dated 8-24-90 or later to work with the 
  126.           present version of EMMNET.  Check the file named EMM.DVR; if it 
  127.           is less than 10K in size, you have not copied your EMMNET 
  128.           driver to this filename, which is necessary for DESQview to 
  129.           load EMMNET.
  130.  
  131.           Remember that EMMNET is not likely to affect the operation of a 
  132.           solitary DESQview window.  It is intended to resolve problems 
  133.           that occur only when multitasking is taking place and some of 
  134.           the multitasking windows are running in expanded memory.  If 
  135.           your problem occurs within a solitary DESQview window, and if 
  136.           it occurs with both the original EMM.DVR and with EMMNET 
  137.           renamed to EMM.DVR, then EMMNET is not expected to help, and 
  138.           other factors should be considered.
  139.  
  140.           It should also be noted that EMMNET only intercepts IPX, SPX, 
  141.           and NETBIOS calls.  EMMNET does not detect, divert or otherwise 
  142.           manipulate calls made through through any other network 
  143.           protocol.
  144.  
  145.           Because EMMNET uses DESQview's common memory for data, it may 
  146.           be necessary in cases of heavy network traffic to increase the 
  147.           amount of common memory.  By default, DESQview allocates 17K 
  148.           for common memory; depending on the needs of your program, you 
  149.           may have to increase this figure slightly or substantially.  
  150.           Use the DESQview SETUP program (select the Advanced Setup and 
  151.           go to the Performance screen) to change the common memory 
  152.           allocation.  Adding 2K of common memory is a reasonable first 
  153.           step.  (Remember that changes to the DESQview Setup do not take 
  154.           effect until you start DESQview again.)  You can use DESQview's 
  155.           Memory Status program to monitor the supply of common memory 
  156.           while your program is running.  
  157.           
  158.           The one known existing problem with EMMNET occurs only when 
  159.           programs are making SPX calls; the symptom is that network 
  160.           packets are sometimes returned out of order.  This problem 
  161.           cannot be fixed by revising EMMNET alone; it requires a new 
  162.           version of DESQview.  DESQview 2.32, which is shipping at the 
  163.           time of this writing, still can generate the problem of out-of-
  164.           order SPX packets; future versions of DESQview will correct the 
  165.           problem.
  166.  
  167.  
  168.           Contacting Quarterdeck
  169.  
  170.           The purpose of testing of this driver to a limited number of 
  171.           users who volunteer to do so is to see if this method of 
  172.           buffering network calls will be of use to our customers.  We 
  173.           hope and expect that you will report any problems to us.
  174.  
  175.           If you have a problem with EMMNET, please notify the 
  176.           Compatibility Department, either by FAX (213-314-3219) or by 
  177.           the Quarterdeck Bulletin Board (213- 396-3904).  We would 
  178.           prefer that you not call us by telephone unless you cannot 
  179.           reach us by FAX or BBS.  In that event, the Quarterdeck Tech 
  180.           Support number is 213-392-9701.
  181.  
  182.  
  183.           -=-=-=-End of File-=-=-=-
  184.