Copyright: ® GS Solutions 1993-1995


Event List

The Event List dialog gives a list of events you have. You can add, edit, copy or delete events.
The fields are listed:

Description Window

The events are described as:
1. Event Description
What you called the event
2. Type
Once, Hourly, Daily, Week Days, Week Ends, Weekly, Monthly  or Yearly
3. Active Time
The actual time the event will be triggered

Add Button

Brings you to the Event Setup window ready to add a new event

Edit Button

Brings you to the Event Setup window ready to edit the current event you are highlighting in the event list
You can also double click on the event you want to edit

Copy Button

Brings you to the Event Setup window ready to edit a copy of the current event you are highlighting in the event list

Delete Button

Will instantly delete the current event you are highlighting in the event list

Help Button

Opens the Windows help file to the Event List context

OK Button

Minimizes the event list

Move Spinner

Moves the selected event up or down on the list for higher or lower priority if event are scheduled for the same time

File Menu

Consist of:
1. Add
  Brings you to the Event Setup window ready to add a new event
2. Edit
  Brings you to the Event Setup window ready to edit the current event you are highlighting in the event list
You can also double click on the event you want to edit
3. Copy
  Brings you to the Event Setup window ready to edit a copy of the current event you are highlighting in the event list
4. Delete
  Will delete the current event you are highlighting in the event list
5. Minimize
  Minimizes the event list
6. Exit
  Closes WinEvent thus canceling all events

Configure Menu

Consist of:
1. System Setting
  Opens the System Settings dialog
2. Disable Events
  Will temporally disable all of the events
3. Set Time & Date
  Opens the control panel to set the time and date
4. View Log File
  If you checked the option 'Log Events', in the system setting, then you can view the log file created by WinEvent
5. Delete Log File
  Deletes the log file
6. Choose a Viewer
  If you prefer a different view

Help Menu

Consist of:
1. Contents
  Opens this help file to it's contents
2. Search
  Opens this help files search dialog
3. About WinEvent
  Gives you information about this program and your system

System Menu

Added:
1. System Settings
2. Disable Events
3. Set Time & Date
4. View Log File
5. Exit Windows
6. Restart Windows
7. Reboot System
8. About

Contents


Copyright

These programs and the related documentation are copyright. The owner is John Geary. All rights reserved. You may not use, copy, modify, or transfer the programs, documentation, or any copy except as expressly provided in the shareware agreement.

© GS Solutions 1993-1995.

Contents


Event Setup

The Event Setup dialog is where you add new events or edit existing ones
The fields are listed:

Description

Your description of the event

Run What

Note: Some of these options will display a group of radio buttons called Unload Method. Please read this topic for a complete discription of these methods

Consist of:
1. Run a Program

Tells WinEvent to run the Command Line using the Startup Directory and Run Style you specified
Note: This option also offers Send Keys. Please read this topic for a complete discription of these methods

2. Display a Reminder Dialog

Tells WinEvent to display a reminder
The Reminder Dialog will be displayed when the event is executed

3. Exit, Restart or Reboot

1. Exits Windows and returns to DOS. This option also offers a Return Code. Please read this topic for a complete discription of these methods
2. Exits and restarts Windows
3. Exits Windows and Reboots the computer

4. Unload by Module/Unload by Title

Use this option to close a program (by title) or group of programs(by module).
The easy way to do it:
1. Start the program you want to unload later.
2. Click the Running Button and choose the program you just started.
3. Schedule the time for the event
4. Press OK
Note: Before pressing OK you can test this option to see the program close by pressing the Test Button.

Caution:
Terminating a vital program, such as a Windows Shell can cause Windows to crash!
Use these options with care!

5. Send Keys by Title

Sends keystrokes to applications that are already running.

6. Unload Method

Please read the topic Unload Method for a complete discription of these methods.

Command Line/Message to Display/Module to Terminate/Window to Terminate/Window to Send Keys

Command line of a program to execute goes here or,
The Message you want to display to remind you or,
The Module name of the programs you want to terminate or,
The Title of the program you want to terminate or Send Keys to.

