home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / ts9412.zip / TS.DOC < prev    next >
Text File  |  1994-12-03  |  8KB  |  205 lines
  1.  
  2.  
  3.                              Task Scheduler
  4.                              By Curt Bates
  5.                                  v94.12
  6.  
  7.  
  8.  
  9.                                 Overview
  10.  
  11.     Task Scheduler (TS.EXE and TS2.EXE, referred to as TS) are utility
  12.     programs designed to schedule tasks to run.  TS.EXE is a DOS
  13.     program, and TS2.EXE is an OS/2 Full Screen program.  I wrote TS
  14.     because I needed a non-PM based scheduler to use with TSHELL.
  15.  
  16.  
  17.  
  18.                          Important Information
  19.  
  20.     This software is freeware.  However, If you find the programs useful
  21.     a contribution of $10 would be very much appreciated. Every little
  22.     bit helps. Contributions should be sent to the author at the mailing
  23.     address given at the end of this section.
  24.  
  25.     The author grants all recipients of this software and documentation
  26.     permission to freely copy and use it.  Permission to distribute the
  27.     software to others is also granted on the condition that this
  28.     "IMPORTANT INFORMATION" section is included in its entirety as part
  29.     of any such transfer and as long as no additional conditions are
  30.     added.
  31.  
  32.     DISCLAIMER : Please note that this software is provided on an as-is
  33.     basis.  The author does not warrant that the functions contained in
  34.     this software will meet your requirements or that the operation of
  35.     the software will be uninterrupted or error free.  The author will
  36.     not be liable for any loss of profit, data, or use of the software,
  37.     or special, incidental, or consequential damages, or other similar
  38.     claims, even if the author has been advised of the possibility of
  39.     such damages.  With any software, it is good practice to test it on
  40.     your own equipment, using non-critical data, before considering it
  41.     for day-to-day use.
  42.  
  43.     Inquiries, complaints, suggestions for improvement, and
  44.     contributions may be directed to the author via OS/2 Shareware BBS
  45.     E-Mail or by letter.  The appropriate addresses are :
  46.  
  47.  
  48.     OS/2 Shareware BBS ID   :       Curt Bates
  49.  
  50.     Mailing Address :               Curt Bates
  51.                                     717 Cypress Dr.
  52.                                     Pacific MO 63069
  53.  
  54.  
  55.  
  56.  
  57.                               Installation
  58.  
  59.     Create a subdirectory on the drive you want to install TS.  Copy all
  60.     the files into the directory.  Start TS by typing TS or TS2
  61.     (depending on wether you are using DOS or OS/2).
  62.  
  63.  
  64.  
  65.                              Program Usage
  66.  
  67.     TS is a menu driven program.  It only one menu with the following
  68.     choices:
  69.  
  70.         Add
  71.         ---
  72.         This option allows you to add a task to the scheduler.  WHile
  73.         you choose this option, you will be presented with the following
  74.         panel:
  75.  
  76.         ╔═══════════════════════════════════════════════════════════════╗
  77.         ║                                                               ║
  78.         ║ Date     :                                                    ║
  79.         ║                                                               ║
  80.         ║ Time     :                                                    ║
  81.         ║                                                               ║
  82.         ║ Frequency:   (Daily, Weekly, Monthly, Other)                  ║
  83.         ║                                                               ║
  84.         ║ Interval :                                                    ║
  85.         ║                                                               ║
  86.         ║ Command  :                                                    ║
  87.         ║                                                               ║
  88.         ╚═══════════════════════════════════════════════════════════════╝
  89.  
  90.         This panel has the following fields:
  91.  
  92.             Date
  93.             ----
  94.             This is the Date to schedule the task for its first
  95.             execution.
  96.  
  97.             Time
  98.             ----
  99.             This is the Time to schedule the task for its first
  100.             execution.
  101.  
  102.             Frequency
  103.             ---------
  104.             This is the frequency to execute the task at.  Valid options
  105.             are:
  106.  
  107.                 D   Daily - Execute this task once a day at the time
  108.                     specified.
  109.                 W   Weekly - Execute this task once a week starting with
  110.                     the date and time specified.
  111.                 M   Monthly - Execute this task once a month starting
  112.                     with the date and time specified.
  113.                     NOTE: This is a proper month.  If a task is to run
  114.                     on the Fifth, then it will run on the fifth every
  115.                     month.
  116.                 O   Other - Execute this task based on the number of
  117.                     hours specified by the Interval, see below.
  118.  
  119.             Interval
  120.             --------
  121.             This field is only used if a Frequency of Other is
  122.             specified.  It is the number of hours between executions of
  123.             the Task.  IE: If the Interval is 1, the Task will be
  124.             executed once an hour.
  125.  
  126.             Command
  127.             -------
  128.             This is the command to be executed.  It is passed to the
  129.             operating system for execution.
  130.  
  131.  
  132.         Edit
  133.         ----
  134.         Edits the currently highlighted task using the same panel as
  135.         ADD.
  136.  
  137.         Delete
  138.         ------
  139.         Deletes the currently highlighted Task.
  140.  
  141.         Save
  142.         ----
  143.         Saves the Tasks to a file.
  144.  
  145.         Quit
  146.         ----
  147.         Saves the Tasks and exits the program.
  148.  
  149.  
  150.  
  151.                   Usage Considerations and Limitations
  152.  
  153.     1)  TS will schedule up 99 tasks.  It can only process 3 or 4 per
  154.         minute (depending on your machine).  So don't schedule a lot of
  155.         tasks for the same time, or some could be skipped.
  156.  
  157.     2)  To make best use of the OS/2 environment you should use the
  158.         START command to run the tasks.  If you don't use the START
  159.         command, TS will wait until the task finishes before continuing
  160.         execution.  Again, without START, other tasks could be skipped.
  161.  
  162.     3)  When TS executes a task, it calculates the next time the task
  163.         should run. It then updates the task to reflect the date and
  164.         time of the next run.
  165.  
  166.     4)  TS maintains it tasks list in sorted order based on next run
  167.         time.  When you add a task, it places it in the list based on
  168.         the next run time.
  169.  
  170.     5)  If you add a task and use a previous date or time, TS will
  171.         calculate the next run time and add the task accordingly.
  172.         You can not schedule tasks in the past.
  173.  
  174.     6)  Any tasks that are skipped while TS is not running, will be
  175.         moved forward and rescheduled.
  176.  
  177.     7)  When Adding and Editing a Task, TS is not monitoring tasks for
  178.         execution, so a task could be skipped.  If you are adding or
  179.         editing a lot of tasks, finish the scheduling the tasks, save
  180.         the database, and exit TS.  When you restart TS, it will check
  181.         all Tasks for proper scheduling.
  182.  
  183.     8)  Minimum time to reschedule a task is 1 hour.  IE: You can not
  184.         setup a task to repeat every 15 minutes.  To do this, setup 4
  185.         tasks 15 minutes apart to run once an hour. (This could change
  186.         if enough people want it.)
  187.  
  188.     9)  TS only handles re-occuring tasks.  To handle scheduling a task
  189.         for a single execution, see the enclosed REXX program AT.
  190.  
  191.  
  192.  
  193.                             Program History
  194.  
  195.     Version         Description
  196.     v94.11          Initial Version
  197.     v94.12          Fixed Bugs in Time entry.
  198.                     Added Task execution logging.
  199.                     Corrected errors in documentation
  200.                     Fixed bug with some tasks being skipped (This was
  201.                     one reason for the log).  If a task's time passes
  202.                     without the task being executed, it will be on the
  203.                     next scan.
  204.  
  205.