DASLOG.HTM
__________

Copyright (c) 1997-2020 DF7BE Wilfried Brunken
Creative Commons License CC BY-SA 2.0 de

"@(#) DASLOG.TXT Stand : 21.11.2001"

ID-String:
"@(#)$Id: daslog.htm 20 2020-05-03 21:03:53Z df7be $"


Beschreibung der Importprogramme zu

DAS LOG von DK8AT
_________________

Stand                         : 21.11.2001

Vendor                        : Reiner Adler , DK8AT  (Soft Art)
gültig für Versionen          : 1.08d , 1.08l ,
                                1.4 (Demo-Version aus dem Internet)
Lizenz des Originalprogrammes : 1.0 - 1.08 Freeware für Amateurfunk.
                                alle anderen Versionen personenbezogene
                                Einzellizenz.
Datenbanktyp                  : DBF
Zielsystem                    : DOS
Referenz                      : http://wg104a.wh.uni-stuttgart.de/
                                       markus/daslog.html
                                CQ-DL 12/1992, Seite 755,
                                Artikel von Ferdi Schmidt, DK5BI
                                über die Version 1.09

Autor des Importprogrammes    : DF7BE
Lizenz des Importprogrammes   : GNU Public Licence
Dateiname des Archives        : DASLOG.ZIP
Zielsystem des Importes       : DOS
Import von                    : LOGBUCH.DBF ,
                                MEMO.DBF, MEMO.DBT (ab 1.4)

Hinweise                      : Die Importe wurde nur mit den o.g.
                                Datenbeständen getestet. Unter Umständen
                                sind Importe weiterer Versionen möglich.
                                LOGBUCH.DBF ist in LOGAT.DBF umzubenennen
                                (Namensgleichheit mit CLLOG)

Inhalt:
_______

1.    Nutzung und Weitergabe
1.1    Ausdrücklicher Haftungsausschluß
2.    Datenstrukturanalyse
3.    Installation und Durchführung des Importes
4.    Dateiliste
5.    Zusatzbeschreibung



1. Nutzung und Weitergabe
_________________________

Copyright :

Copyright (c) 1995-2001 DF 7 BE  Wilfried Brunken

Copyright (c) 1985-1993, Computer Associates International, Inc.


Alle zum Programmkomplex "CLLOG" gehörenden Programme, Module und
Komponenten sind freie Software und unterliegen der
"GNU General Public License".
Jeder kann diese unter den Bedingungen der GNU General Public License,
wie von der Free Software Foundation herausgegeben,
weitergeben und/oder modifizieren, entweder unter der Version 2
der Lizenz oder jeder späteren Version.

Die Veröffentlichung dieser Programme erfolgt in der Hoffnung, daß es
allem von Nutzen sein wird, aber OHNE JEDE GEWÄHRLEISTUNG - sogar ohne
die implizite Gewährleistung der MARKTREIFE oder EIGNUNG FÜR EINEN
BESTIMMTEN ZWECK.

Details finden Sie in der GNU General Public License. Eine Kopie der
GNU General Public License erhalten Sie im Internet unter
www.gnu.de , www.gnu.org oder schriftlich bei der Free Software
Foundation Inc., 675 Mass Ave, Cambridge, MA 021139, USA.


Eine nicht offizelle Übersetzung der GNU General Public License finden
Sie im Internet unter http://www.gnu.de (den Abschnitt GPL auswählen).
Die verbindliche Originalversion in Englisch heißt hier "GPL.TXT" und
sollte diesem Programm beiliegen.

Die in den ausgelieferten EXE-Dateien befindlichen Runtime-Routinen
unterliegen dem Copyright von Computer Associates International, Inc.
(2. Zeile).
In den Lizenzbedingungen von wird von Computer Associates
"Ihr Softwareprodukt" als solches bezeichnet, welches mit CA-Clipper
erzeugt wurde (hier alle EXE-Dateien von CLLOG).

Daher gelten folgende Grundsätze für die Weitergabe und Nutzung
der CLLOG-EXE-Dateien
- Geben Sie alle EXE-Dateien nur zusammen mit allen anderen Dateien
  von CLLOG weiter (Das ist "Ihr Softwareprodukt")
- Entfernen Sie als Entwickler nicht die Copyright-Meldung von
  Computer Associates aus den Hauptprogrammen.
- Geben Sie neu erzeugte EXE-Dateien nur dann weiter,
  wenn Sie lizensierter Besitzer von CA-Clipper sind.
- Die EXE-Dateien dürfen niemals dekompiliert , verändert oder
  rückentwickelt werden.


1.1 Ausdrücklicher Haftungsausschluß
____________________________________

OHNE JEGLICHE GEWÄHRLEISTUNG
(siehe auch GNU General Public License )

