home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 17 Fixes30 / 17-Fixes30.zip / sharefix.zip / SHAREFIX.DOC < prev   
Text File  |  1995-01-04  |  5KB  |  94 lines
  1.    ╔═══════════════════════════════════════════════════════════════════╗
  2.    ║  SHAREFIX.COM - A workaround for OS/2 Warp's SHARE detection bug  ║
  3.    ╚═══════════════════════╤═══════════════╤═══════════════════════════╝
  4.                            │  Version 0.1  │
  5.                            ╘═══════════════╛
  6.  
  7.    This TSR was developed to act as a temporary workaround for use
  8.    with programs running under OS/2 Warp that are failing because
  9.    they are unable to initialize the SHARE environment. (The programs
  10.    do not think SHARE is loaded).
  11.  
  12.    Unlike MS-DOS, OS/2's DOS emulation does not need an external
  13.    program (SHARE.EXE) to enable file sharing support. This support
  14.    is totally integrated into OS/2, thus SHARE.EXE is not needed.
  15.    The main thing to remember is that there is no need to enable this
  16.    support under OS/2. File sharing support is ALWAYS there. You can't
  17.    "turn it off".
  18.  
  19.    There is a SHARE check that certain programs use that IBM "broke"
  20.    when developing Warp. PLEASE NOTE that file sharing itself under
  21.    OS/2 Warp is NOT broken. It's actually a certain way that some
  22.    programs check for the existence of SHARE that is not functioning
  23.    properly.
  24.  
  25.    In a nutshell, certain programs check for the existence of SHARE
  26.    by attempting to set the number of retries SHARE does on a locked
  27.    file. This function call under DOS returns successful if SHARE is
  28.    loaded, and since OS/2 Warp ALWAYS has file sharing enabled, it
  29.    should return successful under OS/2 as well. Up until Warp, it
  30.    did. With OS/2 Warp, this function call returns unsuccessful
  31.    when it SHOULD be returning successful. And that's where the
  32.    problem comes in. Programs that are set to use DOS Share fail
  33.    because this call is not working properly under OS/2 Warp 3.0.
  34.  
  35.    SHAREFIX.COM remedies this problem. It actually intercepts the
  36.    unsuccessful error that WARP produces and returns it to programs
  37.    as being successful. Thus programs that check for the existence
  38.    of SHARE by the locked file retry method described above will now
  39.    work properly.
  40.  
  41.    To use SHAREFIX, simply type SHAREFIX in an OS/2 DOS session, or
  42.    load SHAREFIX in your AUTOEXEC for your DOS session(s). There
  43.    are no command-line parameters. Once loaded it will intercept
  44.    the unsuccessful SHARE function call and return it as successful.
  45.  
  46.    This program, when installed, installs itself as SHARE, not
  47.    SHAREFIX. Thus any programs that check for share by actually
  48.    looking for SHARE physically loaded should work properly as well.
  49.    Typing mem /c at a DOS prompt will show that SHARE is loaded.
  50.    (It really is SHAREFIX, but we'll make that our little secret) :)
  51.  
  52.    IMPORTANT NOTE: This is designed only as a TEMPORARY WORKAROUND
  53.    until either IBM releases a fix, or programs begin to use a
  54.    different SHARE detection routine. This TSR should ONLY be used
  55.    if you are experiencing problems with programs that are failing
  56.    when checking for the existence of SHARE. Once IBM releases a
  57.    fix (it is a known problem), and/or programs have begun to
  58.    use a different routing for detecting SHARE, this program no
  59.    longer needs to be used.
  60.  
  61.    This program is public domain, and may be freely distributed.
  62.  
  63.    Disclaimer
  64.    ──────────
  65.  
  66.    THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  THE
  67.    ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE PROGRAM IS ASSUMED
  68.    BY YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE ENTIRE COST
  69.    OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.  FURTHER, THERE IS NO
  70.    WARRANTY, GUARANTEE, NOR REPRESENTATION REGARDING THE USE OF, OR THE
  71.    RESULTS OF THE USE OF THE PROGRAM IN TERMS OF CORRECTNESS, ACCURACY,
  72.    RELIABILITY, CURRENTNESS, OR OTHERWISE; AND YOU RELY ON THE PROGRAM
  73.    AND RESULTS SOLELY AT YOUR OWN RISK. NO PERSON OR ORGANIZATION WILL
  74.    BE LIABLE FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SYSTEM DAMAGE,
  75.    SERVICE, REPAIR, CORRECTION, LOSS OF PROFIT, LOST SAVINGS, OR ANY OTHER
  76.    INCIDENTAL, CONSEQUENTIAL, OR SPECIAL DAMAGES OF ANY NATURE WHATSOEVER
  77.    RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  78.  
  79.    Technical Information
  80.    ─────────────────────
  81.    When loaded, this TSR will force the INT 21h ax=440b (set retry count)
  82.    function to always return success.  Although I don't particularly like
  83.    this method of working around this problem, "when all else fails...".
  84.    Additionally, it will modify it's own MCB so that it contains the
  85.    the name "SHARE", just for those programs that are picky.
  86.    Use at your own risk.  This program is specifically for OS/2 VDMs.
  87.  
  88.    ╒══════════════════╤═════════════════════════════════════════════════
  89.    │ Revision History │
  90.    ╘══════════════════╛
  91.  
  92.    0.1 (01-04-95) Initial Release.
  93.  
  94.