====Create Event====
This verb creates a new scheduled event with the explicit start time and repeat period. You can turn on/off, dim or toggle a unit, execute a script or speak a phrase. You can even randomize the event and choose the weekdays.

===Usage:===
  * **create event** (event name, or blank and XTension will create one for you)\\
  * **that** (command: turnson/turnsoff/toggles/executes/dims/presets/blocks/unblocks)\\
  * **unit|script** (name of the unit or the script to act upon)\\

===Optional Parameters:===
  * **to level** (integer, the value for the chosen command)\\
  * **in** (seconds till the start time)\\
  * **starts at** (AppleScript date at which to start the event)\\
  * **repeats every** (integer value in seconds)\\
  * **randomize by** (integer, minutes by which to randomize the repeat interval)\\
  * **with no script** (perform the action, but dont run the unit scripts)\\
  * **weekdays** (7 character string in the form of "-MTWTF-" use dashes for days not to execute)\\
  * **handler** (string, name of the handler) If executing a script you can optionally specify the handler to call rather than just running the script. This value is ignored unless the event is to execute a script.\\
  * **parameter** A list of items to be optionally passed to the handler. Only valid if you are executing a handler in the script. The number of parameters in the list must be the same as expected by the handler.

===Examples:===
<code applescript>
create event "Morning Coffee" that turnson unit "Coffee Pot" starts at (date) repeats every 1 * days weekdays "-MTWTF-"
</code>

<code applescript>
create event "Evening Tea" that turnson unit "tea pot" starts at ((sunset for the (current date)) - 20 * minutes) weekdays "-MTWTF-"
</code>

<code applescript>
create event "nightly" that executes script "going to bed" in 15 * minutes
</code>

==Passing Parameters To A Handler Example==
if you had a global script named “meal manager” with a handler named “mealLogger” like this:
<code>
on mealLogger( theName, theEvent)
    write log theName & “ has had “ & theMeal
end doThing
</code>

and then created an event such as this:

<code>
create event “breakfast” that executes script “meal manager” handler “mealLogger" parameter {“Jamie”, “Breakfast”} in 10 * minutes
</code>

in 10 minutes you would see output in the log like:

jamie has had breakfast


===History:===
The optional “handler” parameter was added in XTension 9.4.21