Startup Directory

Type the complete path of the startup directory here.
ie: c:\winfax

Schedule

Consist of:
1. When

One Time	specifying:(Time of day, Date, Month, Year)
Hourly	specifying:(Minutes after the hour)
Daily	specifying:(Time of day)
Week Days	specifying:(Time of day)
Week Ends	specifying:(Time of day)
Weekly	specifying:(Time of day and Day of week)
Monthly	specifying:(Time of day and Date)
Yearly	specifying:(Time of day and Date)

2. Time

Time of day

3. Day

Day of week

4. Date

Day number of Month

5. Month

Month name

6. Year

This year or next year

Next Page on Event Setup

Contents


Copyright ©
             WinEvent

      Windows Event Scheduler

  Copyright © GS Solutions 1993-1995

                      All Rights Reserved


Introduction

    WinEvent TM (Windows Event Scheduling Program) is an easy to use tool that allows you to:

Schedule programs to start unattended

Reminder messages to popup at a specified time

Schedule exit, restart and reboot

Unload single programs by title, or groups by module

Send keystrokes to applications when they start or while they're already running.

WinEvent can even run programs that don't run under Window and then restart Windows when it's done!

You can schedule an event for:

One Time	specifying:(Time of day, Date, Month, Year)

Hourly	specifying:(Minutes after the hour)

Daily	specifying:(Time of day)

Week Days	specifying:(Time of day)

Week Ends	specifying:(Time of day)

Weekly	specifying:(Time of day and Day of week)

Monthly	specifying:(Time of day and Day in Month)

Yearly	specifying:(Time of day and Date)

     For information on using WinEvent read Getting Started.

    To become a registered user, please see "Registration Information".

Contents


Contents
WinEvent

Copyright © GS Solutions

Windows Event Scheduler

Introduction

Requirements

Getting Started

Customer Support

Whats New

Program History

Registration

Registration Information

Ordering by Credit Card

Shareware Agreement

Limited Use

Contacting the Author

Disclaimer

Copyright

The Shareware Concept

Press F1 to get help on using Help.

For context sensitive help select a window and press F1.


Registering
WinEvent Registration Form/Invoice

Ordering by check:

Mail this order form and the check or money order to:
GS Solutions, P.O. Box 762, Soquel, CA. 95073-0762.
To print this order form pull down the help file menu and select print.
We prefer payments made in US dollars drawn on a US bank.

Credit card ordering:

See Ordering by Credit Card

Ordering with CompuServe's Software Registration Service:

Enter GO SWREG at the ! prompt and request product registration ID = 2751.

Site licenses:

A site license for WinEvent entities an organisation to receive one copy of the distribution package and duplicate the distribution disk for the specified number of copies.

Invoice:

Please check one: 5.25" Disk ____  3.5" Disk ____ Either size ____

WinEvent Single Copy    ____    copies at $29 each	=	______
WinEvent Site License
  2 to   9 computers:	____ computers at $25 each	 	=	______
 10 to  24 computers:	____ computers at $20 each	=	______
 25 to  49 computers:	____ computers at $16 each	=	______
 50 to  99 computers:	____ computers at $11 each	=	______
100 to 199 computers:	____ computers at $6.50  each	=	______
Over 199 copies are negotiable.
CA Residents add local sales tax (7%-8.25%)	+	______
Shipping and Handling	+	   $6.00
Total payment	______

Name:____________________________Date:______________

Company:___________________________________________

Address:____________________________________________

City, State, Zip:_______________________________________

Country: ____________________________________________

Day Phone:___________________Eve:____________________

Electronic Mail address:________________________________

How did you hear about WinEvent ?________________________

Comments:


Requirements

You must have the following file:

VBRUN300.DLL - the Visual Basic runtime library.

and be running Windows 3.1 or higher to use  WinEvent.

Contents


Program Execute

If you specified a program to run WinEvent will display the Program Execute dialog when the event fires that will describe the event, program to execute and a countdown from whatever you specified in the System Settings.

 Your choices from here are:
