home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / cronct11.zip / CRONCT.DOC < prev    next >
Text File  |  2003-05-21  |  11KB  |  242 lines
  1.                              
  2.                              
  3.                              
  4.                              
  5.                              
  6.                              
  7.                              
  8.                              
  9.                       CronCT/2 v1.10ß & CUtil/2 v1.10ß
  10.                            Timed Program Execution
  11.                    (C)opyright 1993-1994 CyberTech Software
  12.                                      by   
  13.                                 Billy Glover
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.   ■ (C) Copyright & License Information -- PLEASE READ
  26.  
  27.     CronCT Executables & Documentation are Copyright (C) CyberTech Software,
  28.   Billy Glover.  All Rights Reserved.  You may use CronCT in any environment
  29.   for any purpose.  You may NOT sell CronCT, nor charge a fee for CronCT
  30.   except where a nominal price would be applicable for recovering costs.
  31.  
  32.     You have accepted this program with the understanding that CyberTech
  33.   Software makes no representations or warranties as to the suitability of
  34.   this program for your particular purpose, and to the extent you use or
  35.   implement this program in your own setting, you do so at your own risk. 
  36.   In no event will CyberTech Software be liable for any damages, whether
  37.   consequential, incidental, or special, arising out of the use or inability 
  38.   to use the program provided herewith.  This program has restrictive terms
  39.   and conditions associated with its use and reproduction to which you must
  40.   agree. DO NOT POST MODIFIED VERSIONS OF THIS PROGRAM FOR PUBLIC ACCESS.
  41.  
  42.   ■ CronCT/2
  43.  
  44.     CronCT/2 has been a project of mine for about 8 months.  It started out
  45.   a very simple program for a boss of mine and evolved into something very
  46.   different!  I've used it 24 hours/day on a 486 DX-33 8 MEG RAM and haven't
  47.   had any trouble.  There have been several requests for a DOS DESQview
  48.   version, so I've been checking into it.  A PM DatFile editor is on the way,
  49.   but I don't know much about PM coding.  I NEED Alpha/Beta sites! If your
  50.   interested, please call the number below.  I would also like to take the
  51.   time to thank Bob Hood for all the help with CronCT/2.  Again this was a
  52.   major code update, so be carefull as there may be bugs.  :)
  53.  
  54.     If you have ANY trouble I'd be glad to help you out anyway I can, just
  55.   call the number below.
  56.  
  57.   ■ REGISTERING CronCT/2
  58.  
  59.     You may register by calling up (817) 684-1434 and getting a 10 digit
  60.   code.  It cost nothing, and only used so I can keep track of who is
  61.   currently using the program.  It also lets me make sure that Alpha/Beta
  62.   copies are only being used by authorized sites only.  Currently all Betas
  63.   are public.
  64.   
  65.   ■ The DATAFILE
  66.  
  67.     CronCT/2 DATFILES may be created with any text editor.  If you get an
  68.   Exception Error your datafile is a good place to start looking for your
  69.   trouble.
  70.  
  71.     When CronCT comes online it will check all AT Queue Entries for there
  72.   Date/Time and if found past due, will delete its entry from the Datafile.
  73.   Later I'll put in options for rescheduling it.
  74.  
  75.     While running CronCT will check the current datafile and rescan it if it
  76.   has been changed, but will wait for all General Queue entries to Terminate
  77.   before rescaning.  When rescaning the datafile it will only rescan General
  78.   Queue entries and not AT, if you change an AT entry you must stop/restart
  79.   CronCT before change will take place.
  80.     
  81.      'LOG:' entries enable CronCT's FileLoging ... 'LOG: CronCT.LOG'
  82.      'REG:' CronCT/2 RegInfo
  83.      Comments are denoted by a '#' sign in the 1st column
  84.      Comments denoted by '#$' are logged each time the processes
  85.       after them are executed
  86.      One Queue Record/Line
  87.      Queue Records are limited by memory only
  88.      Each Queue Record will have the following:
  89.        [!]Minutes, [!]Hours, [!]Days,[!]Months, [!]Day of Week
  90.        Fullscreen or Windowed ( FULL[-] | WIND[-] '-' = Minimized to Icon )
  91.        [PATH]File Executable & Options
  92.      Entries starting with '@ ' are AT processes
  93.  
  94.   0    1 2 3 * FULL- D:\os2\apps\misc\backup.exe -now
  95.   On March 2, 01:00 am Launch <backup.exe -now> as Fullscreen MIN process.
  96.  
  97.     Minutes, Hours, Days, Months, and Day of Week can each have multiple
  98.   entries by separating them with commas.  Make sure there aren't any
  99.   spaces after each comma ( 23,53,52 ).  All times ( unless noted ) are in
  100.   24 hour format, this may change later.
  101.   
  102.     If you add an '!' before a number it is treated as a time to kill, 
  103.   ( 0,!30 ) starts on 0 minute, and kills on minute 30.
  104.  
  105.     An '-' is the range operator.  ( 0,2-7 ) would go on 0 and 2 through 7.
  106.   The '!' operator will also work for ranges so ( 0,!0, 1-3, !1-3 ) would
  107.   be correct.
  108.  
  109.     In most cases CronCT/2 will auto-detect the process type (PM/OS2/VDM),
  110.   but defaults to type OS2.  You may override this by placing one of the
  111.   following tokens after the FULL/WIND token ( PM, OS2, or VDM ).  You may
  112.   also play the override token in () for (PM), (OS2), or (VDM).  This looks
  113.   better to some so I made it up to the user.
  114.  
  115.   ■ Starting up CronCT/2
  116.  
  117.     CronCT.EXE [/D:DATAFILE.DAT /L:LOGFILE.LOG]
  118.  
  119.   /D:DATAFILE.DAT    -  Specify new DataFile, default is CronCT.DAT.
  120.   /L:LOGFILE.LOG     -  Specify new LogFile, /L will activate Logging to
  121.                         CronCT.LOG.
  122.  
  123.     CronCT/2 can be auto-started each time you boot by:
  124.       1. Create an Icon for CronCT.EXE and place it in your startup folder.
  125.       2. Place it in you startup.cmd file.
  126.       3. Type 'START CRONCT.EXE' at the command line.
  127.  
  128.   ■ CronCT/2 Menu Commands
  129.  
  130.     ESC Terminate CronCT/2.
  131.     / Move up/down in CronCT's Queue.
  132.      E  Execute current Queue Record.
  133.      G  Switch to this running Queue Record.
  134.      S  Skip/Unskip current Queue Record.
  135.      T  Terminate ( stop running program ) current Queue Record.
  136.   
  137.   ■ CUtil.EXE
  138.  
  139.      CUtil.EXE may be executed from any directory as it 'talks' to CronCT/2
  140.   through a named pipe.  Place it somewhere in your path for convince.  You
  141.   can rename CUtil.EXE to anything else you like, I have mine as CU.EXE
  142.   Returns ErrorLevel of 0 for Success or 1 for Error.
  143.    
  144.    General Commands:
  145.  
  146.      /?  CUtil.EXE Usage Information.
  147.      /C  Create/Modify DATFILES ( NOT IMPLEMENTED YET ).
  148.      /I  Get CronCT's General/AT Queue Status.
  149.          /Iq General Only, /Ia AT Only, /It AT Time ( am/pm ) to execute.
  150.      /L  Trim CronCT's LOG.  /L FileName # of days to keep.
  151.          /L CronCT.LOG 5  would keep the last 5 days log entries from
  152.          the log CronCT.LOG
  153.      /Q  Terminate Running CronCT/2.
  154.  
  155.    CronCT/2 Queue Commands:   /COMMAND [QUEUE #] [FILENAME]
  156.  
  157.      /E  Execute                      /S  Skips
  158.      /T  Terminate                    /U  Unskips
  159.  
  160.     CUtil.EXE /S EXE  Would Skip all entries with EXE in there FILENAME.
  161.     CUtil.EXE /U le   Would Unskip all entries will 'le' in there FILENAME.
  162.  
  163.    AT Commands:
  164.  
  165.    CUtil.EXE /AT [/N] [DATE] [TIME] [[NEXT | INCREMENT] TIME DESIGNATION] JOB
  166.  
  167.    CUtil.EXE /AT 01/02/94 03:00 JOB           -  DateTime.
  168.    CUtil.EXE /AT + 2 MONTHS JOB               -  Now + 2 months.
  169.    CUtil.EXE /AT NEXT DAY JOB                 -  Now + 1 day.
  170.    CUtil.EXE /AT SAT + 2 WEEKS JOB            -  Next SAT + 2 Weeks.
  171.    CUtil.EXE /AT DEC 7 [1994 | 94] 00:00 JOB
  172.    
  173.    Keywords are:  ( Case insensitive )
  174.      
  175.      NEXT | + # [ MIN[UTEs] | HOURs | DAYs | WEEKs | MON[THs] ]
  176.      /N = Notify User  NOON = 12:00pm   MIDNIGHT = 00:00am  TOMORROW = +1 Day
  177.      Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
  178.      JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
  179.  
  180.    /N - Notify User will 'PopUp' in any Fullscreen OS2/VDM window ( this
  181.         will include PM later ) thats in the Foreground with a notice that
  182.         there AT Queue has finished and post its ErrorLevel.  The 'PopUp'
  183.         will last 5 seconds or until a key is pressed.
  184.  
  185.     NOTE:  AT entries are donoted with a '@ ' before them, the format is:
  186.   DATE/TIME to run, DATETIME entered, [(NU) Notify User], FULL/WIND, [PM]
  187.   [OS2] [VDM] forced Session Type, JOB.  If you need to delete on, just
  188.   erase the entire line and resave the DatFile, you will need to stop &
  189.   restart CronCT/2 for the change to take place.
  190.  
  191.   ■ The Future
  192.  
  193.     Editor to Create/Modify DATFILES in CUtil.EXE.
  194.     DOS version of CUtil.EXE.
  195.     More than 1 DAT file, and 'chaining' of DATFILES.
  196.     Smaller memory requirements & faster code.
  197.     I'll also do my best to add anything that asked for.
  198.     Better DOCs!  Sorry about these docs... Programmers can't write docs!  :)
  199.  
  200.   ■ Bug Reports, Questions, and Comments
  201.  
  202.     Computer Insight      We have some VERY good prices!  Just ask.
  203.     CyberTech Software
  204.     C/O Billy Glover      BIZ Voice: 817-552-6286  (Ask for Glen Cook)
  205.     P.O. Box 1948         Personal : 817-684-1434  (Ask for Billy Glover)
  206.     Vernon, TX  76385     FAX      : 817-552-6288  (24 hours/day)
  207.  
  208.   ■ History
  209.  
  210.     v0.01α 12/29/93  -  First Release.
  211.  
  212.     v0.02α 04/05/94  -  Major Rewrite of code.  Many Features added,
  213.                         And many bugs fixed!
  214.  
  215.     v0.03α 04/14/94  -  ADDED CUtil.EXE with Option /I INFO.
  216.            04/22/94  -  ADDED Skip/Unskip Commands to CronCT/2.
  217.            04/30/94  -  ADDED Skip/Unskip/Execute/Terminate/TERM CronCT/2
  218.                         Commands to CUtil.EXE
  219.            05/22/94  -  ADDED Full /AT Command to CUtil.EXE
  220.            05/27/94  -  ADDED /L Opt to CUtil.EXE:  /L LogName # of days.
  221.            05/29/94  -  UPDATED CronCT.DOC file.  :)
  222.            06/01/94  -  FIXED several bugs from adding so much new stuff.
  223.  
  224.     v1.00ß 06/01/94  -  Released CronCT/2 v1.00ß & CUtil/2 v1.00ß
  225.  
  226.     v1.10g 06/11/94  -  Changed DATFILE() to be more forgiving...  :)
  227.            06/11/94  -  Changed DATFILE() to not convert lower case to
  228.                         upercase.  Some program opts are case sensitive,
  229.                         sorry about this one...  :)  Thanks Jason.
  230.            06/11/94  -  Made the PIPE that CUtil.EXE talkes to CronCT/2 with
  231.                         Optional.
  232.            06/11/94  -  ADDED 'LOG:' Opt to Datafiles.
  233.            06/19/94  -  ADDED 'REG:' Opt to Datafiles.
  234.            06/19/94  -  FIXED some minor bugs from updates...
  235.            07/01/94  -  Changed DATFILE() to support '!'.
  236.            07/03/94  -  Changed DATFILE() to be faster.
  237.            07/05/94  -  Changed CUtil.EXE /L Opt, added stats.
  238.            07/07/94  -  Changed DATFILE() to support '-' range opt.
  239.            07/08/94  -  Changed PQueue() to put a '*' before a Forced App Type
  240.  
  241.            07/08/94  -  Released CronCT/2 v1.10g & CUtil/2 v1.10g.
  242.