*******************************************************************************
E-BATCH v2.0 - Der Programm-Starter                        1995-96 Robert Wei
*******************************************************************************

Mit E-BATCH knnen Applikationen zu bestimmten (wiederkehrenden) Zeiten mit und
ohne Kommandozeile gestartet werden.


Inhalt:
=======
1  Lieferumfang
2  Shareware-Gebhren
3  Haftung
4  Registrierung
5  Installation
6  Arbeiten mit E-BATCH
6.1  Eine Applikation editieren
6.2  Eine neue Applikation hinzufgen
6.3  Das Applikations-Fenster
6.3.1  Programm-Name
6.3.2  "Versteht VA_START"
6.3.3  "Aufrufe protokollieren"
6.3.4  "Kommandozeile"
6.3.5  "Start-Datum/Uhrzeit"
6.3.6  "Wiederholung"
6.4  Die Protokoll-Datei
6.5  Einstellungen sichern
7  MagiC, MultiTOS, etc.
8  Der AVSERVER
9  Einschrnkungen und bekannte Fehler
10 Kontakt
11 Bankverbindung


1 Lieferumfang:
===============

EBATCH.ACC           Das ACC/Programm (Demoversion)
EBATCH.TXT           Diese Anleitung
REGISTER.PRG         Programm zur Registrierung

Die Einschrnkung der Demo gegenber der registrierten Vollversion ist, da nur
eine Applikation eingetragen werden kann. Diese kann maximal 3 mal mit
beliebigen Parametern gestartet werden. Die Demo gibt bei jedem Programmstart
einen Pling aus.


2 Shareware-Gebhren:
=====================

E-BATCH ist Shareware, das heit, da E-BATCH unter der Vorraussetzung, da
alle zu E-BATCH gehrenden Dateien unverndert kopiert werden, fr private
Anwender frei kopiert und benutzt werden darf.

Aufgrund der schlechten Zahlungsmoral von Shareware in Deutschland hat die
ffentliche Version von E-BATCH nicht den vollen Funktionsumfang. Viele User
benutzen vollwertige Shareware, ohne zu bezahlen, daher sah ich mich gentigt,
diese User zur Zahlung zu ermuntern.

Wer E-BATCH (auch die Demoversion) lnger als 2 Wochen benutzt, mu sich
registrieren lassen und E-BATCH bezahlen. Ausgenommen hiervon sind alle
registrierten E-BACKUP-User.

Fr ... erhalten Sie von mir ...

DM 40,-    eine Diskette mit der aktuellen Demoversion, sowie Seriennummer und
           Schlssel zur Registrierung und Umwandlung der Demo- in eine
           Vollversion. (registrierte E-BACKUP-Benutzer: DM 20,-)

DM 30,-    Seriennummer und Schlssel zur Registrierung und Umwandlung der
           Demo- in eine Vollversion. (registrierte E-BACKUP-Benutzer: DM 10,-)

DM 10,-    eine Diskette mit der aktuellen Demoversion
  oder
Disk und
frankierter
Rckumschlag

Wenn Sie ein Modem besitzen, knnen Sie die aktuelle Demoversion immer in der
Maus Regensburg (Tel. 0941-448518) finden.

Aufgrund der hheren Versandkosten auerhalb Deutschlands addieren Sie zu
obigen Betrgen DM 5,-.

Bitte beachten Sie, da dieser Betrag auch bei mir ankommen mu!

Da ich meine Kontoauszge monatlich durchsehe, kann es bei berweisung zu
lngeren Wartezeiten kommen. Einen Scheck kann ich sofort beantworten!

Jeden Betrag, der geringer ist, als die genannten Registrierungsgebhren,
betrachte ich als Spende.

Die registrierte Version darf nicht frei weitergegeben werden!

Ein kommerzieller Vertrieb ist in jeder Form nur mit meiner schriftlichen
Erlaubnis statthaft. Dies schliet den Vertrieb ber Public-Domain-Disketten
ein.


3 Haftung:
==========

Ich, Robert Wei, kann keine Haftung fr direkte oder indirekte Schden
finanzieller, materieller, oder sonstiger Art bernehmen, die durch den
Gebrauch von E-BATCH entstehen.

E-BATCH wurde mit grter Sorgfalt programmiert und getestet, dennoch kann ich
keine Garantie fr die Fehlerfreiheit von E-BATCH bernehmen.

Fehlerbeschreibungen, Anregungen und Wnsche zur Weiterentwicklung von E-BATCH
werden gerne entgegengenommen.


4 Registrierung:
================