1. Snooze x minutes

The Event will attempt to execute again in however many minutes you specified in the System Settings dialog.
An * shows in the Event List next to an event that's snoozing.

2. Start Event Now

The event will start immediately

3. Cancel Event

The event will be canceled completely

Contents


Getting Started

Windows

Event List

Event Setup

Return Code

Send Keys

Unload Method

System Settings

Program Execute

Reminder Dialog

Creating New Events

1. Start WinEvent normaly.

If WinEvent is hide simply run it again and it will display the Event List

2. Pull down the File menu and choose the options you want

Refer to the Event List for details on choices

3. Click the mouse on Add

The Event Setup will appear with the caption 'Add Event'

4. Type in a discription of the event you are scheduling

5. Select whether to run a program or display a reminder

6. If you choice to run a program then type in a command line. For a reminder type in a message

Use the Browse Button or Running Button if you would rather point and click the program to run and then type any optional perameters the program might require after it on the command line

7. Enter the complete path of the startup directory here

If you used browes this field will be filled with the directory that the program is located in
example: c:\winfax

8. Choose the Run Style if the event is a program

Refer to the Event Setup for details on choices

9. Schedule when the event will occur

Refer to the Event Setup for details on choices

10. Click the OK button

If all the information is correct then click OK. The event will be added to the Event List

Note

Events can occur while you adding or editing other events

Contents


Reminder Dialog

When a reminder event fires it will display your message and wait for you to press OK before erasing the message.

Note

Up to 50 Reminders can be displayed on the screen a once!
And all programs scheduled will still execute without clearing the reminders.

Contents


Customer Support

If you have any problems,questions,suggestions please send me mail to one of the following addresses:

By eMail @ Compuserv 72623,3712

By Snail Mail @ GS Solutions, P.O. Box 762, Soquel, CA. 95073--762.

If you decide not to register please send me a message describing what you would like to see in WinEvent that would interested you.

Contents


Shareware Agreement

You are hereby licensed to:  Use this software for a 30 day evaluation period; make as many copies of this software and documentation as you wish; give exact copies of the original to anyone; and distribute the software and documentation in its unmodified form via electronic means.  There is no
charge for any of the above.

You are specifically prohibited from charging, or requesting donations, for any such copies, however made; and from distributing the software and/or documentation with other products (commercial or otherwise) without prior written permission.

Contents


Limited Use

This product is Shareware and its continued development can only be supported by YOU This license allows you to use this software for evaluation purposes without charge for a period of 30 days.  If you use this software after the 30 day evaluation period a registration fee is required. One registered copy of WinEvent may be used by a single person who uses the software on one or more computers or to a single workstation used by multiple people.

If you continue to use this product after a reasonable trial period then please register it.

The Benefits

The Nag messages will be removed immediately upon registration You will be advised of updates and other products available.

The Cost

US$29.00
Payable by Check or Money Order.

Contents


Disclaimer

This product is provided "as is" without representation of warranty, either expressed or implied.

The entire risk as to the use of this product is assumed by the user.  In no event will GS Solutions or their estate be liable for any damages direct, indirect, incidental or consequential resulting from any defect in the product.

If you do not accept these terms you must cease using this product forthwith and destroy the program, the documentation and all copies thereof.

Contents


The Shareware Concept

Shareware is copyrighted software that is distributed by authors through bulletin boards, on-line services and disk vendors.

Shareware allows you to try the software for a reasonable limited period.  If you decide not to continue using it, you throw it away and forget about it. You only pay for it if you continue to use it. Shareware is a distribution method, not a type of software. You benefit because you get to use the software to determine whether it meets your needs, before you pay for it.

The shareware system and the continued availability of quality shareware products depend on your willingness to register and pay for the shareware you use. It's the registration fees you pay which allow authors to support and continue to develop our products. Please show your support for shareware by registering those programs you actually use.

Contents


Ordering by Credit Card

