Managing Ensemble Productions - InterSystems Documentation

What to Manage
the item to be stopped and started at specific times and on specific days of the week, month, or year. When it is time to
start, if the item is enabled, the scheduler starts it; when it is time to stop, if the item is running, the scheduler stops it.
The Schedule string is a comma-separated list of event specifications. Each event specification has the following format:
action:YYYY-MM-DDThh:mm:ss
Where each item in the event specification, from left to right, has the described values:
Item
action
:
YYYY-MM-DD
Possible Values
START or STOP indicates the desired action
Required separator
Either:
• YYYY is the year as 4 numerals
• MM is the month as 2 numerals
• DD is the day of the month as 2 numerals
• Any of these fields may be the single character * (asterisk) indicating all years,
all months, or all days
Or:
• YYYY is the word WEEK
• MM is the specific occurrence of the day of the week (indicated by DD) in the
month (01 = first occurrence of the specific day of the week in the month, 02 =
second occurrence in the month, etc.)
• DD is a specific day of the week (00 = Sunday, 01 = Monday, etc.)
• MM may be * for all occurrences and DD may be * for all days
Once a field is specified as *, all fields to the left of it are also assumed to be *.Thus,
if the DD value is *, the MM value is treated as * even if it has a specific numeric
value. Similarly, if MM is *, YYYY is treated as *.
T
hh:mm:ss
,
Required separator
Hour, minute, and second
Use the comma separator only if there is another event specification after the current
one. Do not use it at the end of the Schedule string.
If your schedule contains recurring events, the Schedule setting requires both START and STOP actions. If your schedule
setting is an absolute one time event, then you need only use the appropriate single START or STOP action. In most cases,
Schedule strings should contain both a START and a STOP action.
Some examples of Schedule strings follow:
• Start the configuration item every day at 8 a.m. and stop it every day at 5 p.m.
START:*-*-*T08:00:00,STOP:*-*-*T17:00:00
• Stop every year on January 2 at 7 a.m. and start again on January 3 at 7 a.m.
STOP:*-01–02T07:00:00,START:*-01-03T07:00:00
26 Managing Ensemble Productions