home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / lw321.arj / TAP11.ZIP / TAP.DOC < prev    next >
Encoding:
Text File  |  1995-05-15  |  2.7 KB  |  73 lines
  1. Standard TAP Specification
  2. Revision 1.1
  3.  
  4. May 15, 1995
  5.  
  6. Okay, we've gone through a revision and now there's also a sample
  7. server application. Things look good, and PMView works wonderfully
  8. with LiveWire. Thanks to Peter Nielsen for all his help, input,
  9. and expertise.
  10.  
  11. Les Novell
  12. DataMirage Software
  13.  
  14. ---
  15. January 5, 1995
  16.  
  17. This is the first attempt at a standard TAP specification on the
  18. OS/2 32-bit platform. This specification is intended to allow separate
  19. processes access to file data while a file is being transferred.
  20. This specification is limited because it does not allow distributed 
  21. processes to share a single file.
  22.  
  23. Files in this package:
  24.    TAP.DOC        This document
  25.    TAP.H          Shared TAP header file
  26.    TAPAPP.C       TAP Application API code
  27.    TAPAPP.H       TAP Application API header file
  28.    TAPSERVE.C     TAP Server API code
  29.    TAPSERVE.H     TAP Server API header file
  30.    TAPSERVE.RC    TAP Server resources
  31.    TAPRES.H       TAP Server resources header file
  32.    TAPSAMP.C      TAP Application Sample code
  33.  
  34. To compile the sample TAP Application you'll need to make a project
  35. that includes TAPSAMP.C and TAPAPP.C with dependencies TAP.H and
  36. TAPAPP.H.
  37.  
  38. For help writing a TAP Server please contact Les Novell on CompUServe 
  39. ID 73631,1233 or from the internet write 73631.1233@compuserve.com.
  40.  
  41. Brief description of methodology:
  42. =================================
  43. A TAP Server is a single process which mediates access to a file or
  44. files. The TAP Server has both write and read access to shared
  45. file data. The TAP Application(s) is a process that has read access to
  46. file data and whose access is in some ways restricted by the TAP Server.
  47. These processes will be referred to as Server and Application, respectively.
  48.  
  49. At any time during a file transfer the Server may choose to start one
  50. or more Applications. Each application will be passed a command line
  51. parameter /TAP=<string> where <string> is the name of the pipe.
  52.  
  53. The Server will pass the following file data down the pipe every time the
  54. length of the file is increased or one of the flags changes:
  55.      FULLY QUALIFIED FILE NAME
  56.      SERVER VERSION STRING
  57.      CURRENT FILE SIZE
  58.      COMPLETE FILE SIZE
  59.      FLAGS
  60.         EMERGENCY CLOSE
  61.         END OF FILE
  62.         BEGINNING OF FILE
  63.         END OF BATCH
  64.         CANCEL
  65.  
  66. The Application opens and receives the pipe information continuously in
  67. a secondary thread while the Application's primary thread opens the file
  68. for shared reading. The primary thread reads and processes from the file
  69. in a standard way until the transfer is complete. If another file is in
  70. the transfer batch the Application should open it and continue processing 
  71. until the end of batch condition.
  72.  
  73.