Programmdatei die der C64 lesen und erstellen kann.
Eine Programmdatei dient wie der Name bereits sagt zum Speichern von BASIC- und Maschinenspracheprogrammen. Sie kann jedoch auch für beliebige andere Daten verwendet werden, sofern diese einen zusammenhängenden Speicherbereich belegen, zum Beispiel Sprite-Daten, Sounddaten, Zeichensätze oder Bitmaps.
Auf Dateisystemebene unterscheiden sich Programmdateien lediglich durch die Dateikennung
PRG von
SEQ- und
USR-Dateien.
Aufbereitet von mir nach der
C64-Wiki Programmdateihttps://www.c64-wiki.de/wiki/ProgrammdateiAufbau Dateiformat PRG
Aufbau auf der Diskette / DatasetteSchauen wir uns mal ein Beispeil an:10 PRINT "HALLO LEUTE"
20 PRINT "DAS IST EIN TEST"
30 PRINT "DAS IST MEIN PROGRAMM"
| Byte-Stelle | Beschreibung |
|---|
| 00 | Spurnummer des nächsten Datenblocks(00 wenn noch kein neuer Datenblock vorhanden ist) |
| 4f | Das ist der Zeiger auf das Ende der Datei. auf den Datenträger(wenn noch kein neuer Datenblock vorhanden ist). Sonst Sektornummer des nächsten Datenblocks. |
| 01 08 | Das ist die Ladeaddresse, wo das Programm im C64 abgelegt werden soll bei LOAD $0801 (Standard Basicstartaddresse) |
| 15 08 | Das ist der Zeige auf die Nächste Basic-Zeile in unseren fall auf 2e ($0815) |
| Byte-Stelle | Beschreibung |
|---|
| 0a 00 | Das ist unsere 10 die Nummerierte Basic-Zeile.($000a) |
| 99 | Das ist das Token für PRINT |
| 20 22 48 41 4c 4c 4f 20 4c 45 55 54 45 22 | Das ist jetzt alles was nach PRINT kommt: 20= 22="48=H41=A4c=L4c=L4f=O20= 4c=L45=E55=U54=T45=E22=" |
| 00 | Abschluss der Basic-Zeile. |
| Jetzt kommt die Neue Basic-Zeile | |
| 2e 08 | Das ist wieder der Zeiger auf die nächste Basic-Zeile 4b ($082e) |
| Byte-Stelle | TEXT |
|---|
| 14 00 | Das ist unsere 20 die Nummerierte Basic-Zeile.($0014) |
| 99 | Das ist wieder das Token für PRINT |
20 22 44 41 53 20 49 53 54
20 45 49 4e 20 54 45 53 54 22 | Ihr könnt euch bestimmt schon vorstellen, was das jetzt darstellen soll. 😊 |
| 00 | Abschluss der Basic-Zeile. |
Die letzte Zeile könnt ihr gerne selbst noch einmal durchgehen.
Am Programmende stehen nun noch zwei Bytes 00 00. Dabei handelt es sich erneut um Sprungadressen. Da diese jedoch auf 0 gesetzt sind, ist das Programm an dieser Stelle beendet.
Aufbau Dateiformat SEQ (Sequentielle Datei)
Eine sequentielle Datei ist eine Datei, auf deren Inhalt nur der Reihe nach zugegriffen werden kann. Das bedeutet, um einen bestimmten Bereich der Datei zu lesen, müssen alle vorhergehenden Daten eingelesen werden. Ebenso ist es nicht möglich, beliebige Teile der Datei zu überschreiben, sondern nur die Datei vollständig neu zu schreiben. Allerdings können zusätzliche Daten an das Ende der Datei angehängt werden, wobei zum Auffinden des Dateiende ebenfalls alle vorherigen Daten gelesen werden müssen.
Datasette-Dateien sind technisch bedingt immer sequentiell aufgebaut. Diskettendateien hingegen sind blockweise organisiert, sodass grundsätzlich ein wahlfreier Zugriff möglich ist. Dieser erfordert jedoch zusätzlichen Verwaltungsaufwand, den man sich bei SEQ-Dateien sparen kann.
Bis auf die Bezeichnung des Typs im Verzeichnis gelten sämtliche Eigenschaften einer sequenziellen Datei wie bei USR- und PRG-Dateien.
Vorteile:
👍 Effiziente Speicherausnutzung auf Diskette (geringer Anteil organisatorischer Daten).
👍 Geringerer Verwaltungsaufwand im DOS, daher können mehr Dateien gleichzeitig geöffnet sein (abhängig vom jeweiligen Laufwerk).
👍 Einfache Verwendung unter BASIC.
👍 Gut für binäre Daten einsetzbar, da kein Zeichen eine besondere Bedeutung hat und das Dateiende eindeutig gekennzeichnet ist.Als Basisoperation ist das Zusammenfügen (Merge- oder Combine-Funktion des DOS) mehrerer Dateien zu einer einzigen unterstützt.
Nachteile:
👎Es müssen immer alle Daten bis zur gesuchten Position eingelesen (und auch übertragen) werden.
👎Es ist nicht möglich einzelne Bereiche innerhalb der Datei zu ändern.
👎Ein Anhängen von Daten ist zwar möglich, dazu muss aber das DOS zuerst alle vorhergehenden Datenblöcke lesen (wobei die Daten dazu nicht übertragen werden müssen, was dann auch schneller als etwa bei einem Ladevorgang vonstatten geht).
Verwendung
Verwendet werden SEQ-Dateien zum Speichern beliebiger Daten, vorzugsweise solche, die sich selten ändern.(z.B. Sprite-Musterdaten, Sounddaten, Zeichensätze oder Bitmaps).
| Zugriffsart | Dateiparameter für OPEN-Befehl | Bemerkung |
|---|
| Lesen (Read) | "DATEINAME,R" | Ohne Suffix wird die Datei automatisch zum Lesen geöffnet. Ist die Datei nicht vorhanden, gibt die Floppy auf dem Fehlerkanal "62, FILE NOT FOUND,00,00" aus. |
| Erstellen/Schreiben (Write) | "DATEINAME,W" | Datei erstellen und zum Schreiben öffnen. Ist die Datei schon vorhanden, gibt die Floppy auf dem Fehlerkanal "63, FILE EXISTS,00,00" aus. |
| Daten anhängen (Append) | "DATEINAME,A" | Datei öffnen und auf das Dateiende positionieren. Ist die Datei nicht vorhanden, gibt die Floppy auf dem Fehlerkanal "62, FILE NOT FOUND,00,00" aus. |
| Überschreiben (Replace) | "@:DATEINAME,W" "@0:DATEINAME,W" | Datei zum Überschreiben öffnen. Aufgrund des REPLACEhttps://www.c64-wiki.de/wiki/REPLACE-Bugs nicht zu empfehlen, stattdessen lieber die Datei löschen und neu erstellen.Ohne fehlerhafte Nebenwirkung kann auch die Syntax mit Drive-Angabe (z.B. Drive 0 im Beispiel) verwendet werden. |
| Dateiwiederherstellung (Modify) | "DATEINAME,M" | Dient zum Wiederherstellen von Daten aus einer nicht korrekt abgeschlossenen Datei. |
Erstellen wir mal eine SEQ-DateiBesonderheiten!!Bezugnehmend und verifiziert auf CBM-DOS 2.6, typischerweise auf einem 1541er-Laufwerk.
LeerdateiDas Anlegen einer Leerdatei mit
OPEN 1,8,2,"0-DATEI,W":CLOSE 1
gibt beim Auslesen z.B. mit folgendem Programm1000 OPEN 1,8,3, "0-DATEI"
1010 FOR C=0 TO 1E6
1020 GET#1,A$
1030 PRINT C":"ASC(A$+CHR$(.)),
1040 GET A$:IF ST OR A$<>"" THEN C=C+1E6
1050 NEXT
1060 PRINT: PRINT "ST="ST,C-1E6 "BYTES"
1070 CLOSE 1
1100 OPEN 15,8,15
1110 INPUT#15,E$,F$,T$,S$
1120 PRINT E$","F$","T$","S$
1130 CLOSE 15
Daraus folgt, dass sich immer das Muster bestehend aus 4 Zeichen: <13> <0> <2> <13> ergibt.
Eine Datei zum auslesen mit der Länge 0 lässt sich auf diese Art nicht erzeugen.
Dateien der Länge 1
Wie auch bei einer Leerdatei ergibt sich beim Versuch eine Datei mit Länge 1 zu erstellen ein ähnliches Bild:
10 OPEN 1,8,2,"1-DATEI,W"
20 PRINT#1, "A";
30 CLOSE 1
Dateien erst ab einer Anzahl von 2 Zeichen, zeigt sich beim Auslesen der Datei tatsächlich die geschriebenen Daten.10 OPEN 1,8,2,"2-DATEI,W"
20 PRINT#1, "AB";
30 CLOSE 1
Erstellen wir ein Programm, das eine
SQR-Datei erzeugt und ausgibt. Anschließend betrachten wir das Speicherbild noch einmal genauer.
100 PRINT CHR$(147)
Erstellen und beschreiben einer SEQ-Datei
110 OPEN 2,8,2,"TESTDATEI,S,W"
120 PRINT#2,"1 DIES IST EINE SEQ-DATEI"
130 PRINT#2,"2 DIE AUS DREI ZEILEN BESTEHT."
140 PRINT#2,"3 ENDE."
150 CLOSE 2
Auslesen einer SEQ-Datei
160 OPEN 2,8,2,"TESTDATEI,S,R"
170 FOR C=0 TO 1
180 INPUT#2,A$: PRINT A$
190 C=ABS(ST)
200 NEXT
210 CLOSE 2:END
und jetzt noch das Speicherbild auf der Diskette:
| Byte-Stelle | Beschreibung |
|---|
| 00 | Spurnummer des nächsten Datenblocks(00 wenn noch kein neuer Datenblock vorhanden ist) |
| 41 | Das ist der Zeiger auf das Ende der Datei auf dem Datenträger, wenn noch kein neuer Datenblock vorhanden ist. Ansonsten ist es die Sektornummer des nächsten Datenblocks. |
31 20 44 41 53 20 49 53 54 20 45 49
4e 45 20 53 45 51 2d 44 41 54 45 49 2c | 31=120= 44=D41=A53=S20= 49=I53=S54=T20= 45=E49=I4e=N45=E20= 53=S45=E51=Q2d=-44=D41=A54=T45=E49=I2c=, |
| 0d | Das ist das Trennzeichen (EOI-Markierung) der einzelne Einträge. RETURN-Zeichen |
| ... | und so weiter 😁 |
Oben ist der erste Block und unten folgt der nächste. Schaut euch die ersten beiden Bytes an:
( $11 = 17 = Spur oder auch Track genannt )
( $0a = 10 = Sector )
Lasst uns noch einen neuen Eintrag anhängen mit:
10 OPEN 2,8,2,"NEUDATEI,S,A"
20 PRINT#2,"4 NOCH EIN NEUER EINTRAG."
30 CLOSE 2
Dateiformat REL
Eine Relativdatei (Abkürzung im Directory: REL) ermöglicht im Gegensatz zu sequentiellen Dateien den wahlfreien Zugriff. Das bedeutet, man kann direkt auf beliebige Daten zugreifen, ohne die Datei vom Anfang an einlesen zu müssen, und zudem den Inhalt an beliebigen Stellen ändern.
Relative Dateien sind in Datensätzen wählbarer Länge organisiert, den sogenannten Records. Die für den Zugriff benötigten zusätzlichen Verwaltungsinformationen werden in den Side Sectors gespeichert und bei neueren DOS-Versionen auch in den Super Side Sectors.
Diese Struktur ähnelt weitgehend der Organisation heutiger Dateisysteme, wenn man den Aufbau in Datensätzen betrachtet.1).
Vorteile:
👍Schnelles Positionieren auf eine beliebige Position innerhalb der Datei.
👍Tabellenartige Organisation, somit gut für Datenbanken geeignet (Index ist dabei die Datensatznummer)..
👍Einfaches und dynamisches Reservieren von Diskettenplatz..
👍Gemischte Schreib- und Lesevorgänge.
Nachteile:
👎 Die benötigten Verwaltungsinformationen belegen zusätzliche Blöcke auf der Diskette (je einen auf 120 Datenblöcke).
👎 Es sind weniger Datenkanäle pro Laufwerk verfügbar, da eine relative Datei den Pufferspeicher von 3 sequentiellen Dateien belegt.
👎Nur bedingt für binäre Daten geeignet, da eine Folge von Null-Bytes bis zum Ende eines Datensatzes das vorzeitige Ende dieses Datensatzes markiert.
👎 Sie kann nicht mehr gekürzt werden (nur durch Umkopieren auf eine neue Datei und Löschen der alten, was aber entsprechenden Platz auf der Diskette erfordert).
👎 Die Behandlung im Vergleich zu den "Standarddateien" im sequenziellen Format ist völlig anders und zeigt kein vereinfachtes Verhalten, z.B. das kompatibel zu sequenziellen Dateien wäre.
Eigenschaften:
👉 Logische Datensatzgröße: 1 bis 254 Bytes.
👉 Maximale Anzahl Datensätze pro Datei: 65535.
👉 Theoretische Anzahl Nutzdatenblöcke pro Datei: 720 im Falle von CBM DOS 2.6 wie bei einem 1541-Laufwerk, 90.720 ab CBM-DOS 2.7 mit erweitertem Format.
👉 Maximale Nutzdatengröße: 167.132 Bytes auf 1541-Diskette, 182.880 Bytes auf einer doppelseitigen 1571-Diskette, theoretisch bis zu 23.042.880 Bytes beim erweiterten Format.
Erstellen wir mal eine REL-DateiErstellt wird eine REL-Datei mit dem OPEN-Befehl, wobei als Dateiattribut
L übergeben wird und anschließend, durch ein
Komma getrennt,
die Datensatzlänge als ASCII-CodeASCII-Tabelle
www.c64-wiki.de/images/2/20/ASCII-Codes.gif
:
OPEN 1,8,2,"RELDATEI,L,"+CHR$(10)
Erstellt, falls noch nicht vorhanden, auf Laufwerk 8 eine Relativdatei mit Namen
RELDATEI und einer Datensatzlänge von 10 Bytes. Ist eine Datei mit diesem Namen, aber falschem Dateityp vorhanden, wird die Floppy-Fehlermeldung "
64, FILE TYPE MISMATCH,00,00" erzeugt. Ist die
REL-Datei zwar vorhanden, aber mit einer anderen Datensatzlänge angelegt worden, gibt der Fehlerkanal
"
50, RECORD NOT PRESENT,00,00" zurück. Zum Öffnen einer bereits vorhandenen
REL-Datei muss die Datensatzlänge nicht übergeben werden, es reicht in einem solchen Fall schon ein:
OPEN 1,8,2,"RELDATEI" Wird die Datei unmittelbar nach der Erstellung geschlossen, zeigt das Inhaltsverzeichnis einen Verbrauch von 0 Block, allerdings werden bereits 2 Blöcke auf dem Datenträger belegt, nämlich ein Side-Sector- und ein Datenblock, auch wenn dieser nur leere Datensätze (1. Byte Wert 255, Rest 0) enthält, so viele, wie in einen Datenblock passen.