You can order with MC, Visa, Amex, or Discover from Public (software) Library by calling:	800-2424-PsL or 713-524-6394
or by FAX to:
713-524-6398
or by CIS Email to:
71355,470
You can also mail credit card orders to:
PsL
P.O.Box 35705
Houston, TX 77235-5705.

You will need the following information to register:
product: WinEvent
product #11355
$33 US/Canada and $35 overseas will be billed to your credit card.

 THE ABOVE NUMBERS ARE FOR ORDERS ONLY.

  PsL operators are available from 7:00 a.m. to 7:00 p.m. CST Monday-Friday and normally from 7:00 a.m. to 4:00 p.m. on
weekends.

  Any questions about the status of the shipment of the order, refunds, registration options, product details, technical support,
volume discounts, dealer pricing, site licenses, etc, must be directed to GS Solutions at one of the following:

CompuServe:   72623,3712 (Compuserve members only)
or regular mail to:

GS Solutions
P.O. Box 762
Soquel, CA. 95073-0762.

  To insure that you get the latest version, PsL will notify us the day of your order and we will ship the product directly to you.

Contents


Program History

Version 1.5x:

Unload a Program

Turn off the title bar clock

Don't show errors

Log Events

Load With Windows

Move or 'Promote' Events in the list

Improved Event handling

Turn off the bell

Now Time Button

Return Codes when exiting Windows

Temporarily disabling of all Events

Better Event handling

More System menu functions

Set the Time and Date

New Spinners :-)

Version 1.25:

You can now tell WinEvent where to find the EVENTLST.INI File

Changing to the startup directory now works properly.

Version 1.24:

International Date Formats are accepted now.

The nag has also been improved (like you really care!)

Version 1.23:

A System Settings dialog has been added to give you control over:

Showing a countdown or not

How long of a count down

How often to check for an event

To check the eventlst.ini file for changes or not

How often to check the eventlst.ini

Also:

The File Menu has been changed and the Hide Minimized, Start Minimized, and Check EVENTLST.INI options have been moved to the System Settings dialog.

An * shows in the Event List next to an event that's snoozing.

Version 1.1:

WinEvent TM now has the capability to:

'Quick' Exit Windows

Restart Windows

Reboot the System.

These new functions can be used in your events.

They have also been added to the system menu so that you can use WinEvent as a 'quick' exit utility.

To use as a 'Quick' Exit utility just click once on the control box in the left corner or if it's minimized click once on the icon and select 'Exit Windows' from the menu.

Contents


System Settings

The System Settings dialog is where you can specify things like showing a countdown or not, how long of a count down, how often to to check for an event, to check the eventlst.ini file for changes or not and how often to check the eventlst.ini file
The fields are listed:

Hide Minimized

Hides WinEvent when it's minimized
WinEvent can be displayed by running WinEvent again

Start Minimized

Starts WinEvent minimized and hides it if you specified Hide Minimized

Load w/Windows

This will ether append or remove WinEvent from the load= line in the win.ini file

Display Countdown

Checking this will display the Program Execute dialog and use the specified countdown

Turn off Title Clock

In some cases you may not want the title on WinEvent to display the time are date

Show Errors

Dosn't display an error messege if a program isn't found or some other reason
Turning this off will enable WinEvent to continue Scheduling while your away

Log Events

Checking this option, reports all event activity to an log file, 'EVENTLOG.TXT', which can be viewed from the Configure Menu.
ie: If it was successful or not and what the cause could be

Turn off Bell

If you don't want any noise when an event happens, check this option

Count Down

Here you tell WinEvent how long to countdown if the Display Countdown is checked and if it's a program your executing.
The range is 1 to 60 seconds

Snooze Time

Here you tell WinEvent how long to snooze if you select snooze in the  Program Execute dialog.
The range is 1 to 59 minutes

Event Cycle

Determines how often to to check for an event, it will default to once a second. If you don't have alot of events scheduled for that exact minute then this can be set for as much as every 30 seconds and still function correctly.
The range is 1 to 30 seconds

Check EVENTLST.INI

Used mostly for updating across a network
Looks at the eventlst.ini file, located in the Windows directory, for any changes that might have occurred and updates the internal Event List
Note:
This will only occur while the Event List is minimized