Die Software wird so ausgeliefert WIE SIE IST und wurde mit größtmöglicher
Sorgfalt erstellt und getestet. Trotzdem kann eine einwandfreie Funktion
auf allen möglichen Rechnerkonfigurationen nicht gewährleistet werden.
Die Autoren des Programmes schließen jede Haftung für mittelbare oder
unmittelbare Schäden aus, die durch  Nutzung der Programme entstehen.
Das volle Risiko bezüglich Qualität und Leistungsfähigkeit liegt bei
Ihnen. Sollten sich die Programme als fehlerhaft herausstellen,
liegen die Kosten für den notwendigen Service, Reparatur oder Korrektheit
bei Ihnen.
In keinem Falle ist irgendein Copyright-Inhaber oder irgendein
Dritter, der die Software wie in der Lizenz erlaubt modifiziert oder
verbreitet hat, Ihnen gegenüber für irgendwelche Schäden haftbar,
einschließlich jeglicher allgemeiner oder spezieller Schäden,
Schäden durch Seiteneffekte (Nebenwirkungen) oder Folgeschäden,
die aus der Benutzung der Software oder Unbenutzbarkeit der Software
folgen (einschließlich - aber nicht beschränkt auf - Datenverluste,
fehlerhafte Verarbeitung von Daten, Verluste, die von Ihnen oder
anderen getragen werden müssen, oder dem Unvermögens der
Software, mit irgendwelchen anderen Programmen zusammenzuarbeiten),
selbst wenn ein Copyright-Inhaber oder Dritter über die Möglichkeit
solcher Schäden unterrichtet worden war.

Weiterhin kann nicht garantiert werden, daß die verwendeten Programme
je nach nationaler Rechtslage frei von Schutzrechten anderer sind.


Die Dateien enthalten möglicherweise urheber- , patent- und
markenrechtlich geschützte Firmen- und Markennamen sowie Produktbezeichnungen
verschiedener Soft- und Hardwarehersteller.


Achtung !
Beachten Sie bitte die Lizenzbedingungen des Programmes, aus dem Sie
Daten importieren. Für Verstöße gegen diese Bedingungen haftet weder der
Programmautor des Importprogrammes noch die Personen und Institutionen,
die das Importprogramm zur Verfügung stellen, sondern immer der Anwender des
beschriebenen Logbuchprogrammes.


2. Datenstrukturanalyse
________________________

Am Ende dieses Dokumentes finden Sie die Ausgabe der Strukturanalyse.
Falls Sie nicht sicher sind, ob das vorliegende Importprogramm zu Ihrer
verwendeten Version von DAS LOG paßt, laden Sie das CLLOG-Entwicklerpaket
von der Homepage von Z02 herunter.
Hier finden Sie auch ein Tool zur Analyse von DBF-Dateien.
Damit können Sie die Datenbestände von DAS LOG überprüfen.
Das Importprogramm kann unter Umständen unterschiedliche Feldlängen anpassen,
fehlende Datenfelder und unterschiedliche Typen aber nicht.
Teilen Sie uns mit, wenn Sie auch mit einer anderen Version
Erfolg hatten, ansonsten benötigen wir Unterstützung von Ihnen,
um das Importprogramm zu erweitern.


3. Installation und Durchführung des Importes
_____________________________________________

1.) Es wird davon ausgegangen, daß DAS LOG in einem eigenen
    Verzeichnis installiert wurde (z.B. C:\LOG).

   Machen Sie den Datenbestand unter DAS LOG konsistent:
    - Die noch nicht erfassten QSO's eingeben.
    - QSL-Schulden begleichen.
    - QSL-Eingabe einarbeiten.
    - Conteste und Runden abschließen, damit der Datenbestand in der
      Hauptdatei eingearbeitet wird.
    Sichten die Sie den gesamten Datenbestand noch einmal kurz.
    Notieren Sie einen "Stichtag" in Ihrem Papierlog oder
    woanders.
    Danach dürfen im alten Datenbestand keine Änderungen mehr
    vorgenommen werden.

2.) Verschieben Sie das Verzeichnis von DK8AT unter einem
    anderen Namen. ( am besten mit dem Dateimanager oder Explorer )
    z.B. C:\LOG nach C:\LOGALT
    Unter MS-DOS müssen Sie das Verzeichnis kopieren und dann löschen