Unmittelbar nach dem Öffnen der Datei zeigt der Datensatzzeiger auf den 1. Datensatz (am Dateianfang). Mittels PRINT# kann nun der jeweilige Datensatz beschrieben werden, wobei das Ende der mit dem PRINT#-Befehl gesendete Daten gleichzeitig die EOI-Markierung bildet, also das Ende des Datensatzes kennzeichnet. Überschreitet die Anzahl der zum Schreiben übertragenen Zeichen die Datensatzlänge, so gibt die Floppy die Fehlermeldung "51, OVERFLOW IN RECORD,00,00" aus. Der Datensatz wird trotzdem geschrieben, allerdings auf die passende Anzahl von Zeichen abgeschnitten. Werden weniger Zeichen übertragen, als in den Datensatz passen, wird der restliche Teil mit Null-Bytes aufgefüllt.
Das Einlesen der Daten kann sowohl mit INPUT# als auch mit GET# erfolgen, wobei GET# aufgrund folgender Gründe vorzuziehen ist:
INPUT# kann nur Datensätze mit der maximalen Länge des BASIC-Eingabepuffers (bei Rechner mit Basic V2 oder Basic 3.5 sind es 88 Zeichen) einlesen, ansonsten wird das Programm mit der Fehlermeldung ?STRING TO LONG ERROR abgebrochen.
Felder innerhalb eines Datensatzes lassen sich mittels INPUT# nur durch die üblichen Trennzeichen wie das RETURN-Zeichen(CHR$(100) bzw. $0d), Komma etc. realisieren. Bei einer freien Aufteilung des Datensatzes in Felder muss nicht jeder Datensatz zwingend mit einem RETURN-Zeichen enden.
Mit GET# ist das Einlesen flexibler, wobei das Ende eines Datensatzes durchaus vor der Datensatzlänge erreicht werden kann.
Unter bestimmten Umständen kann der INPUT#-Befehl wegen eines fehlenden RETURN-Zeichens hängen bleiben, sodass das Programm nur noch mittels RUN/STOP -RESTORE verlassen werden kann.
Das Kriterium für das Ende eines Datensatzes, wenn dieser beispielsweise mittels GET# eingelesen wird, ist das gesetzte Bit 6 der Systemvariable STATUS (Wert 64, entspricht dem EOF-Bit), welches bei REL-Dateien nicht das Dateiende, sondern das Ende des Datensatzes anzeigt (EOI-Markierung).
Einzelne Datensätze werden mit dem Record-Positionierbefehl "P" ausgewählt, in dem an den Befehlskanal des Laufwerks folgender String gesendet wird:
| Befehl | Beschreibung |
|---|
| "P"+CHR$(<Kanalnummer>) | Ist die im OPEN-Befehl übergebene Sekundäradresse, wobei in den Commodore-Handbüchern empfohlen wird, den Wert 96 (hex. $60) zu addieren.(statt CHR$(2) geht auch CHR$(98) ) |
| +CHR$(<Datensatznummer_Low>) | Ist die (05) Datensatznummer beginnend mit 1. |
| +CHR$(<Datensatznummer_High>) | Ist die (05) Datensatznummer |
| +CHR$(<Byteposition>) | Ist die Position innerhalb des Datensatzes, ebenfalls beginnend mit 1. Die Angabe ist optional, allerdings muss darauf geachtet werden, dass dann der PRINT#-Befehlt mit ";" endet, da sonst das RETURN-Zeichen mit seinem Codewert 13 als Byteposition interpretiert wird. |
OPEN 1,8,2,"RELATVDATEI"
OPEN 15,8,15
PRINT#15,"P"+CHR$(2)+CHR$(1)+CHR$(0)+CHR$(1)
PRINT#1,"EINTRAG 01";
CLOSE 1
CLOSE 15
Schauen wir uns mal den Datenblock an
| Byte-Stelle | Beschreibung |
|---|
| 00 | Spurnummer des nächsten Datenblocks (00 wenn noch kein neuer Datenblock vorhanden ist) |
| fb | Sektornummer des nächsten Datenblocks (Wenn noch kein neuer Datenblock vorhanden ist, dann die letzte Stelle des vollständigen Datensatzes) |
| 45 49 4e 54 52 41 47 20 30 31 | EINTRAG 01 in unseren Beispiel eine länge von 10 Zeichen. |
| ff 00 00 00 00 00 00 00 00 00 | Reservierte Bytes für jeden Eintrag (Leere Datensätze werden durch den Wert 255 ($FF) gefolgt von Null-Bytes gekennzeichnet) |
Jetzt schauen wir uns noch den Indexblock (Side-Sector-Block) an
| Byte-Stelle | Beschreibung |
|---|
| 00 | Spurnummer des nächsten Datenblocks (00 wenn noch kein neuer Datenblock vorhanden ist) |
| 17 | Sektornummer des nächsten Datenblocks (Wenn noch kein neuer Datenblock vorhanden ist, dann die letzte Stelle des vollständigen Datensatzes) |
| Byte-Stelle | Beschreibung |
|---|
| 00 | Index des Side Sectors (0 - 5) |
| 0a | Datensatzlänge (in unseren Beispiel 10) |
| 11 0a | Track/Sektor des Side Sectors 0: Spur(Track) 17 / Sektor 10 |
| 00 00,00 00,00 00,00 00 | Track/Sektor des Side Sectors 1-5 |
| Byte-Stelle | Beschreibung |
|---|
| 16 - 255 | Track/Sektor-Zeiger auf insgesamt 120 Datenblöcke |
| 11 00 | (1) In meinen Beispiel hat er den ersten Block an Track 17 und Sector 00 |
| 11 0b | (2) weiter geht es mit Track 17 und Sector 11 |
| 11 01 | (3)danach weiter nach Track 17 und Sector 1 |
| 11 0c | (4)das ist bis jetzt der letzte Block bei Track 17 und Sector 12 |
Dateiformat USR
User-Datei
Eine User-Datei kann beliebige Daten enthalten und wird typischerweise für Grafikdaten, Sounddaten, Spielstände und ähnliche Informationen verwendet. Sie verhindert, dass solche Daten versehentlich als Programm per LOAD geladen werden, was unter Umständen zu Irritationen oder sogar zur Beschädigung des Speichers führen könnte, zum Beispiel wenn beim Laden mit den Parametern ,8,1 die ersten beiden Bytes auf kritische Speicherbereiche verweisen.
Auf Dateisystemebene ist eine User-Datei bis auf die Dateikennung USR strukturell identisch mit einer Programmdatei (PRG) oder einer sequenziellen Datei (SEQ).
Aufbau
Eine User-Datei hat keinen vorgegebenen Aufbau und besteht daher nur aus einem durchgehenden Datenstrom. Anders als bei PRG-Dateien werden die ersten beiden Bytes hier nicht als Startadresse im Speicher genutzt, es sei denn, die User-Datei wird gezielt mit LOAD/SAVE behandelt.
Verwendung
Prinzipiell kann eine USR-Datei wie eine sequenzielle Datei mit OPEN zum Lesen oder Schreiben geöffnet werden. Es ist außerdem möglich, eine USR-Datei mit SAVE zu sichern, indem dem Dateinamen ein Komma und anschließend die passende Dateikennung U für USR angehängt wird. Analog funktioniert das Laden solcher Dateien mit LOAD.
Bei LOAD und SAVE wirkt jedoch die Konvention von PRG-Dateien nach, bei der die ersten beiden Bytes der Datei als Startadresse im Speicher verwendet werden.