Scheduling Terms
You can use the following pre-defined scheduling terms in CA WA DE workload definitions:
ALL
Specifies all of the elements within a period (equivalent to ANY and EVERY). For example, you can use FIRST WORKDAY OF ALL MONTHS instead of FIRST WORKDAY OF MONTH.
AM
Specifies the time between 00:00 and up to, but not including, 12:00.
AND
Indicates an optional connecting word that you can use to specify multiple similar scheduling terms (days of the month, months of the year) and ordinal numbers, for example:
FIRST AND LAST WORKDAY OF EACH MONTH
TUESDAY AND WEDNESDAY
JUNE, JULY AND AUGUST
Note: You cannot use this term with times of day.
ANY
Specifies all of the elements within a period (equivalent to ALL and EVERY), for example, ANY WORKDAY OF 6th MONTH OF YEAR.
ANYDAY
Indicates that no day of the week restriction exists. For example, ANYDAY OF JUN specifies all the days in June.
COMPLETE
Indicates that you want the schedule to occur only during a complete period. For example, you can specify FIRST COMPLETE WEEK OF YEAR. If a week starts in one year but finishes in the next year, CA WA interprets the expression to mean the next complete week.
DAILY
Specifies every one day.
DAYS
Specifies a period of time in days, for example, TODAY PLUS 5 DAYS.
EACH
Specifies every occurrence of a particular day or period, for example, EACH MONDAY OF OCTOBER.
ENDING
Specifies the ending point for a repeating schedule, for example, DAILY AT 9AM STARTING TOMORROW ENDING 1JUL2005. This term is identical to the term UNTIL.
Note: You cannot use this term in Run and Do not Run statements for jobs and Applications.
EVERY
Specifies all elements within a period (equivalent to ANY and EACH), for example, EVERY 1 HOUR.
Note: You cannot use this term as a run criteria for a job.
EVERY ''n units''
Indicates how often, in units of time, you want the schedule to recur. The units can be seconds, minutes, hours, workdays, days, weeks, months, or years, for example, EVERY 5 MINUTES, EVERY 1 HOUR, EVERY 2 DAYS.
Note: You cannot use this term as a run criteria for a job.
EXCEPT
Indicates an exception. You can use different criteria as exceptions, for example:
DAILY EXCEPT MONDAY TUESDAY
FRIDAYS EXCEPT FIRST AND LAST DAY OF MONTH
WEEKDAYS EXCEPT WEDNESDAYS
HOLIDAYS EXCEPT CHRISTMAS
WORKDAYS EXCEPT INVENTORY_DAY
Note: You cannot use this term in a run criteria for a job with a date, for example, Run DAILY EXCEPT OCT 3, 2008. However, you can accomplish this using a Do not run statement: Run DAILY; Do not run OCT 3, 2008.
FIRST
Specifies the first occurrence of a particular day or period, for example, FIRST MONDAY OF MONTH or FIRST DAY OF 2nd FISCAL_MONTH OF FISCAL_YEAR. You can also use the ordinal number 1ST, for example, 1ST HOLIDAY OF YEAR.
HOLIDAYS
Specifies all of the holidays in each calendar. You can refer to specific holidays by name, for example, CHRISTMAS.
HOURLY
Specifies every one hour, for example:
HOURLY means 00:00, 01:00, and so on.
HOURLY STARTING AT 2:15 means 2:15, 3:15, and so on.
LAST
Specifies the final occurrence of a particular day or period, for example:
LAST HOLIDAY OF YEAR
LAST WORKDAY OF FISCAL_MONTH
FIRST AND LAST TUESDAY OF MONTH
LESS ''n units''
Requests an adjustment by subtracting a value which must be a whole number. For example, you can specify LESS 2 WEEKDAYS, LESS 1 MONTH, or LESS 0 WORKDAYS. To obtain the second last day of the month, you can use LAST DAY OF MONTH LESS 1 DAY.
MIDDAY
Specifies the time 12:00 or noon.
MIDNIGHT
Specifies the time 24:00. CA WA recognizes 24:00 as the same as 00:00. For example, if you specify MIDNIGHT MONDAY, it is the same as 00:00 TUESDAY.
MINUTE/MINUTES
Specifies a period of time in minutes, for example, EVERY 2 MINUTES.
MONTH/MONTHS
Specifies a period of time in months, for example 1ST MONTH OF YEAR.
MONTHLY
Specifies every one month.
Note: You cannot use this qualifier by itself within a job definition. You can use RUN 15TH MONTHLY, but you cannot use RUN MONTHLY.
NOON
Specifies the time 12:00.
NOW
Specifies the current virtual time. It refers to the scheduled time of the Event that triggered the Application.
Note: You cannot use this term in an Event definition on its own. You can, however, specify a submission time for a job such as NOW PLUS 1 HOUR.
OF
Indicates a connecting word for scheduling terms, for example, LAST DAY OF MONTH or 1ST-9TH WORKDAY OF EACH YEAR.
ON
Indicates a connecting word indicating that a date follows, for example, 7PM ON THURSDAYS instead of 7PM THURSDAYS.
ONCE
Indicates that you want an Event to run once only.
OR
Indicates a connecting word that is used as a conjunction. This term lets you specify either of two similar scheduling terms. For example, 9PM ON FIRST MONDAY OR TUESDAY OF MONTH means that if the month starts on Tuesday, then this job will run on Tuesday. Otherwise, it will run on Monday.
Note: The term OR implies whichever instance occurs first and should only be used when it is meaningful. A statement such as 1ST JANUARY or 2ND FEBRUARY is meaningless to CA WA.
PLUS ''n units''
Requests an adjustment by adding a value, which must be a whole number. For example, you can specify PLUS 2 WEEKDAYS, PLUS 0 WORKDAYS, or PLUS 1 WEEK. To obtain the first day after the last workday of the month, you can use LAST WORKDAY OF MONTH PLUS 1 DAY.
PM
Specifies a time between 12:00 and up to, but not including, 24:00. It identifies a preceding number as a time of day, for example, 6PM.
REALNOW
Specifies the actual time that the Event is triggered. For example, you can specify the start time for a job as REALNOW PLUS 1 HOUR.
ROUND
Indicates that the computed time is an integral multiple of the units parameter. You can use ROUND with EVERY n UNITS phrases, for example:
EVERY 1 HOUR ROUND requests every hour at the hour mark.
EVERY 6 HOURS ROUND requests the times 00:00, 06:00, 12:00, and 18:00.
EVERY 5 HOURS ROUND provides the next hour that is an integral multiple of five hours starting at 00:00 on the current day (that is, 00:00 today, 05:00, 10:00, 15:00, 20:00, 1:00 tomorrow, 06:00, and so on).
STARTING
Specifies the starting point for a repeating schedule. You can use an actual date or time after STARTING, for example, DAILY STARTING NOV 6, HOURLY STARTING 2PM.
Note: You cannot use this term in Run and Do not Run statements for jobs and Applications.
THE
Indicates an optional connecting word, for example, 5TH DAY OF THE MONTH instead of 5TH DAY OF MONTH.
THIS
Specifies the current period, for example, 1ST WORKDAY OF THIS MONTH. You do not usually need the term THIS when you schedule jobs; however, it can be useful when you want to ensure CA WA generates date and time variables in the current period. For example, to simulate an Event for the last workday of this month plus one day, use LAST WORKDAY OF THIS MONTH PLUS 1 DAY.
TODAY
Specifies the current virtual or scheduled day.
TOMORROW
Specifies the day after today.
UNTIL
Specifies the ending point for a repeating schedule, for example, DAILY AT 9AM STARTING TOMORROW UNTIL 1JUL2005. This term is identical to the term ENDING.
Note: You cannot use this term in Run and Do not Run statements for jobs and Applications.
WEEK
Specifies a seven-day period. The first day of the week depends on your geographical location.
WEEKDAYS
Specifies Monday through Friday.
WEEKEND
Specifies a grouping of Saturday and Sunday together. For example, ANYDAY OF WEEKEND resolves to Saturday and Sunday.
WEEKLY
Specifies every one week.
WITHIN
Indicates a connecting word for period processing. For example, 5TH MONDAY WITHIN MONTH selects only the 5th Monday in the months that have five Mondays. CA WA ignores the other months.
WORKDAYS
Specifies all of the days worked in each calendar. Workdays exclude holidays.
YEARLY
Specifies every one year.
YESTERDAY
Specifies the day before today.