home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / c / cals2-0.zip / CALSCHED.DOC < prev    next >
Text File  |  1993-01-24  |  13KB  |  366 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.   ````````````````````````````````````````````````````````````````````````````
  18.   ````````````````````````````````````````````````````````````````````````````
  19.   ``                                                                        ``
  20.   ``                                                                        ``
  21.   ``                                                                        ``
  22.   ``                                                                        ``
  23.   ``                                                                        ``
  24.   ``                                                                        ``
  25.   ``                                                                        ``
  26.   ``                                                                        ``
  27.   ``                                                                        ``
  28.   ``                                                                        ``
  29.   ``                                                                        ``
  30.   ``                           "C A L S C H E D"                            ``
  31.   ``                                                                        ``
  32.   ``                                 v2.0a                                  ``
  33.   ``                                                                        ``
  34.   ``                       THE SCHEDULED EVENT TIMER                        ``
  35.   ``                                                                        ``
  36.   ``                           RELEASED SHAREWARE                           ``
  37.   ``                                                                        ``
  38.   ``          ENTIRE WORK COPYRIGHTED (C)1993 BY MICHAEL S. HOENIE          ``
  39.   ``                                                                        ``
  40.   ``                          ALL RIGHTS RESERVED                           ``
  41.   ``                                                                        ``
  42.   ``           Written, Designed & Programmed by Michael S. Hoenie          ``
  43.   ``                                                                        ``
  44.   ``                                                                        ``
  45.   ``                                                                        ``
  46.   ``                                                                        ``
  47.   ``                                                                        ``
  48.   ``                                                                        ``
  49.   ``                                                                        ``
  50.   ````````````````````````````````````````````````````````````````````````````
  51.   ````````````````````````````````````````````````````````````````````````````
  52.  
  53.  
  54.  
  55.  
  56.  
  57. 0.0 DOCUMENTATION CONTENTS.
  58.  
  59.  
  60.     0.0 DOCUMENTATION CONTENTS.
  61.           this section of the documentation.
  62.  
  63.     1.0 INTRODUCTION.
  64.           explains what CALSCHED is and what it does.
  65.  
  66.     1.1 CALSCHED FEATURES.
  67.  
  68.     2.0 SOFTWARE DISCLAIMER AND SHAREWARE NOTICE.
  69.           shareware description, copyright notices.
  70.  
  71.     3.0 COPYRIGHTED NOTICES.
  72.  
  73.     4.0 CALSCHED MODULE HARDWARE SPECIFICATIONS.
  74.           effectivly playing CALSCHED, dos and memory configurations,
  75.           graphics config, monitor functions, 8mhz-4mhz differences.
  76.  
  77.     4.1 MODIFYING YOUR "SCHEDULE.DAT" SCHEDULE FILE.
  78.  
  79.     5.0 INITALIZING CALSCHED.
  80.           CALSCHED path, CALSCHED directory.
  81.  
  82.     6.0 COMMAND LINE PARAMETERS.
  83.           listing of all command line variables available to you.
  84.  
  85.     7.0 AUTHOR FEEDBACK.
  86.           us-mail drop, bbs contact, bbs-network, how to get in touch
  87.           with the author, list of boards where CALSCHED code files and
  88.           MODULE files are distributed, general thanks.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.    1.0 INTRODUCTION.
  96.  
  97.      CALSCHED is a program that allows you to run up to 30 schedules per
  98.      day or night, unattended. CALSCHED was written to be used with
  99.      GETMAIL, a program that allows you to call PCBOARD systems, upload
  100.      and download mail using MEGAMAIL or QMAIL4.
  101.  
  102.      CALSCHED is a program to set up schedules to call any of thirty
  103.      scheduled events. You can download your mail from any PCBOARD bbs
  104.      by using GETMAIL and CALSCHED
  105.  
  106.  
  107.  
  108.  
  109.  
  110.    1.1 CALSCHED FEATURES.
  111.  
  112.    v2.0 features:
  113.    ~~~~~~~~~~~~~~
  114.      o CALSCHED will allow you to run up to 30 batch files any day or
  115.        days - or all days of the week.
  116.  
  117.      o CALSCHED can run up to 30 scheduled events. Simply run it and
  118.        leave your machine running. CALSCHED will run all of the events.
  119.        This is good for users pulling mail off boards at night, hard
  120.        disk cleanups, mail systems and so forth.
  121.  
  122.      o Simple abort of program with the touch of any key.
  123.  
  124.      o Easy one file setup with automatic compilation of any changes
  125.        made.
  126.  
  127.  
  128.  
  129.  
  130.  
  131.    2.0 SOFTWARE DISCLAIMER AND SHAREWARE NOTICE.
  132.  
  133.      You may not reproduce this code for profit or direct sales. You may
  134.      not modify the code and redistribute it to other users. This code
  135.      is provided "AS IS" without warranty of any kind, either expressed
  136.      or implied, included but not limited to the implied warranty of
  137.      merchantability and fitness for a specific purpose. The entire risk
  138.      as to the quality and performance of the coding is with you. Should
  139.      the code prove defective, you assume the entire cost of all
  140.      necessary servicing, repair or correction. In no event will the
  141.      author be liable to you for any damages, including any lost
  142.      profits, lost savings or other incidental or consequential damages
  143.      arising out of the use or inability to use this code.
  144.  
  145.      This version is termed "SHAREWARE".
  146.  
  147.      You may not engage in nor permit third parties to engage in any of
  148.      the following:
  149.  
  150.        1. Making any kind of alteration to the software or the files
  151.           that are contained within the CALS2-0.ZIP file.
  152.        2. Attempt to disassemble, decompile, or reverse engineer the
  153.           software or the files it generates in any way.
  154.        3. Granting sub-licenses, lease or other rights in the software
  155.           to others.
  156.  
  157.      CALSCHED is distributed as "SHAREWARE." This means that CALSCHED is
  158.      distributed freely to whomever wants to use it, without charge for
  159.      an indefinite trial period.
  160.  
  161.      CALSCHED is a fully functional SHAREWARE program. It is not
  162.      crippled in any way.
  163.  
  164.      NOTICE: If you have a registered version of GETMAIL then you are
  165.              entitled to recieve CALSCHED registration FREE OF CHARGE.
  166.              Just list your GETMAIL registration on the orderform and
  167.              send it in to us.
  168.  
  169.  
  170.  
  171.  
  172.  
  173.    3.0 COPYRIGHTED NOTICES.
  174.  
  175.      CALSCHED was compiled using Borlands Turbo Pascal version 4.0,
  176.      copyright Borland International.
  177.  
  178.      CALSCHED was programmed using QEDIT v2.1, February 1990 -
  179.      copyrighted (c)1985-1990 by SemWare - all rights reserved.
  180.  
  181.      MS-DOS is a trademark of Microsoft Corporation.
  182.  
  183.      CALSCHED is copyrighted under the copyright laws of the United
  184.      States of America. CALSCHED are copyrighted (c) 1993 by MICHAEL S.
  185.      HOENIE.
  186.  
  187.      NOTICE: The CALSCHED documentation and program files are subject to
  188.              change without notice from MICHAEL S. HOENIE. CALSCHED was
  189.              designed to go with GETMAIL, a PCBOARD mail retreiver,
  190.              however, it may be used for purposes other than GETMAIL.
  191.  
  192.  
  193.  
  194.  
  195.  
  196.    4.0 CALSCHED MODULE HARDWARE SPECIFICATIONS.
  197.  
  198.    CALSCHED should be located in it's own directory. Create a directory
  199.    such as "C:\CALSCHED" and change to that directory. The ZIP or ARJ
  200.    file (respectivly) is an archive file.
  201.  
  202.    All .DAT files should be contained in the CALSCHED directory.
  203.  
  204.    The filename should be: CALS2-0.ZIP or CALS2-0.ARJ.
  205.  
  206.    If you have purchased GETMAIL and it was mailed to you, then you will
  207.    not need to UN-ZIP or UN-ARJ the CALS2-0.ZIP/ARJ file.
  208.  
  209.    Extract the CALS2-0.ZIP file by typing:
  210.  
  211.       PKUNZIP CALS2-0.ZIP
  212.  
  213.    Or, extract the CALS2-0.ARJ file by typing:
  214.  
  215.       ARJ E CALS2-0.ARJ
  216.  
  217.    CALSCHED will then be extracted.
  218.  
  219.      To execute CALSCHED, run the SCHED.BAT batch file. This batch file
  220.      will do the following:
  221.  
  222.          ECHO OFF
  223.          CD C:\SCHED
  224.          IF EXIST SCHEDULE.BAT ERASE SCHEDULE.BAT
  225.          CALSCHED.EXE
  226.          IF EXIST SCHEDULE.BAT SCHEDULE.BAT
  227.          ECHO ON
  228.  
  229.      Here is a detailed list of how the batch file works:
  230.  
  231.      1. Turn off the echo:
  232.  
  233.          ECHO OFF
  234.  
  235.      2. Change to the SCHEDULER directory: (where CALSCHED is located)
  236.  
  237.          CD C:\SCHED
  238.  
  239.      3. Erase the old schedule file if it exists:
  240.  
  241.          IF EXIST SCHEDULE.BAT ERASE SCHEDULE.BAT
  242.  
  243.      4. Run CALSCHED.EXE:
  244.  
  245.          CALSCHED.EXE
  246.  
  247.      5. Run the SCHEDULE.BAT file if it exists:
  248.  
  249.  
  250.  
  251.  
  252.          IF EXIST SCHEDULE.BAT SCHEDULE.BAT
  253.  
  254.      6. Turn on the echo:
  255.  
  256.          ECHO ON
  257.  
  258.    WARNING: CALSCHED MUST BE RUN THROUGH THE "SCHED.BAT" FILE. THIS
  259.             BATCH FILE CONTAINS EXECUTION FOR SCHEDULE.BAT. ONCE A
  260.             SCHEDULE IS ACTIVATED, ALL CONTENTS OF THE BATCH FILE CALLED
  261.             WILL BE COPIED INTO THE SCHEDULE.BAT FILE. IF THIS BATCH
  262.             FILE EXITS, THE "SCHED.BAT" FILE WILL EXECUTE IT.
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.    4.1 MODIFYING YOUR "SCHEDULE.DAT" SCHEDULE FILE.
  270.  
  271.    Before running CALSCHED, you must first edit your SCHEDULE.DAT
  272.    file. This file is broken up into variables that CALSCHED will
  273.    compile. CALSCHED will always automatically compile it.
  274.  
  275.    sched,#<1..30>,time=<00:00>,batch=<batchname>,enabled,days=<01234567>
  276.  
  277.    Where:
  278.  
  279.                 "sched" = the definition of a schedule record.
  280.  
  281.              "#<1..30>" = a schedule number 1..30. CALSCHED will allow
  282.                           you to use schedules out of sequential order.
  283.                           This means that you could use any schedule you
  284.                           wish.
  285.  
  286.          "time=<00:00>" = a time that this schedule will go off. You
  287.                           must use military time ranging from 00:00 to
  288.                           24:59. If the time is less than 12:00, then a
  289.                           0 must be inserted in front of the time, thus
  290.                           making 2:00 into 02:00.
  291.  
  292.     "batch=<batchname>" = a batchfile name to run when schedule is
  293.                           activated. Once the schedule is run, the
  294.                           contents of <batchname> will be copied into
  295.                           SCHEDULE.BAT, CALSCHED will halt and the
  296.                           SCHEDULE.BAT file will be run.
  297.  
  298.               "enabled" = this schedule is enabled to execute at the
  299.                           given time. If you specify "disabled" then the
  300.                           schedule will not run.
  301.  
  302.       "days=<01234567>" = which days the schedule should run. Valid days
  303.                           are 0 through 7. 0 = all days, 1=monday,
  304.                           2=tuesday, 3=wednesday, 4=thursday, 5=friday,
  305.                           6=saturday, 7=sunday. You may also specify 135
  306.                           for monday, wednesday and friday events to
  307.                           run.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.    6.0 COMMAND LINE PARAMETERS.
  314.  
  315.      Here is a list of command line variables. (LOWER CASE ONLY)
  316.  
  317.       /v = Show version of CALSCHED and compilation date without running
  318.            the scheduler.
  319.  
  320.  
  321.  
  322.  
  323.  
  324.    7.0 AUTHOR FEEDBACK.
  325.  
  326.        The author, MICHAEL HOENIE, can be found on the following networks
  327.        and bulletin board systems. Please do not attempt to contact the
  328.        author by voice, however, he will respond to electronic mail across
  329.        the networks.
  330.  
  331.           US-MAIL: 4241 S. MARQUIS WAY, SLC, UT,  84124.
  332.  
  333.        A Support Conference exists on : THE SANDBOX under "SN-SHAREWARE".
  334.                                         - (801) 569-2803/1818.
  335.  
  336.        Here is a list of Bulletin Board Systems that CALSCHED gets placed
  337.        on for the latest versions.
  338.  
  339.        HOME BOARD: (where the latest CALSCHED can *always* be found)
  340.  
  341.          The Sandbox, DOOR DIRECTORY, (801) 569-2803/1818. USR 9600bps.
  342.            - Thom Allen, Sysop, SOURCENET, FIDO, BITNET networks;
  343.  
  344.        OTHER BOARDS: (uploaded to as deemed fit)
  345.  
  346.          The Rat Trap, MAIN BOARD, (801) 561-5025. USR 38.4k
  347.            - Marty Greenlief, Sysop, INTELEC networks;
  348.  
  349.  
  350.        CONFERENCES TO CORRESPOND WITH THE AUTHOR (as of 01-Feb-93):
  351.  
  352.          SourceNet Network:
  353.             - PASCAL [moderator], SHAREWARE;
  354.          Intelec Network:
  355.             - PASCAL;
  356.          RIME Network;
  357.             - SHAREWARE;
  358.          PCRelay Network;
  359.             - SHAREWARE;
  360.  
  361.        The author would like to personally thank THOM ALLEN for his kind
  362.        words, and for allowing CALSCHED to be placed on his system as a
  363.        free download.
  364.  
  365.  
  366.