Calendar management

Scheduled tasks in production often need to respect business calendars -- running on workdays and skipping weekends or public holidays. Without calendar-based scheduling, you must either build custom skip-logic into each task or manually disable tasks on holidays and risk missed or unintended executions.

SchedulerX calendars solve this by defining which days are workdays for a given year. Attach a calendar to an application or task, and the system schedules tasks based on the workday rules defined in the calendar.

Prerequisites

Before you begin, make sure that you have:

Access to the MSE SchedulerX console
At least one application or task that requires calendar-based scheduling

Create a calendar

Log on to the MSE SchedulerX console.
In the left-side navigation pane, choose Calendar Manage.
Click Create Calendar.

In the dialog box, configure the following parameters:

Parameter	Required	Description
Calendar Name	Yes	A unique name for the calendar. 0 to 45 characters. The name must be unique within a given year, but you can reuse the same name across different years. Cannot duplicate a predefined system calendar name.
Year	Yes	The year this calendar covers, for example, `2025`. Each calendar applies to a single year.
Month Details	Yes	A JSON array that defines the workdays for each month. See Month Details JSON format.

Click Confirmed.

Month Details JSON format

The Month Details field accepts a JSON array. Each element specifies the workdays for one month:

month -- the month number (1--12).
days -- an array of integers representing workday dates in that month.

Example for a full year (standard weekdays, excluding weekends and public holidays):

[
  {"month":1,"days":[3,4,5,6,9,10,11,12,13,16,17,18,19,20,28,29,30,31]},
  {"month":2,"days":[1,2,3,6,7,8,9,10,13,14,15,16,17,20,21,22,23,24,27,28]},
  {"month":3,"days":[1,2,3,6,7,8,9,10,13,14,15,16,17,20,21,22,23,24,27,28,29,30,31]},
  {"month":4,"days":[3,4,6,7,10,11,12,13,14,17,18,19,20,21,23,24,25,26,27,28]},
  {"month":5,"days":[4,5,6,8,9,10,11,12,15,16,17,18,19,22,23,24,25,26,29,30,31]},
  {"month":6,"days":[1,2,5,6,7,8,9,12,13,14,15,16,19,20,21,25,26,27,28,29,30]},
  {"month":7,"days":[3,4,5,6,7,10,11,12,13,14,17,18,19,20,21,24,25,26,27,28,31]},
  {"month":8,"days":[1,2,3,4,7,8,9,10,11,14,15,16,17,18,21,22,23,24,25,28,29,30,31]},
  {"month":9,"days":[1,4,5,6,7,8,11,12,13,14,15,18,19,20,21,22,25,26,27,28]},
  {"month":10,"days":[7,8,9,10,11,12,13,16,17,18,19,20,23,24,25,26,27,30,31]},
  {"month":11,"days":[1,2,3,6,7,8,9,10,13,14,15,16,17,20,21,22,23,24,27,28,29,30]},
  {"month":12,"days":[1,4,5,6,7,8,11,12,13,14,15,18,19,20,21,22,25,26,27,28,29]}
]

View calendars

Log on to the MSE SchedulerX console.
In the left-side navigation pane, choose Calendar Manage.
Select a view:
View Description
Card view A visual month-by-month date layout
List view Calendar configuration details in a table
(Optional) Filter calendars by name and year.

View	Description
Card view	A visual month-by-month date layout
List view	Calendar configuration details in a table

Edit a calendar

Log on to the MSE SchedulerX console.
In the left-side navigation pane, choose Calendar Manage.
Find the target calendar and click Edit in the Actions column.
Make the required changes and click Confirmed.

Only full updates are supported. Each edit replaces the entire calendar definition -- partial updates to individual months are not available.

Delete a calendar

Log on to the MSE SchedulerX console.
In the left-side navigation pane, choose Calendar Manage.
Find the target calendar and click Delete in the Actions column.
In the confirmation dialog box, click OK.

Attach a calendar to an application or task

After you attach a calendar, the system schedules tasks based on the workday rules defined in that calendar. You can attach calendars at two levels:

Level	Scope	Where to configure
Application	Applies the calendar to all tasks under the application	Basic Configuration page > Advanced Configuration section
Task	Applies the calendar to a specific task only	Timing Configuration page > Advanced Configuration section

If both levels have a calendar attached, the task-level calendar takes precedence.

Attach to an application

Create or edit an application. On the Basic Configuration page, locate the Advanced Configuration section.
Select Specify calendar and choose the calendar to attach.
Complete the remaining configuration.

Attach to a task

Create or edit a task. On the Timing Configuration page, locate the Advanced Configuration section.
Select Specify calendar and choose the calendar to attach.
Complete the remaining configuration.

Limits

Limit	Description
Calendar scope	Each calendar is tied to a single year. To schedule tasks across multiple years, create a separate calendar for each year.
Naming uniqueness	Calendar names must be unique within a given year. The same name can be reused across different years.
System calendar names	Custom calendars cannot share a name with a predefined system calendar.
Update mode	Only full updates are supported. Each edit replaces the entire calendar definition.
Non-workday behavior	After a calendar is attached, the system schedules tasks based on the workday rules defined in the calendar.