 -----------------------------------------------------------------------------

               * * MIDIDUMP.PRG V3.6/97 Bedienungsanleitung * *

 Wie der Name schon verrt, dient dieses Programm zum verwalten von MIDI-
 System-Exclusive-Daten.
 Neu berarbeitet und mit einem neuen Outfit versehen, habe ich die MIDIDUMP-
 Version 3.6 gegenber seinen Vorgngern zustzlich um einige ntzliche Funk-
 tionen erweitert.

 So ist es jetzt z.B. mglich, Requestanweisungen innererhalb des Programmes
 zu erstellen. Auerdem ermglicht die 'RAM-Reservierung' MIDI-Dump's bis zu
 16 MBytes! Das drfte fr alle Flle reichen!
 Ein groes Texteingabefeld erlaubt Begleitkommentare fr jede Dump-Datei.

 -----------------------------------------------------------------------------

 * RAM-RESERVIERUNG  *
 
 Nach dem Programmstart sollten als erstes die Speicherverhltnisse geklrt
 werden. Voreingestellt ist von mir der kleinstmgliche RAM-Wert von 10 KByte.
 Um diesen zu verndern klickt man einmal auf die Box: 'RAM-Reserve' am 
 rechten Bildrand. Darauf ffnet sich eine Dialogbox;

 Unterhalb von 1 MByte ndern sich die Reservierungsschritte in 10 KBytes,-
 oberhalb  von 1 MByte in 100 KBytes-Schritte.
 Es sind max. 16 MBytes reservierbar - es sei denn, Dein Computer hat einen
 kleineren RAM-Speicher.
 150 KByte gehen von oben ab (fr das Programm selbst), der Rest kann reser-
 viert werden.
 Nach dem klicken auf: 'Speichern', wird der eingestellte Wert an das MIDI-
 DUMP-Programm angelinkt (es wird dadurch um einige Bytes lnger - also nicht
 wundern). Ab dem nchsten Programmstart wird der eingestellte Bytewert fr
 das Programm reserviert und in der Box: 'RAM-RESERVE' angezeigt!

 -----------------------------------------------------------------------------

 * RAM-RESERVE / IM SPEICHER / -AZEIGE *

 Gibt jederzeit Auskunft ber den Rest-Speicher des Computers sowie ber die
 Anzahl der im RAM-Speicher befindlichen MIDI-Bytes.
 
 -----------------------------------------------------------------------------

 * LSCHEN *
 
 Lscht alle im Speicher befindlichen MIDI-Daten und stellt die vorgegebene
 maximale RAM-Speichergre wieder zur Verfgung.

 -----------------------------------------------------------------------------

 * DUMP-STATUS *

 Zwei Dump-Arten sind mglich; 'Normal-Dump' und 'Multi-Dump'.
 'Normal-Dump arbeitet wie blich; einzelne Dump's werden ausgefhrt.

 'Multi-Dump' erlaubt eine kaskadierung von Dump-Daten.
 Es knnen soviele Daten hintereinander gepackt werden wie der Speicher
 erlaubt. Dies ist in vielen Fllen sinnvoll wie praktisch, da es z.B. Gerte
 gibt, welche ihre Speicherinhalte nacheinander rausrcken - die aber alle
 zusammengenommen eine Konfiguration bilden. 

 -----------------------------------------------------------------------------

 * REQUEST-MENS *

 'MIDIDUMP.PRG' besitzt drei Pulldown-Mens fr die Requestanweisungen.
 Alles was man im tglichen MIDI-Leben so an Request's braucht, msste hier
 seinen Platz finden. Es sind 42 Eintrge mglich!

 Wie kommen diese Eintrge da hin...?
 Das geht folgendermaen...
 
 Alle Requestanweisungen die in die Pulldown-Mens sollen, mssen in dem
 Ordner: 'REQUEST.REQ' kopiert werden.
 Dieser Ordner mu sich beim Programmstart auf der gleichen Diskettenebene
 befinden wie das Programm selbst (sonst klapt's nicht)!
 Der Ordnername darf nicht verndert werden (sonst klapt's ebenfalls nicht)!
 Auerdem mssen die einzelnen Requestdateien die Endung: '.REQ' aufweisen!
 
 Eine weitere Bedingung fr das automatische einladen der Requestdateien
 ist das korrekte Request-Datenformat...

 Am besten schaut man sich hierzu eine der Requestdateien einmal an;
 in der ersten Zeile steht der Request-Name. Dieser sollte nicht lnger als
 24 Zeichen sein, anderenfalls wird der Name vom Programm gekappt.
 Ganz wichtig ist die maximale Anzahl der Request-Bytes und die Hexadezimale
 schreibweise!
 Eine Request-Anweisung darf max. aus 21 Bytes bestehen (incl. Status & Eox).
 Diese mssen untereinander geschrieben stehen und wie gesagt - in Hexa!
 Dies wird erkenntlich gemacht, indem vor jedem eigentlichen Bytewert das
 '&H' steht.

 Diese ganze Information hat uns eigentlich garnicht zu kmmern (es sei denn,
 Du willst Deine Requestdateien unbedingt mit einem Textverarbeitungsprogramm
 erstellen), was ja nun Dank 'MIDIDUMP.RPG' nicht mehr ntig ist, da es diese
 Aufgabe viel schneller und einfacher erledigt.
 Es knnte jedoch sein, da die eine oder andere Requestdatei (die bei Dir so
 rumliegt) nicht das erforderliche Format aufweist. Fr diesem Fall ist diese
 Information ganz ntzlch!

 Fehlerhafte bzw. nicht dem Format entsprechende Requestdateien werden in der
 Regel vom 'MIDIDUMP.PRG' abgewiesen.

 P.s. Befinden sich im Request-Ordner viele Dateien (so etwa 40),
 dauert der Programmstart einwenig lnger, da nun alle Mens gefllt werden.
 Wer es also immer besonders eilig hat, der sollte nicht mehr Dateien in 
 diesem Ordner ablegen als fr die Praxis bentigt wird. 

 Jetzt wieder zurck zum Programm...
 In diesem Zusammenhang knnen einzelne Requestanweisungen geladen oder ge-
 speichert werden (ber's Pulldown-Men).
 Das erstellen eigener Requestanweisungen erfoglt ber die  l a n g e  Zeile.
 Ich habe hier auf eine Eingabemaske vezichtet, da die Regeln fr die Eingabe
 recht einfach sind...
 Wie gesagt erfolgt die Eingabe in hexadezimaler Schreibweise!
 Jedes Byte besteht aus zwei Ziffern, - fr die 1 z.B. mu also 01 eingegeben
 werden. Die einzelnen Bytes knnen durch Kommas, Symikolons oder Leerzeichen
 voneinander getrennt werden. Alle Eingaben werden vom Programm auf ihre rich-
 tigkeit berprft und ggf. reklamiert wenn versucht wird, fehlerhafte Daten
 zu senden oder zu speichern. Auerdem erfolgt natrlich eine berprfung der
 Requestzeile nach dem verlassen ber Return.

 Damit spter beim 'Auto-load' der Requestdateien auch ein Requestname im 
 Pulldown-Men erscheint, mu oberhalb der Requesteingabezeile noch ein pas-
 sender Name eingegeben werden.
 
 Das senden einer Requestanweisung erfolgt natrlich ber einen Mausklick auf
 den Button: 'REQUEST SENDEN'.
 
 Das war' schon!

 -----------------------------------------------------------------------------

 Alle weiteren Bedienungsschritte erklren sich eigentlich von selbst...
 zumal das 'MIDIDUMP.PRG' ein   g r o  e s  INFO-'Fenster' besitzt, in dem
 alle ntigen Anweisungen angezeigt werden!
 
 Nun viel spa beim dumpen...                         Klaus Reichel

 -----------------------------------------------------------------------------
