home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: SysTools / SysTools.zip / cronct12.zip / CronCT.DOC < prev    next >
Text File  |  1994-10-06  |  29KB  |  664 lines
  1.                              
  2.                              
  3.  
  4.                                                           
  5.                              
  6.                      CronCT/2 v1.20g & CUtil/2 v1.20g
  7.                              
  8.                            Timed Based Execution
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 USER MANUAL
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.             Software and Documentation written by Billy F. Glover  
  22.                  (C) Copyright 1993-1994 CyberTech Software
  23.                             ALL RIGHTS RESERVED!
  24.  
  25. ──────────────────────────────────────────────────────────────────────────────
  26.  
  27.   Table of Contents:
  28.  
  29.       1  Introduction
  30.          1.1  What is CronCT/2 ?
  31.          1.2  Features & The Future
  32.          1.3  Contents of Archive
  33.          1.4  Registering & Authors Address
  34.          1.5  Copyright & License Information -- PLEASE READ
  35.  
  36.       2  CronCT/2
  37.          2.1  Installation & Command Line Options
  38.          2.2  CronCT.DAT File
  39.               2.2.1  Options & Overrides
  40.               2.2.2  Examples
  41.          2.3  Status Window
  42.          2.4  Log Window
  43.               2.4.1  ERRORS & NOTES During System IPL
  44.               2.4.2  ERRORS & NOTES Processing CronCT.DAT
  45.               2.4.3  ERRORS & NOTES Processing CronCT.AT
  46.          2.5  Queue Window
  47.          2.6  Menu Commands
  48.               2.6.1  INS-CREATE
  49.               2.6.2  DEL-KILL
  50.               2.6.3  Execute
  51.               2.6.4  Goto
  52.               2.6.5  Modify
  53.               2.6.6  Skip
  54.               2.6.7  Terminate
  55.               2.6.8  View
  56.               2.6.9  Colors
  57.               2.6.10 Log
  58.               2.6.11 PM
  59.               2.6.12 ALT-P Pause
  60.               2.6.13 F1-HELP
  61.               2.6.14 ESC-EXIT
  62.          2.7  Exiting - ErrorLevels & DropFiles
  63.  
  64.       3  CUtil/2
  65.          3.1  General Options
  66.          3.2  LOG Trimmer
  67.          3.3  AT Command
  68.               3.3.1  Examples
  69.          3.4  ErrorLevels Returned
  70.  
  71.       4  Credits
  72.  
  73. ──────────────────────────────────────────────────────────────────────────────
  74.  
  75.  
  76.   CHAPTER 1 - Introduction
  77.  
  78. ──────────────────────────────────────────────────────────────────────────────
  79.   1.1  What is CronCT/2
  80. ──────────────────────────────────────────────────────────────────────────────
  81.  
  82.     Thank you for trying out CronCT/2!  CronCT/2 can schedule events with
  83.   great precision.  You can schedule an event based upon minutes, hours, days,
  84.   months, and/or day of week, using any combination thereof.
  85.   
  86.     LAN Servers can be scheduled to be backed up after hours, as can critical
  87.   files such as CONFIG.SYS, AUTOEXEC.BAT, and OS/2 .INIs just to name a few.
  88.   BBS SysOps can schedule events so there BBS can stay on-line, when the BBS
  89.   is open for callers, and when that voice line is used for a second node!
  90.   
  91.     There are several things that are inconvenient to have to do, and if your
  92.   like me, sometimes I'll forget something that needed to be done.  We all
  93.   know Murphy's law, the second you need that backup, you'll have forgot to
  94.   do it!  With CronCT/2 running you won't have to worry about that anymore.
  95.  
  96.     CronCT/2 is the result of many months worth of work.  I started working
  97.   on it around NOV 15, 1993.  It was started for my boss, who ended up going
  98.   bankrupt.  So I decided to finish it and see if there was any interest in
  99.   it.  There sure was!  I'm really surprised by amount of people that have 
  100.   called in about it.  I didn't know that it would go over as well as it did!
  101.  
  102. ──────────────────────────────────────────────────────────────────────────────
  103.   1.2  Features & The Future
  104. ──────────────────────────────────────────────────────────────────────────────
  105.  
  106.    Features:
  107.  
  108.     Works under OS/2 v2.0 GASP, v2.1 GA, v2.1 GASP, & OS/2 for Windows.
  109.     Command Line Utility for interfacing with CronCT/2.
  110.     Very low system memory requirements.
  111.     Supports HPFS Long Filenames.
  112.     Auto-detection of Application type.
  113.  
  114.    Future Plans:
  115.  
  116.     PM version.
  117.     HyperText Help Engine.
  118.     DAEMON version.
  119.  
  120. ──────────────────────────────────────────────────────────────────────────────
  121.   1.3  Contents of Archive
  122. ──────────────────────────────────────────────────────────────────────────────
  123.  
  124.    CronCT .EXE  -  The main executable file.
  125.    CUtil  .EXE  -  Command Line Util for interfacing with CronCT/2.
  126.    CCTSM  .DLL  -  CronCT/2 Support Module.
  127.    CronCT .DAT  -  Sample CronCT.DAT file.
  128.    CronCT .DOC  -  CronCT/2 & CUtil/2 Documentation.  ( This File! )
  129.    CronCT .REV  -  Complete program History.  ( Well almost anyway )
  130.    File_ID.DIZ  -  Short description of program for BBSs
  131.  
  132. ──────────────────────────────────────────────────────────────────────────────
  133.   1.4  Registering & Authors Address
  134. ──────────────────────────────────────────────────────────────────────────────
  135.  
  136.     Starting with version 1.20 I will accept all contributions offered.  As
  137.   a lot of my time is now spent answering the phone, mail, and faxes about it.
  138.   Please send what you feel the program is worth.  If sending cash, please
  139.   send it by registered mail only for your protection.  If you send a check,
  140.   I'll wait for it to clear.  If you have a FidoNet node number or access to
  141.   a FAX machine, please include it, and I'll send your registration code to
  142.   you.  I'm already working on v1.30 now.  Please include the version you have
  143.   if you call/fax/mail me.  Thanks.
  144.  
  145.     All new versions & bugfixes of CronCT/2 are uploaded to OS/2 ShareWare
  146.   BBS.  I may be reached there as User: Billy Glover.  Please get a hold of me
  147.   if you have a suggestion, bug report, or just what to chat!  The InterNet
  148.   account below belongs to a friend of mine and e-mail sent to it will take a
  149.   while to get to me, but I will get it and reply.  Enjoy the program.
  150.  
  151.   CyberTech Software            Voice    : (817) 684-1434
  152.   C/O Billy Glover              FAX      : (817) 552-6288
  153.   P.O. Box 333                  INTERNET : JHOBBS@ABACUS.MWSU.EDU
  154.   Crowell, TX  79227            OS/2 Shareware BBS - (703) 385-4325
  155.  
  156. ──────────────────────────────────────────────────────────────────────────────
  157.   1.5  (C) Copyright & License Information -- PLEASE READ
  158. ──────────────────────────────────────────────────────────────────────────────
  159.  
  160.     CronCT/2 Executables & Documentation are Copyright (C) CyberTech Software,
  161.   Billy Glover.  All Rights Reserved.  You may use CronCT/2 in any environment
  162.   for any purpose.  You may NOT sell CronCT/2, nor charge a fee for CronCT/2
  163.   except where a nominal price would be applicable for recovering costs.
  164.  
  165.     You have accepted this program with the understanding that CyberTech
  166.   Software makes no representations or warranties as to the suitability of
  167.   this program for your particular purpose, and to the extent you use or
  168.   implement this program in your own setting, you do so at your own risk. 
  169.   In no event will CyberTech Software be liable for any damages, whether
  170.   consequential, incidental, or special, arising out of the use or inability 
  171.   to use the program provided herewith.  This program has restrictive terms
  172.   and conditions associated with its use and reproduction to which you must
  173.   agree.  DO NOT POST MODIFIED VERSIONS OF THIS PROGRAM FOR PUBLIC ACCESS.
  174.  
  175.     CronCT/2 & CUtil/2 are trademarks of CyberTech Software, Billy Glover.
  176.   
  177.     All other product names and services identified in this manual are
  178.   trademarks or registered trademarks of there respective companies.
  179.  
  180. ──────────────────────────────────────────────────────────────────────────────
  181.  
  182.  
  183.   CHAPTER 2 - CronCT/2
  184.  
  185. ──────────────────────────────────────────────────────────────────────────────
  186.   2.1  Installation & Command Line Options
  187. ──────────────────────────────────────────────────────────────────────────────
  188.  
  189.     Create a base directory and UnZip the distribution archive ( SECTION 1.3)
  190.   in it.  This directory should to be placed in your CONFIG.SYS path statement
  191.   for convenience.  The next thing you need to do is create your own CronCT.DAT
  192.   file using the one given as a guideline ( SECTION 2.2 ).
  193.  
  194.   CronCT/2 Command line:  CronCT.EXE [/L] [/P-]
  195.  
  196.   /C-  Will deactivate the PIPE Thread.  This is the thread that CUtil/2 uses.
  197.   /L   Will activate logging to CronCT.LOG
  198.   /M   Mono Colors
  199.   /P   Activate CronCTPM/2
  200.  
  201.   CronCT/2 can be auto-started each time you boot by:
  202.     1. Creating an Icon for CronCT.EXE and placing it in your startup folder.
  203.     2. Starting it from your STARTUP.CMD file.
  204.   
  205.   This is the interactive version of CronCT/2, so don't 'DETACH' or 'RUN' it.
  206.  
  207. ──────────────────────────────────────────────────────────────────────────────
  208.   2.2  The CronCT.DAT File - Structure, Options & Overrides, Examples
  209. ──────────────────────────────────────────────────────────────────────────────
  210.  
  211.     CronCT.DAT, the heart of CronCT/2, may be created with any text editor.
  212.   An example copy of CronCT.DAT is given with the distribution archive.  On
  213.   the top of each minute, CronCT/2 will check CronCT.DAT for changes and will
  214.   be reprocessed if needed.  While processing CronCT.DAT, LOG messages may
  215.   appear in the LOG window.  They are described in SECTION 2.4.2
  216.  
  217.   General Structure of CronCT.DAT:
  218.       
  219.      Comments are denoted by a '#' sign in the 1st column
  220.      Comments denoted by '#$' are logged each time the processes
  221.       after them are executed
  222.      Each Queue Record will have the following:
  223.        [!]Minutes, [!]Hours, [!]Days, [!]Months, [!]Day of Week
  224.        [/PM | /OS2 | /VDM] [/M:filename] [/FG | /BG] [/NJ] [/NU[:#]]
  225.         [/WIND[-]] | /FULL[-]] are Options & Overrides.  See SECTION 2.2.1
  226.        [PATH]+FileName & Options
  227.  
  228.     Minutes, Hours, Days, Months, and Days of Week can have multiple entries
  229.   by separating them with commas.  Make sure there aren't any spaces after
  230.   each comma ( 1,2,3 ).  Hours are in 24 hour format, this may change later.
  231.  
  232.     By placing a [!] before a number entry, the number is treated as a time
  233.   to Terminate that Queue entry.  ( 0,!30 1,!1,2 ) would start at 1:00a 2:00a
  234.   and stop at 1:30a but not 2:30a.
  235.  
  236.     The [-] is the range operator.  ( 0,!30 1-4,!1-3 ) would start at 1:00a
  237.   2:00a 3:00a 4:00a and stop at 1:30a 2:30a 3:30a but not 4:30a.
  238.  
  239. ──2.2.1 ─ Options & Overrides─────────────────────────────────────────────────
  240.  
  241.     Commands Options & Overrides may appear after the Day of Week entry and
  242.   before the [PATH] Program entry.  They can be in any order.
  243.  
  244.     In most cases, CronCT/2 will auto-detect the process type, but defaults
  245.   to type OS2.  You may override this with /PM | /OS2 | /VDM.
  246.  
  247.     /FULL[-] & /WIND[-] Fullscreen or Windowed.  '-' Minimized to Icon.
  248.  
  249.     /M:filename will direct CronCT/2 to execute this file before running this
  250.   Queue Record.  If the Macro returns an errorlevel of 1 then the Queue Record
  251.   is executed, anything else and the try is logged and the Queue Record isn't
  252.   executed.
  253.  
  254.     /SIZE:X,Y & /POS:X,Y will override the default settings for window Size
  255.   & Position.  Value is in PELs.
  256.     
  257.     /FG | /BG override:  /FG for ForeGround, /BG for BackGround.  CronCT/2
  258.   defaults to type /BG background.
  259.  
  260.     /NJ will cause CronCT/2 to remove this Queue Records Session information
  261.   from the PM 'Window List'.  In effect, you can't jump to or see it from the
  262.   PM 'Window List'.  You can still terminate or switch to it from CronCT/2.
  263.   This is good for making sure that a Queue Record isn't stopped on accident.
  264.  
  265.     /NU[:#] is the Notify User command.  This will notify the user after each
  266.   time the Queue Record has ended.  CronCT/2 will 'PopUp' in any Fullscreen
  267.   non-pm window that's in the Foreground to inform the user.  The 'PopUp' will
  268.   last 5 seconds or until a key is pressed.  If you specify a number ( /NU:# )
  269.   CronCT/2 will only 'PopUp' if the errorlevel returned is different from the
  270.   number.
  271.  
  272. ──2.2.2 ─ Examples────────────────────────────────────────────────────────────
  273.  
  274.   Some Examples:
  275.  
  276.   0    1 2 3 *  /FULL-  D:\os2\apps\misc\backup.exe -now
  277.   On March 2, 01:00 am Launch <backup.exe -now> as Fullscreen MIN process.
  278.  
  279.   0,!0 1,!3 * * *  /WIND-  Mailer.EXE /com2
  280.   At 1:00am Launch <Mailer.EXE /com2> as PM-Window MIN process. Kill at 3:00a
  281.  
  282.   0    1 * * *  /NJ /OS2 /NU:0  JOB
  283.   At 1:00am Launch [JOB] as OVERRIDE apptype to OS2, NoJump, & notify user of
  284.   exit if errorlevel isn't 0.
  285.  
  286. ──────────────────────────────────────────────────────────────────────────────
  287.   2.3  Status Window
  288. ──────────────────────────────────────────────────────────────────────────────
  289.  
  290.    ╔═════════════════════════════╗
  291.    ║   Monday, August 22, 1994   ║  PM  - Total PM  processes Queued/Running.
  292.    ║            19:32            ║  OS2 - Total OS2 processes Queued/Running.
  293.    ║                             ║  VDM - Total VDM processes Queued/Running.
  294.    ║                             ║
  295.    ║  PM  : 000/000    AT : 000  ║  AT  - Total # of AT  Processes Queued.
  296.    ║  OS2 : 000/000   GEN : 000  ║  GEN - Total # of GEN Processes Queued.
  297.    ║  VDM : 000/000   TOT : 000  ║  TOT - Total # of Processes in memory.
  298.    ╚═════════════════════════════╝
  299.  
  300.     CronCT/2 displays GEN Queue Records in the QUEUE below.  AT Queue Records
  301.   aren't displayed.  For more information about the QUEUE, SEE SECTION 2.5
  302.  
  303. ──────────────────────────────────────────────────────────────────────────────
  304.   2.4  Log Window - System IPL, CronCT.DAT, CronCT.AT, PIPE
  305. ──────────────────────────────────────────────────────────────────────────────
  306.  
  307.     If CronCT.LOG is busy ( in use by another process ) CronCT/2 will place
  308.   the LOG entry on the pending write stack ( FIFO Queue ).  Once CronCT.LOG is
  309.   ready, it will write out all pending writes in the order they were received.
  310.   If CronCT/2 is terminated & CronCT.LOG is still busy, CronCT/2 will write
  311.   out all pending writes to PLogW.CCT.  The contents of this file are then
  312.   added to CronCT.LOG during the next System IPL.
  313.  
  314. ──2.4.1 ─ ERRORS & NOTES During System IPL────────────────────────────────────
  315.  
  316.   During System IPL, CronCT/2 may log any of the following:
  317.  
  318.   NOTE: Pipe Handler Disabled!           -  Started with Option /P-
  319.   NOTE: Processing Pending Log Writes    -  Found 'PLogW.CCT'
  320.   NOTE: Processing Pending AT Adds       -  Found 'PATAdd.CCT'
  321.   NOTE: Processing Pending AT Kills      -  Found 'PATKill.CCT'
  322.  
  323. ──2.4.2 ─ ERRORS & NOTES Processing CronCT.DAT────────────────────────────────
  324.  
  325.   During processing of CronCT.DAT, CronCT/2 may log any of the following:
  326.  
  327.   NOTE: BAD MIN   [ # ]  LN: #  -  Range 1-59
  328.   NOTE: BAD HOUR  [ # ]  LN: #  -  Range 0-23
  329.   NOTE: BAD DAY   [ # ]  LN: #  -  Range 1-31
  330.   NOTE: BAD MONTH [ # ]  LN: #  -  Range 1-12
  331.   NOTE: BAD DOW   [ # ]  LN: #  -  Range 1-07
  332.   
  333.   NOTE: BAD Option or Override LN: # -  Recheck line, SEE SECTION 2.2.1
  334.  
  335. ──2.4.3 ─ ERRORS & NOTES Processing CronCT.AT─────────────────────────────────
  336.  
  337.   During processing of CronCT.AT, CronCT/2 may log any of the following:
  338.  
  339.   NOTE: BAD Option or Override!  LN: #   -  Recheck line, SEE SECTION 2.2.1
  340.  
  341.   ERROR: AT QUEUE DATE/TIME INVALID!     -  Line Removed.
  342.  
  343. ──2.4.3 ─ ERRORS & NOTES from PIPE────────────────────────────────────────────
  344.  
  345.   During PIPE ( CUtil/2 ) operation, CronCT/2 may log any of the following:
  346.  
  347.   ERROR: DosCreateNPipe() RC: # - CronCT/2 may already be running.
  348.   ERROR: DosConnectNPipe() RC: #
  349.   ERROR: (R#) Broken PIPE!  RC: #
  350.   ERROR: (R#) MORE DATA!  RC: #  BR: #
  351.   ERROR: (R#) Something wrong with PIPE!  RC: #
  352.   ERROR: (DDCNP) Broken PIPE!  RC: #
  353.   ERROR: (DDCNP) BAD PIPE!  RC: #
  354.  
  355.   If you keep getting any the above 7 errors call up and I'll check into it.
  356.   The above errors are very rare, and you shouldn't ever get any of them.
  357.  
  358.   Rejected AT Queue Entry from PIPE!  -  AT Queue rejected from CUtil/2.
  359.   ERROR: AT Queue DATE/TIME Invalid!  -  because of DATE/TIME information.
  360.  
  361. ──────────────────────────────────────────────────────────────────────────────
  362.   2.5  Queue Window
  363. ──────────────────────────────────────────────────────────────────────────────
  364.  
  365.    ╔══════════════════════════════════════════════════════════════════════╗
  366.    ║ QUEUE  SESSION INFO  PROGRAM & OPTIONS                      STATUS   ║
  367.    ╟──────────────────────────────────────────────────────────────────────╢
  368.    ║   001   PM/WIND/MIN  PMP.EXE -com1                          Ready    ║
  369.    ║ > 002  OS2/FULL/MIN  OS2Scan.EXE C: D: E:                   Running  ║
  370.    ║   003  VDM/FULL/MIN  DB.EXE                                 Running  ║
  371.    ║   004  OS2/FULL/MIN  Tape.EXE -now                          MacroCHK ║
  372.    ║   005  OS2/FULL/MIN  Play.CMD FILE=CUCKOO.WAV               Ready    ║
  373.    ║   006 * PM/FULL/MAX *Jigsaw -scramble                       Ready    ║
  374.    ║                                                                      ║
  375.    ║                                                                      ║
  376.    ║                                                                      ║
  377.    ║                                                                      ║
  378.    ╚══════════════════════════════════════════════════════════════════════╝ 
  379.  
  380.     QUEUE
  381.     Queue numbers, each Queue Records is given a Queue Number.  The '>'
  382.     designates the current Queue Record.
  383.     
  384.     SESSION INFO
  385.     Session Type, Fullscreen | Windowed, Minimized | Maximized.  If the
  386.     process type has been forced it will have a '*' before it.
  387.  
  388.     PROGRAM & OPTIONS
  389.     Name and any options that go with it.  Path is not included.  If the
  390.     program can't be located it will have an '*' before it and be launched as
  391.     an OS2 command shell type ( like a cmd file ).
  392.  
  393.     STATUS
  394.     Ready     -  Ready to be executed.
  395.     Running   -  Currently running.
  396.     Failed    -  Queue Record failed to execute, check log for reason.
  397.     Skipped   -  Queue Record has be skipped.
  398.     MacroCHK  -  Executing MACRO.
  399.     Modify    -  The Queue Record is currently being modified.
  400.  
  401. ──────────────────────────────────────────────────────────────────────────────
  402.   2.6  Menu Commands
  403. ──────────────────────────────────────────────────────────────────────────────
  404.  
  405.   Menu Command  -  Action Taken
  406.  
  407.     INSERT      -  Create Queue Record.
  408.     DELETE      -  Delete current Queue Record.
  409.       E         -  Execute current Queue Record.
  410.       G         -  Switch this running Queue Record to the Foreground.
  411.       M         -  Modify current Queue Record.
  412.       S         -  Toggle Skip current Queue Record.
  413.       T         -  Terminate ( stop running program ) current Queue Record.
  414.       V         -  View current Queue Record.
  415.       C         -  Colors.
  416.       L         -  Log Options.
  417.       P         -  CronCTPM/2 Options.
  418.     ALT-P       -  Pause Queue Launches.
  419.       F1        -  HELP.
  420.   ESC & ALT-X   -  Terminate CronCT/2.
  421.  
  422.   Page UP/DOWN  -  Move one page Up/Down in the Queue.
  423.   /           -  Move up/down in CronCT's Queue.
  424.   HOME/END      -  Change to the top/bottem of current Queue list.
  425.   CTRL-HOME/END -  Change to the START/END of Queue list.
  426.  
  427. ──2.6.1  ─ INSERT──────────────────────────────────────────────────────────────
  428.  
  429.     Comment  -  Comment to log before each launch
  430.     Program  -  Program to launch
  431.     Options  -  Program Options
  432.     Path     -  Path to find the program
  433.  
  434.     Minutes, Hours, Days, Months, and Days of Week can have multiple entries
  435.   by separating them with commas.  Make sure there aren't any spaces after
  436.   each comma ( 1,2,3 ).  Hours are in 24 hour format, this may change later.
  437.     By placing a [!] before a number entry, the number is treated as a time
  438.   to Terminate that Queue entry.  ( 0,!30 1,!1,2 ) would start at 1:00a 2:00a
  439.   and stop at 1:30a but not 2:30a.
  440.     The [-] is the range operator.  ( 0,!30 1-4,!1-3 ) would start at 1:00a
  441.   2:00a 3:00a 4:00a and stop at 1:30a 2:30a 3:30a but not 4:30a.
  442.  
  443.     The following are Options & Overrides from SECTION 2.2.1
  444.     
  445.     Session Type  -  Defaults to AUTO-DETECT
  446.     Notify User   -  'Y' to Notify all the time, or a Number to notify only
  447.                      if the errorlevel doesn't match.  Defaults to NO.
  448.     FULL/WIND     -  'F' for Fullscreen, 'W' for Windowed.  Defaults to FULL.
  449.     Jumpable      -  'J' for Jumpable, 'N' for NotJumpable.  Defaults to J.
  450.     FgBg          -  'F' for Foreground, 'B' for Background.  Defaults to BG.
  451.     Macro         -  Macro to execute.  Defaults to NONE.
  452.  
  453.   After your finished editing the Queue Record press ALT-S or F10.
  454.  
  455. ──2.6.2  ─ DELETE──────────────────────────────────────────────────────────────
  456.  
  457.     The DELETE command should be used with caution!  Once deleted, the only
  458.   way to get the Queue Record back is to re-enter it.  You will not be asked
  459.   for confirmation.
  460.  
  461. ──2.6.3  ─ Execute─────────────────────────────────────────────────────────────
  462.  
  463.     Executes the Queue Record if its status isn't one of the following:
  464.   
  465.   Running  - Already running!
  466.   Skipped  - Unskip it to execute.
  467.   MacroCHK - Checking Macro, already running.
  468.  
  469. ──2.6.4  ─ Goto────────────────────────────────────────────────────────────────
  470.  
  471.     Switches the Queue Record into the foreground.  If the Queue Records was
  472.   launched with the option of /NJ, this is the only was to switch to the
  473.   Queue Record.
  474.  
  475. ──2.6.5  ─ Modify──────────────────────────────────────────────────────────────
  476.  
  477.     The modify command lists all the information from SECTION 2.6.1 and lets
  478.   you change any of it.  You can't change a running Queue Record.  After your
  479.   finished editing the Queue Record press ALT-S or F10.
  480.  
  481. ──2.6.6  ─ Skip────────────────────────────────────────────────────────────────
  482.  
  483.     The SKIP command will toggle the skip status of the current Queue Record.
  484.   This command only works if the current status is READY.
  485.  
  486. ──2.6.7  ─ Terminate───────────────────────────────────────────────────────────
  487.  
  488.     The TERMINATE command will stop the current Queue Record from running.  If
  489.   the Queue Record was started with the option of /NJ, this is the only way to
  490.   stop it, until it ends normally.
  491.  
  492. ──2.6.8  ─ View────────────────────────────────────────────────────────────────
  493.  
  494.     The VIEW command lets you view all the information from SECTION 2.6.1, but
  495.   not change any of it.  Press any key when finished.
  496.  
  497. ──2.6.9  ─ Colors──────────────────────────────────────────────────────────────
  498.  
  499.     The COLOR Command lets you change ANY color ANYWHERE in CronCT/2.
  500.  
  501. ──2.6.10 ─ Log─────────────────────────────────────────────────────────────────
  502.  
  503.   * Log Options havn't been implemented yet.
  504.  
  505. ──2.6.11 ─ PM──────────────────────────────────────────────────────────────────
  506.  
  507.   * PM Support was taken out at the last minute.  Its just to unstable in this
  508.     version and will be in the next version.  This was my first attempt at PM
  509.     coding so I still learning!
  510.  
  511. ──2.6.12 ─ ALT-P Pause─────────────────────────────────────────────────────────
  512.  
  513.     The ALT-P command will suspend the background launching of Queue Records
  514.   ( including AT Queue Records ).  Press ALT-P again to resume.
  515.  
  516. ──2.6.13 ─ F1-HELP─────────────────────────────────────────────────────────────
  517.  
  518.   * F1-HELP system hasn't been implemented yet.
  519.  
  520. ──2.6.14 ─ ESC-EXIT────────────────────────────────────────────────────
  521.  
  522.     This command, or ALT-X, will perform CronCT/2 system shutdown.  Anything
  523.   pending action ( Log/AT ) will be wrote to dropfiles and processed during
  524.   the next System IPL.
  525.  
  526. ──────────────────────────────────────────────────────────────────────────────
  527.   2.7  EXITING - ErrorLevels & DropFiles
  528. ──────────────────────────────────────────────────────────────────────────────
  529.  
  530.     CronCT/2 will return an errorlevel of 0 if everything went ok.  Otherwise,
  531.   it will return the following:
  532.  
  533.   248  -  General Error Code
  534.   249  -  Error with CCTSM.DLL
  535.   250  -  Error in Command Line Options.  Check your command line options.
  536.   251  -  Memory Allocation Error.  You should'nt get this error.
  537.   252  -  Can't Create/Locate File.  Check your files.
  538.   253  -  Thread Creation Error.  You should'nt get this error.
  539.   254  -  CUtil/2 PipeError.
  540.   255  -  EXCEPTION ERROR!  Record all information and call me
  541.           ( SEE SECTION 1.4 ).
  542.  
  543.     Under certain situations CronCT will leave 'dropfiles' in its base
  544.   directory.  These files, if they exist, will be processed during the next
  545.   System IPL.
  546.  
  547.   CronCT .AT   -  AT Command Support File, Modify this file at your on risk.
  548.  
  549.   CronCT .INI  -  Where CronCT/2 keeps its Colors.
  550.   
  551.   PATAdd .CCT  -  Pending AT Adds, will be added to 'CronCT.AT'.
  552.                   LOG Entry:  'NOTE: Processing Pending AT Adds'
  553.   
  554.   PATKill.CCT  -  Pending AT Kills, will be deleted from 'CronCT.AT'.
  555.                   LOG Entry:  'NOTE: Processing Pending AT Kills'
  556.   
  557.   PLogW  .CCT  -  Pending Log writes, contents will be added to 'CronCT.LOG'.
  558.                   LOG Entry:  'NOTE: Processing Pending Log Writes'
  559.  
  560. ──────────────────────────────────────────────────────────────────────────────
  561.  
  562.  
  563.   CHAPTER 3 - CUtil/2
  564.  
  565. ──────────────────────────────────────────────────────────────────────────────
  566.   3.1  General Options
  567. ──────────────────────────────────────────────────────────────────────────────
  568.  
  569.    Command  -  Action Taken
  570.  
  571.      /?     -  CUtil.EXE Usage Information.
  572.      /I     -  Get CronCT's General/AT Queue Status.
  573.      /Iq    -  General Only
  574.      /Ia    -  AT Records Only
  575.      /It    -  AT Records Time to execute ( AM/PM format ).
  576.      /L     -  Trim CronCT's LOG.  ( SEE SECTION 3.2 )
  577.      /Q     -  Terminate Running CronCT/2.
  578.  
  579.    CronCT/2 Queue Commands:   /COMMAND QUEUE #  |  FILENAME
  580.  
  581.      /E  Execute              /S  Skips            /P  Pauses
  582.      /T  Terminate            /U  Unskips          /R  Resumes
  583.  
  584.     CUtil.EXE /S EXE  Would Skip all entries with EXE in there FILENAME.
  585.     CUtil.EXE /U le   Would Unskip all entries will 'le' in there FILENAME.
  586.  
  587. ──────────────────────────────────────────────────────────────────────────────
  588.   3.2  LOG Trimmer
  589. ──────────────────────────────────────────────────────────────────────────────
  590.  
  591.   Command Format:  CUtil.EXE /L [path]filename #
  592.  
  593.     CUtil/2 Log Trimmer will trim your log based on date or finding a trigger
  594.   word in the log line.  Trigger words are stored in the file 'CU_LOG.CCT'.
  595.   This file MUST be in the same directory as CUtil/2.  If CUtil/2 can't find
  596.   this file it will still work, just not using kill words.
  597.  
  598.     The file 'CU_LOG.CCT' has one entry/line, and you can have any number of
  599.   entries.  Each entry can be more than one word, so that 'Log Trimmer' would
  600.   be one entry line.  
  601.   
  602.   Command Format:  CUtil.EXE /L filename #
  603.  
  604.   * CU_LOG.CCT hasn't been implemented yet.
  605.  
  606. ──────────────────────────────────────────────────────────────────────────────
  607.   3.3  AT Command Options
  608. ──────────────────────────────────────────────────────────────────────────────
  609.    
  610.    [DATE] [TIME] [[NEXT | INCREMENT] TIME DESIGNATION] [Opts | Overrides] JOB
  611.  
  612.    CUtil.EXE /AT 01/02/94 03:00 JOB           -  DateTime.
  613.    CUtil.EXE /AT + 2 MONTHS JOB               -  Now + 2 months.
  614.    CUtil.EXE /AT NEXT DAY JOB                 -  Now + 1 day.
  615.    CUtil.EXE /AT SAT + 2 WEEKS JOB            -  Next SAT + 2 Weeks.
  616.    CUtil.EXE /AT DEC 7 [1994 | 94] 00:00 JOB  -  DEC 7, 1994 at Midnight.
  617.    
  618.    Keywords are:  ( Case insensitive )
  619.      
  620.      NEXT | + # [ MIN[UTEs] | HOURs | DAYs | WEEKs | MON[THs] ]
  621.      NOON = 12:00pm   MIDNIGHT = 00:00am  TOMORROW = +1 Day
  622.      Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
  623.      JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
  624.  
  625.    You can use any of the Options & Overrides listed in SECTION 2.2.1
  626.  
  627. ──3.3.1 ─ Examples────────────────────────────────────────────────────────────
  628.  
  629.   CUtil.EXE /AT NEXT DAY 11:00 /NU:0 /NJ /FULL- DOTHIS.EXE Opts
  630.   CUtil.EXE /AT + 5 HOURS /WIND- DOTHIS.EXE Opts
  631.   CUtil.EXE /AT 8:00 TOMORROW DOTHIS.EXE Opts
  632.   CUtil.EXE /AT DOTHISNOW.EXE Opts
  633.  
  634. ──────────────────────────────────────────────────────────────────────────────
  635.   3.4  ErrorLevels Return from CUtil/2
  636. ──────────────────────────────────────────────────────────────────────────────
  637.  
  638.     CUtil/2 will return an errorlevel of 0 if everything went ok.  Otherwise,
  639.   it returns 1 for error.
  640.  
  641. ──────────────────────────────────────────────────────────────────────────────
  642.  
  643.  
  644.   CHAPTER 4 - Credits
  645.  
  646.     I would like to think all the registered users and Alpha/Beta/Gama Testers
  647.   for there contributions.  Thank you for the time you spent testing the code,
  648.   reporting problems, and making suggestions.  CronCT/2 wouldn't be half the
  649.   program it is today without you!
  650.  
  651.   Alpha/Beta Sites:
  652.    
  653.     Jennifer Blackwell
  654.     Mark Zembrzuski
  655.     Jason Knight
  656.     Eric Hall
  657.     
  658.   I'd also like to send a very special thinks to:
  659.   Bob Hood     - For answering so many questions!
  660.   Miriam Irwin - So MANY things its unreal!  :)
  661.  
  662. ──────────────────────────────────────────────────────────────────────────────
  663. 
  664.