home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
CALS2_0.ZIP
/
CALSCHED.DOC
< prev
next >
Wrap
Text File
|
1993-01-24
|
13KB
|
366 lines
````````````````````````````````````````````````````````````````````````````
````````````````````````````````````````````````````````````````````````````
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` "C A L S C H E D" ``
`` ``
`` v2.0a ``
`` ``
`` THE SCHEDULED EVENT TIMER ``
`` ``
`` RELEASED SHAREWARE ``
`` ``
`` ENTIRE WORK COPYRIGHTED (C)1993 BY MICHAEL S. HOENIE ``
`` ``
`` ALL RIGHTS RESERVED ``
`` ``
`` Written, Designed & Programmed by Michael S. Hoenie ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
`` ``
````````````````````````````````````````````````````````````````````````````
````````````````````````````````````````````````````````````````````````````
0.0 DOCUMENTATION CONTENTS.
0.0 DOCUMENTATION CONTENTS.
this section of the documentation.
1.0 INTRODUCTION.
explains what CALSCHED is and what it does.
1.1 CALSCHED FEATURES.
2.0 SOFTWARE DISCLAIMER AND SHAREWARE NOTICE.
shareware description, copyright notices.
3.0 COPYRIGHTED NOTICES.
4.0 CALSCHED MODULE HARDWARE SPECIFICATIONS.
effectivly playing CALSCHED, dos and memory configurations,
graphics config, monitor functions, 8mhz-4mhz differences.
4.1 MODIFYING YOUR "SCHEDULE.DAT" SCHEDULE FILE.
5.0 INITALIZING CALSCHED.
CALSCHED path, CALSCHED directory.
6.0 COMMAND LINE PARAMETERS.
listing of all command line variables available to you.
7.0 AUTHOR FEEDBACK.
us-mail drop, bbs contact, bbs-network, how to get in touch
with the author, list of boards where CALSCHED code files and
MODULE files are distributed, general thanks.
1.0 INTRODUCTION.
CALSCHED is a program that allows you to run up to 30 schedules per
day or night, unattended. CALSCHED was written to be used with
GETMAIL, a program that allows you to call PCBOARD systems, upload
and download mail using MEGAMAIL or QMAIL4.
CALSCHED is a program to set up schedules to call any of thirty
scheduled events. You can download your mail from any PCBOARD bbs
by using GETMAIL and CALSCHED
1.1 CALSCHED FEATURES.
v2.0 features:
~~~~~~~~~~~~~~
o CALSCHED will allow you to run up to 30 batch files any day or
days - or all days of the week.
o CALSCHED can run up to 30 scheduled events. Simply run it and
leave your machine running. CALSCHED will run all of the events.
This is good for users pulling mail off boards at night, hard
disk cleanups, mail systems and so forth.
o Simple abort of program with the touch of any key.
o Easy one file setup with automatic compilation of any changes
made.
2.0 SOFTWARE DISCLAIMER AND SHAREWARE NOTICE.
You may not reproduce this code for profit or direct sales. You may
not modify the code and redistribute it to other users. This code
is provided "AS IS" without warranty of any kind, either expressed
or implied, included but not limited to the implied warranty of
merchantability and fitness for a specific purpose. The entire risk
as to the quality and performance of the coding is with you. Should
the code prove defective, you assume the entire cost of all
necessary servicing, repair or correction. In no event will the
author be liable to you for any damages, including any lost
profits, lost savings or other incidental or consequential damages
arising out of the use or inability to use this code.
This version is termed "SHAREWARE".
You may not engage in nor permit third parties to engage in any of
the following:
1. Making any kind of alteration to the software or the files
that are contained within the CALS2-0.ZIP file.
2. Attempt to disassemble, decompile, or reverse engineer the
software or the files it generates in any way.
3. Granting sub-licenses, lease or other rights in the software
to others.
CALSCHED is distributed as "SHAREWARE." This means that CALSCHED is
distributed freely to whomever wants to use it, without charge for
an indefinite trial period.
CALSCHED is a fully functional SHAREWARE program. It is not
crippled in any way.
NOTICE: If you have a registered version of GETMAIL then you are
entitled to recieve CALSCHED registration FREE OF CHARGE.
Just list your GETMAIL registration on the orderform and
send it in to us.
3.0 COPYRIGHTED NOTICES.
CALSCHED was compiled using Borlands Turbo Pascal version 4.0,
copyright Borland International.
CALSCHED was programmed using QEDIT v2.1, February 1990 -
copyrighted (c)1985-1990 by SemWare - all rights reserved.
MS-DOS is a trademark of Microsoft Corporation.
CALSCHED is copyrighted under the copyright laws of the United
States of America. CALSCHED are copyrighted (c) 1993 by MICHAEL S.
HOENIE.
NOTICE: The CALSCHED documentation and program files are subject to
change without notice from MICHAEL S. HOENIE. CALSCHED was
designed to go with GETMAIL, a PCBOARD mail retreiver,
however, it may be used for purposes other than GETMAIL.
4.0 CALSCHED MODULE HARDWARE SPECIFICATIONS.
CALSCHED should be located in it's own directory. Create a directory
such as "C:\CALSCHED" and change to that directory. The ZIP or ARJ
file (respectivly) is an archive file.
All .DAT files should be contained in the CALSCHED directory.
The filename should be: CALS2-0.ZIP or CALS2-0.ARJ.
If you have purchased GETMAIL and it was mailed to you, then you will
not need to UN-ZIP or UN-ARJ the CALS2-0.ZIP/ARJ file.
Extract the CALS2-0.ZIP file by typing:
PKUNZIP CALS2-0.ZIP
Or, extract the CALS2-0.ARJ file by typing:
ARJ E CALS2-0.ARJ
CALSCHED will then be extracted.
To execute CALSCHED, run the SCHED.BAT batch file. This batch file
will do the following:
ECHO OFF
CD C:\SCHED
IF EXIST SCHEDULE.BAT ERASE SCHEDULE.BAT
CALSCHED.EXE
IF EXIST SCHEDULE.BAT SCHEDULE.BAT
ECHO ON
Here is a detailed list of how the batch file works:
1. Turn off the echo:
ECHO OFF
2. Change to the SCHEDULER directory: (where CALSCHED is located)
CD C:\SCHED
3. Erase the old schedule file if it exists:
IF EXIST SCHEDULE.BAT ERASE SCHEDULE.BAT
4. Run CALSCHED.EXE:
CALSCHED.EXE
5. Run the SCHEDULE.BAT file if it exists:
IF EXIST SCHEDULE.BAT SCHEDULE.BAT
6. Turn on the echo:
ECHO ON
WARNING: CALSCHED MUST BE RUN THROUGH THE "SCHED.BAT" FILE. THIS
BATCH FILE CONTAINS EXECUTION FOR SCHEDULE.BAT. ONCE A
SCHEDULE IS ACTIVATED, ALL CONTENTS OF THE BATCH FILE CALLED
WILL BE COPIED INTO THE SCHEDULE.BAT FILE. IF THIS BATCH
FILE EXITS, THE "SCHED.BAT" FILE WILL EXECUTE IT.
4.1 MODIFYING YOUR "SCHEDULE.DAT" SCHEDULE FILE.
Before running CALSCHED, you must first edit your SCHEDULE.DAT
file. This file is broken up into variables that CALSCHED will
compile. CALSCHED will always automatically compile it.
sched,#<1..30>,time=<00:00>,batch=<batchname>,enabled,days=<01234567>
Where:
"sched" = the definition of a schedule record.
"#<1..30>" = a schedule number 1..30. CALSCHED will allow
you to use schedules out of sequential order.
This means that you could use any schedule you
wish.
"time=<00:00>" = a time that this schedule will go off. You
must use military time ranging from 00:00 to
24:59. If the time is less than 12:00, then a
0 must be inserted in front of the time, thus
making 2:00 into 02:00.
"batch=<batchname>" = a batchfile name to run when schedule is
activated. Once the schedule is run, the
contents of <batchname> will be copied into
SCHEDULE.BAT, CALSCHED will halt and the
SCHEDULE.BAT file will be run.
"enabled" = this schedule is enabled to execute at the
given time. If you specify "disabled" then the
schedule will not run.
"days=<01234567>" = which days the schedule should run. Valid days
are 0 through 7. 0 = all days, 1=monday,
2=tuesday, 3=wednesday, 4=thursday, 5=friday,
6=saturday, 7=sunday. You may also specify 135
for monday, wednesday and friday events to
run.
6.0 COMMAND LINE PARAMETERS.
Here is a list of command line variables. (LOWER CASE ONLY)
/v = Show version of CALSCHED and compilation date without running
the scheduler.
7.0 AUTHOR FEEDBACK.
The author, MICHAEL HOENIE, can be found on the following networks
and bulletin board systems. Please do not attempt to contact the
author by voice, however, he will respond to electronic mail across
the networks.
US-MAIL: 4241 S. MARQUIS WAY, SLC, UT, 84124.
A Support Conference exists on : THE SANDBOX under "SN-SHAREWARE".
- (801) 569-2803/1818.
Here is a list of Bulletin Board Systems that CALSCHED gets placed
on for the latest versions.
HOME BOARD: (where the latest CALSCHED can *always* be found)
The Sandbox, DOOR DIRECTORY, (801) 569-2803/1818. USR 9600bps.
- Thom Allen, Sysop, SOURCENET, FIDO, BITNET networks;
OTHER BOARDS: (uploaded to as deemed fit)
The Rat Trap, MAIN BOARD, (801) 561-5025. USR 38.4k
- Marty Greenlief, Sysop, INTELEC networks;
CONFERENCES TO CORRESPOND WITH THE AUTHOR (as of 01-Feb-93):
SourceNet Network:
- PASCAL [moderator], SHAREWARE;
Intelec Network:
- PASCAL;
RIME Network;
- SHAREWARE;
PCRelay Network;
- SHAREWARE;
The author would like to personally thank THOM ALLEN for his kind
words, and for allowing CALSCHED to be placed on his system as a
free download.