home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / tools / phone / TEUMAX.1.6.1.README < prev   
Encoding:
Text File  |  1998-01-15  |  10.1 KB  |  252 lines
  1. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  2.  
  3.  
  4.                 T A R I F E I N H E I T E N A U S W E R T U N G
  5.  
  6.                       F U E R
  7.  
  8.                        Ackermann EURACOM 180, 181 & 182
  9.                        Alcatel ISDN 2001, 2002 & 2003
  10.                        Bosch Integral 10/1, 10/2 & 10/3
  11.                           Quante MAXIMA IS-1, IS-2 & IS-3
  12.                            und
  13.                         baugleiche
  14.  
  15.                                       v1.6.1
  16.  
  17.                                   vom 12.01.1998
  18.  
  19. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  20.  
  21.  (c) 1996-1998 by NiFiX dental develop, Stephan Gelhaus
  22.  
  23.  NiFiX_________                                       www: http://www.nifix.com
  24.  dental develop                                e-mail: mailto:gelhaus@nifix.com
  25.  
  26. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  27.  
  28. Inhalt:
  29.  
  30.  0. Neues
  31.  1. Einfuehrung
  32.  2. Aufbau
  33.  3. Installation
  34.  4. Was noch fehlt...
  35.  5. Ausgabe-Beispiel
  36.  
  37.  
  38.              =======================================================
  39.          
  40.                   A N   A L L E   B E N U T Z E R   ! ! !
  41.               
  42.           W E R   D I E S E   S O F T W A R E   B E N U E T Z T
  43.           
  44.          S C H I C K E   M I R   B I T T E   E I N E   E M A I L
  45.          
  46.                            gelhaus@nifix.com
  47.              =======================================================
  48.  
  49.  
  50. 0. Neues
  51. v1.6.1 vom 12.01.1998
  52. - entschuldigung, falsche Version uploaded
  53. v1.6.0 vom 11.01.1998
  54. - erweiterung um: HTML-Ausgabe, Ausgabe von nur einen int. Teilnehmer,
  55.   Ausgabe von nur kommenden oder nur gehenden Gespraechen
  56.  
  57. v1.5.3 vom 06.08.1997
  58. - erweiterung um: Top-Liste Gesamt (Anzahl der gehenden Gespraeche)
  59.  
  60. v1.5.2 vom 23.07.1997
  61. - erweiterung um: Durchwahl-Text frei definierbar
  62.  
  63. v1.5.1 vom 16.03.1997
  64. - bug-fix: Top-Listen Sortierung
  65.  
  66. v1.4.0
  67. - Erweiterung: Ausgabe von Top-Listen: Gesamt oder nur Citytarif-Bereich
  68.   kann als kleiner Anhaltspunkt dienen wo sich evtl. CityPlus oder CityWeekend
  69.   lohnt
  70.  
  71. v1.4.1
  72. - bug-fix: zeitraum ausgabe modifiziert
  73.  
  74. v1.4.0 vom 28.02.1997
  75. - Erweiterungen von Hellmuth Michaelis, hm@kts.org und mir
  76. - NoPrint, Unterdrueckung von Namen welche in der aliases-Datei
  77.   entsprechend gekennzeichnet wurden
  78. - NoPrint rueckgaengig machen (-N Option)
  79. - Wildcard "*" bei Rufnummern, z.B. fuer Firmen
  80. - Unbekannte Rufnummern in Datei schreiben (-u Option)
  81. - Eingabe der Log-Daten über Datei anstatt STDIN (-i Option)
  82. - Ausgabe nur der Summen (-s Option)
  83.  
  84. v1.3.1 vom 09.04.1996
  85. - bug-fix: heutiges datum
  86.  
  87. v1.3.0 vom 26.03.1996
  88. - Nur Nummern-Ausgabe fuer direkten Vergleich mit dem EVN der Telekom
  89. - Angabe eines Datums-Bereich fuer Berechnung und Ausgabe
  90.  
  91. v1.2.0 vom 09.03.1996
  92. - Prozentuale Verteilung der Gebuehren
  93. - Dienste-Kennung: zur eigenen besseren Uebersicht.
  94. - Erweiterung der Konvertierung einer Nummer zu einem Namen
  95.  
  96. v1.1.0 vom 28.02.1996
  97. - Ausgabe-Format etwas geaendert.
  98.  
  99.  
  100.  
  101. 1. Einfuehrung
  102.  
  103. Im Augenblick gibt es nur die Moeglichkeit der Protokollierung der Tarif-Einheiten ueber einen dierekt an die TK-Anlage angeschlossenen Drucker oder mittels eines ueber die serielle Schnittstelle angeschlossenen MS-DOS PCs mittels dem mitgeliefertem Auswerteprogramm.
  104. Mir war das zu wenig.
  105. Da ich auch noch einen UNIX Rechner zur Verfuegung habe lasse ich meine Auswertung deswegen einfacher hiermit erstellen und mir dann regelmaessig als e-Mail zukommen.
  106. Es werden nur die eingehenden Gespraeche erkannt, welche von einem ISDN-Anschluss oder von einer digitalen Vermittlungsstelle - mit aktivierter Rufnummern-Uebermittlung fuer den analogen Teilnehmer - kommen.
  107. Damit also viele der ankommenden Gespraeche erkannt werden ist den Analog-Rufenden folgendes zu erklaeren:
  108.  
  109.    01114 anrufen:
  110.       "Ich wuensche die Freischaltung der Uebermittlung meiner Rufnummern
  111.        0815, 4711 und anderen, fuer kommende (COLP) und gehende (CLIP)
  112.        Verbindungen, sowie die fallweise Rufnummernunterdrueckung"
  113.       Die Einrichtung dieses Service, sowie der Service selbst sind
  114.       gebuehrenfrei!
  115.  
  116.  
  117.  
  118. 2. Aufbau
  119.  
  120. Anstatt eines Druckers wird die serielle Leitung mittels Hardware-Handshake-Kabel an den UNIX Rechner angeschlossen.
  121. Ein im Hintergrund laufendes Programm sammelt alle ankommenden Informationen der TK-Anlage.
  122. Ein Auswert-Programm kann dann taeglich, woechentlich,... eine Auswertung z.B. per e-mail versenden. Es ermittelt anhand einer weiteren Datei welche Personen/Firmen zu einer bestimmten Telefon-Nummer gehoeren.
  123. Ausserdem ist es moeglich mittels einem Web-browser sich ebenfalls die Datensaetze anzuschauen.
  124.  
  125. Das Ganze ist einer schneller Hack, womit auf Ausgestalltung bzgl. Parameter Uebergabe etc. kein Wert gelegt wurde. Dies bleibt weiteren Versionen vorbehalten. Fuer Anregungen und Wuensche habe ich ein offenes Ohr!
  126.  
  127.  
  128.  
  129. 3. Installation
  130.  
  131. install -m 750 -o root -g wheel eumaxd /usr/local/etc/
  132. install -m 755 -o root -g wheel teumax teumaxIn teumaxSince teumaxToday /usr/local/bin/
  133. install -m 644 -o root -g wheel alias accDays /usr/local/lib/isdn/
  134. install -m 755 -o root -g wheel teumax.pl /usr/local/etc/httpd/cgi-bin/
  135. ln -s /usr/adm/eumax.log /usr/local/etc/httpd/cgi-bin/
  136. ln -s /usr/local/lib/isdn/aliases /usr/local/etc/httpd/cgi-bin/
  137.  
  138.  
  139.  
  140. /usr/local/etc/eumaxd:
  141.  
  142. hier ggf. das Device fuer die serielle Schnittstelle aendern.
  143. Beispiel gilt fuer 040'ger NeXTstation Port B.
  144. WICHTIG! Schnittstelle mit Hardware-Handshake angeben.
  145.  
  146.  
  147.  
  148. /usr/local/lib/isdn/aliases:
  149.  
  150. hier stehen Eintraege drin, die eine Uebersetzung der Telefon-Nummer darstellen. - Genaueres steht in der Datei.
  151. WICHTIG! Nummer, Name und Dienst sind durch mind. ein TAB zu trennen.
  152.  
  153.  
  154.  
  155. /usr/local/lib/isdn/accDays:
  156.  
  157. hier steht in jeder Zeile ein Datum fuer den Beginn einer Abrechnungs-Periode.
  158.  
  159.  
  160.  
  161. /usr/local/bin/teumax [-b <Datum>] [-e <Datum>] [-n] [-i <Log-Datei>]
  162.                       [-s | ( [-n] [-N] ) ] [-u <Neue-Nummern-Datei>]
  163.               [-t <Anzahl>] [-c <Anzahl>] [-g <Anzahl>]
  164.               [-a <interne Teilnehmer-Nr.>] [-k] [-r] [-h]
  165.               
  166.  
  167. Abrechnungsprogramm. Parameter -b <Datum> (z.B. 01.02. oder 01.12.95) fuer beginn der Abrechnung, -e <Datum> fuer Ende der Abrechnung, -n fuer nur Nummern-Ausgabe, -i <Log-Datei> anstatt STDIN, -s Ausgabe nur der Summen der internen Teilnehmer, -N Ausgabe auch der NoPrint-Einträge, -u <Datei> Ausgabe bisher umbekannter Nummern in extra Datei, -t <Anzahl> Ausgabe z.B. der eigenen "TOP 10" im Gesamten oder mit -c <Anzahl> nur für den Citytarif-Bereich, -g <Anzahl> "TOP 10" aller gehenden Verbindungen nach Anzahl der Gespraeche, -a <interne Teilnehmer-Nr.> Ausgabe nur der Daten fuer den angegebenen internen Teilnehmer, -k Ausgabe nur der kommenden Verbindungen, -r Ausgabe nur der gehenden Verbindungen, -h Ausgabe im HTML-Format zum Darstellen in einem Web-Browser.
  168.  
  169. Gerade mit der Top-Citytarif, ist es möglich herauszufinden, welche Nummern für CityWeekend oder CityPlus geeignet sind.
  170.  
  171.  
  172.  
  173. /usr/local/bin/teumaxToday [-<Anzahl>]
  174.  
  175. Abrechnungsprogramm Erweiterung. Parameter -<Anzahl> fuer Abrechnung der Gebuehren vor <Anzahl> Tagen
  176.  
  177.  
  178.  
  179. /usr/local/bin/teumaxSince [-a <Nummer> | -d <Datum | -o <Tage>]
  180.  
  181. Abrechnungsprogramm Erweiterung. Parameter -a <Nummer> fuer Abrechnungs-Zeitraum 1=aktueller, 2 letzter, ...; -d <Datum> fuer Abrechnung seit <Datum>; oder -o <Tage> fuer Abrechnung seit der letzten <Tage> Tage.
  182.  
  183.  
  184.  
  185. in /etc/rc.local:
  186.  
  187. # EURACOM & MAXIMA charge logging
  188. if [ -f /usr/local/bin/eumaxd ]; then
  189.         /usr/local/bin/eumaxd
  190.         (echo -n ' eumaxd')      > /dev/console
  191. fi
  192.  
  193.  
  194.  
  195. in /etc/crontab.local:
  196.  
  197. 10 00 * * *        root    /usr/local/bin/teumaxToday -1 | /usr/ucb/mail -s "EUMAX Gebuehren (gestern)" isdn-master
  198. 11 00 * * 6        root    /usr/local/bin/teumaxSince -a 1 | /usr/ucb/mail -s "EUMAX Gebuehren (laufende Abrechnungs-Periode)" isdn-master
  199.  
  200.  
  201.  
  202. 4. Was noch fehlt...
  203.  
  204.  - Gespraechs-Dauer: Die TK's uebermitteln dies leider nicht. Hiermit waere
  205.    ein genauerer Vergleich zum Einzelverbindungsnachweis (EVN) moeglich.
  206.    Habe ich als Verbesserungsvorschlag bei Ackermann und Quante angegeben.
  207.  - GUI-Applikation fuer diverse Betriebssysteme (NEXTSTEP, OPENSTEP, Rhapsody,
  208.    MacOS,???, bitte kein Windows x.y, oder sonstigen mittelmaessigen Kram)
  209.  - Ausgabe nach Projekten und ggf. mit individuellem Gebuehrensatz
  210.  - Vorschlaege von allen Anwendern.
  211.  
  212.  
  213.  
  214. 5. Ausgabe-Beispiel
  215.  
  216. ----anfang--------anfang--------anfang--------anfang--------anfang----
  217. Datum  Uhrzeit Einh.  Betrag      intern VA extern                        Dienst
  218. --------------+-----+-------+-----------+--+------------------------------+-----
  219. 08.04.96 00:19     4    0.48    PowerMac -> Praxis                           F S
  220. 08.04.96 13:24     1    0.12        Büro -> Wolf                               S
  221. 08.04.96 14:56     6    0.72    PowerMac -> Praxis Dr. Quincy                F S
  222. 08.04.96 15:11     1    0.12     Wohnung -> Adam & Eva                         S
  223. 08.04.96 18:38    54    6.48     Wohnung -> Helmut Kohl                        S
  224. 08.04.96 22:12               [aufgelegt] :( Gelhaus privat                     S
  225. --------------+-----+-------+-----------+--+------------------------------+-----
  226.           1.3%     1    0.12        Büro
  227.          73.3%    55    6.60     Wohnung
  228.          13.3%    10    1.20    PowerMac
  229.          12.0%     9    1.08 ISDN-Router
  230. --------------+-----+-------+-----------+--+------------------------------+-----
  231. Gesamt            75    9.00 DM
  232. --------------+-----+-------+--------------+------------------------------------
  233. TOP-Citytarif   1000  120.00                IP
  234.                  150   18.20                Hänsel & Gretel
  235.                  120   14.40                Telekom Störungsdienst
  236.                  110   13.20                Goethe
  237.                  100   12.00                Rapunzel
  238. --------------+-----+-------+-----------+--+------------------------------+-----
  239. Legende:             Verbindungsart(VA): -> gehend         Dienst:   Daten D
  240.                                          <- kommend                    Fax   F
  241. Zeitraum: 08.04.96-08.04.96                                        Sprache     S
  242. ----ende---------ende---------ende---------ende---------ende---------ende-----
  243.  
  244.  
  245.  
  246. Ciao und viel Spass,
  247.  Stephan Gelhaus
  248. ---
  249.  
  250.  NiFiX_________                                     www: http://www.nifix.com
  251.  dental develop                              e-mail: mailto:gelhaus@nifix.com
  252.