home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / clarion / share.zip / SHARE.DOC < prev    next >
Text File  |  1985-08-16  |  3KB  |  61 lines
  1. SHARE - Shared DOS File LEM
  2. for MS-DOS versions 3.0 and higher
  3. ----------------------------------
  4.  
  5. SHARE allows the user to share DOS files between applications and on
  6. networks, which Clarion through batch 2007 does not support. The file
  7. sharing supported is standard sharing via MS-DOS SHARE as provided in
  8. MS-DOS versions 3.x and higher.  Sharing under PC-MOS/386 is also
  9. supported, and allows sharing of PC-MOS PIPE device files as well.
  10. SHARE LEM was originally written in order to support this last
  11. function for interprocess communications between concurrent PC-MOS
  12. tasks written in Clarion.  There is no inherent advantage to using
  13. SHARE LEM over the standard Clarion DOS file handler with the
  14. exception of the shared processing.
  15.  
  16. The functions supported are:
  17.  
  18. SHARE_OPEN - This function opens a specified file with specified
  19. sharing, and returns a LONG integer File Handle for use by other SHARE
  20. LEM routines.  ERROR() and ERRORCODE() are also set.
  21.  
  22. SHARE_CLOSE - This procedure closes the shared file specified by the
  23. File Handle.  There is no return value.  ERROR() and ERRORCODE() are
  24. set.
  25.  
  26. SHARE_READ - This function reads up to a specified number of bytes
  27. from the handle-specified shared file into the specified buffer.  It
  28. returns a LONG integer value of the number of bytes actually read.
  29. ERROR() and ERRORCODE() may be set.
  30.  
  31. SHARE_WRITE - This function writes up to a specified number of bytes
  32. from the handle-specified shared file into the specified buffer.  It
  33. returns a LONG integer value of the number of bytes actually written.
  34. ERROR() and ERRORCODE() may be set.
  35.  
  36. The format of each instruction and the expected return values and
  37. ERROR messages are found in the SHARE.ASM file.
  38.  
  39. The following files are provided in SHARE.ARC:
  40.  
  41. SHARE.ASM    - Microsoft MASM format assembly language file.
  42.  
  43. SHARE.BIN    - Assembled and linked version of SHARE.ASM.
  44.  
  45. SHAREMOD.CPY - SHARE Module Copy file for INCLUDE within the MAP
  46.                section of the main program.
  47.  
  48. SHARECDS.CPY - Shared file mnemonic codes, for use in setting up calls
  49.                to SHARE_OPEN and SHARE_CREATE.
  50.  
  51. SHARETST.CLA - A minor Clarion program demonstrating the SHARE LEM.
  52.  
  53. SHARE.DOC    - This file.
  54.  
  55.  
  56. This LEM is offered in the Public Domain "as is,"  with no
  57. warranty or guarantee stated or implied as to its operation or
  58. suitability in any specific application.  In particular, neither
  59. the author nor Clarion Software can be held responsible for any
  60. monetary or other damages suffered by any user of this package.
  61.