3.) Installation von CLLOG:
    Sie haben CLLOG noch nicht installiert ? (sonst weiter mit 4.)
    Erzeugen das Verzeichnis von CLLOG neu (z.B. MD LOG )
    und installieren Sie das Programm CLLOG dort, ohne es
    aufzurufen.
    Löschen Sie ggfs. den Demobestand von CLLOG, wenn sie neu beginnen
    wollen. Lesen Sie dazu die Installationsanleitung in CLLOG.TXT
    genau durch.

    Falls Sie CLLOG bereits installiert haben und Sie schon Daten
    eingegeben haben:
    - machen Sie eine Datensicherung ( Sie können auch den gesamten Inhalt
      des CLLOG-Arbeitsverzeichnisses in ein eigenes Verzeichnis auf Ihrer
      Festplatte kopieren)
    - Notieren Sie sich die Anzahl der bisher eingegebenen Datensätze.
      Starten Sie dazu CLLOG. Diese werden im Hauptmenü oben rechts
      angezeigt.
    - machen Sie weiter mit 4.)

4.) Packen Sie den Inhalt von DASLOG.ZIP in ein eigenes Verzeichnis
    z.B. C:\DASLOG aus.
    Kopieren Sie die den Import zuständige EXE in das
    Arbeitsverzeichnis von CLLOG:
    DLOG108.EXE für Versionen 1.08.
    DLOG1_4.EXE für Version 1.4
    DOKKORR.EXE für alle Versionen


5.) Achtung ! ab jetzt darf weder DASLOG noch CLLOG gestartet sein !
    Kopieren Sie die folgenden Dateien aus "DAS LOG" nach CLLOG:
      zum Beispiel :
       COPY C:\LOGALT\LOGBUCH.DBF C:\LOG\LOGAT.DBF  (alle Versionen)
     und für Version 1.4 von DAS LOG zusätzlich
       COPY C:\LOGALT\MEMO.DBF C:\LOG
       COPY C:\LOGALT\MEMO.DBT C:\LOG


6.) Wenn Sie ihre alten LBL-Dateien verwenden wollen,
    kopieren Sie diese in das neue Verzeichnis
      COPY C:\LOGALT\*.LBL C:\LOG
    Vor deren Verwendung müssen Sie
    das Layout an die 4-Stellige Jahreszahl anpassen.
    Sie können dazu LBLEDIT.EXE oder LABEL.EXE von DK8AT verwenden.

7.) Gehen Sie in das Arbeitsverzeichnis von CLLOG (z.B. CD \LOG )
    und starten Sie das Importprogramm
        DLOG108.EXE oder DLOG1_4.EXE


8.) Wenn das Programm ohne sichtbare Fehlermeldung durchgegangen ist,
    sehen Sie in Datei IMPORT.LOG nach, welche Fehlermeldungen
    geschrieben wurden. Eventuelle Datenverluste durch Kürzen von
    Feldinhalten werden gemeldet.

    Bevor Sie die Datei mit einem Texteditor betrachten:
    Prüfen Sie die Dateigröße.
    Der MS-DOS Editor "EDIT" macht ab 64KByte Dateigröße Probleme.
    Falls Sie Probleme haben geben Sie einfach ein
    TYPE IMPORT.LOG | MORE
    Die Datei wird seitenweise dargestellt.
    In der Regel bleibt die Datei aber klein.


9.) Starten Sie nun das Programm DOKKORR.EXE, um die Schreibweise
    der DOKs anzupassen.


10.) Starten Sie CLLOG. Zuerst werden die Indexdateien neu erzeugt.
     Sichten Sie die importierten Daten (Bildschirmlisten).
     Nach einer Neuinstallation von CLLOG gehen Sie unter
     "I ... Installation" alle Punkte durch.

11.) Nacharbeiten:
    Drucken Sie dazu am besten IMPORT.LOG aus.
    Wurden Meldungen in IMPORT.LOG ausgegeben, so wird Ihnen die
    Datensatznummer aus der Quelldatei angegeben. Addieren Sie
    zu dieser Nummer die Anzahl der bereits vorhandenen Sätze aus CLLOG.
    Im Dialog "Bildschirmlisten / Datensatznummer" können Sie die
    Zielsätze ansteuern und korrigieren (z.B. sinnvolle Kürzung)
    Beachten Sie aber, daß die Plausibiltätprüfungen in diesem Dialog
    ausgeschaltet sind.
    Und so wird geändert:
    Gehen Sie mit dem Cursor auf das zu ändernde Feld und betätigen
    . Damit wird das Feld zur Änderung eingestellt.
    Wenn Sie nicht alle Datenfelder sehen:
    Mit den Cursortasten können Sie nach "rechts" rollen, dann
    sehen Sie weitere Datenfelder.

12.) Wenn Sie zufrieden sind , löschen Sie im Arbeitsverzeichnis
    von CLLOG die Dateien:
     DEL LOGAT.DBF
     DEL MEMO.DBF
     DEL MEMO.DBT
     DEL DLOG1_4.EXE  (oder DLOG108.EXE)
     DEL IMPORT.LOG

    Deinstallieren Sie DAS LOG und entfernen Sie auch das Verzeichnis,
    in dem Sie das Importprogramm ausgepackt haben.

