home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / TOOLS / WCRON198 / warpcron.cfg < prev    next >
Text File  |  1997-08-12  |  14KB  |  325 lines
  1. #
  2. # D O N ' T   P A N I C   !
  3. #
  4. # ;-)
  5. #
  6. #
  7. # WarpCron.cfg for WarpCron version 1.98
  8. #
  9. # Date: 12 August 1997
  10. #
  11. # New features will be marked with a 'NEW'
  12. #
  13. # Here you have to configure your events.
  14. # Everything with a '#' as first char or after a value is a comment.
  15. #
  16. # Every value MUST end with a ';' !!!
  17. #
  18. # An event starts with the keyword EVENT and ends (who knows
  19. # it...) with an END; . After the EVENT follows the name of the event.
  20. # Keywords between this both keys are:
  21. #
  22. # NOTE:
  23. # =====
  24. # To make your brain clearer see examples later this document :-)
  25. #
  26. # Program       c:\demo.cmd;
  27. #               path and name of program to start, .cmd is ok
  28. #           NEW WarpCron uses 4os2 if present. That means if
  29. #               COMSPEC points to your 4os2.exe WarpCron will use it.
  30. #               And .btm-file are treatet like .cmd-files then; so just
  31. #               write a "program something.btm" and WarpCron will do the
  32. #               rest ;-)
  33. #               !no default!
  34. # Parameters    param1 param2 .. paramX;
  35. #               parameters for the program
  36. #               default: none
  37. # Type          w;
  38. #               f / w / p / d / D / k
  39. #               f = fullscreen, w = window, p = pm
  40. #               d = DOS window, D = DOS fullscreen
  41. #               k = KillEvent (kills another event)
  42. #
  43. #   ! NOTE !        You have to set "StartRelated" to "true" in order
  44. #                   to use the "k" function! See later this doc and example 7.
  45. #
  46. #               default: w
  47. # Time          12:34;
  48. #               time to run in hour:minutes format
  49. #               default: 00:00
  50. # Date          20.03.1997;
  51. #               date to start in day.month.year format
  52. #               default: none -> run it every day
  53. # RunEveryXMin  10;
  54. #               default: 0 = disabled
  55. #               run this event every X minutes...
  56. # RunEveryXHour ...or hours...
  57. # RunEveryXDay  ...or days...
  58. # RunEveryXMon  ...or months.
  59. #
  60. # DoNotRunFrom  02:00;
  61. #               default: disabled
  62. #               Don't run this event from this time...
  63. # DoNotRunUntil 05:30;
  64. #               ...until this time.
  65. #
  66. # SemPath       e:\ipc\test;
  67. #               path and name to a semaphore. When this file exist WarpCron
  68. #               will start the event and delete the file (!).
  69. #               default: none
  70. # SemDelay      10;
  71. #               wait x minutes after found the semaphore before starting event
  72. #               default: 0
  73. # DenyPath      e:\ipc\dontrun;
  74. #               do not run this event when this file exists
  75. #               default: none
  76. # Unmissable    true;
  77. #               If you shutdown WarpCron a while and this event's time passes
  78. #               WarpCron will "forget" this event.
  79. #               But if you write a "true" here WarpCron will check at startup
  80. #               if this event is missed and starts it then.
  81. #               The unmissable events are saved in the file warpcron.mis .
  82. #               Please don't edit this file.
  83. # RunAtStartup  true;
  84. #               if this is true, WarpCron will start this event at startup.
  85. #               Otherwise just leave it away ;-) or set it false.
  86. # RunAtEnd      true;
  87. #               if this is true, WarpCron will start this event at program end.
  88. #               CAUTION!
  89. #               These to keywords ignore the DoNotRunFrom, DoNotRunUntil and
  90. #               DenyPath!
  91. #
  92. # Log           true;
  93. #               false if you do not want to remark this event in the logfile
  94. #               default: true -> write it to logfile
  95. # Min           true;
  96. #               set "min" to true if you want that warpcron starts programs
  97. #               minimized. Otherwise just don't write it.
  98. # SU            false;
  99. #               false if you want to lock one of these days for this event,
  100. #               otherwise just leave it away :-)
  101. # SA            < default for all days: true -> start it on every day >
  102. # MO
  103. # TU
  104. # WE
  105. # TH
  106. # FR
  107. #
  108. # You DO NOT HAVE to specify every keyword!
  109. # Just write the keys you need!
  110. # And DO NOT FORGET: every value MUST end with a ';'!
  111. # See examples later this file.
  112. #
  113. # logic:
  114. # if you specifiy more than one RunEveryX..., then
  115. #   RunEveryXMinhas priority over RunEveryXHour over RunEveryXDay
  116. #   over RunEveryXMon.
  117. #
  118. # hints:
  119. # - yes, leap years are ok ;-)
  120. # - the default for weekdays is TRUE, so you don't have to specify
  121. #   every weekday for every event like in WarpCron 1.21/1.23
  122. # - WarpCron starts every program out of the program's directory,
  123. #   this means that WarpCron extracts the directory out of your
  124. #   PROGRAM-Statement and changes into it before starting the program.
  125. #   Some programs need this.
  126. # - if you want to start an event just on semaphore, leave the TIME and
  127. #   DATE-statement away (see example)
  128. # - The DoNotRun... statements are just for events with a RunEveryXMin
  129. #   or RunEveryXHour! They DO NOT influence semaphores or event with just
  130. #   a single time statement.
  131. #
  132. # W A R N I N G !
  133. #
  134. # !!! WarpCron deletes a semaphore after starting the event !!!
  135. #
  136. #
  137.  
  138. REG  <code>;                       # if you send me a postcard, then
  139.                                    # I'll you send a little code via email.
  140.                                    # Then the "will I get a postcard..."
  141.                                    # will change.
  142. Editor tedit.exe;                  # The editor for changing warpcron.cfg
  143.                                    # directly via key 'c'.
  144.                                    # This is quit a fast hack and seems to
  145.                                    # run with textmode editors only!
  146.                                    # If you really need a PM editor...
  147.                                    # write me and I will see what I can do ;-).
  148. # LogPath e:\logs;                 # if you want to specify a special path
  149.                                    # for the logfile
  150. # LogFile e:\logs\myWcronLog.log;  # use this if you want to use a special
  151.                                    # name for the logfile, too.
  152.                                    # Normally just for special reasons. :-)
  153. # PIDPath  e:\ipc;                 # path for the pid-file that contains the
  154.                                    # process id.
  155. # MissPath e:\ipc;                 # path for the warpcron.mis file where
  156.                                    # WarpCron stores the unmissable events.
  157. CheckConfig;                       # WarpCron will check its config file
  158.                                    # every second if it's changed.
  159.                                    # If so, it will reread it.
  160. # CfgReadSem e:\buffer\read_now;   # WarpCron will reread its config if
  161.                                    # the semaphore e:\buffer\read_now
  162.                                    # exists.
  163. # EndSem e:\buffer\end_wcron;      # WarpCron ends when this semaphore is there
  164.  
  165. SignTime 1;                        # WarpCron writes every SIGNTIME hour
  166.                                    # an hello to logfile
  167.  
  168. # StartRelated true;               # start programs as child process of warpcron.
  169.                                    # With this keyword enabled warpcron will start
  170.                                    # every program as a child. This is needed if
  171.                                    # you want to kill events with the event type "k".
  172.                                    # Be warned! With this keyword enabled every program
  173.                                    # started by warpcron and being active will be
  174.                                    # terminated if warpcron ends!
  175.                                    # I suggest to enable this keyword only if you want to
  176.                                    # use the "kill event" feature.
  177.  
  178.  
  179.                                    # Colors for the text and background.
  180.                                    # Default is lightgray on black.
  181.                                    # For background:
  182.                                    # 0 = black          1 = blue
  183.                                    # 2 = green          3 = cyan
  184.                                    # 4 = red            5 = magenta
  185.                                    # 6 = brown          7 = lightgray
  186.                                    # For textcolor same as above and:
  187.                                    # 8 = darkgray       9 = lightblue
  188.                                    #10 = lightgreen    11 = lightcyan
  189.                                    #12 = lightred      13 = lightmagenta
  190.                                    #14 = yellow        15 = white
  191.  
  192. # TextColor 7                      # default Textcolor
  193. # BackColor 1                      # Background
  194. # InfoColor 14                     # Information
  195. # WarnColor 12                     # Warnings
  196.  
  197. # NEW
  198.  
  199. # LargeScreen true;                # forces WarpCron to run in 50-lines mode
  200. # SmallScreen true;                # forces WarpCron to run in 25-lines mode
  201.  
  202. # NEW
  203. #                                  # EmailSupport: WarpCron sends you an email...
  204. # emailOnEnd   true;               # at end of program
  205. # emailOnTrap  true;               # if an error occurs
  206. # emailOnStart true;               # on start of program
  207. # emailLog     true;               # the log of the day
  208. # emailTo      you@somewhere.com;  # to who?
  209. # emailFrom    WarpCron@your.host.name; # from whom?
  210. #
  211. # NOTE!
  212. # You have to setup your sendmail system before using this feature!
  213. # WarpCron uses "sendmail.exe -af <file> -t"
  214. #
  215.  
  216. # example 1, running every 42 minutes, but not on thursday, not between 20:00
  217. # and 05:00, it is unmissable and WarpCron will NOT write this event to the
  218. # logfile
  219.  
  220. Event ex1;                         # Event-Block start with name of event
  221.    Program       e:\vp\out\test.cmd;# Program with path, *.CMD is ok!
  222.    Parameters    e:\config.sys;    # Parameters for the program
  223.    Type          f;                # w = window
  224.                                    # f = fullscreen
  225.                                    # p = pm
  226.    Time          12:09;            # first time to start
  227.                                    # WarpCron will calculate the
  228.                                    # RUNEVERYXMIN from this time up to
  229.                                    # the actual time
  230.    RunEveryXMin  42;               # run every 42 minutes, >59 is ok!
  231.    DoNotRunFrom  20:00;            # don't run it between 20:00...
  232.    DoNotRunUntil 05:00;            # ...and 05:00.
  233.    unmissable    true;
  234.    LOG           false;            # do not write to logfile
  235.    TH            false;            # do not run on thursday
  236. End;
  237.  
  238.  
  239. # example 2, running every 42 days, but not on monday and saturday,
  240. # beginning at the 20 Jan. 1997. It runs NOT if the file e:\ipc\dontrun
  241. # exists. It will run at startup and end of WarpCron.
  242.  
  243. Event ex2;
  244.   Program       cmd.exe;
  245.   Parameters    ;
  246.   Type          w;                 # window
  247.   Time          01:15;             # at 01:15
  248.   Date          20.01.1997;        # from this date every 42 days
  249.   RunEveryXDay  42;                # up to the next valid date
  250.   DenyPath      e:\ipc\dontrun     # don't run if this file exists
  251.   MO            false;             # but not on monday and
  252.   SA            false;             # saturday
  253.   RunAtStartup  true;              # WarpCron runs it at startup and
  254.   RunAtEnd      true;              # at end of WarpCron.
  255. End;
  256.  
  257. # example 3, running every 2 months, every weekday,
  258. # beginning at the 24 Aug. 1996
  259.  
  260. Event ex3;
  261.   Program       c:\something.cmd;
  262.   Type          w;                 # run as window
  263.   Time          01:15;
  264.   Date          24.08.1996;        # from this date every 3 months
  265.   RunEveryXMon  3;
  266. End;
  267.  
  268. # example 4, running every day at 3 o'clock or 15 minutes after the
  269. # semaphore 'c:\test' appears.
  270.  
  271. Event ex4;
  272.   Program       c:\something.cmd;
  273.   Parameters    ;
  274.   Type          f;
  275.   Time          03:00;             # start at 3 o'clock OR
  276.   SemPath       c:\test;           # watch this semaphore...
  277.   SemDelay      15;                # ...and run 15 minutes after it appears
  278. End;
  279.  
  280. # example 5, running every day and every two hours
  281. #
  282.  
  283. Event DOS command;
  284.   Program       command.com;       # start DOS-Command.com
  285.                                    # with no parameters
  286.   Type          D;                 # as a fullscreen session
  287.                                    # write 'd' for dos-window
  288.   Time          14:04;             # first time to start at 12 o'clock
  289.   RunEveryXHour 2;                 # every two hours
  290. End;
  291.  
  292. # example 6, running an event just on semaphore, not on time or date
  293. # but not if e:\ipc\dontrun exists
  294.  
  295. Event ex6;
  296.   Program       c:\somepath\donnow.exe; # note: there's no time-statement
  297.   Type          f;                      #       but an semaphore-statement
  298.   SemPath       c:\ipc\donnow.sem;      #       so WarpCron will start the
  299.                                         #       event just on semaphore
  300.   DenyPath      e:\ipc\dontrun;         #       but not if this file exists.
  301. end;
  302.  
  303. # example 7, a kill event. This event kills program "donnow.exe" from example 6
  304. # if it is active.
  305. # Example 6 starts "donnow.exe", and example 7 kills it at 14:25 or on a semaphore.
  306.  
  307. Event Kill event 6;
  308.  type           k;                      # type "k" = kill event
  309.  params         ex6;                    # event name to kill as parameter
  310.  time           14:25;                  # time, date etc. like in any other event
  311.  sempath        c:\ipc\killit
  312. end;
  313.  
  314. #
  315. # If you have problems, ideas, bugs or critics: email me!
  316. #
  317. # email  : jbuss@wiloyee.shnet.org
  318. # fido   : Julian Buss@2:240/5210
  319. # fax    : ++49-4103-91 92 55
  320. # BBS    :                 55 (V34)
  321. #                          54 (ISDN)
  322. #
  323. #
  324. # Eof
  325.