home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1996 December / CD_shareware_12-96.iso / DOS / Comunic / USRCID.ZIP / CCID.DOC < prev    next >
Encoding:
Text File  |  1996-08-01  |  6.3 KB  |  171 lines
  1.  
  2. -------------------------------------------------------------------------
  3.  
  4.                         Courier Caller ID PPE
  5.                          Version 1.32  8-1-96
  6.  
  7.                    Written by Joseph C. Frankiewicz
  8.  
  9.                       Support BBS:  847-843-2871
  10.  
  11. -------------------------------------------------------------------------
  12.  
  13. Version 1.32 corrects the following problem found in version 1.31B:
  14.  
  15. If the "NMBR" field of the Caller ID info is the last item in the
  16. CID sequence, the PPE would mistakenly report that the CID info was
  17. missing.
  18.  
  19. To install this update, simply copy the new PPE file over the old one.
  20. No other changes are needed.
  21.  
  22. -------------------------------------------------------------------------
  23.  
  24. CCID is a PCBoard PPE program designed for use with the US/Canada version
  25. of the USRobotics Courier V.Everything modem.  It may work with other
  26. brands or models, but it hasn't been tested that way.
  27.  
  28. There is no "registration" needed for use of this software, it's free.
  29.  
  30. This software has no guarantee or warranty of any kind.   If you have a
  31. problem with it, I will try to help you as best I can, but remember that
  32. the software is free.
  33.  
  34. This is the third public release of this software.  It has been tested
  35. on a multi-node system running under Desqview+Lantastic, and on a
  36. single-node system under DOS.  Bug reports and feature suggestions are
  37. welcomed.
  38.  
  39. -------------------------------------------------------------------------
  40.  
  41. The program does the following things:
  42.  
  43. 1. It creates a log file in the following format, 1 entry per line:
  44.  
  45.    X YYYYYYYYYYYYYYYYYYYYYYYYY  ZZ-ZZ  ZZ:ZZ  ZZZZZZZZZZZ  ZZZZZZZZZZZZZZZ
  46.  
  47.    Where:
  48.  
  49.    "Y" is the User Name (up to 25 characters)
  50.  
  51.    "Z" is the Caller ID info
  52.  
  53.    "X" is one of the following characters:
  54.  
  55.    space =  Caller ID matches User Record
  56.  
  57.        O =  Caller ID reports "OUT OF AREA"
  58.  
  59.        P =  Caller ID reports "PRIVATE"
  60.  
  61.        ! =  Caller ID does not match User Record
  62.  
  63.        ^ =  Caller ID found in Trashcan file, caller was disconnected
  64.  
  65.        * =  Something went wrong, see message to Sysop
  66.  
  67.  
  68. 2. The "P", "!", "*", and "^" types can trigger an automatic message to
  69.    be sent to the SYSOP.   This feature is controlled by the config
  70.    file.  The message contains details of the call, and can be read by
  71.    logging in as the Sysop and reading your mail.
  72.  
  73. 3. If the Trashcan file is present, and the Caller ID number matches
  74.    any one of the numbers in the trashcan file, the caller is
  75.    disconnected.
  76.  
  77. -------------------------------------------------------------------------
  78.  
  79. This PPE does not display anything to the caller, it just quietly
  80. alerts the Sysop.  <G>
  81.  
  82. The name and location of the log file is specified in the config file. The
  83. log file is written in append mode, it doesn't disappear unless you delete
  84. it yourself.   This file can get pretty big, so keep an eye on it.
  85.  
  86. The Trashcan file (if used) must be located in the same directory as the
  87. PPE, and must be named the same as the PPE, with a .TCN extension.
  88. (Example: CCID.TCN)   Enter the complete phone number as returned in
  89. the Caller ID info, one entry per line.
  90.  
  91. The config file must be located in the same directory as the PPE, and must
  92. be named the same as the PPE, with a .CFG extension.   (Example: CCID.CFG)
  93.  
  94. Config file format:
  95.  
  96. Line 1:  Y or N, controls logging of calls that match the User Record
  97. Line 2:  Y or N, controls logging of OUT OF AREA calls
  98. Line 3:  List of node numbers that the PPE should NOT be used on
  99. Line 4:  Y or N, controls the sending of auto-messages.
  100. Line 5:  The name/location of the log file.
  101. Line 6:  Y or N, controls use of modem ATI15 command
  102. Line 7:  Escape Character for ATI15 mode
  103.  
  104. Example:
  105.  
  106. Y
  107. Y
  108. 0
  109. Y
  110. C:\PCB\CIDLOG.TXT
  111. N
  112. 128
  113.  
  114.  
  115. Explanation of example:
  116.  
  117. Line 1:  Calls that match the phone number found in the User Record
  118.          will be recorded in the log file.   If you only want the
  119.          "bad guys" recorded in the log, set this to N.
  120.  
  121. Line 2   Calls that are OUT OF AREA will be recorded in the log file.
  122.          If you don't want the OUT OF AREA calls in the log, set this
  123.          to N.
  124.  
  125. Line 3:  If you have a multi-node system, and one or more nodes do NOT
  126.          have Caller ID, list them here so the PPE will not try to
  127.          process CID for that node.   If you have more than one node
  128.          to avoid, list each one with a space in between.   If ALL your
  129.          lines have Caller ID, leave this line blank or "0".
  130.  
  131. Line 4:  The PPE will send a private message to the Sysop when the
  132.          Caller ID is missing, private, or doesn't match the User
  133.          Record.
  134.  
  135. Line 5:  The location of the log file.   Do NOT point this at the
  136.          PCBoard caller log.
  137.  
  138. Line 6:  This causes the program to directly interrogate the modem for
  139.          the Caller ID info, instead of using PPL's built-in Callid()
  140.          function.   This works only with the USR Courier modems, and
  141.          the modem must be configured to allow entry into Online
  142.          Command Mode.   If you do not understand how to do this, do
  143.          not use this option!   This feature is intended for diagnostic
  144.          purposes, in cases where PCBoard/PPL "loses" or "forgets" the
  145.          Caller ID info.
  146.  
  147. Line 7:  The escape character used to put the modem into command mode,
  148.          when using the option described above.   Values of 0-127 can
  149.          be used to match the modem's S2 register.  A value of 128
  150.          assumes that the modem is set to &D1, and command mode
  151.          will be entered by briefly toggling DTR.   For more
  152.          information about Online Command mode and modem init strings,
  153.          see the documentation for my STPCB PPE.
  154.  
  155. -------------------------------------------------------------------------
  156.  
  157. This PPE can be installed in a text file or as a logon SCRIPT.  (NOT in
  158. $$LOGON.BAT)   I do not recommend installing it in the NEWS file, as
  159. this can be bypassed under some circumstances. The LOGON SCRIPT is the
  160. most secure place.
  161.  
  162. (File Locations -> New User/Logon/Logoff -> Name/Loc of Logon Script)
  163.  
  164. Also, make sure you have (Configuration Options -> Logging Options ->
  165. Log Connect String to Disk) set to "YES".
  166.  
  167.  
  168. See your PCBoard manual for further installation instructions.
  169.  
  170.  
  171. ---[End]-----------------------------------------------------------------