Coding Each AOF Rule Type › Time-of-Day Rules › )TOD—Event Definition Section of TOD Rules › Defining the Todspec

Defining the Todspec

You can specify each todspec for TOD rules in the format of a date or time. In addition, you can instruct a TOD rule to execute at a specified interval after it is enabled. The following syntaxes are available for specifying a date or time todspec value in TOD rules:

Date

The day, month, year, or day of the week (depending on the format you use to specify the date):

• dd-A two-digit integer (01 through 31) corresponding to a day of the month
• MMM-One of the following three-character abbreviations for a month: JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC
• year-A four-digit year (for example, 2002)
• mm-A two-digit integer (01 through 12) corresponding to a month of the year
• weekday-The full name of a weekday (for example, SUNDAY, MONDAY)

Note: In TOD rules, the week starts on Sunday at 00:00, which implies that Saturday follows Sunday. Start-time must be before End-time; therefore, it is invalid to start a rule on Saturday and end it on Sunday if you use the weekday format. For an example, see Start/end order in Rules Governing the Coding of TOD Event Specifiers in this chapter.

Format (any of the following):

• dd MMM year
• year/mm/dd
• weekday

Time

The time in 24-hour military format, as follows:

• hh-A two-digit integer (00 through 23) indicating the hour
• mm-A two-digit integer (00 through 59) indicating the minutes after the hour
• ss-A two-digit integer (00 through 59) indicating the seconds after the minute. This value is optional.

Format: hh:mm[:ss]

Start at some interval after rule is enabled

This type of todspec is commonly used in dynamically created TOD rules (explained in the chapter “Building and Controlling AOF Rules”) to initiate automation that needs to be performed at some time interval after a specific event occurs, as follows:

• nn-a number greater than 0
• value -DAY(S), WEEK(S), HOUR(S), MINUTE(S) or MIN(S), or SECOND(S) or SEC(S). For example, the following rule executes 1 minute after it is enabled and every 30 seconds thereafter, until it executes a total of three times:

   )TOD *+1 MINUTE,30 SECONDS,,3
  

Note: This is a special type of TOD rule SPEC that is only eligible to be used one time per TOD rule.

Format: *+nn value