Scheduling Terms

Document created by alan.monument on Oct 4, 2013
Version 1Show Document
  • View in full screen mode

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.

1 person found this helpful

Attachments

    Outcomes