home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / cid_os2.zip / readme.cid < prev   
Text File  |  1997-04-01  |  7KB  |  157 lines
  1.  
  2.  CID 0.03 OS/2 PM     Copyright (C) 1997, Craig Morrison          Caller ID Box
  3.                              All Rights Reserved.
  4.  
  5.   What is CID?
  6.  
  7.     CID...Pronounced "syd".
  8.  
  9.       CID is a simple Caller ID box for OS/2 Warp's Desktop. It is designed
  10.     to work with Caller ID subscribers who have CallerID Name & Number
  11.     turned on. You'll never lose another number again! The number of
  12.     callers stored is only limited by the amount of virtual memory you
  13.     have. :-)
  14.  
  15.       If you can operate a standard phone company caller ID box, you can
  16.     operate CID. CID is an almost exact replacement for the box, the best
  17.     part about it is....CID sits right on your desktop, a mouse click away.
  18.  
  19.   Notes About CID..
  20.  
  21.       This is a pre-release version, it may or may not work for you. It has
  22.     been tested with a Motorola 28.8 VoiceSurfr Fax/Modem. As I get the
  23.     bugs worked out, I will be adding a phonebook and twit filters. >;-}
  24.  
  25.       What you are seeing here with CID is the spawning of a retail
  26.     software package. When finished, that release will only be sold, not
  27.     given away. However, you may use any pre-release version for whatever
  28.     you wish, as long as you wish.. The purpose of the net exposure is to
  29.     allow me as wide a test audience as possible. Thank you for helping me.
  30.  
  31.       Double-clicking on the phone number display will auto-dial the
  32.     number shown.
  33.  
  34.   Installing CID..
  35.  
  36.       Run CID_OS2.EXE and kick back...Obviously you have already done that
  37.     because you are reading this file from the self-extracting archive
  38.     installer.
  39.  
  40.       I hope you like the install program, it should be almost transparent to
  41.     the end user. Comments, suggestions, etc.. are welcome.
  42.  
  43.   Starting CID..
  44.  
  45.       Simple:  (well...It used to be simple :-)
  46.  
  47.         CID [switches]
  48.  
  49.         Switches:   (may be preceded by - or /)
  50.                     (NOTE: the examples below are the defaults for CID.)
  51.  
  52.             S              Swap last word in name for first word(s).
  53.                            ie. DOE JOHN becomes JOHN DOE
  54.  
  55.             O              External database file(**), example:
  56.                                -Ocallers.dat
  57.  
  58.             I              Country code, = 1 for USA.
  59.                            Example:        -I1
  60.  
  61.             A              Local area code list. This switch is for
  62.                            those who live in areas that may have one
  63.                            or more local (non-toll call) area codes.
  64.                            Simply string them together with a
  65.                            character separating each one. It is used
  66.                            for auto-dialing purposes.
  67.                            Example:        -A317;765;
  68.  
  69.             D              Dial prefix, example:
  70.                                -DATDT
  71.  
  72.             R              The modem uses a Rockwell chipset.
  73.                            (NOT the default.) This switch changes the
  74.                            defaults to:
  75.  
  76.                                 -C+AT#CID=1
  77.                                 -C-AT#CID=0
  78.  
  79.             P              Specify the comm port to use, i.e.:
  80.                                -PCOM2
  81.  
  82.             C+             The string to turn on CallerID information.
  83.                            Example:        -C+AT#CC1
  84.                                            -C+AT#CID=1
  85.                                            -C+AT#CID1
  86.  
  87.             C+             The string to turn off CallerID information.
  88.                            Example:        -C-AT#CC0
  89.                                            -C-AT#CID=0
  90.                                            -C-AT#CID0
  91.  
  92.            (**)            The record layout for the database file is
  93.                            a packed stream of the following structure:
  94.  
  95.                            typedef struct _cidinfo {
  96.                                unsigned short  cbData;
  97.                                unsigned char   phoneDigits[13];
  98.                                unsigned char   callerName[16];
  99.                                unsigned char   callerDate[6];
  100.                                unsigned char   callerTime[6];
  101.                                unsigned long   callerNumber;
  102.                                struct _cidinfo *next;
  103.                                struct _cidinfo *prev;
  104.                            } CIDINFO, *PCIDINFO;
  105.  
  106.                            callerNumber is relative only to the
  107.                            session that the call was received in.
  108.                            *next and *prev should be ignored as they
  109.                            serve no useful purpose in the external
  110.                            file.
  111.  
  112.       The defaults are setup for Voice/Data/Fax/Modems which utilize Sierra
  113.     Semiconductor Chip Sets. You will have to look the commands up in your
  114.     modem documentation for other chipsets. CID expects the caller ID
  115.     information to be returned in <key>=<value> form:
  116.  
  117.         DATE=   03/27               (*1)
  118.         TIME=   20:24
  119.         CID=    5551113333
  120.         NAME=   MORRISON CRAIG
  121.  
  122.         DATE    =   0327            (*2)
  123.         TIME    =   2024
  124.         NMBR    =   5551113333
  125.         NAME    =   MORRISON CRAIG
  126.  
  127.         *1  Sierra Semiconductor chipsets
  128.         *2  Rockwell Semiconductor chipsets
  129.  
  130.       CID defaults to Sierra Semiconductor chipsets (specifically the
  131.     Motorola VoiceSURFR 28.8 Fax/modem), the switches would be:
  132.  
  133.         CID -C+AT#CC1 -C-AT#CC0
  134.  
  135.       CID writes a comma-delimited record to Standard Error output for each
  136.     call that comes in. The format of the file is simple, no one should
  137.     have any problems figuring it out. To capture the output, redirect
  138.     STDERR to a file your choice:
  139.  
  140.         CID -PCOM1 -C+AT#CC1 -C-AT#CC0 2>>CID.LOG
  141.  
  142.       Please feel free to e-mail <basher@gte.net> the caller ID strings for
  143.     other chipsets to me and I will write an installation program that will
  144.     allow for easier setup (desktop objects, etc..) Please! E-mail me any
  145.     suggestions, bugs, comments, feature requests, etc... My mailbox is
  146.     always open. Or you can stop by my website and leave a note there in the
  147.     guestbook. You may also wish to browse a bit when you stop by, there are
  148.     links to a large number of resources on the net there.
  149.  
  150.       Good luck!
  151.  
  152.         Basher
  153.  
  154.         http://home1.gte.net/basher/index.htm
  155.         basher@gte.net
  156.  
  157.