EVENT SET INTERVAL

    Usage: EVENT <profile> SET [INTERVAL HOURLY|DAILY|WEEKLY|MONTHLY|NONE]

    This command sets up a repeating event. The event will execute again every hour/day/week/month after initial execution as set by EVENT SET TIME. The interval defaults to NONE, which means that the event will execute only once.

    Example:
    /as event open set interval daily

    Some events may be one-time only for a specific event, but many other scripts may be useful to automate and run regularly. Interval allows you to have scripts automatically trigger on a regular basis. Try to avoid setting monthly events to run on the 29th, 30th, or 31st of the month since not all months have more than 28 days.


    EVENT SET SCRIPT

    Usage: EVENT <profile> SET SCRIPT START|END <scriptname>

    This command specifies which scripts should be executed at the times specified with EVENT SET TIME START and EVENT SET TIME END. One script can be associated with each of the end points.

    Examples:
    /as event open set script start open
    /as event open set script end nightly

    Unless scripts are associated with the start and end points of an event, the event will do nothing when it runs. It is unnecessary to set both, but setting at least one is essential.


    EVENT SET TIME

    Usage: EVENT <profile> SET TIME [START|END] [<timespec>]

    This command sets the start and end times of the event in question. The timespec is an arbitrarily precise date and time specification. It follows the format "[<day of week>] [<month>] [<day>] [[, ]<year>] [<time>]". Unspecified portions of the timespec will default to the current date and time. Time can be specified in either 24-hour format (i.e., "19:00") or am/pm format (i.e., "7:00 pm"). The day of the week and month can be abbreviated by specifying only the first three letters thereof. Days of the month beyond the end of the month specified will wrap into the next month (i.e., "Nov 31" becomes "Dec 01"). The year can be separated from the rest of the date by an optional comma, which has no effect (i.e., "Jan 01, 2001" and "Jan 01 2001" are equivalent). An empty timespec will clear that time point.

    Examples:
    /as event open set time start Mon Jan 01, 2001 00:00
    /as event open set time start January 01 2001 12:00 am
    /as event open set time start Monday
    /as event open set time start 00:00
    /as event open set time end Monday January 01, 2001 01:00

    Note that en event will not run unless you specify at least one time and that nothing will happen when it runs unless you associate a script with that end point by using EVENT SET SCRIPT.