13.) Machen Sie vorsichtshalber eine Datensicherung von CLLOG mit
    dem importierten Datenbestand, bevor Sie weiterarbeiten.


14.) Jetzt können Sie arbeiten. Zuvor sollten aber die LBL-Dateien
    getestet werden, ob das Layout in Ordnung ist.


4. Dateiliste
_____________

Beschreibung:
DASLOG.TXT      (diese Datei)

Quellcodes:
DLOG1_4.PRG
DLOG108.PRG
IMPLIB.PRG
LOGDBVER.PRG
DOKKORR.PRG

Ausführbare Programme
DLOG1_4.EXE      Importprogramm für Version 1.4
DLOG108.EXE      Importprogramm für Versionen 1.08
DOKKORR.EXE      DOK-Korrekturprogramm


5. Zusatzbeschreibung
_____________________

Beschreibt die Regeln für den Import und das Ergebnis der
Datenstrukturanalyse.
Es ist bei einigen Datenfeldern mit Verlusten zu rechnen (Kürzung).

Das Zusatzprogramm DOKKORR muss nach dem Import laufen,
 um die Schreibweise der DOK's anzupassen:
 z.B. von Z-02 nach Z02

 Verarbeitungsregel:
 Wenn der erste Buchstabe im Rufzeichen D oder Y (ex DDR) ist,
 dann
 2.Zeichen im DOK ist ein Bindestrich -
  diesen dann entfernen

 Die Länge des DOK-Feldes ist irrelevant

 Die Bezeichnung der Datenfelder stimmt mit denen von CLLOG überein.

  Datenstruktur von LOGBUCH.DBF ==> LOGAT.DBF :

 Version 1.08l
 _____________


 Headergröße 642
 Satzlänge 130

 NAME        TYPE LEN DEC

 CALL        C     11
 ZUSATZ      C      7
 NAME        C     15
 ORT         C     15
 LOC         C      6
 DOK         C      5
 DATUM       D      8
 FREQUENZ    N      8   3
 BETR_ART    C      4
 BEMERKUNG   C     27
 RST         C      6
 ERST        C      6
 MIN         C      2
 H           C      2
 EH          C      2
 EMIN        C      2
 MK          C      1
 SEND        C      1
 REC         C      1


 Version 1.08d
 _____________
 Headergröße 642
 Satzlänge 130

 NAME        TYPE LEN DEC

 CALL        C     11
 ZUSATZ      C      7
 NAME        C     15
 ORT         C     15
 LOC         C      6
 DOK         C      5
 DATUM       D      8
 FREQUENZ    N      8   3
 BETR_ART    C      4
 BEMERKUNG   C     33
 RST         C      3
 ERST        C      3
 MIN         C      2
 H           C      2
 EH          C      2
 EMIN        C      2
 MK          C      1
 SEND        C      1
 REC         C      1


 Nicht abgespeichert : Zusatz  , Power , free

 gelöschte Sätze werden samt der Löschmarkierung
 übernommen.

 Bisher konnten zwischen den einzelnen Versionen nur
 Läengenunterschiede entdeckt werden.

 Zusatzprogramm DOKKORR muss nach dem Import laufen,
 um die Schreibweise der DOK's anzupassen:
 z.B. von Z-02 nach Z02



Version 1.4 :
_____________


  LOGBUCH.DBF ist als LOGAT.DBF zu kopieren


  Datenstruktur von LOGBUCH.DBF ==> LOGAT.DBF :



 Headergröße 706
 Satzlänge 171

 NAME        TYPE LEN DEC

 CALL        C     11
 ZUSATZ      C      7
 NAME        C     15
 ORT         C     15
 LOC         C      6
 DOK         C      6
 DATUM       D      8
 FREQUENZ    N      8   3
 MK          C      1
 BETR_ART    C      4
 BEMERKUNG   C     40
 RST         C      6
 ERST        C      6
 H           C      2
 MIN         C      2
 EH          C      2
 EMIN        C      2
 SEND        C      1
 REC         C      1
 IOTA        C      7        IOTA= in BEMERKUNG
 FREE        C      20       gekuerzt


 Struktur von MEMO.DBF  (mit MEMO.DBT)

 Headergröße 98
 Satzlänge 22

 NAME        TYPE LEN DEC

 MEMOCALL    C     11           ==> CALLSIGN
 NOTIZ       M     10

 Übernahme in CALLMEMO.DBF

 gelöschte Sätze werden samt der Löschmarkierung
 übernommen.

 Zusatzprogramm DOKKORR muss nach dem Import laufen,
 um die Schreibweise der DOK's anzupassen:
 z.B. von Z-02 nach Z02