home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CIDV130.ZIP / CIDLOG.DOC < prev    next >
Encoding:
Text File  |  1993-01-17  |  23.5 KB  |  561 lines
  1.        
  2.        
  3.        
  4.        
  5.        
  6.        
  7.        
  8.        
  9.        
  10.        
  11.        
  12.        
  13.        
  14.        
  15.        
  16.        C I D L O G
  17.        
  18.        ____________________________________________________________________
  19.        
  20.        
  21.        Program Reference Manual
  22.        
  23.        
  24.        
  25.        
  26.        
  27.        
  28.        
  29.        
  30.        
  31.        
  32.        
  33.        
  34.        
  35.        
  36.        
  37.        
  38.        
  39.        
  40.        
  41.        
  42.                       Copyright (C) 1992,1993 by Steven L. Davis.
  43.        
  44.                                 ALL RIGHTS RESERVED.
  45.        
  46.        
  47.        
  48.        
  49.                         
  50.                            Steven L. Davis SLD Systems,
  51.        
  52.              1143 Washington Green, Building M, New Windsor, NY 12553
  53.        
  54.                         (914) 562-1450 / (914)562-1722 BBS
  55.        
  56.        
  57.        
  58.        
  59.            
  60.             
  61.            CIDLOG v1.30                                        COPYRIGHT ii
  62.            
  63.        
  64.        
  65.                                  Copyright Notice
  66.        
  67.        
  68.        
  69.        
  70.        
  71.        CIDLOG is Copyright (c) by Steven L. Davis.
  72.        
  73.        This document is Copyright (c) by Steven L. Davis.
  74.        
  75.        No parts of CIDLOG or  this  document  may  be  copied in part or in
  76.        whole,  except as provided  in  the  License  at  the  end  of  this
  77.        document.
  78.        
  79.        
  80.        Disclaimer
  81.        
  82.        Steven  L.  Davis  and  SLD  SYSTEMS  makes no warranty of any kind,
  83.        either express or  implied,   including  but  not limited to implied
  84.        warranties of merchantability and fitness for a particular  purpose,
  85.        with respect to this software and accompanying documentation.
  86.        
  87.        IN  NO  EVENT SHALL STEVEN L. DAVIS OR SLD SYSTEMS BE LIABLE FOR ANY
  88.        DAMAGES (INCLUDING DAMAGES FOR  LOSS  OF BUSINESS PROFITS,  BUSINESS
  89.        INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
  90.        ARISING OUT OF THE USE OF OR INABILITY  TO  USE  THIS  PROGRAM,   OR
  91.        INFORMATION IN THIS DOCUMENT, EVEN IF STEVEN L. DAVIS OR SLD SYSTEMS
  92.        HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  93.        
  94.        
  95.        Trademarks
  96.        
  97.        CIDLOG is a trademark of SLD SYSTEMS.
  98.        
  99.        Many  product  names  found throughout this manual are trademarks of
  100.        various companies.
  101.        
  102.                 
  103.        
  104.                                        -1-         
  105.        
  106.        CIDLOG V1.30                                          
  107.         
  108.        Caller ID Logging system version 1.30
  109.        
  110.        Caller ID has brought a  great  resource to the BBS community.   And
  111.        with the help of this program maximus can  take  advantage  of  this
  112.        resource.  Not only will it log incoming calls, but it will automate
  113.        part  of  the  login  process,  and give the bbs the ability to give
  114.        personalized greetings to users, and remove the need for the user to
  115.        identify him or her self upon connecting to your system.
  116.        
  117.        The main purpose of this software is to add caller id support to the
  118.        maximus BBS system.   However it  has  been written so that parts of
  119.        this program could be easily adapted to other bbs systems,  as  well
  120.        as other non BBS uses, using most serial Caller ID interfaces!
  121.        
  122.        What will it do?
  123.         
  124.         o The CIDLOG(tm) Caller ID LOGGER system will log all calls.
  125.         o If you wish, It can allow you to reject callers who BLOCK CALL ID
  126.         o It can identify the user and automate part of the MAXIMUS login. 
  127.         o It can verify a user without the need for callback verification. 
  128.         o Will not effect incoming calls from areas without caller ID
  129.         
  130.        
  131.        What do you need to use this software?
  132.        
  133.         o first off you must have Caller ID service from the phone company.
  134.         o you will need either a modified CALLER ID box (Modification adds
  135.           a serial interface to the caller id box) or a bell 202 compatible
  136.           modem (this may also require a slight modification) more on the
  137.           modifications later.
  138.         o  for  this  version,   you will be required to run a multitasking
  139.            system like desqview, however a TSR version is almost ready.
  140.                 
  141.        
  142.        The CIDLOG(tm) system consists of the following files:
  143.        
  144.        CIDLOG.EXE  - Caller ID Logging program.
  145.        CIDFU.EXE   - Maximus find user program.
  146.        CIDCN.EXE   - Used for user verification.
  147.        LOGO.MEC    - Sample LOGO file,  displays users name  and  automates 
  148.                      the name entry.
  149.        CHKPHO.MEC  - Sample user verification using CIDCN.EXE
  150.        CIDLOG.DOC  - This File
  151.        LICENSE.DOC - License Info
  152.        
  153.        Program descriptions:
  154.        
  155.        CIDLOG.EXE(tm) 
  156.        This program monitors  the  serial  port  for  incoming  CALL ID and
  157.        maintains 3 files in the current directory:
  158.         
  159.        CALLID.LOG  - Logs time date and phone number if incoming calls
  160.        NUMBER.DAT  - Number of last incoming call 
  161.        PRIVATE.DAT - File created if the incoming call has call id  blocked
  162.        
  163.                                        -2-         
  164.         
  165.        When  a  call  arrives,   CIDLOG.EXE  logs  the  incoming  calls  to
  166.        CALLID.LOG log file.  The phone number is also written to NUMBER.DAT
  167.        as well over writing any data that may have previously been in  that
  168.        file (if it doesn't exist then it will be created).  If the incoming
  169.        call has CALL ID blocked, then the file PRIVATE is created.   if the
  170.        incoming  call  DOES  NOT have CALL ID blocked,  then PRIVATE.DAT is
  171.        deleted.  sample CALLID.LOG
  172.        
  173.        DATE: 11/22  TIME: 10:30  PH#: (914) 562-1722
  174.        DATE: 11/22  TIME: 10:42  PH#: (914) 562-1450
  175.        DATE: 11/22  TIME: 11:01  PH#: Out of AREA 
  176.        DATE: 11/22  TIME: 11:33  PH#: Private
  177.        
  178.        As you can see there is one  other possible call type,  OUT OF AREA,
  179.        which means that the call is coming from an area that  doesn't  have
  180.        caller id service.   In the case of this type of call being received
  181.        the  NUMBER.DAT  file  will  have the text 'Out of Area' in it,  and
  182.        PRIVATE.DAT will be deleted if it exists.
  183.        
  184.        The Syntax for running CIDLOG  is  CIDLOG  #  [D] Where # is the com
  185.        port number that  your  device  for  receiving  caller  id  data  is
  186.        attached.  'D' is an optional command, adding this to the end of the
  187.        command  will  DISABLE the multitasker/dos speedups.   In most cases
  188.        you will not use this command.
  189.        
  190.        For com2: CIDLOG would be started with this command: 
  191.        
  192.        CIDLOG 2 
  193.        
  194.        
  195.        CIDMFU.EXE(tm)  -  Caller  ID  Maximus Find User.   This is the only
  196.        maximus specific .EXE file  included with this release.   CIDMFU(tm)
  197.        is designed to be called from maximus from the LOGO.BBS  file.    it
  198.        reads  the  NUMBER.DAT  file created by CIDLOG.EXE and tries to find
  199.        the user record for the first record with that number.   if the user
  200.        record does exist then MAXFU will create 2 files:
  201.        
  202.        USERNAME.DAT - raw name for use in logo screen
  203.        POKENAME.DAT - A  mecca  token  file that pokes the  users name into
  204.                       maximus
  205.        
  206.        The POKENAME.DAT file can be linked  into  the logo file so the logo
  207.        screen the user will see can  display  his  name  before  he  enters
  208.        anything.  The second file is a mecca file which when linked to will
  209.        pass the users name to maximus so it is as if the user typed it.  (a
  210.        sample  logo.mec  file  is  included) All the files that are used by
  211.        CIDMFU(tm) must be in the current working directory.   All files and
  212.        created by CIDMFU(tm) are created in the current working directory.
  213.        
  214.        
  215.        CIDCN.EXE<tm> this file  compares  the  NUMBER.DAT  file with a file
  216.        written by a mecca file called CHKPHO.DAT,  if the phone  number  in
  217.        NUMBER.DAT  matches  the number in CHKPHO.DAT then a file is created
  218.        called PHONEOK.DAT.   All files  are  used  by  CIDCN must be in the
  219.        current working directory.   All files and created by CIDCN<tm>  are
  220.        created in the current working directory.
  221.        
  222.                                        -3-         
  223.         
  224.        Initially CIDCN.EXE program was created to use in place of call back
  225.        verification,   however this program doesn't do any duplicate number
  226.        checking in the user.bbs  file.    if  there is sufficient interest,
  227.        then I will add this.
  228.        
  229.        The reason for  passing the number in a file instead of directly  to
  230.        the  program  via  a  mecca  command  is  that  i wanted to give the
  231.        flexibility for use  in  other  applications.   I.E perhaps checking
  232.        against a bad phone number file.
  233.        
  234.        
  235.        INSTALLATION
  236.        
  237.        FOR MAXIMUS:
  238.        
  239.        
  240.        Since caller ID comes in between the first and  second  rings,   you
  241.        will most likely need to change your configuration.   To the best of
  242.        my knowledge, maximus picks up only on the first ring, Therefor, you
  243.        will need to comment out the RING command in MAX.CTL and set up your
  244.        modem to auto answer on the second ring.   you can typically do this
  245.        by  either  adding  ATS0=2  to your init sequence or programming the
  246.        mode m with this parameter and saving it using AT&W command.
  247.        
  248.        Installation is very straight forward.   unarc the files,  and place
  249.        all the .EXE files in  your  maximus sub directory.   Use the sample
  250.        logo.mec file to create your new logo screen (you may need to change
  251.        the directory names used in the sample  logo.mec  file).    generate
  252.        your logo.bbs using the mecca program.
  253.        
  254.        If you want to validate new users then add a link to the  CHKPHO.MEC
  255.        file from one of the files you display to new users.
  256.        
  257.        Connect your Caller ID receiving device to a free com port.
  258.         
  259.        using your favorite multitasker, run CIDLOG specifying the number of
  260.        the com port in the command line.
  261.        
  262.        NON MAXIMUS Installations:
  263.        
  264.        As  far  as  how you will use the programs described above,  that is
  265.        totally up to you.    The  CIDLOG.EXE  program will log all incoming
  266.        calls to a file and the screen.   It is a  great  addition  for  any
  267.        usage,  for bbs applications you will need to run CIDLOG.EXE under a
  268.        multitasker, so you may also run the bbs.  I'm greatly interested in
  269.        how people are using this software, so please feel free to drop me a
  270.        note  or  a  line  and  tell me what applications or situations your
  271.        using it in!
  272.        
  273.        
  274.                                        -4-         
  275.         
  276.        CALLER ID Reception:
  277.        
  278.        How can I receive caller ID data??
  279.        Most of us do not have modems that can receive caller id data.
  280.        
  281.        Caller ID data arrives between  the  first and second rings.   it is
  282.        transmitted via  BELL  202  type  tones,   and  can  be  demodulated
  283.        (received) using any device that can demodulate these tones (I.E.  a
  284.        bell 202 style modem or a caller ID box).
  285.        
  286.        We are currently arranging to get inexpensive interfaces for CALLER
  287.        ID.   However at the moment there are two ways,  that I known of, to
  288.        receive  caller ID to your computer without a special interface or a
  289.        special modem.
  290.        
  291.        One fairly easy method is  to  modify  a  caller id box,  here is an
  292.        example of a mod for a standard AT&T model 125 caller ID box which I
  293.        use on my own BBS.  (I can also give you a modified box  for  about 
  294.        $80 U.S Dollars, call me for more information)      
  295.         
  296.        NOTE:  The following modifications are included in this document for
  297.        informational purposes.  Use this information at your own risk.
  298.         
  299.                         MOD for AT&T Caller id box MODEL 125c
  300.        
  301.        
  302.                                            232 Ground
  303.                                            DB25 pin 3
  304.                                                 ^
  305.                             ---------           |           ---------
  306.                           [|8       7|]---------+         [|1      14|]
  307.                            |         |          |          |         |
  308.                           [|9       6|]         |         [|2      13|]
  309.                            | MC 1488 |          |          | XR 2211 |
  310.                           [|10      5|]         |         [|3      12|]
  311.                            |         |          |          |         |
  312.                           [|11      4|]         +---------[|4      11|]
  313.                            |         |                     |         |
  314.                           [|12      3|]----> 232 OUT to   [|5      10|]
  315.                            |         |       DB25 pin 3    |         |
  316.                           [|13      2|]---------+         [|6       9|]
  317.                            |         |          |          |         |
  318.                         +-[|14      1|]-+       +---------[|7       8|]
  319.                         |   ---------   |                   ---------
  320.                         |               |
  321.                       +12v            -12v
  322.        
  323.        Turn the caller ID box over,  with the  battery  compartment  facing
  324.        you.    remove  the 4 screws covering the back of the 125c caller ID
  325.        box.   Locate the XR2211 chip in  the lower right side of the caller
  326.        id box.   connect pin 7 of the xr2211 to the input of a  232  driver
  327.        (pin  2).   connect the ground of the xr2211(pin 4) to the ground of
  328.        the 232 driver(pin 7) connect  the  output  of  the 232 driver to an
  329.        RS232 cable (pin 3 on a db25).  connect the signal ground of the 232
  330.        driver(pin 7) to the signal ground of the rs232 cable (pin 7 on a db
  331.        25) apply power to your 232 driver, and that's it.
  332.        
  333.                                        -5-         
  334.         
  335.        
  336.        (USER REPORTED MOD) MOD for a 202 style modem.   (authors  note:   I
  337.        have not personally tried this,  however it appears to me as it will
  338.        work  as described to me.   I'm looking for comments from anyone who
  339.        has tried this or other  mods  /  methods of demodulating caller id
  340.        data)
  341.        
  342.        If you can find or have a 4 wire 202 style modem, attach the receive
  343.        lines to the incoming phone lines via a .1uf capacitor rated  at  at
  344.        least 200V.  (a note for you electronic wizards: this keeps the line
  345.        DC  isolated  so the line will not go off hook when connected to the
  346.        modem.   WV of the cap needs  to  be  high enough to handle the ring
  347.        voltage without arcing )
  348.               
  349.                      .1uf(i've heard that .047uf also works)          
  350.                      200WV          | 
  351.          T ------------||---------->| Modem incoming 
  352.                                     | Receive phone 
  353.                                     | Input Line 
  354.                                     | 
  355.          R ------------------------>| 
  356.                                     |
  357.        
  358.        
  359.        
  360.        We are interested in any additional modifications that might  be  of
  361.        interest to those who wish to capture caller id information, so that
  362.        we  may pass this information on to others.   Please if you have any
  363.        additional mods, or comments on these mods, contact us.
  364.        
  365.        
  366.        Version History:
  367.        
  368.        V1.30 Fixed some problems with  CIDLOG.LOG being overwritten on each
  369.              call on some systems.   Added some more improvments  for  os/2
  370.              added the ability to disable multitasker support.
  371.        
  372.        V1.22 Multitasker Support,   Significant  improvments to performance
  373.              under dos and most multitaskers and networks.
  374.        
  375.        V1.12 Added addidional logging and maximus support 
  376.        
  377.        V1.00 Initial release 
  378.        
  379.        
  380.                                        -6-         
  381.         
  382.        Who are we?
  383.        
  384.        SLD Systems 1143 Washington Green Building M New Windsor, NY 12553
  385.        
  386.        Providing consulting services for  both hardware and software needs.
  387.        custom programming and system design.
  388.        
  389.        For a $5.00 US dollars,  you can register your version of CIDLOG(tm)
  390.        V1.30.   Registering your copy of CIDLOG(tm) will  help  us  improve
  391.        this software, and entitles you to free updates from our bbs.
  392.        
  393.        Please   contact   us   for   additional   information   on  support
  394.        arrangements.
  395.        
  396.        Please feel free to leave comments on our BBS on possible updates to
  397.        this software.   If there is sufficient interest in changes, then we
  398.        will include them in a future release of the program.
  399.        
  400.        The author can be reached at:
  401.        
  402.        Steven L. Davis
  403.        1143 Washington Green
  404.        Building M
  405.        New Windsor, NY 12553
  406.        
  407.        VOICE: (914) 562-1450 
  408.          BBS: (914) 562-1722
  409.        
  410.        Comuserve: 70562,540
  411.          
  412.        Echomail: Maximus ECHO, Mail will need to be sent to "Steve Davis"
  413.        
  414.        Fidonet:  1:272/38 (this is not my  node,  however the sysop of this
  415.                            node has been kind enough to accept mail for me.
  416.                            make sure you address your  comments  to  "Steve
  417.                            Davis")
  418.        
  419.        
  420.        
  421.        
  422.        CIDLOG v1.30                                               License i
  423.        
  424.        
  425.        
  426.        
  427.        
  428.                                       LICENSE
  429.        
  430.        
  431.        
  432.        
  433.        
  434.        CIDLOG is Copyright (c) 1992,1993 by Steven L. Davis
  435.        
  436.        CIDLOG is not, nor has ever been, public domain or free software.
  437.        
  438.        The  commercial,  registered version of CIDLOG may not be duplicated
  439.        other than for backup purposes.  A registered copy of CIDLOG must be
  440.        treated like a book,  in that the same registered copy of CIDLOG may
  441.        not be used in more than one  computer  at the same time,  just as a
  442.        book may not be read by more  than  one  person  at  the  same  time
  443.        (without making an illegal copy).
  444.        
  445.        Users are granted a limited license to use the User Supported, trial
  446.        version  of CIDLOG for a limited evaluation period of up to 30 days,
  447.        in order to determine if  it  suits  their needs.   Any other use of
  448.        CIDLOG or use past this period requires registration.
  449.        
  450.        All users are granted a limited license to copy the  User  Supported
  451.        version of CIDLOG only for the purpose of allowing others to try it,
  452.        subject to the above restrictions as well as these:
  453.        
  454.             CIDLOG must be distributed in absolutely unmodified form,
  455.             including ALL program, documentation, and other files.
  456.        
  457.         
  458.        CIDLOG  may  not  be  included with any other product for any reason
  459.        whatsoever without a license from Steven L. Davis and SLD Systems.
  460.        
  461.             No charge or payment may be levied or accepted for CIDLOG.
  462.        
  463.        Bulletin Board system  operators  may  post  the unregistered,  User
  464.        Supported version of CIDLOG on their BBS for  downloading  by  their
  465.        users  without  written  permission only if the above conditions are
  466.        met,  and only if no special  fee  is necessary to access the CIDLOG
  467.        files (a general fee to access the BBS is ok).
  468.        
  469.        Distributors of User  Supported  and  Public  Domain  software  MUST
  470.        obtain  written  permission from Steven L. Davis before distributing
  471.        CIDLOG and must follow the  above conditions.   Permission is almost
  472.        always granted;  this requirement is necessary to ensure  protection
  473.        for ourselves and CIDLOG users from unscrupulous individuals.
  474.        
  475.        The  following  section  contains  information  on  registration and
  476.        licensing.
  477.        
  478.        CIDLOG v1.30                                              License ii
  479.        
  480.        
  481.        
  482.        
  483.        
  484.                       CIDLOG Ordering/Registration Information
  485.        
  486.        Registering (buying) CIDLOG allows you  to use the product after the
  487.        trial period.
  488.        
  489.        CIDLOG version 1.30 registration costs $5 US / $6 CDN.   A disk with
  490.        the current copy of CIDLOG on it is also available for $10 US /  $12
  491.        CDN.    CIDLOG,   and includes registration (the right to use CIDLOG
  492.        after  the  evaluation  period).    The   fee  covers  the  cost  of
  493.        diskette(s) and handling.
  494.        
  495.        Payment may be in the form of check or money order,  All  US  dollar
  496.        checks  must  be drawn on a US bank,  and all Canadian dollar checks
  497.        must be drawn on a Canadian bank.
  498.        
  499.        Previously regis tered owners of  CIDLOG may use the 1.30 evaluation
  500.        release at no charge.
  501.        
  502.        
  503.        Shipping is $2 per copy,  to a maximum of $20 in North America,  and
  504.        $3 per copy to a maximum of $24 outside of North America.
  505.        
  506.        
  507.        CIDLOG v1.30                                             License iii
  508.        
  509.        
  510.        CIDLOG version 1.30                                      #921225-130
  511.        --------------------------------------------------------------------
  512.        Remit to: Steven L. Davis,
  513.                  SLD Systems, 
  514.                  1143 Washington Green
  515.                  New Windsor, NY 12553
  516.                  USA
  517.        --------------------------------------------------------------------
  518.        Quan       Item                              US/CDN        Price
  519.        
  520.        ___  CIDLOG Registration................   @ $5/$6 ea     $________
  521.            (registration of Version 1.30)
  522.        
  523.        ___  CIDLOG Registration and Disk.......   @ $10/$12 ea   $________
  524.               (includes program on disk + registration)
  525.        
  526.             Disk media type: 5.25" [ ] 3.5" [ ]
  527.  
  528.        ___  Modified AT&T 125c Caller ID BOX
  529.             plus Registration and Disk.......     @ $85/$99 ea   $________
  530.               (includes program on disk + registration)
  531.  
  532.             Disk media type: 5.25" [ ] 3.5" [ ]
  533.        
  534.        
  535.               Shipping/Handling is: ------------------> Shipping $________
  536.                 N. America: $2 per disk 
  537.                 N. America: $5 per ID Box + disk               
  538.                 Overseas : $4 per disk 
  539.                 Overseas : $10 per ID Box + disk
  540.                 (call for bulk shipping prices)
  541.                                                       Subtotal   $________
  542.        
  543.        
  544.                                                          TOTAL   $________
  545.        
  546.        --------------------------------------------------------------------
  547.                     Payment by: ( ) Check or MO   ( ) PO # ____________
  548.        
  549.              Name_______________________________________________________
  550.        
  551.           Company_______________________________________________________
  552.        
  553.           Address_______________________________________________________
  554.        
  555.                  _______________________________________________________
  556.        
  557.        
  558.           Phone(______)________________  Other(______)________________
  559.        
  560.        
  561.