Alcorn Mcbride AM-4, Hardware And Software Reference Manual

Page: 37 / 77

Scheduler 31
D:01.01.2001
D:01/01/2001
D:01-1-2001
R: Repeat Number
The Repeat Number acts in one of two ways:
• With no Repeat Set field present.
• With a Repeat Set field present:
1. With no Repeat Set field present:
This is the most common usage of the Repeat Number. It acts as a multiplier of the
Repeat Period. They should be read in conjunction like this:
“Repeat this event
every <repeat number> <repeat period>”. Ex.“Repeat this event every 30
minutes”.
The repeat number can be anywhere from 1 to over 4billion. You can specify
repeating a number of minutes, which is why this is so huge. Realistically though,
you would specify repeating in years, if it got that large. Whatever combination you
choose between Repeat Number and Repeat Period should not multiply our to be
greater than a century.
Example:
R:1 ;do it every period
R:117 ;do it every 117 periods
2. With a Repeat Set field present:
The Repeat Number and the Repeat Period
become an index of the set. These three fields should be read in conjunction like
this:
“Repeat this event every <repeat number> <repeat period> in <set>.”
Ex.“Repeat this event every 4
th
Thursday in November.”
Although there are many possibilities, we can use an example of holidays to explain
what using a set can do for you. Over the period of a year, you may want to schedule
events for some holidays. Unfortunately, not all holidays land on the same date every
year. By defining a set, along with the repeat number and repeat period, you can
choose the first Monday of the month, or whatever you like. Sets can be specific
months or general and periods can be specific or general too.
Example:
R:2 P:Sunday S:May E:Command 1:"1PL" ;Every 2
nd
Sunday in May Play sound #1
R:1 P:Day S:Month E:Command 1:”2PL” ;Every 1
st
day of every month play sound #2
R:2 P:Day S:Month E:Command 1:”4PL” ;Every 2
nd
day of every month play sound #4
R:3 P:Day S:Month E:Command 1:”5PL” ;Every 3
rd
day of every month play sound #5.
….
P: Repeat Period
The Repeat Period defines how long to wait. It is multiplied or indexed according to
the presence of a Repeat Set field. (See the Repeat Set and Repeat Number sections
for details)
Periods can be one of the following: