home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
x
/
xstat.lha
/
XStat.dok
< prev
next >
Wrap
Text File
|
1992-09-04
|
17KB
|
532 lines
Dokumentation zu XStat V1.10
============================
Programm und Dokumentation sind ⌐ Copyright 1992 by Jⁿrgen Weinelt.
IMPORT StdDisclaimer; (* kurz: Benutzung auf eigene Gefahr *)
XStat wurde sorgfΣltig getestet, aber es k÷nnen natⁿrlich trotzdem noch
diverse Fehler 'drinnen sein.
XStat V1.10 ist Freeware. Es darf auf nicht-kommerziellem Weg weitergegeben
werden, solange die folgenden Bedingungen erfⁿllt sind:
* Quelltext, ausfⁿhrbares Programm und Dokumentation mⁿssen zusammen
weitergegeben werden (XStat.mod, XStat, XStat.data, XStat.doc,
XStat.dok und Make).
Die Dateien mⁿssen unverΣndert weitergegeben werden!
* PD-Serien: Die Disketten, die XStat enthalten, dⁿrfen in Deutschland
nicht mehr als 8 DM kosten.
Ansonsten darf der Preis, den Fred Fish fⁿr eine einzelne seiner
AmigaLibDisks verlangt, nicht ⁿberschritten werden.
XStat lΣuft nur mit AmigaOS V37 oder h÷her (das ist 2.04 oder h÷her).
Zusammenfassung
===============
XStat wertet das Xferstat-File aus, das Andrew "Charly" Kopp's
UUCiCo V1.15c (oder h÷her) erzeugt. Die wichtigste Information,
die XStat liefert, sind die Telefonkosten fⁿr einen bestimmten
Zeitraum.
Installation
============
Kopieren Sie das Programm "XStat" an eine Stelle, die im
Suchpfad enthalten ist, vorzugsweise nach UUBIN:
Au▀erdem mu▀ nur noch eine weitere Datei installiert werden;
sie hei▀t "XStat.data", und sollte am besten nach UULIB:
kopiert werden.
XStat.data mu▀ Ihren Gegebenheiten entsprechend angepa▀t werden,
um die Installation zu vervollstΣndigen.
XStat.data
==========
XStat.data enthΣlt die Informationen ⁿber die Verbindungskosten zu jedem
Host, mit dem Sie eine Verbindung unterhalten, im folgenden Format:
XStat.data Datei-Header:
------------------------
H XSTAT DATA
Dieser Header mu▀ am Anfang der ersten Zeile von XStat.data stehen.
XStat.data Kommentarzeile:
--------------------------
# beliebige Kommentare
Kommentarzeilen dⁿrfen ⁿberall in der XStat.data Datei eingefⁿgt
werden, au▀er natⁿrlich vor dem Datei-Header!
XStat.data WΣhrungs-Kennzeichen:
--------------------------------
S <WΣhrungskennzeichen>
Gibt das WΣhrungskennzeichen fⁿr Ihr Land an. Dieser Eintrag mu▀ vor der
ersten "N"-Zeile stehen. Es darf h÷chstens eine "S"-Zeile in der
XStat.data Datei geben.
Beispiele:
# WΣhrungskennzeichen fⁿr die U.S.A.
S $
# WΣhrungskennzeichen fⁿr Deutschland:
S DM
XStat.data Host-Namen-Info:
---------------------------
N <Hostname> <Hostname> ...
Die "N"-Zeile kennzeichnet den Beginn eines neuen Verbindungs-Datensatzes.
Mindestens eine "C"-Zeile mu▀ folgen! <Hostname> sollte der Name
einer UUCP-Site sein, mit der Sie direkt verbunden sind, ohne
irgendwelche Pfad- oder Domain-Informationen.
Beispiele:
# Mein eigener Newsfeed:
N imart
# Ein anderer Newsfeed:
N cbmger
Seit XStat V1.10 dⁿrfen auch mehrere Namen in einer N-Zeile angegeben werden.
Alle diese Hosts erhalten dieselbe Kosteninformation zugeordnet.
Beispiel:
# Mehrere Hosts in derselben Entfernungszone
N cbmger brewak forge
XStat.data Verbindungskosten-Info:
----------------------------------
C <Anfangszeit> <Dauer einer Einheit> <Preis einer Einheit>
Teilt XStat mit, da▀ zwischen <Anfangszeit> und <Anfangszeit der
nΣchsten C-Zeile> eine Verbindung mit dem zugeh÷rigen Host
<Preis einer Einheit> pro <Dauer einer Einheit> kostet.
Die <Dauer einer Einheit> mu▀ in Sekunden angegeben werden, der
<Preis einer Einheit> in der WΣhrung, die Sie benutzen.
Die erste "C"-Zeile mu▀ als Anfangszeit "SU-00:00:00" haben!
(Ausnahme siehe weiter unten bei LOCAL/IGNORE).
Beispiel:
N imart
C SU-00:00:00 120 0.23
C MO-08:00:00 60 0.23
C MO-18:00:00 120 0.23
Von Sonntag, 0:00:00 bis Montag, 7:59:59 kostet eine Verbindung
zwischen meinem Computer und dem von "imart" 23Pfg/120sec.
Von Montag, 8:00:00 bis Montag, 17:59:59 kostet eine Verbindung
zwischen meinem Computer und dem von "imart" 23Pfg/60sec.
Bei diesem kurzen Beispiel wⁿrde eine Verbindung im Rest der Woche
(von Montag 18:00:00 bis Samstag, 23:59:59) 23Pfg/120sec kosten.
Seit Version 1.09 kann man auch folgende neue C-Zeilen benutzen:
"C LOCAL" fⁿr Verbindungen, die keine Kosten verursachen (z.B. bei
Verbindung ⁿber Null-Modem), und "C IGNORE" fⁿr Verbindungen, die
ⁿberhaupt nicht berⁿcksichtigt werden sollen. LOCAL und IGNORE
mⁿssen jeweils die einzigen C-Zeilen fⁿr einen Host sein (keine
anderen Kosteninformationen sind erlaubt), und sie schlie▀en sich
au▀erdem gegenseitig aus.
Beispiel:
N imart
C LOCAL
Verbindung mit imart ist "LOCAL" und kostet nichts; nur die
in/out-Bytes tauchen in der Statistik auf.
Beispiel:
N imart
C IGNORE
Verbindung mit imart taucht ⁿberhaupt nicht in der Statistik auf.
Beispiel fⁿr eine komplette XStat.data Datei:
---------------------------------------------
- schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
H XSTAT DATA
#==============================================================================
# XStat connection cost data file
#==============================================================================
#
#------------------------------------------------------------------------------
# currency sign for Germany; S must come before first N
#------------------------------------------------------------------------------
S DM
#
#------------------------------------------------------------------------------
# my own newsfeed, connection cost is 0.23/60sec (0.23/120sec night & weekend)
#------------------------------------------------------------------------------
N imart
C SU-00:00:00 120 0.23
C MO-08:00:00 60 0.23
C MO-18:00:00 120 0.23
C TU-08:00:00 60 0.23
C TU-18:00:00 120 0.23
C WE-08:00:00 60 0.23
C WE-18:00:00 120 0.23
C TH-08:00:00 60 0.23
C TH-18:00:00 120 0.23
C FR-08:00:00 60 0.23
C FR-18:00:00 120 0.23
#
#------------------------------------------------------------------------------
# cbmger, brewak, forge:
# connection cost is 0.23/21sec (0.23/42sec night & weekend)
#------------------------------------------------------------------------------
N cbmger brewak forge
C SU-00:00:00 42 0.23
C MO-08:00:00 21 0.23
C MO-18:00:00 42 0.23
C TU-08:00:00 21 0.23
C TU-18:00:00 42 0.23
C WE-08:00:00 21 0.23
C WE-18:00:00 42 0.23
C TH-08:00:00 21 0.23
C TH-18:00:00 42 0.23
C FR-08:00:00 21 0.23
C FR-18:00:00 42 0.23
#
#------------------------------------------------------------------------------
# demo1, this is a local (e.g. null-modem) connection
#------------------------------------------------------------------------------
N demo1
C LOCAL
#
#------------------------------------------------------------------------------
# demo2, connects will be ignored
#------------------------------------------------------------------------------
N demo2
C IGNORE
#
- schnipp - schnapp - schnipp - schnapp - schnipp - schnapp - schnipp - schnapp
Aufruf
======
XStat [?] [DATA name] [FILE name] [V | VERBOSE] [FD | FROMDATE date]
[TD | TODATE date] [NI | NOINCOM] [NO | NOOUTGO]
[H | HOSTNAME name] [M | MONTH shortdate] [SE | STDERR]
Sie k÷nnen auch die Environment-Variable "XSTATARGS" benutzen, um
Parameter an das Programm zu ⁿbergeben. Das ist besonders nⁿtzlich,
wenn Sie XStat von der Workbench aus benutzen (XStat unterstⁿtzt
die Workbench eigentlich nicht, daher hat es auch kein Icon).
?
-
Zeigt eine Hilfsmeldung an.
DATA name
---------
Gibt den Namen fⁿr die Verbindungskosten-Datei an. Die Voreinstellung
fⁿr <name> ist "UULIB:XStat.data".
FILE name
---------
Gibt den Namen fⁿr das Logfile an, das ausgewertet werden soll.
Die Voreinstellung fⁿr <name> ist "UUSPOOL:XferStat".
V | VERBOSE
-----------
Steuert den "verbose"-Modus. Wenn der "verbose"-Modus eingeschaltet
ist, zeigt XStat zusΣtzlich eine kurze Statistik fⁿr jeden Connect an.
Die Voreinstellung ist "aus". Geben Sie VERBOSE an, um den "verbose"-
Modus einzuschalten.
FD | FROMDATE date
------------------
Fⁿhrt dazu, da▀ Connects, die vor dem angegebenen Datum stattgefunden
haben, ignoriert werden. Voreinstellung fⁿr <date> ist "01-JAN-78".
Gⁿltig sind alle normalen AmigaDOS Datumsangaben, insbesondere auch
Angaben wie "TODAY" oder "YESTERDAY". XStat fⁿgt intern eine Zeitangabe
von "00:00:00" hinzu, die nicht manuell mit angegeben werden darf!
Falls Sie die neue Workbench 2.1 benutzen, die im Moment nur
eingetragenen Entwicklern zugΣnglich ist (sein sollte), und falls sie
eine andere Sprache als Englisch eingestellt haben sollten, mⁿssen Sie
die Datumsangaben in dieser Sprache machen; fⁿr Deutsch also z.B. "HEUTE"
anstatt "TODAY".
TD | TODATE date
----------------
Fⁿhrt dazu, da▀ Connects, die nach dem angegebenen Datum stattgefunden
haben, ignoriert werden. Voreinstellung fⁿr <date> sind das gerade gⁿltige
Datum und die gerade gⁿltige Uhrzeit. ZulΣssig sind alle normalen AmigaDOS
Datumsangaben, insbesondere auch Angaben wie "TODAY" oder "YESTERDAY". XStat
fⁿgt intern eine Zeitangabe von "23:59:59" hinzu, die nicht manuell mit
angegeben werden darf! In Sachen 2.1/locale gilt das gleiche wie fⁿr FD.
M | MONTH shortdate
-------------------
Fⁿhrt dazu, da▀ XStat die Parameter FD und TD ignoriert und statt
dessen eine Statistik fⁿr den angegebenen Monat erzeugt. Der Monat mu▀ im
Format "MMM-JJ" angegeben werden, also ohne Tageszahl.
Beispiel: "MONTH JUN-92" erzeugt eine Statistik fⁿr den Juni 1992.
NI | NOINCOM
------------
Unterdrⁿckt die Auswertung der eingehenden Anrufe; Voreinstellung ist
"nicht unterdrⁿcken". Geben Sie NI an, um die Verarbeitung eingehender
Anrufe zu verhindern. Die Bedeutung dieses Schalters war vor 1.04 umgekehrt.
NO | NOOUTGO
------------
Unterdrⁿckt die Auswertung der ausgehenden Anrufe; Voreinstellung ist
"nicht unterdrⁿcken". Geben Sie NO an, um die Verarbeitung ausgehender
Anrufe zu verhindern. Die Bedeutung dieses Schalters war vor 1.04 umgekehrt.
Q | QUIET
---------
Steuert den "quiet"-Modus. Unterdrⁿckt die Ausgabe von weniger schweren
Fehlermeldungen; Voreinstellung ist "nicht unterdrⁿcken". Geben Sie
QUIET an, um die Ausgabe weniger schwerer Fehlermeldungen zu verhindern.
Der "quiet"-Modus ist besonders nⁿtzlich, um die "(ignoring this one)"-
Meldungen fⁿr fehlgeschlagene Verbindungsversuche zu unterdrⁿcken.
H | HOSTNAME name
-----------------
Veranla▀t XStat, nur Anrufe fⁿr den Host <name> auszuwerten;
Voreinstellung ist Auswertung aller Anrufe. Ab V1.06 darf fⁿr <name> auch
ein beliebiges AmigaDos-Suchmuster angegeben werden. Falls ein solches
Muster angegeben wird, erstellt XStat au▀erdem fⁿr jeden Host, auf den
das Muster pa▀t, eine eigene Statistik.
Bei den Suchmustern wird nicht zwischen Gro▀- und Kleinschreibung
unterschieden.
Beispiel: XStat hostname (a|x)#?
wertet nur Anrufe aus, bei denen der Host-Name mit "a" oder
"x" beginnt. Erstellt eigene Statistiken fⁿr alle diese
Hosts.
SE | STDERR
-----------
Veranla▀t XStat, alle Fehlermeldungen nach StdErr zu schicken, statt
nach StdOut. Dann kann man nΣmlich die Statistiken mittels ">File"
in eine Datei umleiten, ohne da▀ die Fehlermeldungen auch dorthin
wandern; Voreinstellung ist "alles nach StdOut". Geben Sie STDERR an,
um die Fehlermeldungen nach StdErr zu schicken. StdErr ist stets das
Console-Fenster, von dem aus XStat gestartet wurde.
Hinweis: Diese Option wurde nur mit der Commodore-eigenen AmigaShell
getestet. Es mⁿ▀te aber auch mit anderen Shells funktionieren.
XStat's Ausgaben
================
Beispiel:
> XStat 1.10
> ⌐ Copyright 1992 by Jⁿrgen Weinelt
>
> Connection statistics for outgoing calls to host "cbmger":
>
> connects 14 (0 of them were local)
> online time 366 sec ( 27 sec/connect)
> units 16 units ( 1.143 units/connect)
> cost 3.68 DM ( 0.263 DM/connect)
>
> brutto read 81977 bytes ( 5856 bytes/connect)
> brutto send 30380 bytes ( 2170 bytes/connect)
> netto read 47451 bytes ( 3390 bytes/connect)
> netto send 19489 bytes ( 1393 bytes/connect)
>
> av. brutto speed 306 cps ( 697 cps peak)
> av. netto speed 182 cps ( 550 cps peak)
> av. brutto cost 34.344 DM/MB
> av. netto cost 57.645 DM/MB
>
>
> Connection statistics for outgoing calls to host "imart":
>
> connects 61 (0 of them were local)
> online time 12800 sec ( 210 sec/connect)
> units 143 units ( 2.344 units/connect)
> cost 32.89 DM ( 0.539 DM/connect)
>
> brutto read 11068422 bytes ( 181450 bytes/connect)
> brutto send 1260468 bytes ( 20664 bytes/connect)
> netto read 10120721 bytes ( 165914 bytes/connect)
> netto send 175650 bytes ( 2880 bytes/connect)
>
> av. brutto speed 963 cps ( 1218 cps peak)
> av. netto speed 804 cps ( 969 cps peak)
> av. brutto cost 2.797 DM/MB
> av. netto cost 3.349 DM/MB
>
>
> Connection statistics for incoming calls:
> -----------------------------------------
>
> no connects recorded.
>
>
> Connection statistics for outgoing calls:
> -----------------------------------------
>
> connects 75 (0 of them were local)
> ignored connects 0
> online time 13166 sec ( 176 sec/connect)
> units 159 units ( 2.120 units/connect)
> cost 36.57 DM ( 0.488 DM/connect)
>
> brutto read 11150399 bytes ( 148672 bytes/connect)
> brutto send 1290848 bytes ( 17212 bytes/connect)
> netto read 10168172 bytes ( 135576 bytes/connect)
> netto send 195139 bytes ( 2602 bytes/connect)
>
> av. brutto speed 944 cps ( 1218 cps peak)
> av. netto speed 787 cps ( 969 cps peak)
> av. brutto cost 3.082 DM/MB
> av. netto cost 3.700 DM/MB
connects
--------
Anzahl der ausgewerteten Verbindungen, und Anzahl der Verbindungen,
die LOCAL (also kostenlos) waren (-> XStat.data "C LOCAL").
ignored connects
----------------
Anzahl der Verbindungen, die ignoriert wurden (-> XStat.data "C IGNORE").
online time
-----------
Dauer der Online-Zeit insgesamt, und Durchschnitt pro Anruf.
units
-----
Verbrauchte Einheiten insgesamt, und Durchschnitt pro Anruf.
cost
----
Gesamtkosten, und Durchschnitt pro Anruf.
brutto read
-----------
Empfangene Bytes gesamt (einschl. Protokolldaten), und Durchschnitt pro Anruf.
brutto send
-----------
Gesendete Bytes gesamt (einschl. Protokolldaten), und Durchschnitt pro Anruf.
netto read
----------
Empfangene Bytes gesamt (ohne Protokolldaten), und Durchschnitt pro Anruf.
netto send
----------
Gesendete Bytes gesamt (ohne Protokolldaten), und Durchschnitt pro Anruf.
av. brutto speed
----------------
Durchschnittliche ▄bertragungsgeschwindigkeit, einschl. Protokolldaten, sowie
Geschwindigkeit des schnellsten connects.
av. netto speed
---------------
Durchschnittliche ▄bertragungsgeschwindigkeit, ohne Protokolldaten, sowie
Geschwindigkeit des schnellsten connects.
av. brutto cost
---------------
Durchschnittliche Kosten pro MByte, einschlie▀lich Protokolldaten.
av. netto cost
--------------
Durchschnittliche Kosten pro MByte, ohne Protokolldaten.
History
=======
V1.10 XStat.data N-Zeilen-Syntax erweitert: mehrere Namen pro Zeile erlaubt.
Kleiner Fehler im NI/NO-Feature behoben.
V1.09 XStat.data-Syntax um LOCAL und IGNORE erweitert.
V1.08 Option "STDERR" hinzugefⁿgt. "°" durch "av." ersetzt.
V1.07 Die Liste der Statistics-Records wurde nicht korrekt sortiert.
Behoben.
V1.06 Die "HOSTNAME" Option versteht jetzt auch Suchmuster. Die "pro Host"
Statistiken wurden in die "HOSTNAME" Option integriert.
V1.05 Statistiken "pro Host" hinzugefⁿgt.
V1.04 Einen Fehler behoben (Problem mit 2.1 locale) und Argumenten-
Parsing auf dos.library "ReadArgs()" umgestellt
V1.03 Monatliche Statistiken hinzugefⁿgt.
V1.02 Angabe der Spitzengeschwindigkeit (Geschw. des schnellsten
connects) hinzugefⁿgt.
V1.01 XStat produzierte einen Guru, wenn brutto oder netto nur 0 Bytes
ⁿbertragen wurden. Behoben.
V1.00 Erst-Ver÷ffentlichung :-)
V0.9x diverse Betas
Bekannte Probleme/Bugs
======================
Bis jetzt keine...
Naja, ein Problem gibt's, aber das kann ich leider nicht ohne weiteres
Σndern. Die "online time" ist nicht besonders genau. Das kommt daher,
da▀ die Anfangszeit der Verbindung anscheinend ab dem Zeitpunkt gerechnet
wird, zu dem das Modem "CONNECT" sagt, und das ist nicht der wirkliche
Start-Zeitpunkt der (Telefon-)Verbindung.
Sie k÷nnen mich durch das Usenet erreichen:
swb.de!imart!hcast!jow
oder
uunet.uu.net!cbmvax!cbmehq!cbmger!imart!hcast!jow
(Leider immernoch keine Domain)
Oder mit der Bundespest (Rⁿckporto bitte!):
Jⁿrgen Weinelt
Zur Kanzel 1
D-8783 Hammelburg
Sie k÷nnen auch nach comp.sys.amiga.programmer oder alt.sys.amiga.uucp posten,
ich werde diese Gruppen bis auf weiteres lesen.
Viel Spass!
Danksagung
==========
Die folgenden Leute haben mir mit diversen Anregungen und Bug-Reports
sehr geholfen:
Christian Balzer
Kai Bolay
Michael-Wolfgang Hohmann
Andrew Kopp
Henning Schmiedehausen
Vielen Dank euch allen.