home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 11 Util
/
11-Util.zip
/
cronct11.zip
/
CRONCT.DOC
< prev
next >
Wrap
Text File
|
2003-05-21
|
11KB
|
242 lines
CronCT/2 v1.10ß & CUtil/2 v1.10ß
Timed Program Execution
(C)opyright 1993-1994 CyberTech Software
by
Billy Glover
■ (C) Copyright & License Information -- PLEASE READ
CronCT Executables & Documentation are Copyright (C) CyberTech Software,
Billy Glover. All Rights Reserved. You may use CronCT in any environment
for any purpose. You may NOT sell CronCT, nor charge a fee for CronCT
except where a nominal price would be applicable for recovering costs.
You have accepted this program with the understanding that CyberTech
Software makes no representations or warranties as to the suitability of
this program for your particular purpose, and to the extent you use or
implement this program in your own setting, you do so at your own risk.
In no event will CyberTech Software be liable for any damages, whether
consequential, incidental, or special, arising out of the use or inability
to use the program provided herewith. This program has restrictive terms
and conditions associated with its use and reproduction to which you must
agree. DO NOT POST MODIFIED VERSIONS OF THIS PROGRAM FOR PUBLIC ACCESS.
■ CronCT/2
CronCT/2 has been a project of mine for about 8 months. It started out
a very simple program for a boss of mine and evolved into something very
different! I've used it 24 hours/day on a 486 DX-33 8 MEG RAM and haven't
had any trouble. There have been several requests for a DOS DESQview
version, so I've been checking into it. A PM DatFile editor is on the way,
but I don't know much about PM coding. I NEED Alpha/Beta sites! If your
interested, please call the number below. I would also like to take the
time to thank Bob Hood for all the help with CronCT/2. Again this was a
major code update, so be carefull as there may be bugs. :)
If you have ANY trouble I'd be glad to help you out anyway I can, just
call the number below.
■ REGISTERING CronCT/2
You may register by calling up (817) 684-1434 and getting a 10 digit
code. It cost nothing, and only used so I can keep track of who is
currently using the program. It also lets me make sure that Alpha/Beta
copies are only being used by authorized sites only. Currently all Betas
are public.
■ The DATAFILE
CronCT/2 DATFILES may be created with any text editor. If you get an
Exception Error your datafile is a good place to start looking for your
trouble.
When CronCT comes online it will check all AT Queue Entries for there
Date/Time and if found past due, will delete its entry from the Datafile.
Later I'll put in options for rescheduling it.
While running CronCT will check the current datafile and rescan it if it
has been changed, but will wait for all General Queue entries to Terminate
before rescaning. When rescaning the datafile it will only rescan General
Queue entries and not AT, if you change an AT entry you must stop/restart
CronCT before change will take place.
'LOG:' entries enable CronCT's FileLoging ... 'LOG: CronCT.LOG'
'REG:' CronCT/2 RegInfo
Comments are denoted by a '#' sign in the 1st column
Comments denoted by '#$' are logged each time the processes
after them are executed
One Queue Record/Line
Queue Records are limited by memory only
Each Queue Record will have the following:
[!]Minutes, [!]Hours, [!]Days,[!]Months, [!]Day of Week
Fullscreen or Windowed ( FULL[-] | WIND[-] '-' = Minimized to Icon )
[PATH]File Executable & Options
Entries starting with '@ ' are AT processes
0 1 2 3 * FULL- D:\os2\apps\misc\backup.exe -now
On March 2, 01:00 am Launch <backup.exe -now> as Fullscreen MIN process.
Minutes, Hours, Days, Months, and Day of Week can each have multiple
entries by separating them with commas. Make sure there aren't any
spaces after each comma ( 23,53,52 ). All times ( unless noted ) are in
24 hour format, this may change later.
If you add an '!' before a number it is treated as a time to kill,
( 0,!30 ) starts on 0 minute, and kills on minute 30.
An '-' is the range operator. ( 0,2-7 ) would go on 0 and 2 through 7.
The '!' operator will also work for ranges so ( 0,!0, 1-3, !1-3 ) would
be correct.
In most cases CronCT/2 will auto-detect the process type (PM/OS2/VDM),
but defaults to type OS2. You may override this by placing one of the
following tokens after the FULL/WIND token ( PM, OS2, or VDM ). You may
also play the override token in () for (PM), (OS2), or (VDM). This looks
better to some so I made it up to the user.
■ Starting up CronCT/2
CronCT.EXE [/D:DATAFILE.DAT /L:LOGFILE.LOG]
/D:DATAFILE.DAT - Specify new DataFile, default is CronCT.DAT.
/L:LOGFILE.LOG - Specify new LogFile, /L will activate Logging to
CronCT.LOG.
CronCT/2 can be auto-started each time you boot by:
1. Create an Icon for CronCT.EXE and place it in your startup folder.
2. Place it in you startup.cmd file.
3. Type 'START CRONCT.EXE' at the command line.
■ CronCT/2 Menu Commands
ESC Terminate CronCT/2.
/ Move up/down in CronCT's Queue.
E Execute current Queue Record.
G Switch to this running Queue Record.
S Skip/Unskip current Queue Record.
T Terminate ( stop running program ) current Queue Record.
■ CUtil.EXE
CUtil.EXE may be executed from any directory as it 'talks' to CronCT/2
through a named pipe. Place it somewhere in your path for convince. You
can rename CUtil.EXE to anything else you like, I have mine as CU.EXE
Returns ErrorLevel of 0 for Success or 1 for Error.
General Commands:
/? CUtil.EXE Usage Information.
/C Create/Modify DATFILES ( NOT IMPLEMENTED YET ).
/I Get CronCT's General/AT Queue Status.
/Iq General Only, /Ia AT Only, /It AT Time ( am/pm ) to execute.
/L Trim CronCT's LOG. /L FileName # of days to keep.
/L CronCT.LOG 5 would keep the last 5 days log entries from
the log CronCT.LOG
/Q Terminate Running CronCT/2.
CronCT/2 Queue Commands: /COMMAND [QUEUE #] [FILENAME]
/E Execute /S Skips
/T Terminate /U Unskips
CUtil.EXE /S EXE Would Skip all entries with EXE in there FILENAME.
CUtil.EXE /U le Would Unskip all entries will 'le' in there FILENAME.
AT Commands:
CUtil.EXE /AT [/N] [DATE] [TIME] [[NEXT | INCREMENT] TIME DESIGNATION] JOB
CUtil.EXE /AT 01/02/94 03:00 JOB - DateTime.
CUtil.EXE /AT + 2 MONTHS JOB - Now + 2 months.
CUtil.EXE /AT NEXT DAY JOB - Now + 1 day.
CUtil.EXE /AT SAT + 2 WEEKS JOB - Next SAT + 2 Weeks.
CUtil.EXE /AT DEC 7 [1994 | 94] 00:00 JOB
Keywords are: ( Case insensitive )
NEXT | + # [ MIN[UTEs] | HOURs | DAYs | WEEKs | MON[THs] ]
/N = Notify User NOON = 12:00pm MIDNIGHT = 00:00am TOMORROW = +1 Day
Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
/N - Notify User will 'PopUp' in any Fullscreen OS2/VDM window ( this
will include PM later ) thats in the Foreground with a notice that
there AT Queue has finished and post its ErrorLevel. The 'PopUp'
will last 5 seconds or until a key is pressed.
NOTE: AT entries are donoted with a '@ ' before them, the format is:
DATE/TIME to run, DATETIME entered, [(NU) Notify User], FULL/WIND, [PM]
[OS2] [VDM] forced Session Type, JOB. If you need to delete on, just
erase the entire line and resave the DatFile, you will need to stop &
restart CronCT/2 for the change to take place.
■ The Future
Editor to Create/Modify DATFILES in CUtil.EXE.
DOS version of CUtil.EXE.
More than 1 DAT file, and 'chaining' of DATFILES.
Smaller memory requirements & faster code.
I'll also do my best to add anything that asked for.
Better DOCs! Sorry about these docs... Programmers can't write docs! :)
■ Bug Reports, Questions, and Comments
Computer Insight We have some VERY good prices! Just ask.
CyberTech Software
C/O Billy Glover BIZ Voice: 817-552-6286 (Ask for Glen Cook)
P.O. Box 1948 Personal : 817-684-1434 (Ask for Billy Glover)
Vernon, TX 76385 FAX : 817-552-6288 (24 hours/day)
■ History
v0.01α 12/29/93 - First Release.
v0.02α 04/05/94 - Major Rewrite of code. Many Features added,
And many bugs fixed!
v0.03α 04/14/94 - ADDED CUtil.EXE with Option /I INFO.
04/22/94 - ADDED Skip/Unskip Commands to CronCT/2.
04/30/94 - ADDED Skip/Unskip/Execute/Terminate/TERM CronCT/2
Commands to CUtil.EXE
05/22/94 - ADDED Full /AT Command to CUtil.EXE
05/27/94 - ADDED /L Opt to CUtil.EXE: /L LogName # of days.
05/29/94 - UPDATED CronCT.DOC file. :)
06/01/94 - FIXED several bugs from adding so much new stuff.
v1.00ß 06/01/94 - Released CronCT/2 v1.00ß & CUtil/2 v1.00ß
v1.10g 06/11/94 - Changed DATFILE() to be more forgiving... :)
06/11/94 - Changed DATFILE() to not convert lower case to
upercase. Some program opts are case sensitive,
sorry about this one... :) Thanks Jason.
06/11/94 - Made the PIPE that CUtil.EXE talkes to CronCT/2 with
Optional.
06/11/94 - ADDED 'LOG:' Opt to Datafiles.
06/19/94 - ADDED 'REG:' Opt to Datafiles.
06/19/94 - FIXED some minor bugs from updates...
07/01/94 - Changed DATFILE() to support '!'.
07/03/94 - Changed DATFILE() to be faster.
07/05/94 - Changed CUtil.EXE /L Opt, added stats.
07/07/94 - Changed DATFILE() to support '-' range opt.
07/08/94 - Changed PQueue() to put a '*' before a Forced App Type
07/08/94 - Released CronCT/2 v1.10g & CUtil/2 v1.10g.