Category : Utilities for DOS and Windows Machines
Archive   : TVENT11.ZIP
Filename : TVENT.DOC

Timed eVENT scheduler
Version 1.1
by
Jim Derr

Member of
Association of Shareware Professionals
CSERVE ID 76266,2634


Please note this is a shareware product. If you find these utilities
useful please register and keep shareware alive. Only registered
users will be supported. The fee is small and not unreasonable.


LIMIT OF LIABILITY

TVENT is distributed asis. The author disclaims all warranties,
expressed or implied. The author will assume no liability for
damages either from the direct use of this product or as a
consequence of the use of this product.



-----RUNAT-----


There are two programs included with this package. RUNAT is a program
that will run a program or a BAT file at a specified time. When you
execute RUNAT it will prompt you for the time that you want to run
the program, the directory where the program can be found, the
program that you want to run, and any parameters that the program
requires. RUNAT will then display a window showing the current time
and all entered information. It will wait until the specified time
has occurred before it executes the program or BAT file.

You can also enter all necessary parmeters on the command line. The
command line parameters are shown below.


Usage RUNAT [options] WHERE OPTIONS ARE:
/hxxx = absolute or relative hour to start
(to specify a relative hour precede hour with a + sign)
/mxxx = absolute or relative min to start
(to specify a relative min precede min with a + sign)
/dxxx = disk:\directory of program or bat file
/pxxx = program or bat file to run
(if bat file must enter the .BAT extension
"parms" = parms to pass to program
(must be enclosed in double quotes)
/? = display help

(PLEASE NOTE you must enter the /h /m /d and /p options or RUNAT will
prompt you for all the information it needs.)

EXAMPLE: RUNAT /h9 /m1 /dc:\utility /ppmap "/x"
RUNAT /h+1 /m+1 /dc:\utility /ppmap "/x"

The command line is the only place where you can specify a relative
hour and relative min. YOU CAN NOT ENTER A RELATIVE NUMBER FOR THE
HOUR AND MIN. IF RUNAT PROMPTS YOU FOR THE INFORMATION.

When RUNAT puts up the waiting window the ESC key can be pressed to
abort RUNAT, or the F10 key can be pressed to execute the program or
BAT file immediately.

NOTES ON RUNNING BAT FILES:

The way RUNAT executes a BAT file is to invoke a secondary
command processor to service the BAT file. This is all well
find and good except if the BAT file you execute is going to put
something new into the ENVIRONMENT AREA. Since the secondary

command processor allocates only enough memory to hold the
current USED size of the environment area (i.e. no free space)
you end up getting a message OUT OF ENVIROMENT SPACE. UGGGGGLY.
Well the only way out of this mess is to set up some dummy
environment variables before running RUNAT and then have your
BAT file clear them before setting any new variables.

For Example do the following before running RUNAT:

SET DUMMY1=1111111111111111111111111111111111111111
SET DUMMY2=2222222222222222222222222222222222222222

Then execute RUNAT with your parameters:

RUNAT /h8 /m30 /dd:\plus /phost.bat

Have the BAT file host.bat do the following:

ECHO OFF
SET DUMMY1=
SET DUMMY2=
SET NEWONE=YES
SET NEWTWO=YES
PCPLUS /FHOST


I know this is complex but I haven't found anyother way to do it. If
anyone knows a better way please contact me at the above address.


-----TVENT-----


TVENT is a timed event scheduler. TVENT can handle up to 20
different events each occurring at user specified times. Before
TVENT can be used the TVENT.CFG file must be created. This is
accomplished by executing TVENT with the /SETUP option. This option
will display a data entry screen. Use the Pgup and Pgdn keys to
scroll thru the 20 available entries. Pressing F3 will save the
TVENT.CFG file into the current disk:\directory. The TVENT.CFG file
can be moved to any disk:\directory that is defined in your path.
TVENT will tell you if it can't find it.


TVENT has the capability to automatically execute programs, BAT
files, and to display messages only, at user specified intervals. It
can be setup to perform an item every day, every other day, every
third day,... every 9th day, on a specific day, or every time TVENT
is run. In addition you can have TVENT prompt you to perform an item
so you can decide if you really what to perform the item today.



FILLING OUT THE EVENT DATA ENTRY SCREEN

Shown below is a copy of the EVENT DATA ENTRY SCREEN. Each input
field is numbered for reference purposes only.


ÉITEM#= 0ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ[TVENT EVENT DATA INPUT]ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º º
º º
º º
º º
º First message to display on Warning Screen (REQUIRED) º
º(#1) º
º Second message to display on Warning Screen º
º(#2) º
º Disk and Directory where item to execute can be found (Optional) º
º(#3) º
º Item to execute (include any necessary command line parameters) º
º(#4) º
º (#5)ÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿º
º ³ ³ ³ ³ ³ ³ ³ ³º
º        º
º Run on These Days: SunN MonN TueN WedN ThurN FriN SatN Specific-DayNº
º º
º (#6)ÄÄÄÄ¿ º
º  º
º Run Freq0 (0=every time,1=once a day,2=every other time,3=every 3rd time) º
º (4=every 4th time,......9=evey 9th time) º
º º
º (#7)ÄÄÄÄÄÄÄÄÄ¿ (#8)ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ º
º ³ ³ º
º   º
º Display a Warning Screen(Y or N)Y Pause after running item(Y or N)N º
º º
º If running on a specific day enter date to run(YYMMDD): (#9) º
º º
º Freq Count = 0 Last run on º
º º
ÈÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ[F1=HELP F3=SAVE Pgup=Next Pgdn=Prev]ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ




Field #1:

This field specifies the first line of a message to display on the
warning screen if the warning feature is selected. It also serves as
a trigger to TVENT to tell it that this item is active.
(THIS FIELD MUST NOT BE BLANK!! IF IT IS LEFT BLANK TVENT WILL
BYPASS THIS EVENT UNCONDINTIONALLY)

Field #2:

This field specifies the second line of a message to display on the
warning screen.

Field #3:

This field specifies the disk:\directory of where the item to execute
can be found. If the item to execute is in your path you do not need
to specify it here. If you do specify a disk:\directory TVENT will
change to the disk:\directory before executing the Item.

Field #4:

This field specifies the name of the program or BAT file to run
along with any needed command parameters. If you will be running a
BAT file you must enter the .BAT file extension.
If you do not want to execute anything but only display a warning
message leave this field blank and be sure that Field #7 is set to a
Y.

Field #5:

These fields tell TVENT the weekdays and/or a specific day to
activate this event. Set each day to a Y or a N.

Field #6:

This field tells TVENT the run frequency of the event.

0 = Trigger this event everytime TVENT is executed on a scheduled
day.

1 = Trigger this event once on each scheduled day.
If TVENT is executed more than once a day this will prevent
TVENT from triggering this event everytime it runs.

2 = Trigger this event every other scheduled day.
Examples:
If the event is scheduled to run on Monday this will cause
the event to run every other Monday.

If the event is scheduled to run on Monday,Tue,Wed, this
will case the event to run on Mon, Wed.

3 = Trigger this event every third scheduled day.

n = Trigger this event every Nth scheduled day.

Field #7:

Setting this to Y will cause TVENT to display a Warning Screen
before. Setting this to N suppressed the Warning Screen. If the
Warnging screen is displayed you will have the option of running the
scheduled program or bypassing it.

Field #8:

Setting this to Y will case TVENT to pause after running the
scheduled program. This will allow you to view the contents of the
screen before TVENT clear it.

Field #9:

This field is used to specify a specific date you want to trigger an
event. To use this option you must set the field titled
SPECIFIC-DAY in Field 5 to a Y.



ADDITIONAL TECHNICAL INFORMATION

TVENT can recognize most monitor types. However if you have a
monochrome monitor that emulates a CGA or VGA monitor you may experience
a strange looking display. If this happens set the environment variable
MONO to a Y and try executing TVENT again. I.E. SET MONO=Y.