home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / VSCPPv8.zip / VACPP / IBMCPP / samples / TOOLKIT / OS2 / QUEUES / README < prev    next >
Text File  |  1995-06-08  |  3KB  |  104 lines
  1.  
  2. QUEUES - Interprocess Communication Queue
  3.  
  4.  
  5. DESCRIPTION:
  6.  
  7. QUEUES demonstrates interprocess communications (IPC) using the 32-bit
  8. queue component.  It consists of two executable programs,
  9. SVRQUEUE.EXE and CLIQUEUE.EXE.
  10.  
  11. SVRQUEUE creates an IPC queue a named, shared-memory buffer for queue
  12. elements and a shared, named, mutex (mutual exclusive) semaphore.  After
  13. initializing the queue, SVRQUEUE starts a thread to read from the queue,
  14. prints the contents of the messages read from the queue, and terminates
  15. at the user's request.
  16.  
  17. CLIQUEUE opens the queue and accesses the shared-memory element buffer
  18. and mutex semaphore, and starts a thread to write to the queue.
  19. CLIQUEUE requests a string of data from the user, allocates a
  20. shared-memory element from the buffer, puts the string in the
  21. shared-memory element, then uses an event semaphore to direct the
  22. thread to write the element to the queue.  CLIQUEUE terminates at the
  23. user's request.
  24.  
  25. TASK:
  26. Use queues to implement intertask communication
  27.  
  28. CONCEPT/FEATURE:
  29. Illustrate the use of PM, threads and Queues
  30.  
  31. SAMPLE LOCATION:
  32. Inside the OS/2 Sample Programs folder (which is inside the 
  33. VisualAge C++ Samples folder).
  34.  
  35. Note:This sample is not provided in project form.
  36.  
  37. SOURCE FILE LOCATION:
  38.  
  39. X:\ibmcpp\samples\toolkit\os2\queues
  40. where X: is the drive you installed the samples and document component
  41. of VisualAge C++ for OS/2.
  42.  
  43.  
  44. HOW TO RUN THE SAMPLE:
  45.  
  46. -From your OS/2 desktop:
  47.   Double-click on the sample's icon.
  48.  
  49. -From an OS/2 command prompt:
  50.  To start a non-WorkPlace Shell sample program from an OS/2 command
  51.  prompt, type the name of the executable file and press Enter.  If you
  52.  have edited source code of a sample program and want to recompile,link,
  53.  and run the files, use the NMAKE tool. Your output is the executable
  54.  file.  For information about the NMAKE utility, see the
  55.  OS/2 Tools Reference.
  56.  
  57.  
  58. SOFTWARE/HARDWARE PREREQUISITES:
  59.  
  60. - IBM VisualAge C++
  61. - OS/2 Warp
  62. - IBM or compatible 386 and up.
  63.  
  64.  
  65. REQUIRED FILES          DESCRIPTION
  66.  
  67.   clientry.ipf          Input source for IPF compiler
  68.   queues.mak            MakeMake generated makefile
  69.   cliqglbl.h            Global definitions
  70.   cliqhelp.c            Help manager interface routines
  71.   cliqhelp.h
  72.   cliqhelp.rc           Resource compiler input files
  73.   cliqmain.c            main() file
  74.   cliqmain.h
  75.   cliqthrd.c            Thread support routines
  76.   cliqueue.def          link definitions
  77.   cliqueue.exe
  78.   cliqueue.hlp
  79.   cliqueue.ipf          Input source for IPF compiler
  80.   cliqueue.rc
  81.   cliqxtrn.h
  82.   dlg.ipf               IPF compiler input file
  83.   file.ipf
  84.   help.ipf
  85.   queue.h
  86.   queue.ico
  87.   readme                Description and instructions for sample
  88.   svroptn.ipf
  89.   svrqglbl.h
  90.   svrqhelp.c            Help Manager interface routines
  91.   svrqhelp.h
  92.   svrqhelp.rc
  93.   svrqmain.c            The main() routine
  94.   svrqmain.h
  95.   svrqpnt.c             Window paint support routines
  96.   svrqthrd.c            Thread support routines
  97.   svrqueue.def          link definitions file
  98.   svrqueue.exe          The executable
  99.   svrqueue.hlp          Help resource file
  100.   svrqueue.ipf
  101.   svrqueue.rc
  102.   svrqxtrn.h
  103.  
  104.