home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Misc / TimeGuardian.lha / TimeGuardian_1,1 / doc / english / TimeGuardian.asc next >
Encoding:
Text File  |  1994-08-19  |  69.3 KB  |  1,794 lines

  1.  
  2.                     Documentation for TimeGuardian
  3.                          Version 1.1, 17.8.94
  4.                        written by Markus Matern
  5.  
  6.              translated by Markus Matern and Gerri Körner
  7.  
  8.                       Programpackage TimeGuardian
  9.                          (C)1994 Gerri Körner
  10.  
  11. This is the documentation for the package `TimeGuardian'
  12. Version 1.1, 4.7.94.
  13.  
  14.    The descriptions refers to the following programs:
  15.    * `TGCron' Version 1.43, 24.7.1994
  16.  
  17.    * `TimeGuardian' Version 1.43, 2.8.94.
  18.  
  19.  
  20. Introduction
  21. *************
  22.  
  23. Welcome to the documentation of the program package
  24. `TimeGuardian'.
  25.  
  26.    This package may be freely distributed, as long as no charges more
  27. than reasonable copying and handling fees are collected.  For any other
  28. type of distribution, you must have the written permission of the
  29. author.  This package is shareware, when you want to use the programs
  30. of this package permanently, you have to register, see How can I register
  31. for `TimeGuardian'? for further information.
  32.  
  33.    This program may be included in software collections, providing that
  34. the previous conditions are respected.
  35.  
  36.    This program package is provided without warranty of any kind. In no
  37. event will the author be liable for direct, indirect, or incidental
  38. damages resulting from any defect of the program or in its
  39. documentation. The users are hereby warned of the possibility of such
  40. damage occurences.
  41.  
  42.  
  43. What is `TimeGuardian'?
  44. ========================
  45.  
  46.    `TimeGuardian' is a program package with which you can
  47. easily start events, that have to be done at certain times or dates on
  48. your computer. You also can write log files to disk, where you can see
  49. when your computer was switched on.
  50.  
  51.  
  52. The features of `TimeGuardian'
  53. ===============================
  54.  
  55.    * easy to configure
  56.  
  57.    * Alarm
  58.  
  59.    * daily actions
  60.  
  61.    * yearly actions
  62.  
  63.    * events in time intervals
  64.  
  65.    * localized gui
  66.  
  67.    * `Installer'
  68.  
  69.    * `MUI'-GUI
  70.  
  71.    * AREXX
  72.  
  73.    * online help
  74.  
  75.  
  76. What can I do with `TimeGuardian'?
  77. ===================================
  78.  
  79. The package has two main functions, you can use seperately from each
  80. other.
  81.  
  82.    The first function it provides, is a function to save on disk every
  83. time your computer was turned on and off. You get a complete log file
  84. when anyone turned on your computer. When you want, you are able to log
  85. different projects. That means, that you see in the log files, when you
  86. wirked on a certain project, e.g. private work and business work. You
  87. can analyse these log files easily with the graphical user interface,
  88. so you get a quick overview when you spend time at your computer or at
  89. certain projects.
  90.  
  91.    The second function, that is provided by this package is a function
  92. to start actions (commands or scripts) that you want to be executed
  93. regularly or at specified dates or hours. Moreover you can start
  94. programs or scripts once a day or once a year.
  95.  
  96.  
  97. What do I need, to be able to use `TimeGuardian'?
  98. ==================================================
  99.  
  100.    When you want to use all features of the package
  101. `TimeGuardian', you need some other public domain or shareware
  102. packages, which can't be included in this package, because of different
  103. reasons.
  104.  
  105.    * OS version >= 2.0
  106.      You need a Workbench or Kickstart version greater or equal to 2.0
  107.      *by all means*. When you have not installed this two versions you
  108.      can't install this package. When you want to know, which versions
  109.      you have installed, enter in a `Shell': `version'. The result
  110.      should be like follows:
  111.      `Kickstart version 37.175, Workbench version 37.XX' or greater
  112.      numbers! You need a Workbench versioon >= 2.1 when you want to use
  113.      the localized graphical user interface!
  114.  
  115.    * `MUI' >= 2.0
  116.      You need the program package `MUI' to be able to use the graphical
  117.      user interface of the program `TimeGuardian'. You can use an
  118.      unregistered version of `MUI' when you are testing the program
  119.      package. When you want to use `TimeGuardian' regularely,
  120.      then please register for both packages `MUI' and
  121.      `TimeGuardian'. For further information on how to do this, see How
  122.      can I rgister for `TimeGuardian'? and Where can I obtain MUI?.
  123.  
  124.    * `Installer'
  125.      You need this program to install the package easily.  Many other
  126.      program packages distribute this program.  Where you can obtain
  127.      the program `Installer', see Where can I obtain `Installer'?.
  128.  
  129.    * `Amiga-Guide'
  130.      You need this program, that you can use a feature of the graphical
  131.      user interface of `TimeGuardian', the online help. When you
  132.      want to get information, on how to obtain this package, see Where
  133.      can I obtain `AmigaGuide'?.
  134.  
  135.  
  136. How can I register for `TimeGuardian'?
  137. =======================================
  138.  
  139.    That you are able to use the background program `TGCron' as
  140. long as you want, on a certain day, you need a certain file, you only
  141. get, when you register. This file containd your name and is generated
  142. for you personally. When this file is missing, you can use the program
  143. only for about one and a half hour a day.
  144.  
  145.    To obtain your personal key file, please send 20.- DM or 15.- US-$
  146. in notes and the registration form (see Registration Form) to one
  147. of the below adresses (please note, that only assigments from german
  148. users to a german bank are accepted, because the fees for assignments
  149. from foreign banks are as high as the registration fee).  When you send
  150. the money, be sure that you can't see the notes inside!  Put the notes
  151. inside the registration form.
  152.                              Gerri Körner
  153.                              Kulturenweg 6
  154.                             D-87642 Buching
  155.  
  156.                              Markus Matern
  157.                          Max-Wieland-Straße 13
  158.                            D-89134 Blaustein
  159.  
  160. You get your personal key file and the newest version of the program
  161. package on disk.
  162.  
  163.    You pay for the actual version of the program package
  164. `TimeGuardian' and have neither the pretension to get newer, nor to get
  165. enhanced program versions. You *don't* have to register again for
  166. possible new versions of this package. The personal key files will stay
  167. valid with new versions. Possible enhancements of the package will
  168. depend on the number of registrations.
  169.  
  170.    We both can't be reached via telephone the next time, so when you
  171. have questions, please send an *international reply coupon* to one of
  172. the above adresses.  The better way is to send an E-Mail to (other
  173. forms of questions unfortunately can't be answered.):
  174.  
  175.                  `Gerri.Koerner@student.uni-ulm.de' or
  176.                   `Markus.Matern@student.uni-ulm.de'.
  177.  
  178. The programs of the package `TimeGuardian'
  179. ******************************************
  180.  
  181.    The package `TimeGuardian' consists in general of two
  182. programs, you need both to run properly. They will be described later
  183. on. You need the preferences program `TimeGuardian' only, when you
  184. want to change the configuration of the "cron" (1), which is running in
  185. the background. Or you have to start the first program, when you want
  186. to analyze the files, the package writes on your disk. The second
  187. program is the cron `TGCron'. You should start it every time your
  188. computer is booting, when you want to use the package in a sensible
  189. way. See How can I install `timeGuardian'?, for further information.
  190.  
  191.    ---------- Footnotes ----------
  192.  
  193.    (1)  A cron is a programm, that starts user-specified programs or
  194. scripts at certain user-specified moments.
  195.  
  196.  
  197. The program `TimeGuardian'
  198. ===========================
  199.  
  200.    The preferences program `TimeGuardian' is designed, to help the
  201. user to modify the configuration of the background program easily. You
  202. have a graphical user interface to do this. When you want to change the
  203. configuration, just start `TimeGuardian'.
  204.  
  205.    * From Workbench: Doubleclick on the corresponding icon. When you
  206.      followed the proposals of the installation, you find the icon in
  207.      your drawer `Prefs' of your bootpartition.
  208.  
  209.    * From CLI: Just enter `<path>/TimeGuardian'. Instead of
  210.      `<path>' you have to enter the name of the drawer in which you
  211.      have installed the package `TimeGuardian'. When you
  212.      followed the proposals of the installation this is `Sys:Tools'.
  213.  
  214.    Now follows a description of the different elements of the graphical
  215. user interface and their functions. "Gadgets" are elements, that start
  216. an action immediately. They can be activated by clicking on them with
  217. the mouse or by pressing the underlined character of their name. You
  218. always have to press a single key, even when a capital letter is
  219. underlined. "Pages" are gadgets that activate more and other gadgets.
  220. Depending on the preferences of `MUI' you can see all the page-gadgets
  221. together or one after the other by activating the visible page-gadget.
  222.  
  223.  
  224. The menus of the program `TimeGuardian'
  225. ----------------------------------------
  226.  
  227.    Some program-functions can be activated with gadgets and menus. The
  228. menus are shown further on in this documentation. The functions, that
  229. are available via gadget and menu will be described at the corresponding
  230. gadgets. The menu structure of the preferences program looks like
  231. follows:
  232.  
  233.    * Project
  234.  
  235.  
  236.         - Open
  237.  
  238.         - Save as
  239.  
  240.         - --------------
  241.  
  242.         - User
  243.  
  244.         - Remove Cron
  245.  
  246.         - Iconify
  247.  
  248.         - --------------
  249.  
  250.         - Quit
  251.  
  252.    * Edit
  253.         - Reset to Defaults
  254.  
  255.         - Last Saved
  256.  
  257.         - Restore
  258.  
  259.    * Settings
  260.  
  261.  
  262.         - Create Icons?
  263.  
  264.    * Pages
  265.         - About
  266.  
  267.         - Path Setup
  268.  
  269.         - Cron Setup
  270.  
  271.         - Global Statistics
  272.  
  273.         - Daily Statistics
  274.  
  275.  
  276. The menu `Project=>Open'
  277. .........................
  278.  
  279.    This menu opens a file-requester, with which you can select a
  280. configuration file for loading.  You can choose a file saved before,
  281. with any name.  If you don't select a `TimeGuardian'-
  282. config-file an errormessage will appear. Is the file loaded
  283. succesfully, the gadgets and string gadgets will show the new
  284. configuration. Now you are able to modify, save, use, these new
  285. settings in the custom manner.
  286.  
  287.  
  288. The menu `Project=>Save as'
  289. ............................
  290.  
  291.    When you activate this menu you have the possibility to save your
  292. current settings under any name you choose. The configuration will not
  293. be saved in a way, that it is used immediataly. You have to select the
  294. gadget `Save' or `Use' when you want to do this. This menu is provided 
  295. to be able to change quickly between often used configuratons (e.g. one
  296. configuration for private work and one for business work). Each
  297. configuration has its own name, which easily can be associated with the
  298. corresponding project it is desired for. When you have activated the
  299. menu `Settings=>Create Icons?' there will be generated an icon for
  300. every configuration you save. When you want to use one of your saved
  301. configurations you have to doubleclick on the corresponding icon. This
  302. configuration is only used as long as you don't boot. When you want to
  303. use this configuration permanently, when you doubleclick the icon, then
  304. you have to change the `Tool Types:' of the icon to `ACTION=SAVE'. To
  305. do this, activate the icon (don't doubleclick it!) and select the menu
  306. `Icons=>Information..' on the Workbench. Then change the line
  307. `ACTION=USE' to `ACTION=SAVE' and press `Save'.
  308.  
  309. When you have saved a configuration without an icon you have to activate
  310. this configuration like follows: Either you load the configuration in the
  311. preferences program and press ´Use', or you enter the two following
  312. lines in a shell or a script: ´copy Name.config env:TimeGuardian.config'
  313. and ´setenv TimeGuardian.com config'. The configuration will be active
  314. until you reboot. (For a permanent change you have to press the ´Save'
  315. gadget or you enter this ´copy Name.config envarc:TimeGuardian.config'
  316. and the two lines above.)
  317.  
  318.  
  319.  
  320. The menu `Project=>User'
  321. .........................
  322.  
  323. When you activate this menu you are shown an information window, in
  324. which you can read the message
  325.  
  326.                   This TimeGuardian is registered to:
  327.  
  328.                          *Firstname Lastname*
  329.                                 Street
  330.                            Postcode Location
  331.                                 Country
  332.  
  333. when you are a registered user, or the message
  334.  
  335.                   This is a *unregistered* version of
  336.  
  337.                              TimeGuardian
  338.  
  339.                       you have to register after
  340.                     an evaluation time of 14 days!!
  341.  
  342. when you haven't registered yet. When you want to know how to register
  343. for `TimeGuardian', see How can I register for `TimeGuardian'?.
  344.  
  345.  
  346. The menu `Project=>Iconify'
  347. ............................
  348.  
  349.    When you activate this menu, the program closes the window of the
  350. graphical user interface and appears as an icon on the Workbench. When
  351. you want to reactivate the window, you have to doubleclick the icon.
  352. This menu has the similar effect like the third gadget from the right,
  353. on the top window border.
  354.  
  355.  
  356. The menu `Edit=>Last Saved'
  357. ............................
  358.  
  359.    When you activate this menu, the configuration file that you saved
  360. with the gadget `Save' will be loaded. When the file is loaded
  361. succesfully you can edit, use, save it in the common manner.
  362.  
  363.  
  364. The menu `Settings=>Create Icons?'
  365. ...................................
  366.  
  367.    When this menu has a checkmark, each time you save a configuration
  368. with the menu `Project=>Save As', an icon for the configuration will 
  369. be created.
  370.  
  371.  
  372. The page `About'
  373. -----------------
  374.  
  375.    This page shows the copyrights, the shareware reference and the
  376. reference to `MUI'. It is shown when you start `TimeGuardian' and
  377. when you make one of the folowing actions on the graphical user
  378. interface:
  379.    * Activate the gadget `About'
  380.  
  381.    * Select the menu `Pages=>About'
  382.  
  383.    * Press the keys `Amiga 1'
  384.  
  385.    * Press the keys `rAlt Space', when you are on the page `Daily
  386.      Statistics'
  387.  
  388.    * Press the keys `lAlt Space', when you are on the page `Path Setup'
  389.  
  390.  
  391. The page `Path Setup'
  392. ----------------------
  393.  
  394. This page is shown, when you make one of the folowing actions on the
  395. graphical user interface:
  396.    * Activate the gadget `Path Setup'
  397.  
  398.    * Select the menu `Pages=>Path Setup'
  399.  
  400.    * Press the keys `Amiga 2'
  401.  
  402.    * Press the keys `rAlt Space', when you are on the page `About'
  403.  
  404.    * Press the keys `lAlt Space', when you are on the page `Cron Setup'
  405.  
  406.    On this page you can select all the files and paths `TGCron'
  407. accesses. You see eight different string gadgets, in which you can
  408. enter the values on different ways:
  409.    * Click with the mouse inside the frame of the desired string gadget.
  410.  
  411.    * Press the underlined character of the desired string gadgt on the
  412.      keyboard.
  413.  
  414.    * The string gadgets are concated, press the key that you selected in
  415.      the `MUI' preferences program for concatenation (`TAB', when you
  416.      didn't change this option). Press this key so many times, that the
  417.      cursor appears in the desired string gadget. Enter the desired
  418. Command or Path on your keyboard now. In the first and the last four
  419. string gadgets the entered values will be checked. When they don't
  420. exist they will be rejected.
  421.  
  422.    * Press the gadget in the right of the string gadget. You then will
  423.      be able to select the path or command/ script with a file
  424.      requester.
  425.  
  426.    When you start `TimeGuardian' the first time, you will find some
  427. values filled in, in some string gadgets. Otherwise you will see the
  428. last saved configuration.
  429.  
  430.    Besides you see four gadgets, with which you can make different
  431. changes to the configuration.  For further information see The Gadgets
  432. Save- Use and The gadgets Default- Restore.
  433.  
  434.  
  435. The string gadget `Log Path'
  436. .............................
  437.  
  438.    In this string gadget you have to enter the drawer or partition,
  439. where the cron program shall save, when the computer has booted and how
  440. long and when it was switched on. The names of these three files you
  441. can enter in the following string gadgets.
  442.  
  443.    When you want to change the path, activate the string gadget, like
  444. described above, and enter the desired path. The path must already
  445. exist, otherwise it is rejected. When you activate the string gadget
  446. with the gadget in the right of it, a file requester pops up, where you
  447. easily can select the path.
  448.  
  449. When you press the gadget `Default' the path `Sys:Tools/' appears.
  450.  
  451.  
  452. The string gadget `Starts'
  453. ...........................
  454.  
  455.    Here you have to enter the name of the file, in which `TGCron'
  456. shall save the time, when the computer has had a reset. The file will be
  457. created in the drawer described above, when it doesn't exists. The
  458. suffix is automatically created by the program and is a period,
  459. followed by the year (in the year 1994: `.94').
  460.  
  461. When you select the gadget `Default' the file name `Logfile' appears.
  462.  
  463.    The values in the file will only show your real boot times, when you
  464. start the program `TGCron' every time your computer is booting. How
  465. you can reach this, see How can I install `TimeGuardian'?.
  466.  
  467.    When you start `TGCron' manually, you can each time you work on
  468. a certain project, start the program. You then have a protocol for this
  469. specific project. You can reach this in a second way. You start the
  470. program `TGCron' always and change the configuration for different
  471. projects. You define a configuration for a certain project and save it
  472. with the menu `Project=>Save As'. When you start working on the project
  473. you use the menu `Project=>Open' to load it. For further information,
  474. see The menu Project=>Open and The menu Project=>Save as.
  475.  
  476.    The file is saved in ASCII format and can be loaded with any editor
  477. or text viewer. A sample file named `Logfile.94', could look like this:
  478.      Wed   04-May-94 15:26
  479.      Thu   05-May-94  8:24
  480.      Thu   05-May-94 14:26
  481.      Thu   05-May-94 15:22
  482.      Thu   05-May-94 16:01
  483.  
  484. The date format can be changed, see The gadget Date format for furher
  485. information.
  486.  
  487.  
  488. The string gadget `Runtime'
  489. ............................
  490.  
  491.    Here you have to enter the file, in which `TGCron' shall save
  492. how long the computer was switched on at which dates. When the file
  493. doesn't exist, it will be created in the drawer or partition, you
  494. selected in the first string gadget on this page. The suffix is
  495. automatically created by the program and is a period, followed by the
  496. year (in the year 1994: `.94').
  497.  
  498. When you select the gadget `Default' the file name `Uptime' appears.
  499.  
  500.    The entry for a day will be written the following day, you switch
  501. your computer on. That means, when you look at this file the actual day
  502. isn't shown.
  503.  
  504.    The file is saved in ASCII format and can be loaded with every
  505. editor or text viewer. A sample file named `UpTime.94', could look like
  506. this:
  507.      Wed   04-May-94 Runtime:  2 h  47 min.
  508.      Thu   05-May-94 Runtime:  2 h  43 min.
  509.      Mon   09-May-94 Runtime:  3 h  11 min.
  510.  
  511. The date format can be changed, see The gadget Date format for furher
  512. information.
  513.  
  514.  
  515. The string gadget `OnOff'
  516. ..........................
  517.  
  518.    Here you have to enter the file, in which `TGCron' shall save
  519. the times when the computer was switched on and off. When the file
  520. doesn't exist, it will be created in the drawer or partition, you
  521. selected in the first string gadget on this page. The suffix is
  522. automatically created by the program and is a period, followed by the
  523. year (in the year 1994: `.94').
  524.  
  525. When you select the gadget `Default' the file name `OnOff' appears.
  526.  
  527.    The entry for the current "switch on" will be written to the file,
  528. the next time, the computer is switched on.  When you look at the file,
  529. the last time you switched the computer on, may be saved like follows:
  530. `System switched on:  Th 05-May-94 14:26'.
  531.  
  532.    The file is saved in ASCII format and can be loaded with any editor
  533. or text viewer. A sample file named `UpTime.94', could look like this:
  534.      System switched on:   Wed   04-May-94 17:38
  535.      Resets:  0
  536.      System switched off:  Wed   04-May-94 19:26
  537.      
  538.      System switched on:   Thu   05-May-94  8:24
  539.      Resets:  0
  540.      System switched off:  Thu   05-May-94  9:25
  541.      
  542.      System switched on:   Thu   05-May-94 14:26
  543.      Resets:  2
  544.      System switched off:  Thu   05-May-94 16:11
  545.  
  546. The date format can be changed, see The gadget Date format for furher
  547. information.
  548.  
  549.    The decision, whether the computer is switched on or had a reset, is
  550. made depending on the settings of the slider `Startuptime', see The
  551. slider Startup time, for further information.
  552.  
  553. The string gadget `Once a day'
  554. ...............................
  555.  
  556.    Here you can select a file that is executed once a day. The file is
  557. executed only once a day independent of the time, the computer is
  558. switched on. When the computer works at midnight, it will be executed
  559. short after midnight. This entry is not fit for polling at your mailbox
  560. once a day, because the time when this happens is not determined. It is
  561. intended for commands which you don't want to execute from your
  562. `Startup-Sequence' every time your computer is booting. You can make a
  563. backup once a day of important files or update your database for a fast
  564. file search.
  565.  
  566.    When you press the gadget in the right of the string gadget, a file
  567. requester pops up, where you easily can select the desired file. You
  568. can choose an executable or a script in ASCII format. When you want a
  569. script to be executed, the `S-flag' has to be set. For example the
  570. script `Once_a_day' in the drawer `S:'. Enter `protect S:Once_a_day s
  571. add' in a CLI to set this flag. You have to start commands inside
  572. scripts with their full path! You don't need the path, when you use
  573. intern commands or commands in the `C:'-directory.
  574.  
  575. A sample script may look like this:
  576.      ;Skript once a day
  577.      dir all sys: > T:.directorytree ;for fast file search
  578.      copy T:.directorytree sys:
  579.      delete T:.directorytree
  580.  
  581. The comands will be automatically started in the background. You don't
  582. have to enter anything like `run < nil: > nil: Command'. Bevor adding a
  583. command line to a script, you want to execute, try the command in a
  584. `Shell' so that you can be sure it works the intended way. When this is
  585. not successfull you can start the command from the script and redirect
  586. the output to a file: `Command > Sys:.logfile'. You can read the file
  587. `Sys:.logfile' with a text viewer or an editor to look what went wrong
  588. (you can look at this file with `type Sys:.logfile' in a `Shell', too).
  589.  
  590.  
  591. The string gadget `Once a year'
  592. ................................
  593.  
  594.    Here you can select a file, that is executed once a year. The file is
  595. executed only once a year, independent of the time, when the computer is
  596. switched on the first time in a year. When the computer works at the
  597. turn of the year, it will be executed short after midnight. You could
  598. use this entry to copy the files, the cron program produced, to another
  599. directory. In the drawer, you selected in the string gadget `Log Path',
  600. you will only find the actual files.
  601.  
  602.    When you press the gadget in the right of the string gadget a file
  603. requester pops up, where you easily can select the desired file. You
  604. can choose an executable or a script in ASCII format. When you want a
  605. script to be executed, the `S-flag' has to be set. For example the
  606. script `Once_a_year' in the drawer `S:'. Enter `protect S:Once_a_year s
  607. add' in a CLI to set this flag. You have to start commands inside
  608. scripts with their full path! You don't need the path, when you use
  609. intern commands or commands in the `C:'-directory.
  610.  
  611. An example script, that copies the files from the drawer `Sys:Tools' to
  612. a new drawer
  613. `Sys:Tools/Store' could look like this (the drawer `Store' will be
  614. created, when the drawer `Sys:Tools' already exists):
  615.      ;Script once a year
  616.      copy Sys:Tools/LogFile.?? Sys:Tools/Store quiet
  617.      delete Sys:Tools/LogFile.?? quiet
  618.      copy Sys:Tools/UpTime.?? Sys:Tools/Store quiet
  619.      delete Sys:Tools/UpTime.?? quiet
  620.      copy Sys:Tools/OnOff.?? Sys:Tools/Store quiet
  621.      delete Sys:Tools/OnOff.?? quiet
  622.  
  623. The used names and paths, are the ones, that you get, when you press the
  624. gadget `Default'. When you have chosen other names and want to use this
  625. script, then you have to modifiy the script to suit your needs.
  626.  
  627.  
  628. The string gadget `Timer interval'
  629. ...................................
  630.  
  631.    Here you can select a file that is executed in regular time
  632. intervals. This entry therefore can be used to save the project you are
  633. working on at the moment every ten minutes. The moments when this
  634. happens are always relative to the boot time, i.e. (boot time + n *
  635. interval). To change the interval see The sliders hours-
  636. minutes.
  637.  
  638.    When you press the gadget in the right of the string gadget, a file
  639. requester pops up, with which you can select the desired file. You only
  640. can change the entry in this string gadget, when you have selected
  641. `interval' or `fixed & interval' at the gadget `Type' on the page `Cron
  642. Setup'. Otherwise the gadget will be ghosted. You can select an
  643. executeable or a script in ASCII format. When you want to use a script
  644. the `S- flag' has to be set. To set this flag for the script `Example'
  645. in the directory `s:' type in a `CLI' window: `protect s:Example s add'.
  646. You have to start commands inside scripts with their full path! You
  647. don't need the path, when you use intern commands or commands in the
  648. `C:'-directory.
  649.  
  650.  
  651. The string gadget `Timer fixed'
  652. ................................
  653.  
  654.    Here you can select a "CronTab"(1) file in which is saved which
  655. programs have to be started at certain moments. This file has to be an
  656. ASCII file with a certain format, that will be described below. It is
  657. possible to use samples in this file or certain days, months, etc.
  658.  
  659.    When you press the gadget in the right of the string gadget, a file
  660. requester pops up, where you easily can select the desired file. You can
  661. only access this string gadget, when you have selected `fixed' or
  662. `fixed & interval' at the gadget `Type' on the page `Cron Setup'.
  663. Otherwise the string gadget is ghosted.
  664.  
  665. An example file could look like follows:
  666.      ; TimeGuardian CronTable
  667.      ;
  668.      ;55 23 * * * RequestChoice TimerRequest "It is  23:55 " "What else ?!"
  669.      ;
  670.      59 19 * * 1-5 s:News
  671.      ;
  672.      0,15,30,45 * * * * "newshell con:82/175/550/90/UpTime from batch:saytime"
  673.      ;
  674.  
  675. When the 1st character of a line is `;', the line will be ignored
  676. completely.  You can use this to add comments to the file or to stop
  677. executing a program for some time.  This was done in the third line. 
  678. The command `RequestChoice' won't be executed.
  679.  
  680.    Shall a file be executed at a certain moment, the line in the file
  681. must look like the folowing sample: `<Minute> <Hour> <Day> <Month>
  682. <Day_of_week> <Path/<Command|Script>>'.
  683.  
  684. The decision, whether a command is executed or not, is made by a *AND*-
  685. combination of the five time parameters. That means, that the command
  686. is only executed, when all five parameters are true.
  687.  
  688. Now follows an exact description for the different samples, set in acute
  689. parenthesis.  Some characters have a certain meaning:
  690.    - `<>':
  691.      The parameter in acute parenthesis has to  be specified.
  692.  
  693.    - `|':
  694.      The vertical bar seperates alternative parameters, which can be
  695.      used either or.
  696.  
  697.    - `[]':
  698.      The parameter in angular parenthesis can be used when you want.
  699.  
  700.    - `...':
  701.      Three periods mean, that the parameter before can be used multiple
  702.      times.
  703.    * `<Minute>'
  704.      The complete sample looks like this:
  705.      `<*|Min[[,Min]|[,Min-Min]...]|Min-Min[[,Min]|[,Min-Min]...]>'
  706.      The value for `Min' has to be choosen in the range from 0 to 59.
  707.      It follows a description of all possibilities:
  708.        1. `*':
  709.           When you use an asterisk for this parameter, th command is
  710.           executed every minute.
  711.  
  712.        2. `Min':
  713.           You can choose a moment, at which the command is executed.
  714.  
  715.        3. `Min-Min':
  716.           You can specify a range, whilst which the command is
  717.           executed. The first value for `Min' has to be smaller or
  718.           equal than the second value for `Min'.
  719.  
  720.        4. `<Min>,<Min-Min>,...,<Min>':
  721.           You can specify multiple moments and ranges seperated by
  722.           colons. The command is executed at every specified moment and
  723.           whilst the ranges.
  724.  
  725.      Example: `0,5,10,15-20,30,45-50 * * * * Command'
  726.      That would start the command every full hour, five, ten and 30
  727.      minutes after the full hour and in the range from 15 to 20 and
  728.      from 45 to 50 minutes every minute after the full hour. The
  729.      command is executed every day.
  730.  
  731.    * `<Hour>'
  732.      The complete sample looks like this:
  733.     
  734.     
  735.     
  736.      `<*|Hour[[,Hour]|[,Hour-Hour]...]|Hour-Hour[[,Hour]|[,Hour-Hour]...]>'
  737.      The value for `Hour' has to be choosen in the range from 0 to 23.
  738.      For a more precise description of the parameter `Hour' look at the
  739.      parameter `Minute' above. Both parameters have the same sample.
  740.      Example: `* 0,3,6,9,12,15,18,21 * * * Command'
  741.      That would execute the command every three hours. As an asterisk
  742.      is used for the minutes, the command is executed every minute of
  743.      these hours.
  744.  
  745.    * `<Day>'
  746.      The complete sample looks like this:
  747.      `<*|Day[[,Day]|[,Day-Day]...]|Day-Day[[,Day]|[,Day-Day]...]>'
  748.      The value for `Day' has to be choosen in the range from 1 to 31.
  749.      For a more precise description of the parameter `Day' look at the
  750.      parameter `Minute' above. Both parameters have the same sample.
  751.      Example: `* * 5-10,20-25 * * Command'
  752.      That would start the command at the fifth to 10. of a month and at
  753.      the 20. to 25. of a month. As asterisks are used for the other
  754.      parameters, the command will be executed every minute at these
  755.      days!
  756.  
  757.    * `<Month>'
  758.      The complete sample looks like this:
  759.      `<*|Mon[[,Mon]|[,Mon-Mon]...]|Mon-Mon[[,Mon]|[,Mon-Mon]...]>'
  760.      The value for `Mon' has to be choosen in the range from 1 to 12.
  761.      For a more precise description of the parameter `month' look at
  762.      the parameter `Minute' above. Both parameters have the same sample.
  763.      Example: `* * * 1,5-7 * Command'
  764.      This would start the command in the months from January to May and
  765.      in July. It will be executed every minute in these months!
  766.  
  767.    * `<Day_of_week>'
  768.      The complete sample looks like this:
  769.      `<*|DoW[[,DoW]|[,DoW-DoW]...]|DoW-DoW[[,DoW]|[,DoW-DoW]...]>'
  770.      The value for `DoW' has to be choosen in the range from 1 to 7.  1
  771.      corresponds to Monday, 7 corresponds to Sunday. For a more precise
  772.      description of the parameter `Day_of_Week' look at the parameter
  773.      `Minute' above. Both parameters have the same sample.
  774.      Example: `* * * * 1-5 Command'
  775.      This would start the command from Monday to Friday every minute,
  776.      your computer is turned on.
  777.  
  778.    * `<Path/<Command|Script>>'
  779.      Here you have to enter the command or script that shall be
  780.      executed. You always have to use the complete path. In the above
  781.      example in line seven the command `newshell' needs no path,
  782.      because this is an *internal* command, which is not loaded from a
  783.      data media. System commands, which are located in the `C:' drawer
  784.      likewise don't need a path. All other commands do.
  785.  
  786.    * examples:
  787.        1. `* * * * * "dir >> t:test sys:tools"'
  788.           This command is executed every minute.
  789.  
  790.        2. `0,30 8-16 * * 1-5 s:Gong'
  791.           This script is executed Mondays to Fridays from eight a.m. to
  792.           four o'clock p.m. every full hour and every half hour.
  793.  
  794.        3. `0 15 24 12 * execute "s:12. 24."'
  795.           This script is execute at three o'clock p.m. the 24.th of
  796.           December.
  797.  
  798.        4. `0 20 15,16 4 7 s:Example'
  799.           This script is executed the 15.th and 16.th of April at eight
  800.           o'clock p.m. (when this date is a Sunday). Of course two
  801.           successive days both can't be Sundays, but this example shall
  802.           illustrate the *AND*- combination.
  803.  
  804. When you want to start scripts, the `S- flag' of the files has to be
  805. set (to do this with the script `News', which is in the directory `S:',
  806. type the following in a `CLI': `protect s:News s add'). The second way
  807. to start a script is to use the command `execute' like in the third
  808. example (you don't have to set the `S- flag' here). You have to start
  809. commands inside scripts with their full path! You don't need the path,
  810. when you use intern commands or commands in the `C:'-directory. When
  811. you have problems with commands, not doing what you want them to do,
  812. check the commands for spaces. Try quoting the part of the command
  813. including spaces. Test the command you wish to use in a `Shell', before
  814. you use it in a script.
  815.  
  816.    ---------- Footnotes ----------
  817.  
  818.    (1)  The format is the Un*x format
  819.  
  820.  
  821. The page `Cron Setup'
  822. ----------------------
  823.  
  824. This page is shown, when you make one of the following actions on the
  825. graphical user interface:
  826.    * Activate the gadget `Cron Setup'
  827.  
  828.    * Select the menu `Pages=>Cron Setup'
  829.  
  830.    * Press the keys `Amiga 3'
  831.  
  832.    * Press the keys `rAlt Space', when you are on the page `Path Setup'
  833.  
  834.    * Press the keys `lAlt Space', when you are on the page `Global
  835.      Statistics'
  836.  
  837.    On this page you can modify the time values, that `TGCron'
  838. accesses.  Furthermore you can select the date format, the language, and
  839. which type of alarm you want to use. You see three different gadgets
  840. and four sliders. You can change the shown values in different ways:
  841.    * Slider
  842.         - Click with the mouse on a slider and move the mouse, pressing
  843.           the mouse button, to the left or to the right, the knob
  844.           follows the mouse. When you reached the desired value,
  845.           release the mouse button.
  846.  
  847.         - Press the underlined character on your keyboard: The knob
  848.           moves to the right.
  849.  
  850.         - Press the underlined character on your keyboard together with
  851.           a Shift- key: The knob moves to the left.
  852.  
  853.    * Gadgets
  854.         - Activate the gadget with a mouseclick and hold the mouse
  855.           button pressed: Select the desired entry (activation in the
  856.           text field).
  857.  
  858.         - Activate the gadget with a mouseclick: the next entry is
  859.           selected (activation in the image field or in the text field)
  860.  
  861.         - Press the underlined character on your keyboard: The next
  862.           entry is selected.
  863.  
  864.         - Press the underlined character together with a Shift- key:
  865.           The previous entry is selected.
  866.  
  867. When you start `TimeGuardian' the first time, you see the default
  868. values. Otherwise you see the last saved configuration.
  869.  
  870.  
  871. The slider `Startuptime'
  872. .........................
  873.  
  874.    With this slider you have to enter the time in minutes, your
  875. computer needs to boot, rounded to the next full minute. When your
  876. system needs for example two minutes and 30 seconds to start, you would
  877. have to enter three here. This is necessary, so that the background
  878. program can decide whether the computer is switched on or had a reset.
  879. The program decides, that the computer was switched on, when the
  880. difference between the last saved value and the actual time is greater
  881. than the value that you entered with the slider. Otherwise a reset is
  882. supposed.
  883.  
  884.  
  885. The slider `Increment'
  886. .......................
  887.  
  888.    This value is the time in minutes, when the background program
  889. saves, that the computer was still working. The smaller you make this
  890. value, the more accurate are the values in the three saved files which
  891. you can select on the page `Path Setup'. When you enter two, for
  892. example, every two minutes is saved, that the computer still is
  893. working. The greatest error which may occur at this value is then two.
  894. The greater the entered value, the inaccurate is the supposed switch
  895. off moment, as the last saved value for a running system is taken.
  896.  
  897.  
  898. The gadget `Date Format'
  899. .........................
  900.  
  901.    With this gadget you can enter nine different formats for the date,
  902. that is used, when saving the time in the different files. The format,
  903. that is used is the one, that is shown. The following formats can be
  904. selected:
  905.      `tt-mm-jj', `tt.mm.jj', `tt/mm/jj',
  906.  
  907.      `mm-tt-jj', `mm.tt.jj', `mm/tt/jj',
  908.  
  909.      `jj-mm-tt', `jj-mm-tt', `jj-mm-tt'.
  910.    Here stands `tt' for the day of the month, `mm' for the short form of
  911. the month and `jj' stands for the last two digits of the year. The
  912. short form of the month is saved in the selected language.
  913.  
  914.  
  915. The gadet `Locale'
  916. ...................
  917.  
  918.    With this gadget you can select a language for the background program
  919. `TGCron'.  The config program is *always* localized in the
  920. language that you selected in the language preferences program
  921. (certainly you need an approriate file `TimeGuardian.catalog'
  922. installed in your drawer `Locale:Catalogs/language').  The program runs
  923. in the default language english, when this file is missing, or when you
  924. use a workbench version < 2.1.  In this distribution only the default
  925. language english and german are supported.
  926.  
  927.    You can select six different settings:
  928.    * localized:
  929.      Use this when you have a localized workench and you want the files
  930.      for the time functions to be written in this language. You need
  931.      the appropriate file for your language!
  932.  
  933.    * english:
  934.      With this and the following selections, the text that is written
  935.      in the files, appears in the selected language.
  936.  
  937.    * german, french, italian, spanish:
  938.      time functions: selected language
  939.  
  940. When you are intrested, in translating the text for the graphical user
  941. interface into one of the above languages or into another, please
  942. contact one of the adresses at which you can register for the package,
  943. see How can I register for `TimeGuardian'?. When you do this (you
  944. translate the complete graphical user interface, the error messages and
  945. the text for the time functions) you will get a registered version of
  946. the package `TimeGuardian'. Please contact one of us *under
  947. any circumstances*, befor you start to translate!
  948.  
  949.  
  950. The gadget `Type'
  951. ..................
  952.  
  953.    With this gadget you can select, which type of background actions
  954. shall be executed. The program `TGCron' executes the commands/
  955. scripts `Once a year' and `Once a day' and writes the protocol files
  956. always when its necessary. This happens not depending on the following
  957. selectons. You have several possibilitys to choose:
  958.    * none:
  959.      That means, that neither the script in the string gadget `Timer
  960.      fixed' nor the command/ script in the string gadget `Timer
  961.      interval' is executed.
  962.  
  963.    * fixed:
  964.      That means, that only the script in the string gadget `Timer
  965.      fixed' is executed. You can use as many moments and commands in
  966.      this script as you want. See Das Eingabefeld Zeituhr fest, for the
  967.      contents of such a script.
  968.  
  969.    * interval:
  970.      Only the command/ script in the string gadget `Timer interval'
  971.      will be executed in the selected interval as long as the computer
  972.      is working.
  973.  
  974.    * fixed & interrval:
  975.      The two above described commands/ scripts will be executed
  976.  
  977.  
  978. The sliders `Hours'/ `Minutes'
  979. ...............................
  980.  
  981.    Here you can set the interval, in which the command/ script `Timer
  982. interval' will be executed regularly.  You have to set the minutes and
  983. hours seperately.  When you set the slider `hours' to 0 and the slider
  984. `Minutes' to 15, the command/ script will be executed every quarter of
  985. an hour. You can change these two values only, when you selected `timer
  986. & interval' or `interval' at the gadget `Type', otherwise the two
  987. sliders will be ghosted (see The gadget Type).
  988.  
  989.  
  990. The gadgets `Save'/ `Use'
  991. --------------------------
  992.  
  993.    When you press the gadget `Save' or the corresponding key on the
  994. keyboard, the program saves the current preferences in a way so that
  995. they are used immediately and after booting (The preferences are saved
  996. in the directory `ENVARC:' and `ENV:' under the name
  997. `TimeGuardian.config').
  998.  
  999.    When you press the gadget `Use' or its corresponding key- shortcut,
  1000. the preferences are saved in the drawer `ENV:' under the same name like
  1001. above. The configuration will be used immediately, but is only active
  1002. as long as the computer has no reset. When the computer boots, the
  1003. configuration is used, that you saved with the gadget `Save'. In
  1004. contrast to the standard preferences programs `TimeGuardian' is not
  1005. quit, when you press one of these two gadgets. When you want to leave
  1006. the program press the `Quit'- gadget.
  1007.  
  1008.  
  1009. The gadgets `Default'/ `Restore'
  1010. ---------------------------------
  1011.  
  1012.    When you press the gadget `Default', some default values will appear.
  1013. This are the settings, you see when you start the program the first time
  1014. after the installation.
  1015.  
  1016.    With the gadget `Restore' you can cancel the changes, that you have
  1017. made before. This works as long as you did not use one of the two
  1018. gadgets `Save' or `Use'. You will get the settings back, that you have
  1019. activated with the gadget `Use' the last time.
  1020.  
  1021.  
  1022. The page `Global Statistics'
  1023. -----------------------------
  1024.  
  1025. This page is shown, when you make one of the folowing actions on the
  1026. graphical user interface:
  1027.    * Activate the gadget `Global Satistics'
  1028.  
  1029.    * Select the menu `Pages=>Global Statistics'
  1030.  
  1031.    * Press the keys `Amiga 4'
  1032.  
  1033.    * Press the keys `rAlt Space', when you are on the page `Cron Setup'
  1034.  
  1035.    * Press the keys `lAlt Space', when you are on the page `Daily
  1036.      Statistics'
  1037.  
  1038.    On this page you find a table on which you can see at which days of
  1039. the actual year the computer was working how long. When you control
  1040. different projects with different configurations the times and dates
  1041. shown correspond to the selected configuration. In the lower field you
  1042. see the total amout of hours and days for the year. In the upper field
  1043. you see single days with the times for this day. You can move around in
  1044. the upper field of the page like follows:
  1045.    * Press the Tab key and use the keys Cursor up or Cursor down: Each
  1046.      time you press one of the keys the bar moves up or down a day.
  1047.  
  1048.    * Click with the mouse on the desired day.
  1049.  
  1050.    * Move the proportional gadget on the right side of the field and
  1051.      then click with the mouse on the desired day.
  1052.  
  1053.    * Click with the mouse on the gadgets next to the proportional gadget
  1054.      and click with the mouse on the dsired day.
  1055.  
  1056.    When you have highlighted the day, about which you want more
  1057. information, with one of the above methods, you can activate the page
  1058. `Daily Statistics' in different ways:
  1059.  
  1060.    * Enter the key Return (the highlighted day is shown)
  1061.  
  1062.    * Doubleclick with the mouse on the desired day (this works with a
  1063.      day, that isn't selected yet, too)
  1064.  
  1065.  
  1066. The page `Daily Statistics'
  1067. ----------------------------
  1068.  
  1069. This page is shown, when you make one of the folowing actions on the
  1070. graphical user interface:
  1071.    * Activate the gadget `Daily Satistics'
  1072.  
  1073.    * Select the menu `Pages=>Daily Statistics'
  1074.  
  1075.    * Press the keys `Amiga 5'
  1076.  
  1077.    * Press the keys `rAlt Space', when you are on the page `Global
  1078.      Statistics'
  1079.  
  1080.    * Press the keys `lAlt Space', when you are on the page `About'
  1081.  
  1082.    This page is devided into three areas. In the uppermost you can
  1083. select with a gadget, what you want to see from the selcted day in the
  1084. middle of the page:
  1085.    - OnOff:
  1086.      This shows, when the computer was switched on, how many resets it
  1087.      had and when it was switched off.  The accuracy of the switch off
  1088.      time depends on the settings of the slider `Increment', see The
  1089.      slider Increment, for further information.
  1090.  
  1091.    - Starts:
  1092.      Here you can see the times, when your computer had a reset.
  1093.  
  1094.    In the lowest area you see a summary of the selected day.
  1095.  
  1096. When you cannot see all entrys together, you can move the proportional
  1097. gadget the same way like on the page `Global Statistics'. To change
  1098. between the two views `OnOff' an `Starts' you can press the Space key.
  1099.  
  1100.  
  1101. The gadget `Remove Cron'
  1102. -------------------------
  1103.  
  1104.    With this gadget you can stop the background program `TGCron'.
  1105. You have to answer a requester, whether you want the program to quit or
  1106. not. When you select `Yes' `TGCron' is stopped within the next
  1107. minute. When you select `No' nothing happens, the program continues.
  1108.  
  1109.  
  1110. The gadget `Quit'
  1111. ------------------
  1112.  
  1113.    You can leave the program with this gadget. When you have changed the
  1114. preferences, but didn't save them a requester pops up. When you select
  1115. `Yes' the program is left without saving. When you select `No' or press
  1116. the Return key you're back in the program. You can save the preferences
  1117. manually and leave the program afterwards.
  1118.  
  1119.  
  1120. The online help
  1121. ----------------
  1122.  
  1123.    The online help is a feature to get easily and fast help when you
  1124. use the graphical user interface. To use this feature the
  1125. `amigaguide.library' has to be installed correctly on your system
  1126. (located in the drawer `Libs:'). When this is not true you can't use
  1127. this feature. Where you can obtain the library, see Where can I obtain
  1128. Amiga-Guide.
  1129.  
  1130.    When the above described file is installed on your computer, you can
  1131. get help about an element of the graphical user interface by moving the
  1132. mouse pointer over the corresponding element (do not click it) and
  1133. pressing the Help key afterwards. The corresponding text for the
  1134. element from this documentation will appear.
  1135.  
  1136.  
  1137. The AREXX-Port
  1138. ---------------
  1139.  
  1140. At the present version the program only supports the standard `MUI'
  1141. commands:
  1142.    * QUIT
  1143.  
  1144.    * HIDE
  1145.  
  1146.    * SHOW
  1147.  
  1148.    * INFO
  1149.  
  1150.    * HELP
  1151.  
  1152. For more information see `MUI.guide' from the distribution of `MUI'.
  1153.  
  1154.  
  1155. What do the errormessages mean ?
  1156. ---------------------------------
  1157.  
  1158.    * `Cannot quit now, still
  1159.      some asl popups opened.'
  1160.      This message appears, when you have to close a file requester,
  1161.      which was opened before, before you can leave the program
  1162.  
  1163.    * `You changed the configuration without saving
  1164.      Do you really want to quit?'
  1165.      That remembers you, that you haven't pressed the gadget `Save'
  1166.      yet. Do this before you leave the program.
  1167.  
  1168.    * `TGCron is not running!'
  1169.      The background program `TGCron' is not running yet, therefore
  1170.      the change of the configuration will have no effect! When you want
  1171.      to use the new configuration, you have to start `TGCron'.
  1172.  
  1173.    * `File already exists!
  1174.      Do you want to replace it?'
  1175.      A file you want to save, is already saved with this name. When you
  1176.      select `Yes' the old file is overwritten. When you select `No' you
  1177.      can save the file again and change the name.
  1178.  
  1179.    * `Do you want to remove TimeGuardianCron?'
  1180.      When you want to stop the background program `TGCron' select
  1181.      `Yes', otherwise `No'.
  1182.  
  1183.    * `You have to define a Log File,
  1184.      an empty string is not allowed!'
  1185.      You have not entered anything in  a string gadget, this is not
  1186.      allowed her. You have to enter a name for the file.
  1187.  
  1188.    * `Invalid config-file: *'
  1189.      The file * is not a valid config file, please select an other file.
  1190.  
  1191.    * `Could not load config-file: *
  1192.      I will use defaults instead!'
  1193.      The file * could not be opened correctly, while starting
  1194.      `TimeGuardian'. The program will use the values, you get, when you
  1195.      press the gadget `Default'. Change the configuration to suit your
  1196.      needs and press `Save' to correct the error.
  1197.  
  1198.  
  1199. Das Programm `TGCron'
  1200. ======================
  1201.  
  1202.    After setting up your preferences with `TimeGuardian', you may
  1203. start `TGCron'. According to your setup the program executes the
  1204. appropriate programs and scripts and stores the runtime information of
  1205. your computer. Its CPU usage is very low. While waiting for the next
  1206. event it uses *no* CPU power, only when beeing started and each minute
  1207. during a short moment and when it looks for an event or writes some
  1208. information to disk.
  1209.  
  1210.  
  1211. What does `TGCron' do?
  1212. -----------------------
  1213.  
  1214.    `TGCron' is designed to stay in memory all the time and run as
  1215. a background task.  It executes user defined events at predefined
  1216. moments. This means on the one hand that script files are executed, on
  1217. the other it stores by predefined precission information about the
  1218. runtime and when your computer has been booted.  It is very important
  1219. to configure `TGCron' for your personal environment, therewith it
  1220. is able to accomplish your events.  How you can do that, see The
  1221. program TimeGuardian.
  1222.  
  1223. `TGCron' searches for the following files during startup:
  1224.    * These files at every boot:
  1225.         - `*ENV:TimeGuardian.config*'
  1226.           `TimeGuardian' saves the current preferences to this
  1227.           file, `TGCron' reads them from it.
  1228.  
  1229.         - `*s:TimeGuardian.key*'
  1230.           This is your personal keyfile. You will get it when you
  1231.           become a registered user. If this file does not exist or has
  1232.           been modified, you will only be able to use `TGCron'
  1233.           about 1½h a day. How to get your key, please refer to Wie
  1234.           kann ich mich registrieren lassen?.
  1235.  
  1236.         - `[Log path]*TG_private/LastBoot*'
  1237.           The time of your last boot is stored here. Don't change
  1238.           anything here, when you want, that the values are correct in
  1239.           `[OnOff]' and `[UpTime]'!
  1240.  
  1241.         - `[Log path]*TG_private/UpTime*'
  1242.           Here is stored the time in minutes, how long your computer
  1243.           has been running on the current day. Don't change anything
  1244.           here, when you want, that the values are correct in
  1245.           `[UpTime]'!
  1246.  
  1247.         - `[Log path]*TG_private/UpDate*'
  1248.           This file contains the point of time, when your computer was
  1249.           turned off for the last time. Don't change anything here,
  1250.           when you want, that the values are correct in `[UpTime]' and
  1251.           `[OnOff]'!
  1252.  
  1253.         - `[Log path]*TG_private/Resets*'
  1254.           Here is the number of resets stored since your last startup.
  1255.           Don't change anything here, when you want, that the values
  1256.           are correct in `[OnOff]'!
  1257.  
  1258.         - `[Log path][LogFile].<yy>'
  1259.           At every startup or reset the curent time is appended to this
  1260.           file.
  1261.  
  1262.    * These files only at the first boot of a day or at midnight:
  1263.         - `[Once a day]'
  1264.           This file will be executed.
  1265.  
  1266.         - `[Log path][UpTime].<yy>'
  1267.           Once a day the full runtime of the previous day is stored
  1268.           here.
  1269.  
  1270.    * This file at a cold boot (not at a reset):
  1271.      `[Log path][OnOff].<yy>'
  1272.      The information when the computer has been turned on and how long
  1273.      is stored here during startup.
  1274.  
  1275.    * This file only at the first boot of the year:
  1276.      `[Once a year]'
  1277.      This file will be executed.
  1278.  
  1279.    * These files only if selected:
  1280.         - `[Timer fixed]'
  1281.           If you selected this at the page `Cron Setup', this file will
  1282.           be read during startup and stored internally. Then it will be
  1283.           checked every minute for a user event.
  1284.  
  1285.         - `[Timer interval]'
  1286.           If you selected this at the page `Cron Setup', this file will
  1287.           be executed at fixed intervals relative to the boottime.
  1288.  
  1289. Neither change any files in the `.../TG_private' directory nor with a
  1290. `.key' or `.config' suffix.
  1291.  
  1292.    The marks have the following meaning:
  1293.    - If a filename is marked like *this*, the filename or parts of the
  1294.      filename cannot be influenced by the user.
  1295.  
  1296.    - A filename marked like `[this]', shows that the user is able to
  1297.      configure the path/filename or path and filename at the `Path
  1298.      Setup' page. The string gadget in the configuartion program has
  1299.      the same name.
  1300.  
  1301.    - A mark like this `<yy>' means, that a suffix is appended
  1302.      automatically by program, generated from the last two digits of
  1303.      the current year.
  1304.  
  1305.  
  1306. How can I get information about `TGCron'
  1307. -----------------------------------------
  1308.  
  1309.    If you want to get further information about `TGCron', please
  1310. enter the following from the CLI (replace `<path>' by the directory
  1311. where you have installed the package to): `<Pfad>/TGCron'
  1312. There are two different possible messages, according to the fact you
  1313. have `TGCron' already started or not.
  1314.   1. `TGCron' has already been started:
  1315.      `TGCron v1.43 (24.7.1994) by G.Körner/J.Matern
  1316.      use -r option to remove...'
  1317.  
  1318.   2. `TGCron' is not running:
  1319.      `TGCron v1.43 (24.7.1994) by G.Körner/J.Matern
  1320.      use -i option to install...'
  1321.  
  1322. You can also get information about the revision and the compilation
  1323. date by using the `version'-command. Enter the following commandline:
  1324. `version full <path>/TGCron'
  1325. You should get this result: `TGCron v1.43
  1326. (24.7.1994)'.
  1327. If you don't get that, you are definitely reading the wrong
  1328. documentation.
  1329.  
  1330.  
  1331. How can I start `TGCron'?
  1332. --------------------------
  1333.  
  1334. If you didn't choose the automtic startup option during installation,
  1335. you have two different options to start `TGCron' by hand:
  1336.   1. Start from CLI
  1337.      To start it from CLI please enter the following:
  1338.      `<path>/TGCron -i'
  1339.      As `TGCron' does not detach from your CLI, you have to use
  1340.      the `run' command to get your shell back after startup as follows:
  1341.      `run < nil: > nil: <path>/TGCron -i'.
  1342.      Replace <path> by the directory you have the
  1343.      `TimeGuardian' package installed to.
  1344.  
  1345.   2. Workbench startup
  1346.      If you want to start `TGCron' from your Workbench, just
  1347.      doubleclick its icon.
  1348.  
  1349. When you try to start the program, but it is already running, you will
  1350. get the following results:
  1351.    - At the CLI:
  1352.      You will get the message: `TGCron is already running'
  1353.      This shows that `TGCron' is already running and you cannot
  1354.      restart it again.
  1355.  
  1356.    - At the workbench
  1357.      You will get a requester asking you: `Do you want to remove
  1358.      TimeGuardianCron?'
  1359.      If you want to remove it, click on `*Yes*' or press Return.
  1360.      Choosing `No' or pressing Escape does not affect `TGCron' and
  1361.      it keeps on running. Regardless, what you choose, it won't be
  1362.      started again!
  1363.  
  1364.  
  1365. How can I stop `TGCron'?
  1366. -------------------------
  1367.  
  1368. If `TGCron' is already running, you have three options to remove
  1369. it:
  1370.   1. From CLI:
  1371.      Please enter the following command: `<path>/TGCron -r'
  1372.      Replace <path> by the directory you have the
  1373.      `TimeGuardian' package installed to. Then you will get the
  1374.      message: `TGCron will be removed after next time interval'.
  1375.      The end of the time interval is normally the next full minute.
  1376.  
  1377.   2. At the Workbench:
  1378.      Just doubleclick its icon. You will get a requester asking you:
  1379.      `Do you want to remove TimeGuardianCron?'
  1380.      If you want to remove it, click on `*Yes*' or press Return.
  1381.      Choosing `No' or pressing Escape does not affect `TGCron' and
  1382.      it keeps on running. You won't get any further messages, but as
  1383.      similar as removing it from CLI it will quit after the next full
  1384.      minute.
  1385.  
  1386.   3. Start `TimeGuardian' and press the `Remove Cron' button,
  1387.      refer to Der Knopf Cron entfernen for detailed information.
  1388.  
  1389.  
  1390. What do the error messages mean?
  1391. ---------------------------------
  1392.  
  1393. You can get the following error messages from `TGCron':
  1394.    * `Invalid .config file. Use TimeGuardian to create a new one!'
  1395.      `TGCron' reads data from the file `env:TimeGuardian.config',
  1396.      but it was changed or corrupted and is not valid any more. Start
  1397.      `TimeGuardian', enter a new configuration and store it with
  1398.      the `Save' button.
  1399.  
  1400.    * `Could not open env:TimeGuardian.config!
  1401.      Use TimeGuardian to create it'
  1402.      Start `TimeGuardian', enter your configuration and store it
  1403.      with the `Save' button.
  1404.  
  1405.    * `Could not open locale, please check configuration!
  1406.      Using english instead'
  1407.      You selected `localised' at the `localisation' switch, but the
  1408.      program is not able to find the corresponding files in
  1409.      `Locale:languages/your_country/TimeGuardian.catalog' (replace
  1410.      `your_country' by the name of the locale your computer is running
  1411.      with), therefore it will use english as a default. To get rid of
  1412.      this message, install the needed .catalog file or select one of
  1413.      the hard coded languages, `english' for example.
  1414.  
  1415.    * `Your evaluation time has expired for today,
  1416.      Please consider registering !!'
  1417.      You have reached the end of your evaluation time for `TGCron'
  1418.      as an unregistered user. You cannot restart it again on this day.
  1419.      If you want to use the package unlimited, please become a
  1420.      registered user, look at Wie kann ich mich registrieren lassen?
  1421.      for detailed information.
  1422.  
  1423.    * `CronParser ERROR:
  1424.      Wrong number of Arguments in CronTable line:
  1425.      CronTab_line
  1426.      Please correct it!'
  1427.      The displayed `CronTab_line' from the file that you have choosen
  1428.      at the string gadget `Timer fixed', contains too much or not
  1429.      enough entries. Correct the line to get rid of this requester,
  1430.      because it will be shown again and again. For detailed information
  1431.      on the CronTab, refer to Das Eingabefeld Zeituhr fest.
  1432.  
  1433.    * `CronParser ERROR:
  1434.      Bad entry '*' in CronTable line:
  1435.      CronTab_line
  1436.      Please correct it!'
  1437.      The entry '*' in the `CronTab_line' is not valid. Correct the line
  1438.      to get rid of this requester, because it will be shown again and
  1439.      again. For detailed information on the CronTab, refer to Das
  1440.      Eingabefeld Zeituhr fest.
  1441.  
  1442.    * `CronParser ERROR:
  1443.      Value * out of range (*...*)
  1444.      Please search for commandline and fix it !'
  1445.      The number after `Value' is not in the range, that is shown in
  1446.      paranthesis. For detailed information on the CronTab, refer to Das
  1447.      Eingabefeld Zeituhr fest.
  1448.  
  1449.    * `CronParser ERROR:
  1450.      Range *-* out of range (*...*)
  1451.      Please search for commandline and fix it !'
  1452.      The range after `Range' has to be in the range that is shown in
  1453.      parenthesis. For detailed information on the CronTab, refer to Das
  1454.      Eingabefeld Zeituhr fest.
  1455.  
  1456.  
  1457. Where do I get the support programs?
  1458. *************************************
  1459.  
  1460.  
  1461. Where can I obtain `MUI'?
  1462. ==========================
  1463.  
  1464.    You can get `MUI' directly from the author, where you get a
  1465. registered version, and can use all the features of the `MUI' graphical
  1466. user interface (see Where can I register for MUI?). Or you
  1467. obtain the `Fish-Disks 967/968' from your local public domain dealer or
  1468. the `Aminet'.
  1469.  
  1470.    When you think, it is not worth to install `MUI', because of one
  1471. single program, this may be correct. But the background program
  1472. `TGCron' doesn't use `MUI' at all. Only the preferences program uses it
  1473. for its graphical user interface. So `MUI' is not started all the time 
  1474. but only when you want to change the configuration. So you can install
  1475. this package even on computers with little menmory, because you don't
  1476. need `MUI' all the time.
  1477.  
  1478.    When you have not installed `MUI' yet, you have to do this before the
  1479. installation of `TimeGuardian' by all means, as the
  1480. installation will be aborted otherwise. See How can I 
  1481. install `TimeGuardian'?, for further information.
  1482.  
  1483.  
  1484. Where can I obtain `Installer'?
  1485. ================================
  1486.  
  1487.    For the easy installation of the program package, you need the
  1488. program Installer from C*mm*d*re. When you have this program not
  1489. installed on your computer, you can obtain it on different ways.
  1490.  
  1491.    * With the Workbench 2.0/2.1/3.0
  1492.  
  1493.    * On the `Fish-Disk 870'
  1494.  
  1495.    * On the distribution of `MUI'.
  1496.  
  1497.    * On most distributions of commercial software
  1498.  
  1499.  
  1500. Where can I obtain `Amiga-Guide'?
  1501. ==================================
  1502.  
  1503.    When you want to use the "online help", you need the
  1504. `amigaguide.library' in your `LIBS:'-drawer (see The online help). You
  1505. don't need it to run the package `TimeGuardian', but won't be
  1506. able to use the online help feature.
  1507.  
  1508. The `amigaguide.library' is on the `Fish-Disk 870' and is distributed
  1509. with Workbench version 3.0.
  1510.  
  1511.  
  1512. How can I install `TimeGuardian'?
  1513. **********************************
  1514.  
  1515.    This chapter describes the installation of the package
  1516. `TimeGuardian'. When you want to install other packages, not included
  1517. in this distribution, look in the corresponding distributions for 
  1518. installing them.
  1519.  
  1520. You have two possibilities to install the package
  1521. `TimeGuardian'. You should use the first one:
  1522.  
  1523.  
  1524. The installation with `Installer'
  1525. ==================================
  1526.  
  1527. You have two choices to start the installation script:
  1528.   1. Doubleclick with the mouse the icon `TG.install.deutsch':
  1529.      The installation starts. The text appears german. When you want to
  1530.      use the geramn text please read the german documentation.
  1531.  
  1532.   2. Doubleclick with the mouse the icon `TG.install.english':
  1533.      The installation starts. The text appears in english.
  1534.  
  1535. Now follows a step by step description of the installation:
  1536.    * At the beginning you have the possibility to choose the user level
  1537.      for the installation. When you select `Novice' you won't be able
  1538.      to select anything more. You cannot control, where the package is
  1539.      installed.  All files which are necessary to work corretly will be
  1540.      copied, and the preferences program will be started.  At the end
  1541.      you get a summary about what was saved to which location.  To quit
  1542.      the installation you have to leave the preferences program.
  1543.  
  1544.      When you want to install the package press `Proceed With Install'.
  1545.      With `Help...' you get some information.
  1546.  
  1547.    * When you select the user level `EXPERT' you can choose whether you
  1548.      want to install the package (`Install for Real') or whether you
  1549.      just want to test the installation script (`Pretend to Install').
  1550.  
  1551.      Furthermore you can choose, whether all actions are logged or not.
  1552.      You can write the file
  1553.      `Sys:TGInstall.e.log' to disk (`Log File'), you can print the
  1554.      results (`Printer') or you can suppress a log file (`None').
  1555.  
  1556.      The installation is continued with `Proceed'.
  1557.  
  1558.    * The installation checks, whether `MUI' is installed with the
  1559.      correct version. When this is not true it is aborted.
  1560.  
  1561.    * Now you can choose what you want to install.
  1562.      The first gadget means, that only the necessary programs and
  1563.      config files are copied.
  1564.      The second gadget means the documentation. Here are three files at
  1565.      the moment:
  1566.         - The file `TimeGuardian.dvi', that you can print or
  1567.           view, when you have installed TeX.
  1568.  
  1569.         - The file `TimeGuardian.guide', that you can read with
  1570.           `AmigaGuide'. This file contains the information for the
  1571.           online help. This file is always copied, when the file
  1572.           `Libs:amigaguide.library' is installed on your system.
  1573.  
  1574.         - The file `TimeGuardian.asc', you can read with any
  1575.           text viewer or editor, or that you can print.
  1576.  
  1577.    * When you have activated the first gadget:
  1578.         - You are asked, if the background program `TGCron' should
  1579.           be started every time the computer is booting.
  1580.  
  1581.         - When you answered the last question with `Yes', the program
  1582.           checks whether this is possible on your system.
  1583.  
  1584.         - When multiple possibilities exist, to start the background
  1585.           program, you can select which of them you prefer. When you
  1586.           select `From CLI (user-startup)' the file `S:user-startup'
  1587.           will be changed in an appropriate way. When you select `From
  1588.           WB (WBStartup)' the icon of the progam `TGCron' is
  1589.           copied to the drawer `Sys:WBStartup'. Users, that work mainly
  1590.           on the workbench should use the second possibility.
  1591.  
  1592.         - Now you can choose, where the programs shall be copied to. The
  1593.           installation makes a proposal. When you want a new drawer for
  1594.           the package created, select `Make New Drawer...', otherwise
  1595.           choose an existing one.
  1596.  
  1597.         - You can continue with the button `Proceed'.
  1598.  
  1599.         - Even if you did not select the documents to be installed the
  1600.           file
  1601.           `TimeGuardian.guide' will be copied, when the file
  1602.           `Libs:amigaguide.library' is installed. When this is not true
  1603.           a message appears, that you won't be able to use the online
  1604.           help.
  1605.  
  1606.    * When you have selected the second gadget:
  1607.         - You now have to choose a drawer where the documents shall be
  1608.           copied to. The program suggests a subdirectory, in the
  1609.           drawer, where you copied the programs to.
  1610.  
  1611.         - The file `TimeGuardian.guide' is only copied, when
  1612.           the file `Libs:amigaguide.library' is installed on your
  1613.           system. When this is not true a message appears, that you
  1614.           won't be able to use the online help.
  1615.  
  1616.    * When you have installed the programs you now can decide, whether
  1617.      you wish to start the preferences program `TimeGuardian'.
  1618.      Start the program with selecting `Yes'. Change the configuration
  1619.      to suit your needs and press the gadget `Save' before you leave
  1620.      the program with the gadget `Quit'. When you don't start the
  1621.      program, you have to answer a message, that you will have to start
  1622.      the preferences program later on. Select `Proceed' here to leave
  1623.      the installation correctly.
  1624.  
  1625.    * When you have left the preferences program or you answered the
  1626.      message, the installation is complete and the last message appears.
  1627.  
  1628.  
  1629. The installation without `Installer'
  1630. =====================================
  1631.  
  1632. To install the package without the `Installer' please follow these
  1633. steps:
  1634.   1. Open a `Shell' window (doubleclick the icon `Shell' in the drawer
  1635.      `System' of your boot partition).
  1636.  
  1637.   2. Please enter `version libs:muimaster.library'. You should get this
  1638.      result:
  1639.      `libs:muimaster.library 7.973'. When you get a smaller number or
  1640.      `object not found', you have to install `MUI' version 2.0 or
  1641.      greater before you can continue.
  1642.  
  1643.   3. When you want to install the package in a drawer, that already
  1644.      exists, please enter `cd drawer' (instead of drawer please use the
  1645.      name of the directory). When you want to copy the files to a new
  1646.      drawer, then you have to create it with the command `makedir
  1647.      drawer', then change to this drawer with `cd drawer' (please use
  1648.      the name of the new directory instead of drawer in the two command
  1649.      lines, e.g. TimeGuardian).
  1650.  
  1651.   4. Now put the disk with the package into any drive (when you have
  1652.      copied the files already to your hard disk then enter: `assign
  1653.      TimeGuardian: sourcedrawer', where
  1654.      sourcedrawer is the drawer, where the files are on your hard disk).
  1655.  
  1656.   5. To copy the programs enter: `copy TimeGuardian:bin/#? ""'.
  1657.      Some messages appear, which files have been copied already.
  1658.  
  1659.   6. When you want to copy the locale files (only german available at
  1660.      the moment) please enter:  `copy
  1661.      TimeGuardian:Catalogs/deutsch/#? Locale:Catalogs/deutsch'. You
  1662.      should get a message about a copied file.
  1663.  
  1664.   7. When you want to copy the english documentation files please enter
  1665.      `copy TimeGuardian:doc/english/#?  Help:english'.
  1666.  
  1667.   8. Please enter `copy TimeGuardian:env/#?  envarc:' and `copy
  1668.      TimeGuardian:env/#?  env:' now.
  1669.  
  1670.   9. Please enter `copy TimeGuardian:s/#? s:'.
  1671.  
  1672.  10. When the background program shall be started, while booting, please
  1673.      enter:
  1674.         - start from Workbench:
  1675.           `copy TimeGuardian:bin/TGCron.info Sys:WBStartup'
  1676.           Open the drawer `WBStartup' on the Workbench and click at the
  1677.           icon `TGCron'. Activate the menu `Icons=>Information...'
  1678.           or press the keys Amiga i. A window should pop up. Now enter
  1679.           in the string gadget `Default Tool:': `path/TGCron' (you
  1680.           have to replace path with the full path, where you copied the
  1681.           programs to). Leave the window with the gadget `Save'.
  1682.           or:
  1683.  
  1684.         - start from user-startup:
  1685.           Add the following lines to the file `s:startup-sequence' or
  1686.           `s:user-startup': `run < nil: >nil: path/TGCron' (you
  1687.           have to replace path with the full path, where you copied the
  1688.           programs to). You can do this with the help of an  editor.
  1689.  
  1690.  11. When you want to start the preferences program from the same
  1691.      drawer as the standard preferences programs then enter:  `copy
  1692.      TimeGuardian:bin/TimeGuardian.info
  1693.      Sys:Prefs'. You have to change the `Default Tool:' like described
  1694.      above at step 10 (from Workbench). Enter the name
  1695.      `path/TimeGuardian' instead of `path/TGCron'!
  1696.  
  1697.  12. To use your personal configuration start the program
  1698.      `TimeGuardian' and leave it with the gadget `Save'.
  1699.  
  1700.    It may be, that you run into problems with this above described
  1701. installation. This can be, when the assign `Help' and the drawer
  1702. `Help:english' don't exist. You can copy the documentation files to any
  1703. other drawer you want. You have to change the file
  1704. `Envarc:AmigaGuide/path' and `Env:AmigaGuide/path' so, that the drawer,
  1705. where you copied the file `TimeGuardian.guide' to, is
  1706. searched. E.g. add the line `dh0:docs' when you copied the above file
  1707. to the drawer `dh0:docs'.
  1708.  
  1709.  
  1710. What is `MUI'?
  1711. ***************
  1712.  
  1713.    `MUI' is program package for users and developpers, that makes a
  1714. graphical user interface available to the programmer and user, with many
  1715. features. `TimeGuardian' ist not able to run without  `MUI'.
  1716. More precise, the preferences program `TimeGuardian'! Therefore
  1717. you have installed `MUI' already or you have to do it before the
  1718. installation of `TimeGuardian'. Where you can obtain `MUI',
  1719. see Where can I obtain MUI?.
  1720.  
  1721.  
  1722. Where can I register for `MUI'?
  1723. ================================
  1724.  
  1725.                          This application uses
  1726.                        MUI - MagicUserInterface
  1727.                 (C) Copyright 1993/94 by Stefan Stuntz
  1728.  
  1729.      `MUI' is a system to generate and maintain graphical user
  1730.      interfaces. With the  aid  of  a  preferences program, the user of
  1731.      an application has the ability to customize the outfit according
  1732.      to his personal taste.
  1733.  
  1734.      `MUI' is distributed as shareware. To obtain a complete package
  1735.      containing lots of examples and more information about
  1736.      registration please look for a  file  called  `muiXXusr.lha'  (XX
  1737.      means the latest version number) on your local bulletin boards or
  1738.      on public domain disks.
  1739.  
  1740.           If you want to register directly, feel free to send
  1741.  
  1742.                         DM 30.-  or  US-$ 20.-
  1743.  
  1744.                                   to
  1745.  
  1746.                              Stefan Stuntz
  1747.                        Eduard-Spranger-Straße 7
  1748.                              80935 München
  1749.                                 GERMANY
  1750.  
  1751.  
  1752. Registration Form
  1753. ******************
  1754.  
  1755.      --------8<-------------------------------------8<-----------------
  1756.      
  1757.      REGISTRATIONS-FORM
  1758.      
  1759.      
  1760.          Firm:              ___________________________________________
  1761.      
  1762.          First name, Name:  ___________________________________________
  1763.      
  1764.          Street:            ___________________________________________
  1765.      
  1766.          Location:          ___________________________________________
  1767.      
  1768.          Post code:         ___________
  1769.      
  1770.          Country:           ___________________________________________
  1771.      
  1772.          Telephone:         _____________
  1773.      
  1774.      
  1775.      I want to become a registered user of the program package TimeGuardian
  1776.      and therefore
  1777.      
  1778.          o sent 20.- DM in notes.
  1779.      
  1780.          o sent 15.- US-$ in notes.
  1781.      
  1782.      
  1783.      Please send me the newest version of the above program package and my
  1784.      personal key file to the above address.
  1785.      
  1786.      
  1787.      
  1788.          ____________________              ___________________________
  1789.             Location, Date                         Signature
  1790.      
  1791.      
  1792.      --------8<-------------------------------------8<-----------------
  1793.  
  1794.