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