EVENTLST.INI

Determines how often to to check the Eventlst.ini file.
If you notice some delay while typing in an other application while WinEvent is running the increase the time to the maxinum that you can allow for updates.
The range is 1 to 10,000 seconds

EVENTLST.INI Directory

This field tells WinEvent where to find the EVENTLST.INI File.
This is useful for sharing the file across a network or remote editing.

Reboot Delay

If you choose to reboot the system using the Terminate Method, WinEvent will reboot Windows using a 'non stand method' that your Windows programs will note be notified about. So WinEvent will use this delay to allow time for your disk cache to write to the disk before rebooting.

SendKeys Delay

The delay for when the keys start being sent.
The delay is only for DOS windows.

Contents


Return Codes

A return code is a number from 1 to 255 that is returned to an environment variable called errorlevel in DOS.
This variable can be used in a batch file for branching or a number of other useful purposes.
WinEvent uses the return code in the Exit Windows Event. A batch file calling Windows can use this return code to run a program that normally won't run out of Windows or some other function you might have the batch file do.
A DOS program called 'erlevel.exe' is included to help you with your batch files. It has one function: to create a return code for DOS. To use this program, put it in a batch file with the DOS %1 variable following it. EX: erlevel %1 . Then run your batch file with a number from 1 to 255 on the command line following it. EX startwin 7 .
Here's an example of a batch file that you can modify to suit your needs:
(A copy of this batch file is in your WinEvent directory called:Startwin.bat)

@echo off
:StartWin

win                             REM when testing, rem this line

rem erlevel %1                  REM when testing, un rem this line

if errorlevel 8 if not errorlevel 9 goto Test1
if errorlevel 7 if not errorlevel 8 goto Test2
Echo: No errorlevel was processed - Exiting to DOS -
if errorlevel 0 if not errorlevel 1 goto end        REM If you didn't get an errorlevel.
goto quit                       REM If the errorlevel is greater that zero.

:test1
set %1=errorlevel               REM Set a variable so we can display the value
Echo Errorlevel is ' %1 ', Running 'Your Program test1' and then Restarting Windows.
pause Put your the program you want to start here. Press Ctrl+C to exit to DOS.
goto StartWin                   REM Restart Windows

:test2
set %1=errorlevel               REM Set a variable so we can display the value
Echo Errorlevel is ' %1 ', Running 'Your Program test2' and then Restarting Windows.
pause Put your the program you want to start here. press Ctrl+C to exit to DOS.
goto StartWin                   REM Restart Windows

:quit                           REM Display the errorlevel
set %1=errorlevel               REM Set a variable so we can display the value
Echo Errorlevel is ' %1 '
:end                            REM End of batch file
set 1=                          REM Clear the memory for the variable

Contents


Whats New

Version 2.0

WinEvent TM now has the capability to:

Send keystrokes to applications when they start or while they're already running. Including DOS windows!

Unload single programs by title, or groups by module.

Yearly Events

Run programs that don't run under Window and then restart Windows when it's done. With an option to pause before returning to Windows.

Run Programs hidden.

New program unload methods to insure WinEvent closes it.

Help buttons have been added.

The user interface has a new look. (But still the same good feel!)

Contents


Event Setup 2
Event Setup

Run Style

Consist of:
1. Normal

Runs in a program in a normal window

2. Minimized

Runs in a program in a minimized window

3. Maximized

Runs in a program in a maximized window

4. From DOS

Closes all programs, then exits Windows, run the program at the DOS prompt, and restarts windows

5. Hidden

Runs in a program in a hidden window
Note: Some windows may not run hidden because of there own internal code.

OK Button

If the information you entered is correct then press OK

Cancel Button

If you want to about editing or added an event then press Cancel

Browse Button

Pressing Browse lets you point and click on the program you want and will automatically fill in the Command Line and Startup Directory for you

Now Button

 Sets the schedule to the Now Time and Date

