home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 May / CMCD0505.ISO / Software / Shareware / Utilitare / comcapt / readme.txt < prev    next >
Text File  |  2004-11-23  |  10KB  |  201 lines
  1. ComCap - Magenta Serial Port Capture Utility
  2. ============================================
  3.  
  4. Readme for Release 3.1 - 2nd November 2004
  5. ------------------------------------------
  6.  
  7. ComCap is a simple Windows application designed to capture any ASCII data
  8. received on PC serial communications ports to text files.  Captured data
  9. is optionally shown in scrolling windows, and may be copied to be
  10. clipboard if required.  Data from up to 20 serial communication ports
  11. can be captured simultaneously, in separate files.  The capture file names
  12. are automatically generated with a new file being created each hour, day,
  13. week or month, or several times a day.  Captured data may be optionally
  14. echoed to a local or network printer.  ComCap is a system tray application
  15. that can be set to start automatically when windows starts, and remain
  16. unobtrusive.  ComCap will run on Windows 98 and later 32-bit versions of
  17. Windows.  On Windows NT4, 2000, XP and 2003, ComCap may be run as a
  18. service, so it automatically starts when the PC boots without needing a
  19. user logged-on.
  20.  
  21. Although basic communications settings need to be specified (speed,
  22. parity, data bits), there are no flow control settings and data will be
  23. captured irrespective of the usual control lines (so just a 2-wire serial
  24. cable is needed).
  25.  
  26. Provided that a reasonably continuous flow of data is being received, the
  27. correct settings can usually be deduced within a minute or so, by changing
  28. the speed until readable data appears.  Although ComCap ignores the
  29. control lines, it does display the status of the CTS, DSR and DCD lines,
  30. and also flashes when data is received.  ComCap sets the RTS and DTR lines
  31. when capture is enabled and uses RTS for flow control.  ComCap never
  32. transmits any data and does not support software flow control (Xon/Xoff).
  33.  
  34. ComCap will optionally add a time stamp to the start of each captured
  35. line, typically for alarm type applications.  There are various options
  36. to ensure the captured files are flushed to disk regularly, to avoid data
  37. loss if the PC crashes.  PC freezes caused by other applications can be
  38. detected and warned, and if the data being captured stops for some reason
  39. warnings can be given.
  40.  
  41. ComCap is primarily designed to capture telephone call logging data from
  42. the serial port provided on most telephone switching systems (PABXs),
  43. typically called Call Data Records (CDR).  Generally, only ASCII data is
  44. saved to the capture file, although there is a raw option.  The saved data
  45. may then be used as input to telephone call management applications that
  46. will cost calls and produce reports on telephone usage.  But ComCap is
  47. application non-specific and will capture anything that arrives on a
  48. serial port.  It has been used for a wide variety of purposes, such as
  49. logging output from test, alarm and monitoring equipment and serial
  50. printer data (but it can not process printer control characters).
  51.  
  52. Please note that ComCap is not designed to monitor data between modems and
  53. PC applications, it requires exclusive access to the serial port so no
  54. other application can use the port at the same time.
  55.  
  56. The ComCap distribution includes a small application written by a user,
  57. 'Concatenation Utility', that allows multiple text file captured by ComCap
  58. to be combined into a single text file that may be easier to import into a
  59. telephone call management application.  There is also a small æTest RS232
  60. SignalsÆ utility that may be useful in testing communication port and
  61. cabling problems.
  62.  
  63. ComCap should have a minimal overhead on the PC and can just be left
  64. running minimised.  It will run on any PC or lap top capable of running
  65. Windows 98 such as a low end Pentium with 16 Mbytes of memory (which could
  66. be dedicated for data capture).  Although ComCap will probably run on
  67. Windows 95, it is no longer officially supported because the Delphi
  68. compiler is not longer supported on that OS.
  69.  
  70.  
  71. Installation
  72. ------------
  73.  
  74. ComCap is usually distributed as a ZIP file, which should first be
  75. unzipped into a temporary folder.  If you do not already have it, the
  76. Winzip application from http://www.winzip.com/ (or from most magazine
  77. cover CD-ROMs, Tucows archives, etc) is strongly recommended.
  78.  
  79. The program SETUP.EXE should then be run to install ComCap.  About 470
  80. Kbytes of disk space is required for the COMCAP.EXE program and 310 Kbytes
  81. for the service version COMCAPSVC.EXE (this is not installed on Windows
  82. 9x).   Two other programs are also installed CONCAT.EXE and SIGNALS.EXE.
  83. These are described later.
  84.  
  85. If you have received an executable with the name COMCAPS.EXE, this should
  86. be run just like SETUP.EXE to install the software.  If the service
  87. version is already installed, please ignore the error saying so.
  88.  
  89. A user with administrative level privileges must install ComCap.
  90.  
  91. Until registered, ComCap will only run for one hour before capture is
  92. automatically stopped.  It will be necessary to restart ComCap to continue
  93. capture.  ComCap may be registered using a secure order form at the web
  94. site:  http://www.magsys.co.uk/comcap/.  Once the order has been
  95. processed, a small file 'userreg.txt' is returned by email, which should
  96. be copied into the ComCap directory.  If ComCap is already running, it
  97. should be exited and restarted to see the new file.  When started, ComCap
  98. will show the name of the individual or company that registered the
  99. software and will run continually.
  100.  
  101. ComCap is run from Start, Programs, Magenta Systems, then ComCap.  The
  102. ComCap icon will appear in the System Tray, which should be clicked to
  103. restore the main application window.  To auto start ComCap each time
  104. windows is booted, copy the ComCap shortcut into the Startup folder.
  105.  
  106. If ComCap has been installed on Windows NT4, 2000, XP or NET Server,
  107. æMagenta ComCap ServiceÆ will be found added to the Services list, with
  108. manual start-up.  Before the ComCap service may be started, the windows
  109. version must be run, Common and Channel Settings specified and capture
  110. tested.  Then the service version may be started, and changed to automatic
  111. start-up, if required.  If the PC reboots, capture will then continue
  112. without the PC needing to be logged-on.
  113.  
  114. Although the ComCap Service may be used logged-on to the 'local system
  115. account', it is better to specify a specific user account with a password.
  116. This ensures that dates and times in ComCap will be formatted according to
  117. that userÆs preferences, rather than the American default, and allows
  118. access to network resources.  Echo printing is only possible when using
  119. the account of a user that has the required printer installed.
  120.  
  121. For testing purposes, a Plessey Call Simulator may be downloaded from the
  122. web site at:  http://www.magsys.co.uk/comcap/callsim.zip.  Note the file
  123. is not indexed on the ComCap web pages.  The Plessey Call Simulator
  124. application creates CDRs for three types of large switch (BTS 7#2, iSDX,
  125. Ericsson), outputting data to a serial port.  The volume and type of
  126. simulated calls may be specified, for a wide range of test purposes.  A
  127. null modem cable will be needed to feed the ComCap port.  It can be used
  128. on the same PC as ComCap, but both COM ports will be needed.
  129.  
  130.  
  131. Uninstalling
  132. ------------
  133.  
  134. ComCap may be removed from the Control Panel, Add/Remove Programs, or by
  135. running the program UNINSTAL.EXE in the installation directory.  The
  136. uninstaller will remove all installed programs and files, and all
  137. registry.  It will not remove any capture or log files that ComCap has
  138. created.
  139.  
  140. Uninstalling ComCap should remove the service version from the NT database
  141. automatically.  If it only the interactive version is required, the
  142. service may be removed manually by typing COMCAPSRV.EXE -UNINSTALL from a
  143. command prompt.
  144.  
  145.  
  146. Release History
  147. ---------------
  148.  
  149. This is now in the help file.
  150.  
  151.  
  152. Ordering ComCap
  153. ---------------
  154.  
  155. Until registered, ComCap will only run for one hour before capture
  156. is automatically stopped.  It will be necessary to restart ComCap to
  157. continue capture.  ComCap may be registered using a secure order
  158. form at the web site, http://www.magsys.co.uk/comcap/.  Once the order
  159. has been processed, a small file 'userreg.txt' is returned by email,
  160. which should be copied into the ComCap directory.  If ComCap is
  161. already running, it should be exited and restarted to see the new
  162. file.  When started, ComCap will show the name of the individual or
  163. company that registered the software and will run continually.
  164.  
  165.  
  166. Distribution
  167. ------------
  168.  
  169. ComCap may be freely distributed via web pages, FTP sites, BBS and
  170. conferencing systems or on CD-ROM in unaltered zip format, but no
  171. charge may be made other than reasonable media or bandwidth cost.  Any
  172. notifications must state that ComCap is shareware until registered
  173. with Magenta Systems Ltd.  Please email Magenta Systems Ltd if you
  174. distribute ComCap in some way, so you can be notified of upgrades or
  175. other important changes.
  176.  
  177.  
  178. Copyright Information
  179. ---------------------
  180.  
  181. Copyright Magenta Systems Ltd, England, 2004.
  182.  
  183. Magenta Systems Ltd
  184. 9 Vincent Road
  185. Croydon
  186. CR0 6ED
  187. United Kingdom
  188.  
  189. Phone 020 8656 3636, International Phone +44 20 8656 3636
  190. Fax 020 8656 8127, International Fax +44 20 8656 8127
  191.  
  192. Email: comcap@magsys.co.uk
  193. Web: http://www.magsys.co.uk/comcap/
  194. Download: http://www.magsys.co.uk/software/comcap.zip
  195.  
  196. There is also a support conference on the CIX conferencing system,
  197. cix:magsoft.  Information on joining CIX may be found at
  198. http://www.cix.co.uk/ or http://www.conferencing.co.uk
  199.  
  200.  
  201.