Starten das im Paket enthaltene Programm namens REGISTER.PRG.

Es sollte nun eine Dateiauswahlbox erscheinen, in der nach dem Accessory
EBATCH.ACC gefragt wird. Whlen Sie dieses aus besttigen Sie mit OK.

Daraufhin erscheint eine Dialogbox.

Geben Sie bei "Seriennummer:" Ihre achtstellige Seriennummer und bei
"Schlssel:" ihren ganz persnlichen Schlssel ein. Danach werden Sie nach
Ihrem Namen und Ihrem Wohnort gefragt. Diese knnen jeweils bis zu 32 Zeichen
lang sein. Wenn Sie alle Eingaben richtig gemacht haben, klicken Sie bitte auf
"Registrieren".

Nun wird Ihre Seriennummer und der Schlssel berprft und bei Erfolg wird eine
Vollversion mit Ihrer persnlicher Anschrift erzeugt.


5 Installation:
===============

Kopieren Sie einfach EBATCH.ACC in das oberste Verzeichnis Ihres Bootlaufwerks
oder in den Orner, in dem sich Ihre ACCs befinden, und beim nchsten Reset wird
Ihnen E-BATCH als Accessory zur Verfgung stehen.


6 Arbeiten mit E-BATCH:
=======================

Wenn Sie E-BATCH aktivieren, erscheint der Statusdialog. Hier werden in
zeitlich aufsteigender Reihenfolge (von oben nach unten) bis zu 16 zu startende
Applikationen mit Zeit des nchsten Starts, Name und Kommandozeile aufgefhrt.


6.1 Eine Applikation editieren
==============================

Durch Klicken auf eine Applikationszeile ffnet sich das Applikations-Fenster,
wo alle Einstellungen fr diese eingetragen sind und nun verndert werden
knnen.


6.2 Eine neue Applikation hinzufgen:
=====================================

Durch Bettigung von "Neu" im Hauptdialog ffnet sich das leere
Applikations-Fenster, welches Sie nun mit den Daten der neuen Applikation
ausfllen knnen.


6.3 Das Applikations-Fenster:
=============================

6.3.1 Programm-Name
-------------------

In die erste Zeile gehrt der Name mit Pfadangabe der zu startenden Applikation
selbst. Dies erreichen Sie durch einen Mausklick auf diese Zeile, und
anschlieender Auswahl des Programms in der Dateiauswahlbox.


6.3.2 "Versteht VA_START"
-------------------------

Unter Multitasking-Betriebssystemen (MultiTOS, MagiC, Geneva, ...) ist es
mglich, da die zu startende Applikation bereits gestartet wurde und immer
noch aktiv ist, bzw. als Accessory installiert (z.B. KOBOLD) ist. Wozu dann
nocheinmal starten? E-BATCH sucht dann nach dieser Applikation und sendet ihr
bei Erfolg eine "VA_START"-Nachricht. Ob das zu startende Programm VA_START
versteht, oder nicht, entnehmen Sie bitte der jeweiligen Anleitung, bzw.
probieren es einfach einmal aus.

Vorsicht bei E-BACKUP: Ist gerade ein Batch am laufen, wird "VA_START" mit
einem "BESETZT" beantwortet. Falls sich also verschiedene Backup-Batches
zeitlich berschneiden knnten und genug freier Speicher zur Verfgung steht,
sollten Sie E-BACKUP ohne "VA_START" aufrufen.


6.3.3 "Aufrufe protokollieren"
------------------------------

Hier kann eingestellt werden, ob die Starts dieser Applikation in der
Protokoll-Datei notiert werden sollen, oder nicht. Diese Option deshalb, weil
E-BATCH Programme auch z.B. jede hundertstel Sekunde starten kann. Wrde dies
Protokolliert, htten Sie innerhalb krzester Zeit eine Protokoll-Datei mit
einer Gre von mehreren MBytes.


6.3.4 "Kommandozeile"
---------------------

Die Kommandozeile wird an das zu startende Programm bergeben. Dabei knnen
beliebige Zeichen/Buchstaben/Dateinamen/... in die Kommandozeile eingetragen
werden. Um einfach ganze Dateinamen+Pfade einfgen zu knnen, gengt ein
Doppelklick auf eine der Zeilen, worauf die Dateiauswahlbox erscheint. Der
ausgewhlte Dateiname wird an der aktuellen Cursorposition eingefgt. Durch
drcken von [INSERT] erscheint ein Dialog mit allen Sonderzeichen.


6.3.5 "Start-Datum/Uhrzeit"
---------------------------