Running Button

 Lets you select a program that's running to be scheduled to terminate at a later time.
 Only appears when the 'Unload a Program' option is selected

Help Button

Opens the Windows help file to the Event Setup context

Test Button

This allows you to test the event before saving it

Previous Page on Event Setup

Contents


Unload Method

The unload method is the way WinEvent handles unloading a program, exiting, restarting and rebooting from Windows. Also when you choose the Run Style 'form DOS', because WinEvent must first close all running programs before it can exit Windows and run the program.

The methods are:

Close

The close method is the safest way the unload. It works the same as exiting from the programs file menu or choosing close from the programs system menu.
If the program needs to save information however, and ask to save, WinEvent will fail to close this application.

Quit

This method will close most applications and If the program needs to save information, it will be lost.

Terminate

The final method will close applications that Quit won't and If the program needs to save information, it will be lost.

If you are rebooting, this method works different.
1. WinEvent will first lock any input to Windows.
2. Then check to see if SmartDrive is installed and if it is force it to write any unsaved blocks to disk and if not wait for a certain amount of time that is specified in the System Settings of WinEvent.
3. Finally WinEvent will reboot using a special keyboard interupt. (Kind of like pressing the reset button).

Caution:
Quit and Terminate Methods, beside the fact that you could loose unsaved information, can also leave part of the program in memory. Though the program may have ended, some of your resources may be temporally lost until you restart Windows.

Contents


Send Keys

Keys to Send:  String expression sent to the specified window.

Each key is represented by one or more characters.  To specify a single keyboard character, use the character itself.  For example, to represent the letter A, use "A" for keytext.  If you want to represent more than one character, append each additional character to the one preceding it.  To represent the letters A, B, and C, use "ABC" for keytext.

The plus sign (+), caret (^), percent sign (%), tilde (~), and parentheses ( ) have special meanings to SendKeys.  To specify one of these characters, enclose it inside braces.  For example, to specify the plus sign, use {+}.  Brackets ([ ]) have no special meaning to Send Keys, but you must enclose them in braces as well, because in other applications for Microsoft Windows, brackets do have special meaning that may be significant when dynamic data exchange (DDE) occurs.  To send brace characters, use {{} and {}}.
To specify characters that aren't displayed when you press a key (such as Enter or Tab) and keys that represent actions rather than characters, use the codes shown below:

Key	Code
----------------------------------------------------------------------
Backspace	{BACKSPACE} or {BS} or {BKSP}
Break	{BREAK}
Caps Lock	{CAPSLOCK}
Clear	{CLEAR}
Del	{DELETE} or {DEL}
Down Arrow	{DOWN}
End	{END}
Enter	{ENTER} or ~
Esc	{ESCAPE} or {ESC}
Help	{HELP}
Home	{HOME}
Ins	{INSERT}
Left Arrow	{LEFT}
Num Lock	{NUMLOCK}
Page Down	{PGDN}
Page Up	{PGUP}
Print Screen	{PRTSC}
Right Arrow	{RIGHT}
Scroll Lock	{SCROLLLOCK}
Tab	{TAB}
Up Arrow	{UP}
F1	{F1}
F2	{F2}
F3	{F3}
F4	{F4}
F5	{F5}
F6	{F6}
F7	{F7}
F8	{F8}
F9	{F9}
F10	{F10}
F11	{F11}
F12	{F12}
F13	{F13}
F14	{F14}
F15	{F15}
F16	{F16}
Combined with any combination of Shift, Ctrl, and Alt keys, precede the regular key code with one or more of the
following codes:

Key	Code
-------------------------------
Shift	+
Control	^
Alt	%

To specify that Shift, Ctrl, and/or Alt should be held down while several other keys are pressed, enclose the keys' code in parentheses.  For example, to have the Shift key held down while E and C are pressed, use "+(EC)".  To have Shift held down while E is pressed, followed by C being pressed without Shift, use "+EC". To specify repeating keys, use the form {key number};  you must put a space between key and number.  For example, {LEFT 42} means press the Left Arrow key 42 times; {h 10} means press h 10 times.

Contents