home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / business / cron092.zip / CHANGES.DOC next >
Text File  |  1993-01-01  |  5KB  |  131 lines

  1.  
  2.     Changes made to cron 0.92:
  3.     -------------------------
  4.  
  5.     - you can now re-scan the crontab file while cron is running,
  6.       instead of having to restart.  Use r/R from the cron session.
  7.  
  8.     - one of the most requested features was to have cron automatically
  9.       rescan the crontab file to pick up new changes.  I really didn't
  10.       want to do this, since the standard cron doesn't; it would also
  11.       require substantial re-working of the code.  But HEY, it was the
  12.       first day of the new year, so I said, 'What the hell!'.  So, by
  13.       cleaning up the code and adding a few lines, I was able to add
  14.       re-scanning of the crontab file every n seconds.  To use this
  15.       feature, use -r with or without an argument (seconds).  If no
  16.       argument is specified, 5 minutes is assumed.  Minimum interval is
  17.       15 seconds. Unfortunately, there is no way to have a thread
  18.       notified when a file is changed (in standard C - it could probably
  19.       be done with SOM), so I have to check every n seconds.
  20.  
  21.     - To prevent accidental termination of cron, you can now tell cron
  22.       to ignore Ctrl-C/Break messages (SIGINT) from OS/2.  When this
  23.       option (-i) is enabled, you can only terminate cron directly by
  24.       using Ctrl-Alt-Q. You can still kill the process (by sending cron
  25.       a SIGTERM), however.
  26.  
  27.     - d/D will display a list of command and arguments that are currently
  28.       defined to cron.  This is more of a debugging tool, but I thought it
  29.       might be useful.
  30.  
  31.     Changes made to cron 0.91:
  32.     -------------------------
  33.  
  34.     - lines may now be split across two lines, to make reading the file
  35.       a little easier.  As a result, a ';' is required to terminate the
  36.       cron entry
  37.  
  38.     - additional options are now available, which appear after the
  39.       optional command arguments string.  The available options are:
  40.  
  41.         ::  title="title of window"
  42.         ::  fgbg=[fg|bg]
  43.         ::  type=[def|wvio|fs|pm|vdm|wvdm]
  44.         ::  control=control_options (see below)
  45.         ::  pos=(#,#,#,#)
  46.  
  47.         [a|b|c] means choose ONE of a, b, or c
  48.  
  49.     title="title of window"
  50.  
  51.         this is the string that will be displayed in the title bar of
  52.         the window when it is visible.  If this is not specified, the
  53.         title defaults to the invocation name of the command.
  54.  
  55.     fgbg=[fg|bg]
  56.  
  57.         sessions can be created to either being in the foreground or the
  58.         background of the desktop.  The default is background.  NOTE: if
  59.         cron is not the current foreground session (it has the focus)
  60.         specifying a task as fg will cause an error, since OS/2 will
  61.         not let a background session start a foreground session (go
  62.         figure!)
  63.  
  64.             :: fg - create session as a foreground session
  65.             :: bg - create session as a background session
  66.  
  67.     type=[def|fs|wvio|pm|vdm|wvdm]
  68.  
  69.         this specifies the type of session that is to be started.  OS/2
  70.         by default will probably create the correct one - you should
  71.         only use this option to specify that a session is to be a full
  72.         screen VDM session or an OS/2 full screen session.  Choosing the
  73.         wrong value will lead to spawn errors.  Here is what the options
  74.         mean:
  75.  
  76.             :: def  - default mode, let OS/2 choose the type
  77.             :: fs   - OS/2 full screen session
  78.             :: wvio - Windowed VIO session
  79.             :: pm   - Presentation Manager Program
  80.             :: vdm  - virtual dos machine (full screen)
  81.             :: wvdm - windowed VDM
  82.  
  83.     control=control_options (see below)
  84.  
  85.         For each session, you can specify a number of options.  These
  86.         options are:
  87.  
  88.             :: vis      - window is to be visible
  89.  
  90.             :: invis    - window is to be invisible
  91.  
  92.             :: max      - start session maximized
  93.  
  94.             :: min      - start session minimized
  95.  
  96.             :: nac      - no auto close on window session - this option
  97.                           is only applicable to Windowable VIO sessions
  98.                           - it is ignored for all others.
  99.  
  100.             :: setpos   - specify screen position for the window - if
  101.                           you specify this option, you must also include
  102.                           the pos=() option.  If you don't, the window
  103.                           will have zero size, and will not be
  104.                           displayed.
  105.  
  106.         These control options can be combined using the '&' operator.  See
  107.         the below for an example.
  108.  
  109.     pos=(x,y,cx,cy)
  110.  
  111.         If you specify control=setpos, you should also specify the
  112.         screne positions. Arguments 1 and 2 specify the lower left hand
  113.         corner of the scren, and 3 and 4 speicfy the size in the x and y
  114.         directions, respectively.
  115.  
  116.     Examples:
  117.  
  118.         Let's create a crontab entry that will start a windowed dos
  119.         session at 00:15 on the first day of the first 6 months of the
  120.         year.  To really make things interesting, lets position the
  121.         screen at (50,50) and give it a width of 100 pixels, and a
  122.         height of 75:
  123.  
  124.         15 00 1 1-6 * "c:\os2\mdos\command.com" "c:\bin\test.bat"
  125.                           title="This is a test session"
  126.                           type=wvdm
  127.                           control=vis&setpos
  128.                           pos=(50,50,100,74);
  129.  
  130.  
  131.