Der erste Termin wird hier mit Datum und Uhrzeit eingetragen. Wenn Sie gleich
einen Start haben wollen, darf das Datum auch lter sein, da intern getestet
wird, ob das eingetragene Datum berschritten oder gleich ist! Aber keine
Angst: Der Starttimer wird erst aktiv, wenn Sie den Hauptdialog von E-BATCH
mittels "OK" beendet haben und E-BATCH wieder in der ACC-Menleiste schlummert.


6.3.6 "Wiederholung"
--------------------

Der zeitliche Interval zum Starten der Applikation kann in weiten Grenzen
gewhlt werden:

Von einer "1/100 Sekunde" bis zu 999 "Jahren" kann die Wiederholung relativ zum
Startdatum gewhlt werden. Ist dieser Zeitpunkt erreicht, so wird auf das
Startdatum solange das Wiederholungsinterval addiert, bis ein Zeitpunkt grer
als die aktuelle Systemzeit erreicht ist. Dieser Wert wird als neues Startdatum
eingetragen.

Mit "Einmal" ist es mglich, eine Aplikation zu einem festgelegten Zeitpunkt
ein einziges mal zu starten. Danach wird der Eintrag wieder gelscht.

Um ein Programm nach jedem Rechner-Reset zu starten, knnen Sie "Boot-Up"
einstellen. Die so eingetragenen Programme werden nach dem AUTO-Ordner und nach
den ACCs gestartet. hnlich wie unter MagiC die Programme im Ordner
\GEMSYS\MAGIC\APPS. Es drfen also GEM-Programme eingetragen werden.


6.4 Die Protokoll-Datei:
========================

E-Batch notiert Applikationsaufrufe in einer beliebig whlbaren Text-Datei mit
Applikationsstart, Applikationsende und (falls mglich) mit dem Status (Fehler
oder nicht) beim Beenden. Dadurch sind Sie in er Lage, bereits geschehene
Programmstarts zu kontrollieren.

Je nachdem, wie viele Starts gettigt werden, sollten Sie hin und wieder
nachsehen, wie gro diese Datei bereits geworden ist, und gegebenenfalls diese
Lschen.


6.5 Einstellungen sichern:
==========================

Die aktuelle Einstellung wird in der Datei EBATCH.INF gesichert. brigens
werden die Einstellungen nach jedem gestarteten Programm gesichert, um die
einzelnen Startzeiten in der INF-Datei immer auf dem aktuellen Stand zu halten.


7 MagiC, MultiTOS, etc.:
========================

E-BATCH fhlt sich in allen Multitasking-Umgebungen am wohlsten, da sich dort
fr Accessorys keine Einschrnkungen mehr ergeben und mehrere Programme auch
parallel von E-BATCH gestartet werden knnen. Unter dieser Systemumgebung wird
auch kein AVSERVER mehr bentigt.


8 Der AVSERVER:
===============

Arbeiten Sie noch unter einem alten TOS (Version 1.0 bis 4.0, also ohne
Multitasking-Erweiterung) auf Ihrem Rechner, so bentigt E-BATCH einen
sogenannten AVSERVER zum Starten von Applikationen. Soviel mir bekannt ist,
wird das AV-Protokoll von den meisten Desktop-Shells untersttzt, als da wren:
Gemini, NoDesk, Thing, Neodesk, ...

E-BATCH sucht nun im Speicher nach der Applikation "GEMINI  ". Wird diese nicht
gefunden wird nach "VENUS   " gesucht. Wird dies auch nicht gefunden, so wird
nach der Environment-Variablen "AVSERVER" gesucht, die den Namen der Shell
enthalten sollte (z.B.: "AVSERVER=GEMINI"). Wird diese auch nicht gefunden, so
bricht E-BATCH mit der Fehlermeldung "Kein AVSERVER installiert!" ab.


9 Einschrnkungen und bekannte Fehler:
======================================

Unter Nicht-Multitasking-Systemen (TOS 1.0 bis TOS 4.0) gibt es fr Accessorys
normalerweise keine Mglichkeit, ein Programm zu starten. Das heit, das
E-BATCH hier nicht als ACC betrieben werden kann, wenn nicht eine Shell
(Gemini, Thing, Neodesk, ...) installiert ist, die das AV-Protokoll untersttzt


10 Kontakt:
===========

Robert Wei
Baumhackergasse 2
93047 Regensburg
Germany

MAUS-Net  Robert Weiss @ R
USE-Net   robert_weiss @ r.maus.de


11 Bankverbindung:
==================

Postbank Nrnberg
BLZ 760 100 85
Konto-Nr. 3945 86 850
