@database TimeGuardianE.guide @Master dh0:Install/doc/english/TG_e_38.tex @Width 72 This is the AmigaGuide® file TimeGuardianE.guide, produced by Makeinfo-1.49 from the input file dh0:Install/doc/english/TG_e_38.tex. @index Index @Node Main "TimeGuardianE.guide" @Next "Einleitung" Documentation of TimeGuardian Version 1.2, 11.1.1995 written by Markus Matern, Gerri Körner and Jürgen Matern translated by Gerri Körner and Markus Matern Programpackage TimeGuardian (C)1993-95 G.Körner, M.Matern, J.Matern This is the documentation of the package `TimeGuardian' Version 1.2, 11.1.1995. The descriptions refers to the following programs: * `TGCron' Version 1.50, 5.1.1995 * `TimeGuardian' Version 1.50, 5.1.1995. @{" Introduction " Link "Einleitung"} Introduction to `TimeGuardian' @{" Programs " Link "Die Programme des Pakets TimeGuardian"} The program `TGCron' and `TimeGuardian' @{" Supportprog. " Link "Wo bekomme ich die Zusatzprogramme?"} Where do I get the support programs? @{" Installation " Link "Wie installiere ich TimeGuardian?"} How can I install the package `TimeGuardian'? @{" `MUI' " Link "Was ist MUI?"} Informations about the Gui-System `MUI' from Stefan Stunz @{" Index " Link "Index"} The Index @EndNode @Node "Einleitung" "TimeGuardianE.guide/Einleitung" @Next "Die Programme des Pakets TimeGuardian" @Prev "Main" @Toc "Main" Introduction ************ Welcome to the documentation of the program package `TimeGuardian'. This package may be freely distributed, as long as no unreasonable copying and swapping fees are collected. For any other type of distribution you must obtain the written permission of the author. This package is shareware, if you want to use the programs of this package permanently, you have to register, see @{"how to register" Link "Wie kann ich mich registrieren lassen?"} for further information. This program package may be included in software collections, providing that the previously mentioned conditions are met. This program package is provided without warranty of any kind. In no event will the author be liable for direct, indirect, or incidental damages resulting from any defect of the program or of its documentation. The users are hereby warned that such damage might occur. @{" Description " Link "Was ist TimeGuardian?"} What is `TimeGuardian'? @{" Features " Link "Was bietet TimeGuardian für Fähigkeiten?"} The features of `TimeGuardian' @{" Usage " Link "Was kann ich mit TimeGuardian machen?"} What Can I Do with `TimeGuardian'? @{" Assumptions " Link "Was benoetige ich um TimeGuardian nutzen zu koennen?"} What Do I Need to Be Able to Use `TimeGuardian'? @{" Registration " Link "Wie kann ich mich registrieren lassen?"} How can I register for `TimeGuardian'? @EndNode @Node "Was ist TimeGuardian?" "TimeGuardianE.guide/Was ist TimeGuardian?" @Next "Was bietet TimeGuardian für Fähigkeiten?" @Prev "Einleitung" @Toc "Einleitung" What is `TimeGuardian'? ======================= `TimeGuardian' is a program package which makes it easy for you to automate processes which have to be done over and over again. It reminds you about important events or allows you to start programs or scripts at predefined points of time. You also may write log files to disk, where you can see when your computer was switched on. @EndNode @Node "Was bietet TimeGuardian für Fähigkeiten?" "TimeGuardianE.guide/Was bietet TimeGuardian für Fähigkeiten?" @Next "Was kann ich mit TimeGuardian machen?" @Prev "Was ist TimeGuardian?" @Toc "Einleitung" The Features of `TimeGuardian' ============================== * easily configurable * providing a GUI for event input * reminder functions using requesters and alerts * daily actions * weekly actions * monthly actions * yearly actions * events after time intervals relating to the point of startup * detailed evaluation for the points of startup time * graphical representation for the points of startup time * precise information for special days * Localisation * Commodity * `Installer' * `MUI'-GUI * online help * `AREXX' @EndNode @Node "Was kann ich mit TimeGuardian machen?" "TimeGuardianE.guide/Was kann ich mit TimeGuardian machen?" @Next "Was benoetige ich um TimeGuardian nutzen zu koennen?" @Prev "Was bietet TimeGuardian für Fähigkeiten?" @Toc "Einleitung" What Can I Do with `TimeGuardian'? ================================== The package provides you two main functions which may be used seperately from each other. The first function provided is to save on disk every time your computer was turned on and off. You get a complete log file when anyone turned on your computer. Also you may choose to log different projects. This means that you can see in the log files when you worked on a certain project, e.g. private work and business work. You can analyse these log files easily with the graphical user interface, getting a quick overview while working with your computer on certain projects. The second function that is provided by this package is a function to start actions (commands or scripts) that you want to be executed regularly or at specified dates or hours. Moreover you can start programs or scripts e.g. once a day or once a year .... A special function of this feature is the reminder. It reminds you by a requester or an alert, you simply enter the text and point of time for such events, the rest will be done for you by `TimeGuardian'. @EndNode @Node "Was benoetige ich um TimeGuardian nutzen zu koennen?" "TimeGuardianE.guide/Was benoetige ich um TimeGuardian nutzen zu koennen?" @Next "Wie kann ich mich registrieren lassen?" @Prev "Was kann ich mit TimeGuardian machen?" @Toc "Einleitung" What Do I Need to Be Able to Use `TimeGuardian'? ================================================ If you want to use all features of the package `TimeGuardian', you need some other public domain or shareware packages which can't be included in this package because of different reasons: * OS version >= 2.0 You need a Workbench and Kickstart version greater or equal to 2.0 *by all means*. If you are not running those two versions, you can't install this package. If you want to know which versions you have installed, enter in a `Shell': `version'. You should get the following results: `Kickstart version 37.175, Workbench version 37.XX' or greater numbers! You need a Workbench version >= 2.1 if you want to use the localized graphical user interface! * `MUI' >= 2.0 The program package `MUI' has to be installed to be able to use the graphical user interface of the program `TimeGuardian'. You can use an unregistered version of `MUI' while you are testing the program package. If you want to use `TimeGuardian' regularly, please register for both packages `MUI' and `TimeGuardian'. For further information on how to do this, see @{"registrating" Link "Wie kann ich mich registrieren lassen?"} and @{" `MUI' " Link "Wo bekomme ich MUI?"}. * `Installer' You need this program for an easy installation of the package. It is included with many other program packages. To get information where you can obtain the program `Installer', see @{" `Installer' " Link "Wo bekomme ich den Installer?"}. * `Amiga-Guide' You need this program in order to use a feature of the graphical user interface of `TimeGuardian' called online help. If you want to get information on how to obtain this package, see @{"`Amiga-Guide'" Link "Wo bekomme ich den Amiga-Guide"}. @EndNode @Node "Wie kann ich mich registrieren lassen?" "TimeGuardianE.guide/Wie kann ich mich registrieren lassen?" @Prev "Was benoetige ich um TimeGuardian nutzen zu koennen?" @Toc "Einleitung" How Can I Register for `TimeGuardian'? ====================================== To be able to use the background program `TGCron' on a certain day as long as you want, you will need a certain file, which you will only get by registering. This file contains your name and is especially generated for you. If this file is missing, you will only be able to use the program about 3 hours a day. To obtain your personal key file, please send the registration fee and form (see @{"Registration Form" Link "Registrierungsformular"}) to one of the addresses below. If you send the money, be sure that one can't see the notes inside! Put the notes inside the registration form. Please refer to the following table for the amount of your registration fee: * Inside Germany: - Cash: DM 20 - Bank draft: DM 20 - National Cheque: DM 20 - Eurocheque: DM 20 * Inside Europe: - Cash: DM 20 oder US$ 15 - Eurocheque: DM 20 oder US$ 15 - Cheque: DM 40 oder US$ 27 (cashing is very expensive!) * Outside Europe: - Cash: US$ 15 - Cheque: US$ 27 (cashing is very expensive!) Here are the addresses of the authors: Gerri Körner Kulturenweg 6 D-87642 Buching Markus Matern Max-Wieland-Straße 13 D-89134 Blaustein You will receive your personal key file and the newest version of the program package on disk. If you don't send your fee in a way mentioned above you won't become a registered user! Your payment is for the current version of the program package `TimeGuardian'. You are neither entitled to get newer, nor to get enhanced program versions. You *don't* have to register again for possible new versions of this package. The personal key files will stay valid for new versions. Possible enhancements of the package will depend on the number of registrations. You can't reach us by phone, therefore if you have questions, please send an *international reply coupon* to one of the adresses above. The better way is to send an e-mail to: `Gerri.Koerner@student.uni-ulm.de' or `Markus.Matern@student.uni-ulm.de'. Unfortunately we will not be able to answer any questions asked in other ways. @EndNode @Node "Die Programme des Pakets TimeGuardian" "TimeGuardianE.guide/Die Programme des Pakets TimeGuardian" @Next "Wo bekomme ich die Zusatzprogramme?" @Prev "Einleitung" @Toc "Main" The Programs of the Package `TimeGuardian' ****************************************** The package `TimeGuardian' basically consists of two programs, which are needed both for proper work. They will be described later. You need the preferences program `TimeGuardian' if you want to change the configuration of the "cron" (1) which runs in the background or to analyze the files written to your disk. The second program is `TGCron'. You should start it every time your computer boots, if you want to use the package in a sensible way. `TGCron' uses two small modules for rarely needed functions. These modules won't be described here as they are not for public use. See @{"Installation" Link "Wie installiere ich TimeGuardian?"}, for further information. For further information on programs not included in this package refer to @{"support programs" Link "Wo bekomme ich die Zusatzprogramme?"}. @{" `TimeGuardian' " Link "Das Programm TimeGuardian"} The Preferences Program @{" `TGScheduler' " Link "Das Programm TGScheduler"} The "Schedulerprogram" @{" `TGCron' " Link "Das Programm TGCron"} The "Cron Program" ---------- Footnotes ---------- (1) A cron is a program which executes programs or scripts at certain user-specified points of time @EndNode @Node "Das Programm TimeGuardian" "TimeGuardianE.guide/Das Programm TimeGuardian" @Next "Das Programm TGScheduler" @Prev "Die Programme des Pakets TimeGuardian" @Toc "Die Programme des Pakets TimeGuardian" The Program `TimeGuardian' ========================== First of all I want to say something general about the documentation of `TimeGuardian': A GUI should help to work easier with a program and use its features without detailed knowledge. Many people draw the conclusion that they dont't have to read its documentation. That's definitely wrong. I tried to arrange many parts of this program to be operated without any basic knowledge. Nevertheless I advise you to read this documentation once, after that you may use the online help function. It will display the corresponding text to any object of the GUI from the file `TimeGuardian.guide'. Because of its many features and the very powerful syntax of the "CronTable"(1) , it is impossible to develop a GUI which may be used without any basic knowledge. The preferences program `TimeGuardian' was designed to help the user to modify the configuration of the background program easily. It provides you a graphical user interface to do so. If you want to change the configuration, just start `TimeGuardian'. * From Workbench: Doubleclick on the corresponding icon. If you followed the installation instructions, you will find the icon in your drawer `Prefs' of your bootpartition. * From CLI: Just enter `/TimeGuardian'. Instead of `' you have to enter the name of the drawer in which you have installed the package `TimeGuardian'. * If you entered in the icon of `TGCron' at the installation drawer a `CX_POPKEY' tooltype (not in the WBStartup drawer), you may use this short cut to pop up the GUI of `TimeGuardian' while `TGCron' is running. The following is a description of the different elements of the graphical user interface and their functions. "Gadgets" are elements that start an action immediately. They may be activated by clicking on them with the mouse or by pressing the underlined character of their name. You have to press always a single key on the keyboard, even if a capital letter is underlined. "Pages" are gadgets which activate other gadgets. Depending on the preferences of `MUI', you may see all the page-gadgets together or each at a time by activating the visible page-gadget. For browsing through the pages you may also use the keyboard. The combination `ALT ' or `ALT ' allows you to step one page forward or back. @{" Menus " Link "Die Menues des Programms TimeGuardian"} The menustructure @{" `Timer' " Link "Die Seite Timer"} The page `Timer' @{" `Special' " Link "Die Seite Spezial"} The page `Special' @{" `Global Statistics' " Link "Die Seite Hauptstatistik"} The page `Global Statistics' @{" `Daily Statistics' " Link "Die Seite Tagesstatistik"} The page `Daily Statistics' @{" `Save/Use/Quit' " Link "Die Knoepfe Speichern- Benutzen- Ende"} The gadgets `Save'/ `Use'/ `Quit' @{" Online-help " Link "Die Online-Hilfe"} The online help @{" AREXX " Link "Der AREXX-Port"} The AREXX-Port @{" Error Messages " Link "Was bedeuten die Fehlermeldungen (TimeGuardian)"} The description of the errors ---------- Footnotes ---------- (1) A "CronTable" is an ASCII file which contains command lines for cron program. @EndNode @Node "Die Menues des Programms TimeGuardian" "TimeGuardianE.guide/Die Menues des Programms TimeGuardian" @Next "Die Seite Timer" @Prev "Das Programm TimeGuardian" @Toc "Das Programm TimeGuardian" The Menus of the Program `TimeGuardian' --------------------------------------- Some functions of the program may be activated using gadgets and menus. Moreover the basic preferences for the cron have to be done on two windows which may only be activated using the menu. For a further description see below. The functions that are available via gadget and menu will be described at the corresponding gadgets. The menu structure of the preferences program looks like follows: * Project - Open... - Save as... - ---------------- - About - User - Iconify - ---------------- - Quit * Edit - Reset to Defaults - Last Saved - Restore * Settings - Create Icons? * Pages - Timer - Special - Global Statistics - Daily Statistics * Preferences - Cron Setup - Log Path & Names - ----------------- - LogFiles enabled? @{" `Project=>Open' " Link "Der Menuepunkt Projekt=>Oeffnen"} The menu `Project=>Open' @{" `Project=>Save as' " Link "Der Menuepunkt Projekt=>Speichern als"} The menu `Project=>Save as' @{" `Project=>About' " Link "Der Menuepunkt Projekt=>Ueber"} Der menu `Project=>About' @{" `Project=>User' " Link "Der Menuepunkt Projekt=>Benutzer"} The menu `Project=>User' @{" `Project=>Iconify' " Link "Der Menuepunkt Projekt=>Ikonifizieren"} The menu `Project=>Iconify' @{" `Edit=>Reset to Defaults' " Link "Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen"} The menu `Vorgaben=>Reset to Defaults' @{" `Edit=>Last Saved' " Link "Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes"} The manu `Edit=>Last Saved' @{" `Edit=>Restore' " Link "Der Menuepunkt Vorgaben=>auf vorherigen Stand"} The menu `Vorgaben=>Restore' @{" `Settings=>Create Icons?' " Link "Der Menuepunkt Optionen=>Piktogramme erzeugen"} The menu `Settings=>Create Icons?' @{" `Preferences=>Cron Setup' " Link "Der Menuepunkt Voreinstellungen=>Cron Einstellungen"} The menu `Preferences=>Cron Setup' @{" `Preferences=>Log Path & Names' " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} The menu `Preferences=>Log Path & Names' @{" `Preferences=>LogFiles enabled?' " Link "Der Menuepunkt Voreinstellungen=>LogFiles schreiben?"} The menu `Preferences=>LogFiles enabled?' @EndNode @Node "Der Menuepunkt Projekt=>Oeffnen" "TimeGuardianE.guide/Der Menuepunkt Projekt=>Oeffnen" @Next "Der Menuepunkt Projekt=>Speichern als" @Prev "Die Menues des Programms TimeGuardian" @Toc "Die Menues des Programms TimeGuardian" The Menu `Project=>Open...' ........................... Selecting this menu item opens a file-requester which allows you to load a configuration file. If you don't select a `TimeGuardian'- config-file, an error message will appear. After the file has been loaded succesfully, all items of the graphical user interface will show the new configuration. After that you may modify, save or use the new settings in the usual way. @EndNode @Node "Der Menuepunkt Projekt=>Speichern als" "TimeGuardianE.guide/Der Menuepunkt Projekt=>Speichern als" @Next "Der Menuepunkt Projekt=>Ueber" @Prev "Der Menuepunkt Projekt=>Oeffnen" @Toc "Die Menues des Programms TimeGuardian" The Menu `Project=>Save as...' .............................. By activating this menu, you may save your current settings under any name you choose. The configuration will just be saved, it will not be used by a current running cron. You have to select the gadget `Save' or `Use' if you want to do so. This menu is provided to be able to change quickly between often used configuratons (e.g. one configuration for private work and one for business work). Each configuration has its own name which allows you to associate it with the corresponding project. If the menu `Settings=>Create Icons?' is activated an icon will be generated for each configuration you save. If you want to use one of your saved configurations you have to doubleclick on the corresponding icon. This configuration is only used as long as you don't boot. If you want to use this configuration permanently by doubleclicking the icon, then change the `Tool Types' of the icon to `ACTION=SAVE'. If you saved a configuration without an icon you have to activate this configuration as follows: Either load the configuration in the preferences program and press `Use' or enter the two following lines in a shell or a script: `copy Name.config env:TimeGuardian.config' and `setenv TimeGuardian.com config'. The configuration will stay active until you reboot. (For a permanent change press the `Save' gadget or you `copy Name.config envarc:TimeGuardian.config' and enter the two lines above.) @EndNode @Node "Der Menuepunkt Projekt=>Ueber" "TimeGuardianE.guide/Der Menuepunkt Projekt=>Ueber" @Next "Der Menuepunkt Projekt=>Benutzer" @Prev "Der Menuepunkt Projekt=>Speichern als" @Toc "Die Menues des Programms TimeGuardian" The Menu `Project=>About' ......................... Activating this menu item opens the information window which you have already seen during the startup of the program. The difference is that you have to close the window by hand now. You may do this by clicking on the 'OK' button at the bottom of the window. During startup, the window will dissapear automatically after moving the mouse or pressing any key. The window shows the copyrights, the shareware reference and the reference to MUI. @EndNode @Node "Der Menuepunkt Projekt=>Benutzer" "TimeGuardianE.guide/Der Menuepunkt Projekt=>Benutzer" @Next "Der Menuepunkt Projekt=>Ikonifizieren" @Prev "Der Menuepunkt Projekt=>Ueber" @Toc "Die Menues des Programms TimeGuardian" The Menu `Project=>User' ........................ If you activate this menu you will be shown an information window in which the following message is displayed This TimeGuardian is registered to: *Firstname Lastname* Street Postcode Location Country if you are a registered user otherwise, if you haven't registered yet, the display will read This is a *unregistered* version of TimeGuardian you have to register after an evaluation time of 14 days!! If you want to know how to register for `TimeGuardian', see @{"registration" Link "Wie kann ich mich registrieren lassen?"}. @EndNode @Node "Der Menuepunkt Projekt=>Ikonifizieren" "TimeGuardianE.guide/Der Menuepunkt Projekt=>Ikonifizieren" @Next "Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen" @Prev "Der Menuepunkt Projekt=>Benutzer" @Toc "Die Menues des Programms TimeGuardian" The Menu `Project=>Iconify' ........................... If you activate this menu, the program will close the window of the graphical user interface and appear as an icon on the Workbench. If you want to reactivate the window, you have to doubleclick the icon. You may also use the third gadget from the right on the upper window border. @EndNode @Node "Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen" "TimeGuardianE.guide/Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen" @Next "Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes" @Prev "Der Menuepunkt Projekt=>Ikonifizieren" @Toc "Die Menues des Programms TimeGuardian" The Menu `Edit=>Reset to Defaults' .................................. If you click on the gadget `Default', the default values will appear. These are the original default settings which were shown to you after your first startup after installation. @EndNode @Node "Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes" "TimeGuardianE.guide/Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes" @Next "Der Menuepunkt Vorgaben=>auf vorherigen Stand" @Prev "Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen" @Toc "Die Menues des Programms TimeGuardian" The Menu `Edit=>Last Saved' ........................... If you activate this menu, the configuration file that you saved with the gadget `Save' will be loaded. When the file is loaded succesfully, you may edit, use or save it in the usual way. @EndNode @Node "Der Menuepunkt Vorgaben=>auf vorherigen Stand" "TimeGuardianE.guide/Der Menuepunkt Vorgaben=>auf vorherigen Stand" @Next "Der Menuepunkt Optionen=>Piktogramme erzeugen" @Prev "Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes" @Toc "Die Menues des Programms TimeGuardian" The Menu `Edit=>Restore' ........................ With the menu item`Restore' you may cancel changes you may have made before. It'll work as long as you did not use one of the two gadgets `Save' or `Use'. @EndNode @Node "Der Menuepunkt Optionen=>Piktogramme erzeugen" "TimeGuardianE.guide/Der Menuepunkt Optionen=>Piktogramme erzeugen" @Next "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" @Prev "Der Menuepunkt Vorgaben=>auf vorherigen Stand" @Toc "Die Menues des Programms TimeGuardian" The Menu `Settings=>Create Icons?' .................................. If this menu item is checkmarked, each time you save a configuration with the menu `Project=>Save As', an icon for the configuration will be created. @EndNode @Node "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" "TimeGuardianE.guide/Der Menuepunkt Voreinstellungen=>Cron Einstellungen" @Next "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen" @Prev "Der Menuepunkt Optionen=>Piktogramme erzeugen" @Toc "Die Menues des Programms TimeGuardian" The Menu `Preferences=>Cron Setup' .................................. This menu item allows you to open the window where you may enter the basic setup of the cron. You will see the following buttons and sliders. @{" Startuptime " Link "Der Schieberegler Startzeit"} The time your computer needs to boot @{" Increment " Link "Der Schieberegler Schrittweite"} The accuracy of the savings @{" Log History " Link "Der Schieberegler Log Zeitraum"} Die Lebensdauer der LogFiles @{" Date Format " Link "Der Schalter Datumsformat"} The selection of the date format @{" Locale " Link "Der Schalter Lokalisierung"} The selection of the language @{" Cron Task Priority " Link "Der Schieberegler Cron Task Prioritaet"} Die Einstellung der Priorität des Hintergrundprogramms @{" Use " Link "Der Knopf Benutzen(Cron)"} Änderungen aktivieren @{" Cancel " Link "Der Knopf Abbrechen(Cron)"} Änderungen verwerfen @EndNode @Node "Der Schieberegler Startzeit" "TimeGuardianE.guide/Der Schieberegler Startzeit" @Next "Der Schieberegler Schrittweite" @Prev "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Slider `Startuptime' ........................ You may use this slider to enter the time in minutes, your computer needs to boot, rounded to the next full minute. If your system needs for example two minutes and 30 seconds to start, you would have to enter three here. This is necessary, as the background program has to decide whether the computer was switched on or had a reset. The program decides, that the computer was switched on, if the difference between the last saved value and the actual time is greater than the value that you entered with the slider. Otherwise a reset is supposed. @EndNode @Node "Der Schieberegler Schrittweite" "TimeGuardianE.guide/Der Schieberegler Schrittweite" @Next "Der Schieberegler Log Zeitraum" @Prev "Der Schieberegler Startzeit" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Slider `Increment' ...................... This value is the time in minutes, when the background program saves, that the computer was still working. The smaller you make this value, the more accurate are the values in the three saved log-files. If you enter two, for example, every two minutes will be saved, that the computer was still working. The greatest error which may occur for this value will be two. The greater the entered value, the inaccurate is the supposed switch off moment, as the last saved value for a running system is taken. @EndNode @Node "Der Schieberegler Log Zeitraum" "TimeGuardianE.guide/Der Schieberegler Log Zeitraum" @Next "Der Schalter Datumsformat" @Prev "Der Schieberegler Schrittweite" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Slider `Log History' ........................ Select how many month will be stored in the data files. At the beginning of every month an external module will be started which deletes all outdated entries from the data files. You may store the datas of 2 years (=24 month), this is the predefined maximum. But you may set this value to one year for example and make a copy of the datafiles at the beginning of every new year. You won't loose any data this way. @EndNode @Node "Der Schalter Datumsformat" "TimeGuardianE.guide/Der Schalter Datumsformat" @Next "Der Schalter Lokalisierung" @Prev "Der Schieberegler Log Zeitraum" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Gadget `Date Format' ........................ With this gadget you may enter nine different formats for the date, that will be used, when saving the time in the different files. The following formats may be selected: `tt-mm-jj', `tt.mm.jj', `tt/mm/jj', `mm-tt-jj', `mm.tt.jj', `mm/tt/jj', `jj-mm-tt', `jj.mm.tt', `jj/mm/tt'. `tt' represents the day of the month, `mm' the short form of the month and `jj' the last two digits of the year. The short form of the month will be saved in the selected language. @EndNode @Node "Der Schalter Lokalisierung" "TimeGuardianE.guide/Der Schalter Lokalisierung" @Next "Der Schieberegler Cron Task Prioritaet" @Prev "Der Schalter Datumsformat" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Gadget `Locale' ................... Select a language for the background program `TGCron' with this gadget. The configuration program will *always* appear localized in the language you have selected in the language preferences program (of course you need an approriate file `TimeGuardian.catalog' installed in your drawer `Locale:Catalogs/language'). If this file is missing or if you use a workbench version < 2.1 the program will run in the default language English. This distribution contains only the default language English and a German catalog. You may select six different settings: * localized: Use this if you have a localized workbench and you want the files for the time functions to be written in this language. You need the appropriate file for your language! * English: By selecting this or one of the following items, the text will be written in the selected language to the files. * German, French, Italian, Spanish: time functions: selected language If you are intrested in translating the text of the graphical user interface into one of the languages above or into your own, please get in contact with one of the addresses at which you can register for the package, see @{"adress" Link "Wie kann ich mich registrieren lassen?"}. As a reward you will get a registered version of `TimeGuardian' for free. Please contact one of us *at all events*, before you start to translate! @EndNode @Node "Der Schieberegler Cron Task Prioritaet" "TimeGuardianE.guide/Der Schieberegler Cron Task Prioritaet" @Next "Der Knopf Benutzen(Cron)" @Prev "Der Schalter Lokalisierung" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Slider `Cron Task Priority' ............................... It is possible that the cron program won't work precise if the CPU usage is 100% (e.g. running a ray-tracing program). Therefore you may change the task priority of `TGCron' here. You should select a value higher than the priority of the program which uses the whole CPU power. The default value of 4 should work fine anyway. @EndNode @Node "Der Knopf Benutzen(Cron)" "TimeGuardianE.guide/Der Knopf Benutzen(Cron)" @Next "Der Knopf Abbrechen(Cron)" @Prev "Der Schieberegler Cron Task Prioritaet" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Gadget `Use' ................ If you choose this button for closing the window your current changes will be used. If you entered something wrong and don't want to use the changes click on the `Cancel' button. @EndNode @Node "Der Knopf Abbrechen(Cron)" "TimeGuardianE.guide/Der Knopf Abbrechen(Cron)" @Prev "Der Knopf Benutzen(Cron)" @Toc "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" The Gadget `Cancel' ................... If you click on `Cancel' instead of `Use' your current changes will get lost and everything will be reset to the previous values. @EndNode @Node "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen" "TimeGuardianE.guide/Der Menuepunkt Voreinstellungen=>Log Pfad & Namen" @Next "Der Menuepunkt Voreinstellungen=>LogFiles schreiben?" @Prev "Der Menuepunkt Voreinstellungen=>Cron Einstellungen" @Toc "Die Menues des Programms TimeGuardian" The Menu `Preferences=>Log Path & Names' ........................................ This menu item opens the window where you may enter the path and the names of the log files. The String Gadget `Log Path' ............................ In this string gadget you have to enter the drawer or partition, where the cron program is supposed to save when the computer has booted and how long and at what time it was switched on. You can enter the names of these three files in the following string gadgets. If you want to change the path, activate the string gadget and enter the desired path. If the path does not exist, a requester will popup which allows you to create it. When you activate the string gadget with the gadget to the right of it, a file requester pops up, where you can easily select the path. The String Gadget `Runtime' ........................... Enter the file in which `TGCron' is supposed to save, how long the computer was switched on and at which dates. If the file doesn't already exist, it will be created in the drawer or partition you selected at the gadget `Log Path'. The entry for a day will be written on the following day, when you switch your computer on. That implies, if you look at this file the actual day will not be shown. The file is saved in ASCII format and may be loaded with any editor or text viewer. A sample file could look like this: Wed 04-May-94 Runtime: 2 h 47 min. Thu 05-May-94 Runtime: 2 h 43 min. Mon 09-May-94 Runtime: 3 h 11 min. The date format may be changed, see @{"date format" Link "Der Schalter Datumsformat"} for further information. The String Gadget `Starts' .......................... Here you have to enter the name of the file in which `TGCron' is supposed to save the time when the computer has been reset. The file will be created in the drawer described above if it doesn't exist already. The values in the file will only show your real boot times if you start the program `TGCron' every time your computer is booting. See @{"Installation" Link "Wie installiere ich TimeGuardian?"} how to do this. If you start `TGCron' manually, you may, each time you work on a certain project, start the program. Thus you have a protocol for this specific project. You can do this in a another way, too. Start the program `TGCron' everytime and change the configuration for different projects. Afterward define a configuration for a certain project and save it using the menu `Project=>Save As'. When you start working on the project you use the menu `Project=>Open' to load it. For further information, see @{" Open " Link "Der Menuepunkt Projekt=>Oeffnen"} and @{" Save As " Link "Der Menuepunkt Projekt=>Speichern als"}. The file is saved in ASCII format and may be loaded with any editor or text viewer. A sample file could look like this: Wed 04-May-94 15:26 Thu 05-May-94 8:24 Thu 05-May-94 14:26 Thu 05-May-94 15:22 Thu 05-May-94 16:01 The date format may be changed, see @{"date format" Link "Der Schalter Datumsformat"} for further information. The String Gadget `OnOff' ......................... Enter the file in which `TGCron' is supposed to save the times the computer was switched on and off. If the file doesn't already exist, it will be created in the drawer or partition mentioned above. The entry for the current "switch on" will be appended to the file the next time the computer will be switched on. Such a file could look like the following: System switched on: Wed 04-May-94 17:38 Resets: 0 System switched off: Wed 04-May-94 19:26 System switched on: Thu 05-May-94 8:24 Resets: 0 System switched off: Thu 05-May-94 9:25 System switched on: Thu 05-May-94 14:26 Resets: 2 System switched off: Thu 05-May-94 16:11 The date format may be changed, see @{"date format" Link "Der Schalter Datumsformat"} for further information. The decision whether the computer was switched on or had a reset will be made depending on the settings of the slider `Startuptime', see @{"Startuptime" Link "Der Schieberegler Startzeit"}, for further information. The Gadget `Use' ................ If you choose this button for closing the window your current changes will be used. If you entered something wrong and don't want to use the changes click on the `Cancel' button. The Gadget `Cancel' ................... If you click on `Cancel' instead of `Use' your current changes will get lost and everything will be reset to the previous values. @EndNode @Node "Der Menuepunkt Voreinstellungen=>LogFiles schreiben?" "TimeGuardianE.guide/Der Menuepunkt Voreinstellungen=>LogFiles schreiben?" @Prev "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen" @Toc "Die Menues des Programms TimeGuardian" The Menu `Preferences=>LogFiles enabled?' ......................................... If this menu item is checkmarked, the cron program will create a logfile how long and at which point of time your computer was running. You have to choose a directory in the `Log Path & Names' window, even if you don not use the LogFile feature, as some of the special Cron abilities need information from the `TG_private' subdirectory. Data are only written at the first startup of a day to this drawer, after that `TGCron' will behave like a pure Cron/Reminder. @EndNode @Node "Die Seite Timer" "TimeGuardianE.guide/Die Seite Timer" @Next "Die Seite Spezial" @Prev "Die Menues des Programms TimeGuardian" @Toc "Das Programm TimeGuardian" The Page `Timer' ---------------- This page is shown if you carry out one of the following actions on the graphical user interface: * Press the gadget `Timer' * Select the menu `Pages=>Timer' * Press the keys `Amiga 1' * Press the keys `Alt ', while you are on the page `Daily Statistics' * Press the keys `Alt ', while you are on the page `Special' You may select all time dependand functions of `TGCron' on this page. You will see two main groups: The "CronTable" function and the interval timer. If you started `TimeGuardian' for the first time the all string gadgets will be ghostet. You have to choose the type of your timer function with the cycle button at the top of the page. @{" Typ " Link "Der Schalter Typ"} Die Auswahl des Alarmtyps @{" Standard " Link "Das Eingabefeld Standard- Aktuell"} Die Datei in der steht, welche Programme zu welchem Zeitpunkt ausgeführt werde sollen @{" Aktuell " Link "Das Eingabefeld Standard- Aktuell"} Die Datei, die in bestimmten Abständen ausgeführt wird @{" Intervall " Link "Das Eingabefeld Zeituhr intervall"} Die Datei, die in bestimmten Abständen ausgeführt wird @{" Stunden " Link "Die Schieberegler Stunden- Minuten"} Die Einstellung der Intervallzeit @{" Minuten " Link "Die Schieberegler Stunden- Minuten"} Die Einstellung der Intervallzeit @EndNode @Node "Der Schalter Typ" "TimeGuardianE.guide/Der Schalter Typ" @Next "Das Eingabefeld Standard- Aktuell" @Prev "Die Seite Timer" @Toc "Die Seite Timer" The Gadget `Type' ................. By using this gadget you may select which type of background actions will take place: * None: Neither the command/ script in the string gadget `Interval', nor the "CronTables" will be executed. * Cron Table: Only the two "CronTables" will be executed. If you want ot enter such a file use a text editor or the very comfortable `scheduler', you may get into it by clicking on one of the `Edit' buttons. * Interval: Only the command/ script in the string gadget `Interval' will be executed in the selected interval as long as the computer is working. * Cron Table & Interval: Both, commands/ scripts and "CronTables" will be executed. t @EndNode @Node "Das Eingabefeld Standard- Aktuell" "TimeGuardianE.guide/Das Eingabefeld Standard- Aktuell" @Next "Das Eingabefeld Zeituhr intervall" @Prev "Der Schalter Typ" @Toc "Die Seite Timer" The String Gadget `Default/ Current' .................................... You may select a "CronTable"(1) file here where you may store which programs have to be started at certain times. There are two different "CronTables" provided on this page which may be used separately from each other. Thus it is easier for you to generate one "CronTable" for actions which will happen regardless of the current configurations, the other will depend on it. The difference between both them is the fact that the `Default' "CronTable" won't be reread when you change the configuration of running cron. This may happen if you switch to another project you are working on. The `Standard' "CronTable" will always be reread whenever you change your configuration. A notification is set on both files, therefore the "CronTable" will be reread if you save something the file in any way. This file has to be an ASCII file with a certain format that will be described at @{"`CronTable-Syntax'" Link "CronTable-Syntax"}. It is possible to use samples in this file or certain days, months, etc. If you click on the gadget right beside the string gadget, a file requester will pop up with which you may easily select the desired file. You may access these string gadgets only if you have selected `CronTable' or `CronTable & Interval' at the `Type' cycle button. Otherwise the string gadgets will be ghosted. If you click on one of the `Edit' buttons right beside the string-gadgets you will get into the program `TGScheduler', refer to @{"`TGScheduler'" Link "Das Programm TGScheduler"}. This program will help you with its graphical user interface to create the very cryptic "CronTable" files. ---------- Footnotes ---------- (1) The format is the same as used in Un*x,has been enhanced by some very useful features. @EndNode @Node "Das Eingabefeld Zeituhr intervall" "TimeGuardianE.guide/Das Eingabefeld Zeituhr intervall" @Next "Die Schieberegler Stunden- Minuten" @Prev "Das Eingabefeld Standard- Aktuell" @Toc "Die Seite Timer" The String Gadget `Interval' ............................ You may select a file here that will be executed in regular time intervals. Therefore this entry may be used to save the project you are currently working on every ten minutes. The point of time this will happen are always relative to the boot time, i.e. (boot time + n * interval). To change the interval see @{"change the interval" Link "Die Schieberegler Stunden- Minuten"}. If you press the gadget to the right of the string gadget, a file requester will pop up with which you may select the desired file. You may change the entry in this string gadget only if `Interval' or `CronTable & Interval' has been selected at the `Type' gadget, otherwise the gadget will be ghosted. You may select an executable or a script in ASCII format. If you want to use a script the `S- flag' has to be set. To set this flag for the script `Example' in the directory `s:', type in a `CLI' window: `protect s:Example s add'. You have to start commands in a script with their full path! You don't need the path if you use internal commands or commands in the `C:'-directory. @EndNode @Node "Die Schieberegler Stunden- Minuten" "TimeGuardianE.guide/Die Schieberegler Stunden- Minuten" @Prev "Das Eingabefeld Zeituhr intervall" @Toc "Die Seite Timer" The Sliders `Hours'/ `Minutes' .............................. Set the interval time, at which the command/ script `Interval' will be executed regularly. You have to set the minutes and hours seperately. If you set the slider `Hours' to 0 and the slider `Minutes' to 15, the command/ script will be executed every fifteen minutes. You may change these two values only if you selected `Cron Table & Interval' or `Interval' at the gadget `Type', otherwise the two sliders will be ghosted (see @{"select timer type" Link "Der Schalter Typ"}). @EndNode @Node "Die Seite Spezial" "TimeGuardianE.guide/Die Seite Spezial" @Next "Die Seite Hauptstatistik" @Prev "Die Seite Timer" @Toc "Das Programm TimeGuardian" The Page `Special' ------------------ You may select some files here that will be executed at the given points of time. The same functions may be achieved using a "CronTable" entry, but this page is provided for the following two reasons: First the compatability to the old versions and second to enable you to test and use some functions in a fast and simple way. This page is shown if you carry out one of the following actions on the graphical user interface: * Press the gadget `Special' * Select the menu `Pages=>Special' * Press the keys `Amiga 2' * Press the keys `Alt ', while you are on the page `Timer' * Press the keys `Alt ', while you are on the page `Global Statistics' When you start `TimeGuardian' for the first time, you will find the string gadgets empty. Otherwise you will see the last saved configuration. @{" Once a day " Link "Das Eingabefeld Einmal am Tag"} The file which is executed once a day @{" Once a week " Link "Das Eingabefeld Einmal die Woche"} The file which is executed once a week @{" Once a month " Link "Das Eingabefeld Einmal im Monat"} The file which is executed once a month @{" Once a year " Link "Das Eingabefeld Einmal im Jahr"} The file which is executed once a year @EndNode @Node "Das Eingabefeld Einmal am Tag" "TimeGuardianE.guide/Das Eingabefeld Einmal am Tag" @Next "Das Eingabefeld Einmal die Woche" @Prev "Die Seite Spezial" @Toc "Die Seite Spezial" The String Gadget `Once a day' .............................. You may select a file here that will be executed once a day. The file will be executed only once a day regardless of the time the computer is switched on. If the computer is powered on at midnight, it will be executed right past midnight. This entry is not usable for polling at your mailbox once a day because the point of time when this will happen is not fixed. It is intended for commands which you don't want to execute from your `Startup-Sequence' each time your computer boots. Once a day you can make a backup of important files or update your database for a fast file search. If you press the gadget right of the string gadget, a file requester will pop up in which you may easily select the desired file. You may choose an executable or a script in ASCII format. If you want a script to be executed, the `S-flag' has to be set, for example, the script `Once_a_day' in the drawer `S:'. Enter `protect S:Once_a_day s add' in a CLI to set this flag. You have to start commands in a script with their full path! You won't need the path if you use internal commands or commands in the `C:'-directory. A sample script may look like this: ;Script once a day dir all sys: > T:.directorytree ;for fast file search copy T:.directorytree sys: delete T:.directorytree The commands will be automatically started as a background task. You won't have to enter anything like `run < nil: > nil: Command'. Before adding a command line to a script you should execute it in a `Shell',so you can be sure that it works in the intended way. In case you get problems running the command from the script, you may redirect the output to a file: `Command > Sys:.logfile'. Read the file `Sys:.logfile' with a text viewer or an editor to check what went wrong (you may check this file with `type Sys:.logfile' in a `Shell', too). @EndNode @Node "Das Eingabefeld Einmal die Woche" "TimeGuardianE.guide/Das Eingabefeld Einmal die Woche" @Next "Das Eingabefeld Einmal im Monat" @Prev "Das Eingabefeld Einmal am Tag" @Toc "Die Seite Spezial" The String Gadget `Once a week' ............................... You may select a file here that will be executed once a week. The file will be executed only once a week regardless of the day of the week the computer is switched on. @EndNode @Node "Das Eingabefeld Einmal im Monat" "TimeGuardianE.guide/Das Eingabefeld Einmal im Monat" @Next "Das Eingabefeld Einmal im Jahr" @Prev "Das Eingabefeld Einmal die Woche" @Toc "Die Seite Spezial" The String Gadget `Once a month' ................................ You may select a file here that will be executed once a month. The file will be executed only once a month regardless of the day the computer is switched on. @EndNode @Node "Das Eingabefeld Einmal im Jahr" "TimeGuardianE.guide/Das Eingabefeld Einmal im Jahr" @Prev "Das Eingabefeld Einmal im Monat" @Toc "Die Seite Spezial" The String Gadget `Once a year' ............................... You may select a file here that will be executed once a year. The file will be executed only once a year, regardless of the point of time at which the computer was switched on for the first time in a certain year. If the computer is running at the turn of the year, it will be executed right post midnight. You could use this entry to copy the files that the cron program produced to a different directory. @EndNode @Node "Die Seite Hauptstatistik" "TimeGuardianE.guide/Die Seite Hauptstatistik" @Next "Die Seite Tagesstatistik" @Prev "Die Seite Spezial" @Toc "Das Programm TimeGuardian" The Page `Global Statistics' ---------------------------- This page is shown if you carry out one of the following actions on the graphical user interface: * Press the gadget `Global Satistics' * Select the menu `Pages=>Global Statistics' * Press the keys `Amiga 3' * Press the keys `Alt arrow right', while you are on the page `Special' * Press the keys `Alt arrow left', while you are on the page `Daily Statistics' A table will be displayed on this page where you may see at which days of the current logfile the computer was working and how long. While controlling different projects with different configurations the times and dates shown correspond to the selected configuration. You may move around in the upper field of the page like follows: * Press the Tab key and use the keys Cursor up or Cursor down: Each time you press one of the keys the bar moves up or down a day. * Click on the desired day with your mouse. * Move the proportional gadget to the right side of the Listview and then click on the desired day with your mouse. * Click on the gadgets next to the proportional gadget and then choose the desired day. If the desired day has been highligted as mentioned above you should activate the page `Daily Statistics' in one of these ways: * Press the Return key (the highlighted day will be shown) * Doubleclick on the desired day (this will also work if no day has been selected yet) At the bottom you will see two buttons. By clicking on them you may pop up as information window: * Statistics: A window will be opened which displays detailed information on the global runtime, maximum and minimum, furthermore on the startups/resets and onoff-cycles. The text lines are written on alternating background colors. To get this effect which makes it easier to read the table choose different colors or greyscales for the pens `Halfshine' and `Halfshadow' in the preferences program of `MUI'. * Graphics: A graphics window will be opened. This window has not been finished yet in the current release. To be able to realize all planned functions the next versions will need `MUI 2.2'! @EndNode @Node "Die Seite Tagesstatistik" "TimeGuardianE.guide/Die Seite Tagesstatistik" @Next "Die Knoepfe Speichern- Benutzen- Ende" @Prev "Die Seite Hauptstatistik" @Toc "Das Programm TimeGuardian" The Page `Daily Statistics' --------------------------- This page is shown if you carry out one of the following actions on the graphical user interface: * The gadget `Daily Satistics' * Select the menu `Pages=>Daily Statistics' * Press the keys `Amiga 4' * Press the keys `Alt arrow right', while you are on the page `Global Statistics' * Press the keys `Alt arrow left', while you are on the page `Timer' This page contains three main areas. In the uppermost you may select which information will be shown in the middle of the page: - OnOff: This will show when the computer was switched on, how many resets it had, and at what time it was switched off. - Starts: The times when your computer had a reset or was turned on will be displayed here. In the downmost area you'll see a summary of the selected day. If you cannot see all entries together, you may move the proportional gadget the same way as on the page `Global Statistics'. If you want to switch between the two views `OnOff' and `Starts', you may press the Space bar. Furthermore you may use the keys Alt arrow up/down to browse through the days. The active day will be changed on the page `Global Statistics', too. @EndNode @Node "Die Knoepfe Speichern- Benutzen- Ende" "TimeGuardianE.guide/Die Knoepfe Speichern- Benutzen- Ende" @Next "Die Online-Hilfe" @Prev "Die Seite Tagesstatistik" @Toc "Das Programm TimeGuardian" The Gadgets `Save'/ `Use'/ `Quit' --------------------------------- The Gadget `Save' ................. If you press the gadget `Save' or the corresponding key-shortcut, the program will save the current preferences. The new configuration becomes active at once and will be used after a reboot (The preferences will be saved in the directory `ENVARC:' and `ENV:' with the name `TimeGuardian.config'). Contrary to the standard preferences programs `TimeGuardian' won't quit by pressing on the `Save' gadget. The Gadget `Use' ................ If you press the gadget `Use' or its corresponding key- shortcut, the preferences will be saved in the drawer `ENV:' with the same name as above. The configuration will be used immediately, but will stay active only as long as the computer won't be rebooted. If the computer boots, the configuration you saved with the gadget `Save' will be used. The Gadget `Quit' ................. You may leave the program by clicking on this gadget. If the preferences where changed but not yet saved, a requester will pop up. If you select `Quit', the program will be left without saving. If you select `Cancel' or press the Return key, you'll get back to the program. You may save the preferences manually and leave the program afterwards. By pressing the `Use' button, the changed configuration will be used and the program left. But the changed configuration will be lost after the next reboot. @EndNode @Node "Die Online-Hilfe" "TimeGuardianE.guide/Die Online-Hilfe" @Next "Der AREXX-Port" @Prev "Die Knoepfe Speichern- Benutzen- Ende" @Toc "Das Programm TimeGuardian" The Online Help --------------- The online help is a feature that'll help you while using the graphical user interface. The `amigaguide.library' has to be installed correctly (located in the drawer `Libs:') if you want to use this feature. See @{"`Amiga-Guide'" Link "Wo bekomme ich den Amiga-Guide"}. If this library has been installed, you may get help about an element of the graphical user interface by moving the mouse pointer over it (do not click) and pressing the Help key afterwards. The corresponding text from the file `TimeGuardian.guide' will appear. @EndNode @Node "Der AREXX-Port" "TimeGuardianE.guide/Der AREXX-Port" @Next "Was bedeuten die Fehlermeldungen (TimeGuardian)" @Prev "Die Online-Hilfe" @Toc "Das Programm TimeGuardian" The AREXX-Port -------------- At the present version the program only supports the standard `MUI' commands: QUIT SHOW HELP HIDE INFO For more information see `MUI.guide' from the distribution of `MUI'. @EndNode @Node "Was bedeuten die Fehlermeldungen (TimeGuardian)" "TimeGuardianE.guide/Was bedeuten die Fehlermeldungen (TimeGuardian)" @Prev "Der AREXX-Port" @Toc "Das Programm TimeGuardian" What Do the Error Messages Mean ? --------------------------------- * `Failed to create Application!' The program was not able to open its window on the active screen. This may happen if you don't have enough free memory. Close some applications or reboot and try it again. * `Cannot quit now, still some ASL popups open!' This message appears if you want to leave the program but still some file requester are open. Close them and try to quit the program again. * `The configuration has been changed and was not saved!' This message reminds you that you haven't saved the modified preferences. They will be lost if you don't save before leaving. * `TGCron is not running!' The background program `TGCron' is not running yet, therefore the changes of the configuration will have no effect! If you want to use the new configuration, you have to start `TGCron' first. * `The file already exists, I will overwrite it!' A file you want to save was already saved with the same name. If you select `Ok' the old file will be overwritten. If you select `Cancel' or press return you may save the file with a different name. * `You have to define a Log File, an empty string is not allowed!' You didn't enter anything in a string gadget. You have to enter a name for the file. * `Invalid config-file: *' The file * is not a valid config file; please select a different file. * `Could not load config-file: * I will use defaults instead!' The file * could not be opened correctly while starting `TimeGuardian'. The program will use the default values. Change the configuration to suit your needs and press `Save' to correct the error. * `Could not open scheduler window!' There was not enough free memory available on your system to open the scheduler window. Free some memory and try again. * `This path does not already exist! I will create it!' You entered a non existing path in the string gadget. You may create it by pressing `OK'. @EndNode @Node "Das Programm TGScheduler" "TimeGuardianE.guide/Das Programm TGScheduler" @Next "Das Programm TGCron" @Prev "Das Programm TimeGuardian" @Toc "Die Programme des Pakets TimeGuardian" The Program `TGScheduler' ========================= `TGScheduler' isn't an independent program, it's a part of `TimeGuardian'. The following description does *not* refer to an independent program. The scheduler may be used to create a "CronTable" in a very easy way. You don't need to notice the very cryptic syntax of the "CronTable" and you may try out your generated event before you store it. If you want to invoke the scheduler select on the page `Timer' (see @{"`Timer'" Link "Die Seite Timer"}) press one of the `Edit' buttons. Use your mouse or the equivalent short cut. If the corresponding string gadget already contains a file, it will be loaded into the scheduler, otherwise an empty "CronTable" will be created. `TGScheduler' consist of several windows. After startup you will be on the main window. @{" Main Window " Link "Das Hauptfenster"} The "Main" Window @{" Event Input Window " Link "Das Fenster Ereigniseingabe"} The Window `Event Input' @{" Comment Window " Link "Das Fenster Kommentar"} The Window `Enter comment...' @{" Command Window " Link "Das Fenster Befehl"} The Window `Enter command and arguments...' @{" Reminder Window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} The Window `Enter remind-text...' @{" Reminder & Beep Window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} The Window `Enter remind-text...' @{" Alert Window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} The Window `Enter alert-text...' @{" Minutes Window " Link "Das Fenster Minuten- Stunden- Tage"} The Window `Minutes' @{" Hours Window " Link "Das Fenster Minuten- Stunden- Tage"} The Window `Hours' @{" Days Window " Link "Das Fenster Minuten- Stunden- Tage"} The Window `Days' @{" The CronTable-Syntax " Link "CronTable-Syntax"} The Syntax of the "CronTable" @EndNode @Node "Das Hauptfenster" "TimeGuardianE.guide/Das Hauptfenster" @Next "Das Fenster Ereigniseingabe" @Prev "Das Programm TGScheduler" @Toc "Das Programm TGScheduler" The "Main" Window ----------------- Whether the string gadget contained a file or not, it was loaded or an empty listview will appear. You may manipulate existing tables here. By clicking on the close-gadget you will exit from the scheduler without any security requesters, even if you changed something in the active table. If you already named the current table (by saving it) or you loaded an already existing file, the filename will appear in the titlebar of the main window. The length of the complete path and filename is limited to 40 characters, if it will be longer than 40 characters the middle of the path will be replaced by `...' You will see the following elements on the main page: @{" EventList " Link "Das Listview Ereignisliste"} Das ListView `EventList' @{" Gadget New " Link "Der Knopf Neu"} The Gadget `New' @{" Gadget Clone " Link "Der Knopf Klonen"} The Gadget `Clone' @{" Gadget Change " Link "Der Knopf Aendern"} The Gadget `Change' @{" Gadget Up " Link "Der Knopf Hoch"} The Gadget `Up' @{" Gadget Down " Link "Der Knopf Runter"} The Gadget `Down' @{" Gadget Remove " Link "Der Knopf Entfernen"} The Gadget `Remove' @{" Gadget Open " Link "Der Knopf Oeffnen"} The Gadget `Open' @{" Gadget Save " Link "Der Knopf Speichern"} The Gadget `Save' @{" Gadget Save As " Link "Der Knopf Speichern Als"} The Gadget `Save As...' @{" Gadget Clear " Link "Der Knopf Loeschen"} The Gadget `Clear' @{" Gadget Exit " Link "Der Knopf Zurueck"} The Gadget `Exit' @EndNode @Node "Das Listview Ereignisliste" "TimeGuardianE.guide/Das Listview Ereignisliste" @Next "Der Knopf Neu" @Prev "Das Hauptfenster" @Toc "Das Hauptfenster" The ListView `EventList' ........................ This listview will show the current table you are working on. The buttons right beside the listview will act to the highlighted entry. If you want to activate an entry you may click it once with your mouse or select it with the cursor keys. After that it will be highlighted. If there are no entries in the list you may only select the button `New', all other buttons will be ghosted. @EndNode @Node "Der Knopf Neu" "TimeGuardianE.guide/Der Knopf Neu" @Next "Der Knopf Klonen" @Prev "Das Listview Ereignisliste" @Toc "Das Hauptfenster" The Gadget `New' ................ By pressing this button you may create a new entry for the list left to it. It will be entered on top of an empty list or after the highlighted entry. A requester will pop up in which you may select the type of your new entry. There are currently five different types you may choose from: * `Command': A command will be executed by the cron. * `Comment': Those entries contain no information for the cron, they will help you to enter some notes or separate entries for different project, etc. . As they are not important for the cron, you cannot enter time values here. * `Reminder': The cron will invoke the requester/alarm-module of `TimeGuardian'. A requester will pop up, containing the text you have entered before, to remind you of an important event. * `Reminder & Beep': The cron will invoke the requester/alarm-module of `TimeGuardian'. A requester will pop up, containing the text you have entered before, to remind you of an important event. Furthermore your screen will flash for a short moment. * `Alert': The cron will invoke the requester/alarm-module of `TimeGuardian'. An alert will occur, containing the text you have entered before, to remind you of some important event. But you should be very careful using those alerts, as the whole multitasking system will be halted as long as the alert stays active. When you have choosen one of these types, the window `Event Input' will pop up next, see also @{"`Event Input'" Link "Das Fenster Ereigniseingabe"}. @EndNode @Node "Der Knopf Klonen" "TimeGuardianE.guide/Der Knopf Klonen" @Next "Der Knopf Aendern" @Prev "Der Knopf Neu" @Toc "Das Hauptfenster" The Gadget `Clone' .................. This button allows you to duplicate the currently active entry. The copy will appear below the active entry. @EndNode @Node "Der Knopf Aendern" "TimeGuardianE.guide/Der Knopf Aendern" @Next "Der Knopf Hoch" @Prev "Der Knopf Klonen" @Toc "Das Hauptfenster" The Gadget `Change' ................... By clicking on the `Change' button, the currently active entry will be transfered to the editor. You will get the same result by double clicking on an entry in the listview or by pressing the Return key while your desired entry is highlighted. @EndNode @Node "Der Knopf Hoch" "TimeGuardianE.guide/Der Knopf Hoch" @Next "Der Knopf Runter" @Prev "Der Knopf Aendern" @Toc "Das Hauptfenster" The Gadget `Up' ............... This button allows you to move the active entry one position up. If it is already at the top of the listview, nothing will happen. The position of an entry in the "CronTable" has no meaning for the cron. But you may sort your events to make it easier to read the "CronTable". @EndNode @Node "Der Knopf Runter" "TimeGuardianE.guide/Der Knopf Runter" @Next "Der Knopf Entfernen" @Prev "Der Knopf Hoch" @Toc "Das Hauptfenster" The Gadget `Down' ................. This button allows you to move the active entry one position down. @EndNode @Node "Der Knopf Entfernen" "TimeGuardianE.guide/Der Knopf Entfernen" @Next "Der Knopf Oeffnen" @Prev "Der Knopf Runter" @Toc "Das Hauptfenster" The Gadget `Remove' ................... By clicking on this button you may remove the currently active entry from the table. There will be no security requester, be careful. @EndNode @Node "Der Knopf Oeffnen" "TimeGuardianE.guide/Der Knopf Oeffnen" @Next "Der Knopf Speichern" @Prev "Der Knopf Entfernen" @Toc "Das Hauptfenster" The Gadget `Open' ................. This button allows you to load a new table into the scheduler. If the old table has been changed and was not saved, a security requester will pop up and remind you on this fact. @EndNode @Node "Der Knopf Speichern" "TimeGuardianE.guide/Der Knopf Speichern" @Next "Der Knopf Speichern Als" @Prev "Der Knopf Oeffnen" @Toc "Das Hauptfenster" The Gadget `Save' ................. You may use this button to save the currently visible table with the name given in the titlebar of its window. There won't be a security requester. If there will be no name defined in the titlebar, a requester will pop up in which you may enter a path and name. @EndNode @Node "Der Knopf Speichern Als" "TimeGuardianE.guide/Der Knopf Speichern Als" @Next "Der Knopf Loeschen" @Prev "Der Knopf Speichern" @Toc "Das Hauptfenster" The Gadget `Save As...' ....................... By clicking on this button you may save the current table with a new name. If the selected file already exists a security requester will pop up, asking if you really want to overwite the file. @EndNode @Node "Der Knopf Loeschen" "TimeGuardianE.guide/Der Knopf Loeschen" @Next "Der Knopf Zurueck" @Prev "Der Knopf Speichern Als" @Toc "Das Hauptfenster" The Gadget `Clear' .................. This button may be used to clear the whole table. If you have changed the current table, a security requester will appear. Otherwise it will be deleted without any interrogation. The name of the table will be kept. @EndNode @Node "Der Knopf Zurueck" "TimeGuardianE.guide/Der Knopf Zurueck" @Prev "Der Knopf Loeschen" @Toc "Das Hauptfenster" The Gadget `Exit' ................. This button brings you back to the program `TimeGuardian'. If you changed something at the current table a security requester will pop up. If you `Cancel' the requester, you will get back to the scheduler. If you `Exit' from it, you will be back to `TimeGuardian' without saving the table. The middle button alows you to save your data and exit after that to `TimeGuardian'. @EndNode @Node "Das Fenster Ereigniseingabe" "TimeGuardianE.guide/Das Fenster Ereigniseingabe" @Next "Das Fenster Kommentar" @Prev "Das Hauptfenster" @Toc "Das Programm TGScheduler" The Window `Event Input' ------------------------ Now you are in the part of the program where you may select when a certain event will happen. The upper window will be always the same regardless which type of event you are working on. Its main purpose is to choose *WHEN* your event will take place. *WHAT* will happen may be selected with the button at the left top and the second window. The second window will be different for each type of event. If you want to create a "CronTable" by hand using a texteditor, refer to @{"`CronTable-Syntax'" Link "CronTable-Syntax"} for a detailed description of its syntax. @{" Type " Link "Der Knopf Art"} The type of the "CronTable" entry @{" Special " Link "Der Knopf Spezial"} The frequence of the "CronTable" entry @{" Minutes " Link "Das Eingabefeld Minuten"} The time of execution @{" Hours " Link "Das Eingabefeld Stunden"} The time of execution @{" Days " Link "Das Eingabefeld Tage"} The time of execution @{" Months " Link "Das Schalterfeld Monate"} The time of execution @{" Day of week " Link "Das Schalterfeld Wochentage"} The time of execution @{" Edit 1-3 " Link "Die Knoepfe Editieren"} The "Help" Windows @{" Toggle " Link "Die Knoepfe Invers"} Toggling the gadgets @EndNode @Node "Der Knopf Art" "TimeGuardianE.guide/Der Knopf Art" @Next "Der Knopf Spezial" @Prev "Das Fenster Ereigniseingabe" @Toc "Das Fenster Ereigniseingabe" The Gadget `Type' ................. This button shows you which type of event you are currently working on. All types may be converted into a `Comment' and all comments may be reconverted into their former type. Furthermore the three types `Reminder', `Reminder & Peep' and `Alert' may be converted into each other. You won't be able to convert a `Reminder' to an `Alert', because an `Alert' is limited to 78 characters and 20 rows, the size of a `Reminder' depends only from your screen resolution. @EndNode @Node "Der Knopf Spezial" "TimeGuardianE.guide/Der Knopf Spezial" @Next "Das Eingabefeld Minuten" @Prev "Der Knopf Art" @Toc "Das Fenster Ereigniseingabe" The Gadget `Special' .................... This button influences the behavior of the event. It defines what will happen after a event has become active: * Standard: Nothing special will happen. The event will be executed at the predefined points of time. * Once a day: The event will be executed at the predefined points of time, but only once a day. * Once a week: The event will be executed at the predefined points of time, but only once a week. * Once a month: The event will be executed at the predefined points of time, but only once a month. * Once a year: The event will be executed at the predefined points of time, but only once a year. * Use only once: The event will be executed at the predefined point of time, afterwards it will be removed from the "CronTable". For example I am using an entry with `once a week' and `* * *' for the time values, all month enabled and Sat and Sun (weekend), which reminds me to make a backup. The reminder will pop up always when I start my computer for the first time at the weekend. A `once a day' reminder may be used to remind you for example of someones birthday or that her/his birthday will come soon. @EndNode @Node "Das Eingabefeld Minuten" "TimeGuardianE.guide/Das Eingabefeld Minuten" @Next "Das Eingabefeld Stunden" @Prev "Der Knopf Spezial" @Toc "Das Fenster Ereigniseingabe" The String Gadget `Minutes' ........................... You may enter in this stringgadget at which minutes the event will happen. Enter the string like described at @{"`CronTable-Syntax'" Link "CronTable-Syntax"} or click on the button `Edit 1' right beside the gadget to enter it using the help window `Minutes', see @{"`Minutes'" Link "Das Fenster Minuten- Stunden- Tage"}. @EndNode @Node "Das Eingabefeld Stunden" "TimeGuardianE.guide/Das Eingabefeld Stunden" @Next "Das Eingabefeld Tage" @Prev "Das Eingabefeld Minuten" @Toc "Das Fenster Ereigniseingabe" The String Gadget `Hours' ......................... You may enter in this stringgadget at which hours the event will happen. Enter the string like described at @{"`CronTable-Syntax'" Link "CronTable-Syntax"} or click on the button `Edit 2' right beside the gadget to enter it using the help window `Hours', see @{"`Hours'" Link "Das Fenster Minuten- Stunden- Tage"}. @EndNode @Node "Das Eingabefeld Tage" "TimeGuardianE.guide/Das Eingabefeld Tage" @Next "Das Schalterfeld Monate" @Prev "Das Eingabefeld Stunden" @Toc "Das Fenster Ereigniseingabe" The String Gadget `Days' ........................ You may enter in this stringgadget at which days the event will happen. Enter the string like described at @{"`CronTable-Syntax'" Link "CronTable-Syntax"} or click on the button `Edit 3' right beside the gadget to enter it using the help window `Days', see @{"`Days'" Link "Das Fenster Minuten- Stunden- Tage"}. @EndNode @Node "Das Schalterfeld Monate" "TimeGuardianE.guide/Das Schalterfeld Monate" @Next "Das Schalterfeld Wochentage" @Prev "Das Eingabefeld Tage" @Toc "Das Fenster Ereigniseingabe" The Gadgets `Months' .................... You may use this field of buttons to enter at which months the event will happen. A certain month will be activated by pressing its appropriate button (recess it). The `Toggle 4' button may be used to invert all entries, recessed (activated) buttons will become raised (inactivated) and vice versa. @EndNode @Node "Das Schalterfeld Wochentage" "TimeGuardianE.guide/Das Schalterfeld Wochentage" @Next "Die Knoepfe Editieren" @Prev "Das Schalterfeld Monate" @Toc "Das Fenster Ereigniseingabe" The Gadgets `Day of week' ......................... You may use this field of buttons to enter at which days of the week the event will happen. A certain day will be activated by pressing its appropriate button (recess it). The `Toggle 5' button may be used to invert all entries, recessed (activated) buttons will become raised (inactivated) and vice versa. @EndNode @Node "Die Knoepfe Editieren" "TimeGuardianE.guide/Die Knoepfe Editieren" @Next "Die Knoepfe Invers" @Prev "Das Schalterfeld Wochentage" @Toc "Das Fenster Ereigniseingabe" The Gadgets `Edit' .................. A window will pop up which allows you to enter an appropriate string for the string gadget. For a detailed description of the windows elements refer to @{"window Minutes- Hours- Days" Link "Das Fenster Minuten- Stunden- Tage"}. @EndNode @Node "Die Knoepfe Invers" "TimeGuardianE.guide/Die Knoepfe Invers" @Prev "Die Knoepfe Editieren" @Toc "Das Fenster Ereigniseingabe" The Gadgets `Toggle' .................... You may use these two buttons to simply invert the state of the buttons left beside them. All active buttons will become inactive and vice versa. @EndNode @Node "Das Fenster Kommentar" "TimeGuardianE.guide/Das Fenster Kommentar" @Next "Das Fenster Befehl" @Prev "Das Fenster Ereigniseingabe" @Toc "Das Programm TGScheduler" The Window `Comment' -------------------- This window will appear if you select the event-type `Comment' from the cycle button at the left top of the `Event Input' window. Furthermore the window where you may enter the time values for an event will become ghosted. The String Gadget `Comment' ........................... You may enter a comment text here which will appear in the "CronTable". The Gadget `Use' ................ By clicking on this button the text of the string gadget left beside it will be entered into the "CronTable". If you don't want to enter this text, click on the `close-gadget' of the `Event Input' window to get back to the "main" window without any changees. @EndNode @Node "Das Fenster Befehl" "TimeGuardianE.guide/Das Fenster Befehl" @Next "Das Fenster Erinnerung- Erinnerung & Piep- Alarm" @Prev "Das Fenster Kommentar" @Toc "Das Programm TGScheduler" The Window `Command' -------------------- This window will appear if you select the event-type `Command' from the cycle button at the left top of the `Event Input' window. Furthermore the window where you may enter the time values for an event will become active. The String Gadget `Arguments' ............................. Enter the arguments here for the command you entered below. The String Gadget `Command' ........................... You must enter the path and name of the command which should be started by the cron utility as a background task. If you do not remember the exact path, use the button right beside the stringgadget to pop up a file requester. The Gadget `Test' ................. This button allows you to test your command or script, exactly the same will happen when the cron utility starts it later on. The Gadget `Use' ................ By clicking on this button the command left beside it will be entered into the "CronTable". If you don't want to enter this command, click on the `close-gadget' of the `Event Input' window to get back to the "main" window without any change. @EndNode @Node "Das Fenster Erinnerung- Erinnerung & Piep- Alarm" "TimeGuardianE.guide/Das Fenster Erinnerung- Erinnerung & Piep- Alarm" @Next "Das Fenster Minuten- Stunden- Tage" @Prev "Das Fenster Befehl" @Toc "Das Programm TGScheduler" The Window `Reminder- Reminder & Beep- Alert' --------------------------------------------- You may enter the text in this window which will occur in your Reminder, Reminder & Peep or Alert. All windows for the three event types will look like the same and therefore are described here together. You will see a listview which shows you the actual text entries, as same as on the main window of the scheduler. Below the listview you will see a stringgadget which allows you to enter your desired text to the listview. Together with the buttons right beside the listview you get a small text editor to create your events. The Gadget `New' ................ Use this button to append a new textline to the listview. The text will always be appended after the last entry of the listview, regardless which entry has been activated by the listview-cursor. The stringgadget will be activated and you may enter the new text line there, after pressing the RETURN key, the line will be automatically appended to the listview. While the stringgadget is active, you have to press the Amiga key in conjunction with the underlined character to select the button. The Gadget `Clone' .................. By clicking on this button the highlighted entry will be copied and appended at the end of the list. The Gadget `Up' ............... Use this button to move the highlighted entry one position up. The Gadget `Down' ................. Use this button to move the highlighted entry one position down. The Gadget `Remove' ................... Use this button to remove the highlighted entry from the list. There will appear no security requester before deleting it. The Gadget `Test' ................. This button allows you to test your reminder or alert, exactly the same will happen when the cron utility starts it later on. If you are using an EGS-screen it may happen that you won't see the alert. You won't be able to move your mouse pointer as the alert will be displayed on a background screen. The only way to get rid of the alert will be clicking on the right mousebutton. This is a problem of the EGS-system and we are not able to influence that. The only solution will be to use no alerts if you get problems with EGS. The Gadget `Use' ................ By clicking on this button the current event will be entered into the "CronTable". If you don't want to enter this event, click on the `close-gadget' of the `Event Input' window to get back to the "main" window without any change. @EndNode @Node "Das Fenster Minuten- Stunden- Tage" "TimeGuardianE.guide/Das Fenster Minuten- Stunden- Tage" @Next "CronTable-Syntax" @Prev "Das Fenster Erinnerung- Erinnerung & Piep- Alarm" @Toc "Das Programm TGScheduler" The Window `Minutes- Hours- Days' --------------------------------- All of the three windows will look like the same and therefore are described here together. The only difference between them are their title bars and the ranges of their sliders. The Radiobutton `Type' ...................... Use these radio buttons to select which of the sliders you want to become active. * Always: None of the sliders will become active, only the `Replace' button will be activated. `Always' means that the event will be executed every minute (hour or day). * Range: You may use the sliders `Begin' and `End' to define a range of minutes (hours or days) when your event will be executed by the cron utility. * Single: You may select a single minute (hour or day) when your event will be executed by the cron utility. The Slider `Minute'/ `Hour'/ `Day' .................................. This slider allows you to select a single point of time. The Slider `Begin' .................. This slider allows you to set the beginning of a range. The Slider `End' ................ This slider allows you to set the end of a range. The Gadget `Replace' .................... The `Actual value' will be replaced by the currently choosen point of time or range by clicking on this button. The Gadget `Add' ................ The choosen point of time or range will be appended to the currently visible value (`Actual value'). Simplifications will be automatically performed by the program. @EndNode @Node "CronTable-Syntax" "TimeGuardianE.guide/CronTable-Syntax" @Prev "Das Fenster Minuten- Stunden- Tage" @Toc "Das Programm TGScheduler" The "CronTable"-Syntax ---------------------- An example file might look like this: # TimeGuardian CronTable # #55 23 * * * RequestChoice TimerRequest "It is 23:55 now!" "What?!" # 59 19 * * 1-5 s:News # 0,15,30,45 * * * * "newshell con:82/175/550/90/UpTime from batch:saytime" # R 55 23 * * * "It is 23:55 now !" # First of all I want to say that a command line must not contain more than 450 characters. This results of some Amiga- and `TimeGuardian'- specific restrictions. If you need longer commands you should use a small script for that. If the 1st character of a line is `#' (or `;'), the line will be completely ignored. You may use this to add comments to the file or to disable a commandline temporarely. This is shown in the third line. The command `RequestChoice' won't be executed. In order to execute a file at a certain time, the line in the file must look like the following example: `[Type] [Key] <"Text">|>'. The decision, whether a command will be executed or not, is made by a *AND*- combination of the five time parameters. This means that the command will only be executed if all five parameters match. A detailed description of the different samples, set in acute parenthesis, is following here. Some characters have a certain meaning: - `<>': The parameter in acute parenthesis has to be specified. - `|': The vertical bar seperates alternative parameters which may be used or not. - `[]': The parameter in angular parenthesis may be used if you want to. - `...': Three periods indicate that the preceding parameter may be used multiple times. * `[Type]' This is an enhancement of the Un*x syntax which provides you the following possibilities: `[#|;|R|B|A]' If you don't enter one of these parameters the rest of the line will be taken as a command. `#' and `;' indicate a comment line and will be ignored by the cron. The parameters `R', `B' and `A' indicate a so called "reminder" or "alert". The `<"Text">' (see below) will be displayed. These single characters are the abbreviations for: R = reminder B = reminder & beep A = alert A reminder is a system requester, which displays the given text, you may use them to remind you on important events (e.g. birthdays). An alert uses a special system screen. * `' The complete syntax looks like this: `<*|Min[[,Min]|[,Min-Min]...]|Min-Min[[,Min]|[,Min-Min]...]>' The value for `Min' has to be chosen from the period of 0 to 59. The following is a description of all possibilities: 1. `*': If you use an asterisk for this parameter, th command is executed every minute. 2. `Min': You may choose a certain point of time at which the command will be executed. 3. `Min-Min': You may specify a period of time, during which the command will be executed. The first value for `Min' has to be smaller than or equal the second value for `Min'. 4. `,,...,': You may specify multiple points and periods of time seperated by colons. The command will be executed at every specified moment and the specified periods of time. Example: `0,5,10,15-20,30,45-50 * * * * Command' This would start the command every full hour, every five, ten and 30 minutes after the full hour and during the period of 15 to 20 and of 45 to 50 minutes every minute after the full hour. The command will be executed every single day. * `' The complete syntax looks like this: `<*|Hour[[,Hour]|[,Hour-Hour]...]|Hour-Hour[[,Hour]|[,Hour-Hour]...]>' The value for `Hour' has to be chosen from the period of 0 to 23. For a more precise description of the parameter `Hour', consult the parameter `Minute' above. Both parameters have the same syntax. Example: `* 0,3,6,9,12,15,18,21 * * * Command' This would execute the command every three hours. Since an asterisk is used for the minutes, the command will be executed every minute of these hours. * `' The complete syntax looks like this: `<*|Day[[,Day]|[,Day-Day]...]|Day-Day[[,Day]|[,Day-Day]...]>' The value for `Day' has to be chosen from the period of 1 to 31. For a more precise description of the parameter `Day', consult the parameter `Minute' above. Both parameters have the same syntax. Example: `* * 5-10,20-25 * * Command' This would start the command from the fifth to 10th of a month and at the 20th to 25th of a month. Since asterisks are used for the other parameters, the command will be executed every single minute at these days! * `' The complete syntax looks like this: `<*|Mon[[,Mon]|[,Mon-Mon]...]|Mon-Mon[[,Mon]|[,Mon-Mon]...]>' The value for `Mon' has to be chosen from the period of 1 to 12. For a more precise description of the parameter `month', consult the parameter `Minute' above. Both parameters have the same syntax. Example: `* * * 1,5-7 * Command' This would start the command in the months from January to May and in July. It will be executed every single minute in these months! * `' The complete syntax looks like this: `<*|DoW[[,DoW]|[,DoW-DoW]...]|DoW-DoW[[,DoW]|[,DoW-DoW]...]>' The value for `DoW' has to be chosen from the period of 1 to 7. 1 corresponds to Monday, 7 corresponds to Sunday. For a more precise description of the parameter `Day_of_Week', consult the parameter `Minute' above. Both parameters have the same syntax. Example: `* * * * 1-5 Command' This would start the command from Monday to Friday every minute your computer is running. * `[Key]' The complete syntax of this enhancement looks like this: `[§Da[y]|§We[ek]|§Mo[nth]|§Ye[ar]|§Ki[ll]]' Only the first two characters will be checked (`§YE' is equal to `§year'). This check won't be case sensitive, you even might mix up small and capital letters. A commandline which contains such a `key' will be executed only once in the given range of time. After its execution the commandline will become commented and becomes reactivated at the beginning of a new time-period. This means for example that a script will be executed once a week (depending on its time parameters, see above), after that it will become deactivated and at the beginning of a new week reactivated. When the time parameters become valid, it gets executed again. The `§Kill' `Key' indicates a special event, after it has become valid the commandline will be removed from the "CronTable". Here are the meanings of the `Keys': `§Day' : will be executed once a day and reactivated at the beginning of a new day `§Week' : will be executed once a week and reactivated at the beginning of a new week `§Month' : will be executed once a month and reactivated at the beginning of a new month `§Year' : will be executed once a year and reactivated at the beginning of a new year `§Kill' : gets removed after a signle execution * `<<"Text">|>>' You have to enter the command or script here that is supposed to be executed. You always have to use the complete path. In the above example, in line seven, the command `newshell' would need no path, as it this is an *internal* command which is not loaded from any data media. System commands which are located in the `C:' drawer also won't need a path. All other commands will. If you selected a reminder/alert by using `R', `B' or `a' as first character, you have to enter the text quoted. A new line has to be entered as `*N'. * examples: 1. `* * * * * "dir >> t:test sys:tools"' This command would be executed every minute. 2. `0,30 8-16 * * 1-5 s:Gong' This script would be executed Mondays to Fridays from eight a.m. to four o'clock p.m. every full hour and every half hour. 3. `0 15 24 12 * execute "s:Christmas"' This script would be executed at three o'clock p.m. at the 24.th of December. 4. `0 20 15,16 4 7 s:Example' This script would be executed at the 15th and 16th of April at eight o'clock p.m. (if this date is a Sunday). Of course, two successive days can't be both Sundays, this example is just used to illustrate the *AND*- combination. 5. `R 55 23 * * * "You should better*Ngo to bed now!"' At 23:55 you will be sent to bed by your computer. 6. `* 18-22 * * * §Day s:Mailbox' Regardless when you switched your computer on for the first time this day, if it is running during 18-22 o'clock it will start the mailbox script. If you want to start scripts, the `S- flag' of the files has to be set (to do this with the script `News' which is in the directory `S:', type the following in a `CLI': `protect s:News s add'). The second way to start a script is to use the command `execute' as shown in the third example (you don't have to set the `S- flag' here). You have to start commands inside scripts with their full path! You won't need the path, if you use internal commands or commands in the `C:'-directory. If you have any problems with commands, because they are not working properly, check the commands for spaces. Try quoting the part of the command including spaces. Test the commands you want to use in a `Shell' before you enter them to a script. @EndNode @Node "Das Programm TGCron" "TimeGuardianE.guide/Das Programm TGCron" @Prev "Das Programm TGScheduler" @Toc "Die Programme des Pakets TimeGuardian" The Program `TGCron' ==================== After setting up your preferences with `TimeGuardian', you should start `TGCron'. The program is a so called `Commodity', please refer to your manual for the operating system for further information. According to your setup, the program will execute the appropriate programs and scripts and store the runtime information of your computer. Its CPU usage is very low. While waiting for the next event it will use *no* CPU power. CPU power will only be used during startup and when it's looking for an event or writing some information to disk and apart from that each minute for a short stretch of time. @{" Description " Link "Was macht TGCron?"} What does `TGCron' do? @{" Information " Link "Ausgabe von Informationen über TGCron"} How can I get information about `TGCron' @{" Start " Link "Wie kann ich TGCron starten?"} How can I start `TGCron'? @{" Stop " Link "Wie kann ich TGCron abbrechen?"} How can I stop `TGCron'? @{" Errors " Link "Was bedeuten die Fehlermeldungen (TGCron)?"} What do the error messages mean? @EndNode @Node "Was macht TGCron?" "TimeGuardianE.guide/Was macht TGCron?" @Next "Ausgabe von Informationen über TGCron" @Prev "Das Programm TGCron" @Toc "Das Programm TGCron" What Does `TGCron' Do? ---------------------- `TGCron' was designed to stay in memory all the time and run as a background task. It will execute user defined events at predefined points of time. This means on the one hand that script files will be executed and requester or alerts will be shown to remind you about important events, on the other hand it will store information about the runtime and the time your system was booted. The precision for these informations may be preset in `TimeGuardian'. It is very important to configure `TGCron' according to your personal environment, so that it will be able to handle your events. How ythis should be done, see @{"configuration" Link "Das Programm TimeGuardian"}. As the program stores (after predefined intervals) information to your harddisk, it is important not to do a reset at these points of time. It is possible that you would get a corrupted file on your harddisk, but that will be corrected during your next startup. (This happened just once during a period of 8 month on my system) To be safe don't do a reset at any full minute (:00) or remove `TGCron' before you do a reset. All in all you don't have to worry about that as it is not dangerous! @EndNode @Node "Ausgabe von Informationen über TGCron" "TimeGuardianE.guide/Ausgabe von Informationen über TGCron" @Next "Wie kann ich TGCron starten?" @Prev "Was macht TGCron?" @Toc "Das Programm TGCron" How May I Get Information About `TGCron' ---------------------------------------- If you want to get further information about `TGCron', please enter the following from the CLI (replace `' by the directory you have installed the package to): `/TGCron' There are two different messages possible, depending on whether `TGCron' has already been started or not. 1. `TGCron' has already been started: `TGCron v1.50 (5.1.1995) by G.Körner/J.Matern use -r option to remove...' 2. `TGCron' is not yet running: `TGCron v1.50 (5.1.1995) by G.Körner/J.Matern use -i option to install...' You may also get information about the revision and the compilation date by using the `version'-command. Enter the following commandline: `version full /TGCron' It should read: `TGCron v1.50 (5.1.1995)'. If this does not happen, you are definitely reading the wrong documentation. Furthermore you may use the `Commodity Exchange' program of you workbench to display information on TGCron. @EndNode @Node "Wie kann ich TGCron starten?" "TimeGuardianE.guide/Wie kann ich TGCron starten?" @Next "Wie kann ich TGCron abbrechen?" @Prev "Ausgabe von Informationen über TGCron" @Toc "Das Programm TGCron" How May I Start `TGCron'? ------------------------- If you didn't choose the automatic startup option during installation, there are two different ways to start `TGCron' by hand: 1. Start from CLI: To start from CLI please enter the following: `/TGCron -i' As `TGCron' does not detach from your CLI, you have to use the `run' command to get your shell back after startup as follows: `run < nil: > nil: /TGCron -i'. Replace by the directory the `TimeGuardian' package was installed to. 2. Workbench startup: If you want to start `TGCron' from your Workbench, just doubleclick its icon. If you try to start the program while it is already running, you will get the following results: - At the CLI: You will get the message: `TGCron is already running' Indicating that `TGCron' is already running and may not be restarted. - At the workbench: A requester will pop up, asking you: `Do you want to remove TimeGuardianCron?' If you want to remove it, click on `*Yes*' or press Return. Choosing `No' or pressing Escape will not affect `TGCron' and it will keep on running. Regardless of your choice it won't be started again! @EndNode @Node "Wie kann ich TGCron abbrechen?" "TimeGuardianE.guide/Wie kann ich TGCron abbrechen?" @Next "Was bedeuten die Fehlermeldungen (TGCron)?" @Prev "Wie kann ich TGCron starten?" @Toc "Das Programm TGCron" How May I Stop `TGCron'? ------------------------ If `TGCron' is already running, you have three options to remove it: 1. From CLI: Please enter the following command: `/TGCron -r' Replace by the directory the `TimeGuardian' package was installed to. After tahat you will get the message: `TGCron will be removed now!'. The program will be removed from memory at once. 2. At the Workbench: Just doubleclick its icon. A requester will pop up, asking you: `Do you want to remove TimeGuardianCron?' If you want to remove it, click on `*Yes*' or press Return. Choosing `No' or pressing Escape will not affect `TGCron' and it will keep on running. You won't get any further messages, but just as removing it from CLI, it will quit at once. 3. You may use the `Commodity Exchange' program of your workbench to remove `TGCron' from memory. @EndNode @Node "Was bedeuten die Fehlermeldungen (TGCron)?" "TimeGuardianE.guide/Was bedeuten die Fehlermeldungen (TGCron)?" @Prev "Wie kann ich TGCron abbrechen?" @Toc "Das Programm TGCron" What Do the Error Messages Mean? -------------------------------- You may get the following error messages from `TGCron': * `Not enough free memory!' You have not enough free memory in your system. `TGCron' had to quit. * `Invalid .config file. Use TimeGuardian to create a new one!' `TGCron' tried to read data from the file `env:TimeGuardian.config', but it was changed or corrupted and is not valid any more. Start `TimeGuardian', enter a new configuration, and store it with the `Save' button. * `Could not open env:TimeGuardian.config! Use TimeGuardian to create it' Start `TimeGuardian', enter your configuration and store it with the `Save' button. * `Could not open locale, please check configuration! Using english instead' You have choosen `localized' in the preferences program but the cron couldn't find the corresponding catalog. * `Your evaluation time has expired for today, Please consider registering !!' You have reached the end of your evaluation time for `TGCron' as an unregistered user. You won't be able to restart it again on this same day. If you want to use the package for a unlimited amount of time, please become a registered user, refer to @{"register" Link "Wie kann ich mich registrieren lassen?"} for detailed information. * `CronParser ERROR: Wrong number of Arguments in CronTable line: CronTab_line Please correct it!' The displayed `CronTab_line' from one of your choosen "CronTables" contains too much or not enough entries. For detailed information on the "CronTable", refer to @{"CronTable-Syntax" Link "CronTable-Syntax"}. * `CronParser ERROR: Bad entry '*' in CronTable line: CronTab_line Please correct it!' The entry '*' in the `CronTab_line' is not valid. For detailed information on the "CronTab", refer to @{"CronTable-Syntax" Link "CronTable-Syntax"}. * `CronParser ERROR: Value * out of range (*...*) Please search for commandline and fix it !' The number after `Value' is not in the range displayed in parenthesis. For detailed information on the "CronTab", refer to @{"CronTable-Syntax" Link "CronTable-Syntax"}. * `CronParser ERROR: Range *-* out of range (*...*) Please search for commandline and fix it !' The range `*-*' has to be in the range that is shown in parenthesis. For detailed information on the "CronTable", refer to @{"CronTable-Syntax" Link "CronTable-Syntax"}. @EndNode @Node "Wo bekomme ich die Zusatzprogramme?" "TimeGuardianE.guide/Wo bekomme ich die Zusatzprogramme?" @Next "Wie installiere ich TimeGuardian?" @Prev "Die Programme des Pakets TimeGuardian" @Toc "Main" Where Do I Get the Support Programs? ************************************ @{" `MUI' woher? " Link "Wo bekomme ich MUI?"} Where do I get `MUI'? @{" `Installer' woher? " Link "Wo bekomme ich den Installer?"} Where do I get `Installer'? @{" `Amiga-Guide' woher? " Link "Wo bekomme ich den Amiga-Guide"} Where do I get `Amiga-Guide'? @EndNode @Node "Wo bekomme ich MUI?" "TimeGuardianE.guide/Wo bekomme ich MUI?" @Next "Wo bekomme ich den Installer?" @Prev "Wo bekomme ich die Zusatzprogramme?" @Toc "Wo bekomme ich die Zusatzprogramme?" Where May I Obtain `MUI'? ========================= You may get `MUI' directly from the author, where you get a registered version (see @{"registration for `MUI'" Link "Wo kann ich MUI registrieren lassen?"}). This allows you to use all features of `MUI' and store its configuration permanently. The unregistered version is available on many PD-series an via `Aminet'. If you think `MUI' is not worth installing, because of one single program, you may be right. But the background program `TGCron' won't use `MUI' at all. Only the preferences program will use it for its graphical user interface. So `MUI' will not be started everytime, but if you want to change the configuration. So you may install this package even on computers with memory, as you don't need `MUI' all the time. If you have `MUI' not installed yet, you absolutely have to do this before the installation of `TimeGuardian', as the installation will be aborted otherwise. See @{"Installation" Link "Wie installiere ich TimeGuardian?"}, for further information. @EndNode @Node "Wo bekomme ich den Installer?" "TimeGuardianE.guide/Wo bekomme ich den Installer?" @Next "Wo bekomme ich den Amiga-Guide" @Prev "Wo bekomme ich MUI?" @Toc "Wo bekomme ich die Zusatzprogramme?" Where Can I Obtain `Installer'? =============================== For an easy installation of the program package you need the program Installer from C*mm*d*re. If this program is not installed on your computer, you may obtain it in several ways: * Workbench 2.0/2.1/3.0 includes it * From `Fish-Disk 870' * Via the distribution of `MUI'. * Many distributions of commercial software contain it @EndNode @Node "Wo bekomme ich den Amiga-Guide" "TimeGuardianE.guide/Wo bekomme ich den Amiga-Guide" @Prev "Wo bekomme ich den Installer?" @Toc "Wo bekomme ich die Zusatzprogramme?" Where Can I Obtain `Amiga-Guide'? ================================= If you want to use the "online help" you'll need the `amigaguide.library' in your `LIBS:'-drawer (see @{"What is online help?" Link "Die Online-Hilfe"}). You don't need it to run the package `TimeGuardian', but you won't be able to use the online help feature. The `amigaguide.library' is on the `Fish-Disk 870' and gets distributed with Workbench version 3.0. @EndNode @Node "Wie installiere ich TimeGuardian?" "TimeGuardianE.guide/Wie installiere ich TimeGuardian?" @Next "Was ist MUI?" @Prev "Wo bekomme ich die Zusatzprogramme?" @Toc "Main" How Do I Install `TimeGuardian'? ******************************** This chapter describes the installation of the package `TimeGuardian'. If you want to install other packages not included in this distribution (see @{"support programs" Link "Was benoetige ich um TimeGuardian nutzen zu koennen?"}), look into the respective distributions to install them. You have two possibilities to install the package `TimeGuardian'. You should use the first one: @{" Installation with the program `Installer' " Link "Die Installation mit Installer"} (`Installer' program has to be in the search path, e.g. `C:') @{" Installation without the program `Installer' " Link "Die Installation ohne Installer"} @EndNode @Node "Die Installation mit Installer" "TimeGuardianE.guide/Die Installation mit Installer" @Next "Die Installation ohne Installer" @Prev "Wie installiere ich TimeGuardian?" @Toc "Wie installiere ich TimeGuardian?" The Installation with `Installer' ================================= Before you make an *update*, read the file `Update_to_1.2'! There you'll find important hints on how to make an update. You have two choices to start the installation script: 1. Doubleclick on the icon `TG.install.deutsch': The installation will commence. The text will appear in german. If you want to use the German text please read the german documentation. 2. Doubleclick on the icon `TG.install.english': The installation will commence. The text will appear in english. Next is a step by step description of the installation: * At the beginning you may choose the user level for the installation. If you select `Novice', you won't be able to select anything else but the path, where you want to copy the programs to. All files necessary to work correctly will be copied and the preferences program will be started. Finally you'll get a summary about what was saved to which location. To quit the installation you have to leave the preferences program. If you want to install the package press `Proceed With Install'. With `Help...' you'll get some information. * If you select the user level `EXPERT' you may choose whether you want to install the package (`Install for Real') or whether you just want to test the installation script (`Pretend to Install'). Furthermore you may choose, whether all actions are logged or not. You may write the file `Sys:TGInstall.e.log' to disk (`Log File'), print the results (`Printer') or suppress a log file (`None'). The installation is continued with `Proceed'. * The installation will check, whether `MUI' was installed in the correct version. If this was not so, the installation will be aborted. * The installationprogramm checks now, if you have already installed a version of `TimeGuardian'. The installation tries to find the old installationpath. When you haven't changed the old installation procedure this should work correctly. A message with the found path will appear. A running `TGCron' will be stopped. This is necessary to make a proper update. * Now you may choose what you want to install. The first gadget means, that only the necessary programs and config files are copied. The second gadget symbolizes the documentation. * If the first gadget was activated: - You will be asked, if the background program `TGCron' should be started every time the computer is booting. - If you answered the last question with `Yes', the program will check whether this is possible on your system. - If multiple choices exist for starting the background program, you may select which of them you prefer. If you select `From CLI (user-startup)', the file `S:user-startup' will be changed in an appropriate way. If you select `From WB (WBStartup)', the icon of the progam `TGCron' is copied to the drawer `Sys:WBStartup'. Users who work mainly with the workbench should use the second way. Users making an update have to keep in mind to delete the *old* entry in their `user-startup', when you selected the CLI- start at a former installation. - Now you may choose where the programs shall be copied to. The installation will make a proposal. If you want a new drawer for the package created, select `Make New Drawer...', otherwise choose an existing one. - You may continue with the button `Proceed'. The first files will be extracted from the archive. - When you have registered this version of the package your keyfile will be copied now. When you have an variable called `ENV:KEYPATH' on your system, this will be the destination. Otherwise the key is copied to `S:'. - Even if you did not select the documents to be installed, the file `TimeGuardian.guide' will be copied if the file `Libs:amigaguide.library' is installed. If this was not so, a message will appear that you won't be able to use the online help. * If the second gadget was selected: - You can select which of the four files you want to install: 1. The file `TimeGuardian.asc' which you may read with any text viewer or editor or print, if you like to. 2. The file `TimeGuardian.guide' that you may read with `AmigaGuide'. This file contains the information for the online help. This file will always be copied, when the file `Libs:amigaguide.library' is installed to your system. 3. The file `TimeGuardian.dvi' that you may print or view, if you have installed TeX. 4. The file `TimeGuardian.ps' that you may print with a Postscript printer. - For the `.asc' and the `.guide' file you can select a drawer. - The file `TimeGuardian.guide' will only be installed when in the drawer `Libs:' the file `amigaguide.library' is found. Otherwise you're informed, that you will not be able to use the online help. - Now you can select a path for the `.tex' file. - Now you can select a path for the `.ps' file. * If you have installed the programs, you may decide now whether you wish to start the preferences program `TimeGuardian'. Start the program by selecting `Yes'. Change the configuration to suit your needs and press the gadget `Save' before you leave the program with the `Quit' gadget. If you haven't started the program yet, you'll have to answer a message that you will have to start the preferences program later on. Select `Proceed' then to leave the installation correctly. * If you have left the preferences program or answered the message, the installation will be complete. Then the final message will appear. * When you selected the option to start the "Cron" program every time your computer is booting, and you have left the preferences program with `Save' `TGCron' is started. @EndNode @Node "Die Installation ohne Installer" "TimeGuardianE.guide/Die Installation ohne Installer" @Prev "Die Installation mit Installer" @Toc "Wie installiere ich TimeGuardian?" The Installation without `Installer' ==================================== You should use this step by step installation only as an *expedient* when you can't get the `Installer' program. Before you make an *update*, read the file `Update_to_1.2'! There you'll find important hints on how to make an update. To install the package without `Installer' please follow these steps: 1. Open a `Shell' window (doubleclick the icon `Shell' in the drawer `System' of your boot partition). 2. Please enter `version libs:muimaster.library'. You should get this result: `libs:muimaster.library 7.973'. If you get a smaller number or `object not found' you have to install `MUI' version 2.0 or greater before you can continue. 3. If you want to install the package in a drawer that already exists, please enter `cd drawer' (instead of drawer please use the name of the directory). If you want to copy the files to a new drawer you have to create it with the command `makedir drawer', after that change to this drawer with `cd drawer' (please use the name of the new directory instead of `drawer' in the two command lines, e.g. TimeGuardian). 4. Please enter `echo > env:TimeGuardian.path drawer' and `echo > envarc:TimeGuardian.path drawer'. Substitute drawer with the path you used above. You have to type the trailing `/' or `:'! 5. Now put the disk with the package into any drive (if you have already copied the files to your hard disk just enter: `assign {No Value For " DISKNAME"}: sourcedrawer', in which `sourcedrawer' is the drawer, in which the files on your hard disk are stored). 6. To copy the programs enter:`TimeGuardian:Lhx/Lhx e TimeGuardian:bin/TGBins.lha #?'. Some messages will appear, as to which files have already been decrunched. 7. If you want to copy the locale files (only German available at the moment) please enter: `copy TimeGuardian:Catalogs/deutsch/#? Locale:Catalogs/deutsch'. You should get a message about a copied file. 8. If you want to copy the english documentation files please enter `TimeGuardian:Lhx/Lhx e TimeGuardian:doc/english/TGDoc.lha #? Help:english/'. 9. Please enter `copy TimeGuardian:env/#? envarc:' and `copy {No Value For " DISKNAME"}:env/#? env:' now. 10. Please enter `copy TimeGuardian:s/#? s:'. 11. If the background program shall be started while booting, please enter: - start from Workbench: `copy TGCron.info Sys:WBStartup' Open the drawer `WBStartup' on the Workbench and click at the icon `TGCron'. Activate the menu `Icons=>Information...' or press the keys Amiga i. A window should pop up. Now enter in the string gadget `Default Tool:': `path/TGCron' (you have to replace path with the full path you copied the programs to). Leave the window by clicking on the gadget `Save'. or: - start from user-startup: Add the following lines to the file `s:startup-sequence' or `s:user-startup': `run < nil: >nil: path/TGCron' (you have to replace path with the full path you copied the programs to). You may do this with the help of an editor. 12. If you want to start the preferences program from the same drawer as the standard preferences programs simply enter: `copy TimeGuardian.info Sys:Prefs'. You have to change the `Default Tool:' as described above at step 10 (from Workbench). Enter the name `path/TimeGuardian' instead of `path/TGCron'! 13. To use your personal configuration, start the program `TimeGuardian' and leave it by clicking on the gadget `Save'. It may happen that you run into problems trying to install the program as described above. This could happen, if the assign `Help' and the drawer `Help:english' don't exist. You may copy the documentation files to any other drawer you want. You have to change the file `Envarc:AmigaGuide/path' and `Env:AmigaGuide/path' in a way that the drawer in which you copied the file `TimeGuardian.guide' will be searched. E.g. add the line `dh0:docs' if you copied the above file to the drawer `dh0:docs'. @EndNode @Node "Was ist MUI?" "TimeGuardianE.guide/Was ist MUI?" @Next "Index" @Prev "Wie installiere ich TimeGuardian?" @Toc "Main" What is `MUI'? ************** `MUI' is a program package for users and developers, that provides a graphical user interface with many features for the programmer and user. `TimeGuardian' is not able to run without `MUI', to be more precise, the preferences program `TimeGuardian'! Therefore `MUI' has to be already installed or you have to do it before the installation of `TimeGuardian'. Where to obtain `MUI', see @{" `MUI' " Link "Wo bekomme ich MUI?"}. @{" `MUI' (C) " Link "Wo kann ich MUI registrieren lassen?"} Registration for `MUI' und (C) @EndNode @Node "Wo kann ich MUI registrieren lassen?" "TimeGuardianE.guide/Wo kann ich MUI registrieren lassen?" @Prev "Was ist MUI?" @Toc "Was ist MUI?" Where Can I Register for `MUI'? =============================== This application uses MUI - MagicUserInterface (C) Copyright 1993/94 by Stefan Stuntz `MUI' is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. `MUI' is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called `muiXXusr.lha' (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US-$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY @EndNode @Node "Index" "TimeGuardianE.guide/Index" @Prev "Was ist MUI?" @Toc "Main" Index ***** @{" TGScheduler " Link "Das Programm TGScheduler"} @{" MUI, about " Link "Was ist MUI?"} @{" Add, gadget " Link "Das Fenster Minuten- Stunden- Tage"} @{" Alert, window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @{" AREXX-Port " Link "Der AREXX-Port"} @{" Assumptions " Link "Was benoetige ich um TimeGuardian nutzen zu koennen?"} @{" Cancel, gadget " Link "Der Knopf Abbrechen(Cron)"} @{" Change, gadget " Link "Der Knopf Aendern"} @{" Clear, gadget " Link "Der Knopf Loeschen"} @{" Clone, gadget " Link "Der Knopf Klonen"} @{" Command, window " Link "Das Fenster Befehl"} @{" Comment, window " Link "Das Fenster Kommentar"} @{" Cron Task Priority, slider " Link "Der Schieberegler Cron Task Prioritaet"} @{" CronTable, Syntax " Link "CronTable-Syntax"} @{" Current, string gadget " Link "Das Eingabefeld Standard- Aktuell"} @{" Daily Statistics, page " Link "Die Seite Tagesstatistik"} @{" Date Format, gadget " Link "Der Schalter Datumsformat"} @{" Day of week, gadgets " Link "Das Schalterfeld Wochentage"} @{" Days, string gadget " Link "Das Eingabefeld Tage"} @{" Days, window " Link "Das Fenster Minuten- Stunden- Tage"} @{" Default, string gadget " Link "Das Eingabefeld Standard- Aktuell"} @{" Description of the installation " Link "Wie installiere ich TimeGuardian?"} @{" Description, TGCron " Link "Was macht TGCron?"} @{" Down, gadget " Link "Der Knopf Runter"} @{" Edit, gadgets " Link "Die Knoepfe Editieren"} @{" Error messages, TGCron " Link "Was bedeuten die Fehlermeldungen (TGCron)?"} @{" Error messages, TimeGuardian " Link "Was bedeuten die Fehlermeldungen (TimeGuardian)"} @{" Event Input, window " Link "Das Fenster Ereigniseingabe"} @{" EventList, listview " Link "Das Listview Ereignisliste"} @{" Exit, gadget " Link "Der Knopf Zurueck"} @{" Features " Link "Was bietet TimeGuardian für Fähigkeiten?"} @{" Function, package " Link "Was ist TimeGuardian?"} @{" Gadget Add " Link "Das Fenster Minuten- Stunden- Tage"} @{" Gadget Cancel " Link "Der Knopf Abbrechen(Cron)"} @{" Gadget Change " Link "Der Knopf Aendern"} @{" Gadget Clear " Link "Der Knopf Loeschen"} @{" Gadget Clone " Link "Der Knopf Klonen"} @{" Gadget Date Format " Link "Der Schalter Datumsformat"} @{" Gadget Down " Link "Der Knopf Runter"} @{" Gadget Exit " Link "Der Knopf Zurueck"} @{" Gadget Locale " Link "Der Schalter Lokalisierung"} @{" Gadget New " Link "Der Knopf Neu"} @{" Gadget Open " Link "Der Knopf Oeffnen"} @{" Gadget Quit " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Gadget Remove " Link "Der Knopf Entfernen"} @{" Gadget Replace " Link "Das Fenster Minuten- Stunden- Tage"} @{" Gadget Save " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Gadget Save " Link "Der Knopf Speichern"} @{" Gadget Save As... " Link "Der Knopf Speichern Als"} @{" Gadget Special " Link "Der Knopf Spezial"} @{" Gadget Type " Link "Der Schalter Typ"} @{" Gadget Type " Link "Der Knopf Art"} @{" Gadget Up " Link "Der Knopf Hoch"} @{" Gadget Use " Link "Der Knopf Benutzen(Cron)"} @{" Gadget Use " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Gadgets Day of week " Link "Das Schalterfeld Wochentage"} @{" Gadgets Edit " Link "Die Knoepfe Editieren"} @{" Gadgets Month " Link "Das Schalterfeld Monate"} @{" Gadgets Toggle " Link "Die Knoepfe Invers"} @{" Global Statistics, page " Link "Die Seite Hauptstatistik"} @{" Hours, slider " Link "Die Schieberegler Stunden- Minuten"} @{" Hours, string gadget " Link "Das Eingabefeld Stunden"} @{" Hours, window " Link "Das Fenster Minuten- Stunden- Tage"} @{" Increment, slider " Link "Der Schieberegler Schrittweite"} @{" Information, about TGCron " Link "Ausgabe von Informationen über TGCron"} @{" Installation " Link "Wie installiere ich TimeGuardian?"} @{" Installation, with Installer " Link "Die Installation mit Installer"} @{" Installation, without Installer " Link "Die Installation ohne Installer"} @{" Introduction " Link "Einleitung"} @{" Listview EventList " Link "Das Listview Ereignisliste"} @{" Locale, gadget " Link "Der Schalter Lokalisierung"} @{" Log History, slider " Link "Der Schieberegler Log Zeitraum"} @{" Main window " Link "Das Hauptfenster"} @{" Menu Preferences=>Log Path & Names " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" Menu Preferences=>LogFiles enabled? " Link "Der Menuepunkt Voreinstellungen=>LogFiles schreiben?"} @{" Menu, Edit=>Last Saved " Link "Der Menuepunkt Vorgaben=>auf zuletzt gespeichertes"} @{" Menu, Edit=>Reset to Defaults " Link "Der Menuepunkt Vorgaben=>auf Vorgaben zuruecksetzen"} @{" Menu, Edit=>Restore " Link "Der Menuepunkt Vorgaben=>auf vorherigen Stand"} @{" Menu, Preferences=>Cron Setup " Link "Der Menuepunkt Voreinstellungen=>Cron Einstellungen"} @{" Menu, Project=>About " Link "Der Menuepunkt Projekt=>Ueber"} @{" Menu, Project=>Iconify " Link "Der Menuepunkt Projekt=>Ikonifizieren"} @{" Menu, Project=>Open " Link "Der Menuepunkt Projekt=>Oeffnen"} @{" Menu, Project=>Save as " Link "Der Menuepunkt Projekt=>Speichern als"} @{" Menu, Project=>User " Link "Der Menuepunkt Projekt=>Benutzer"} @{" Menu, Settings=>Create Icons? " Link "Der Menuepunkt Optionen=>Piktogramme erzeugen"} @{" Menus of TimeGuardian " Link "Die Menues des Programms TimeGuardian"} @{" Minutes, slider " Link "Die Schieberegler Stunden- Minuten"} @{" Minutes, string gadget " Link "Das Eingabefeld Minuten"} @{" Minutes, window " Link "Das Fenster Minuten- Stunden- Tage"} @{" Month, gadgets " Link "Das Schalterfeld Monate"} @{" New, gadget " Link "Der Knopf Neu"} @{" Once a day, string gadget " Link "Das Eingabefeld Einmal am Tag"} @{" Once a month, string gadget " Link "Das Eingabefeld Einmal im Monat"} @{" Once a week, string gadget " Link "Das Eingabefeld Einmal die Woche"} @{" Once a year, string gadget " Link "Das Eingabefeld Einmal im Jahr"} @{" Online Help " Link "Die Online-Hilfe"} @{" OnOff, string gadget " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" Open, gadget " Link "Der Knopf Oeffnen"} @{" Page Daily Statistics " Link "Die Seite Tagesstatistik"} @{" Page Global Statistics " Link "Die Seite Hauptstatistik"} @{" Page Special " Link "Die Seite Spezial"} @{" Page Timer " Link "Die Seite Timer"} @{" Preferences=>Log Path & Names, menu " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" Preferences=>LogFiles enabled?, menu " Link "Der Menuepunkt Voreinstellungen=>LogFiles schreiben?"} @{" Program TGScheduler " Link "Das Programm TGScheduler"} @{" Program description " Link "Die Programme des Pakets TimeGuardian"} @{" Program, TimeGuardian " Link "Das Programm TimeGuardian"} @{" Program, TGCron " Link "Das Programm TGCron"} @{" Programs, other " Link "Wo bekomme ich die Zusatzprogramme?"} @{" Quit, gadget " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Radiobuttton Type " Link "Das Fenster Minuten- Stunden- Tage"} @{" Registration " Link "Wie kann ich mich registrieren lassen?"} @{" Reminder & Beep, window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @{" Reminder, window " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @{" Remove, gadget " Link "Der Knopf Entfernen"} @{" Replace, gadget " Link "Das Fenster Minuten- Stunden- Tage"} @{" Runtime, string gadget " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" Save As..., gadget " Link "Der Knopf Speichern Als"} @{" Save, gadget " Link "Der Knopf Speichern"} @{" Save, gadget " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Shareware fee " Link "Wie kann ich mich registrieren lassen?"} @{" Slider Begin " Link "Das Fenster Minuten- Stunden- Tage"} @{" Slider Cron Task Priority " Link "Der Schieberegler Cron Task Prioritaet"} @{" Slider Days " Link "Das Fenster Minuten- Stunden- Tage"} @{" Slider End " Link "Das Fenster Minuten- Stunden- Tage"} @{" Slider Hours " Link "Das Fenster Minuten- Stunden- Tage"} @{" Slider Hours " Link "Die Schieberegler Stunden- Minuten"} @{" Slider Increment " Link "Der Schieberegler Schrittweite"} @{" Slider Log History " Link "Der Schieberegler Log Zeitraum"} @{" Slider Minutes " Link "Das Fenster Minuten- Stunden- Tage"} @{" Slider Minutes " Link "Die Schieberegler Stunden- Minuten"} @{" Slider Startuptime " Link "Der Schieberegler Startzeit"} @{" Special, gadget " Link "Der Knopf Spezial"} @{" Special, page " Link "Die Seite Spezial"} @{" Start TimeGuardian " Link "Das Programm TimeGuardian"} @{" Start TGScheduler " Link "Das Programm TGScheduler"} @{" Start, TGCron " Link "Wie kann ich TGCron starten?"} @{" Starts, string gadget " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" Startuptime, slider " Link "Der Schieberegler Startzeit"} @{" Stop, TGCron " Link "Wie kann ich TGCron abbrechen?"} @{" String gadget Log Path " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" String gadget Starts " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" String gadget Current " Link "Das Eingabefeld Standard- Aktuell"} @{" String gadget Days " Link "Das Eingabefeld Tage"} @{" String gadget Default " Link "Das Eingabefeld Standard- Aktuell"} @{" String gadget Hours " Link "Das Eingabefeld Stunden"} @{" String gadget Minutes " Link "Das Eingabefeld Minuten"} @{" String gadget Once a day " Link "Das Eingabefeld Einmal am Tag"} @{" String gadget Once a month " Link "Das Eingabefeld Einmal im Monat"} @{" String gadget Once a week " Link "Das Eingabefeld Einmal die Woche"} @{" String gadget Once a year " Link "Das Eingabefeld Einmal im Jahr"} @{" String gadget OnOff " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" String gadget Runtime " Link "Der Menuepunkt Voreinstellungen=>Log Pfad & Namen"} @{" String gadget Timer Interval " Link "Das Eingabefeld Zeituhr intervall"} @{" Timer Interval, string gadget " Link "Das Eingabefeld Zeituhr intervall"} @{" Timer, page " Link "Die Seite Timer"} @{" Toggle, gadgets " Link "Die Knoepfe Invers"} @{" Type, gadget " Link "Der Schalter Typ"} @{" Type, gadget " Link "Der Knopf Art"} @{" Type, radiobuttton " Link "Das Fenster Minuten- Stunden- Tage"} @{" Up, gadget " Link "Der Knopf Hoch"} @{" Use, gadget " Link "Die Knoepfe Speichern- Benutzen- Ende"} @{" Use, gadget " Link "Der Knopf Benutzen(Cron)"} @{" Window Alert " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @{" Window Command " Link "Das Fenster Befehl"} @{" Window Comment " Link "Das Fenster Kommentar"} @{" Window Days " Link "Das Fenster Minuten- Stunden- Tage"} @{" Window Event Input " Link "Das Fenster Ereigniseingabe"} @{" Window Hours " Link "Das Fenster Minuten- Stunden- Tage"} @{" Window Main " Link "Das Hauptfenster"} @{" Window Minutes " Link "Das Fenster Minuten- Stunden- Tage"} @{" Window Reminder " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @{" Window Reminder & Beep " Link "Das Fenster Erinnerung- Erinnerung & Piep- Alarm"} @EndNode @Node "Registrierungsformular" "TimeGuardianE.guide/Registrierungsformular" Registration Form ***************** To print the registration form from the program `Amiga-Guide', do the following: * Select the menu `Edit=>Mark', the mousepointer changes. * Press the left mousebutton at the beginning of the registration form and move the mouse to the bottom of the form. The selected Text will change the background colour. * Aktivate the menu `Edit=>Print Selected'. --------8<-------------------------------------8<----------------- REGISTRATION FORM Firm: ___________________________________________ First name, Name: ___________________________________________ Street: ___________________________________________ Location: ___________________________________________ Post code: ___________ Country: ___________________________________________ Telephone: _____________ e-mail: ___________________________________________ I want to become a registered user of the program package TimeGuardian and therefore paid: Germany Europe Rest of the World ---------------------------------------------------------- o Cash o 20DM o 20DM o 15US$ o 15US$ ---------------------------------------------------------- o Bank Draft o 20DM ---------------------------------------------------------- o Eurocheque o 20DM o 20DM o 15US$ ---------------------------------------------------------- o Cheque o 20DM o 40DM o 27US$ o 27US$ Please send the newest version of the above mentioned program package and my personal key file to the address above. ____________________ ___________________________ Location, Date Signature --------8<-------------------------------------8<----------------- @EndNode