Introduction

...

Scope

The Calendar feature is introduced with JobScheduler 

• Jira
  server SOS JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 6dc67751-9d67-34cd-985b-194a8cdc9602 key JOC-267

• Jira
  server SOS JIRA columns key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution serverId 6dc67751-9d67-34cd-985b-194a8cdc9602 key JS-1754

Description

General Description

Calendars specify the days on which scheduling events can occur. Calendars specify rules for recurring days and lists of days that are used by JS7 - Schedules to create orders for workflow execution with the JS7 - Daily Plan.

• Any number of Calendars can be defined for working days and for non-working days.
• In addition, Calendars can hold both working days and non-working days combined.
  • An example would be a business day Calendar specifying Monday to Friday for job execution. A second Calendar can specify public holidays on which job execution should not occur. 
  • Users can combine both Calendar Types when used with a Schedule and they can create a single Calendar that combines both working days and non-working days.

The handling of Calendars is explained with the JS7 - Management of Calendars article.

Calendars

Basics

Calendar Types

Calendars are configured as for either working days or non-working days:

• A working day Calendar specifies Working Day Calendars specify the business days for which job executions are targetedorders for workflow execution can be scheduled.
• Non-working days include days for which jobs should not be executedDay Calendars specify days that are excluded from workflow execution.

Both calendar types can be combined with precedence being given to non-working days for any overlapping days.

Frequencies

Handling of days in both types of Calendars is simplified through the managed by use of Frequencies. Typical Frequencies include for example:

• Weekdays: Monday to Friday, every week,
• Specific Weekdays: every first Friday, every last Monday in month
• Specific Days: days selected from a yearly calendar
• Month Days: 3rd of month, last of month, last-3 of month
• Recurring Day; Days: every 2nd last day in every month,
• National Holidays: for a country for the a particular year.

Frequencies can be inclusive and exclusive, allowing a number of approaches to Calender Calendar configuration to be adopted in line with legacy procedures.

Calendars as Resources

Management

As resources, Calendars are managed from the Calendars object folders in the Calenders tab of the Resources Configuration->Inventory view of the JOC Cockpit. Resources are objects that can be configured independently of other objectsIn addition, Calendars are visible in the Resources->Calendars view.

Once they have been configured, one or more Calendars can be assigned to Orders and Jobs to Schedules as required.

Assigned Calendars can also be modified with modifications being applied to all objects that use the respective Calendar.

Note that similar to other Resources, e.g. Locks and Process Classes, Calendars are stored as objects in the file system. Calendars are managed with the JOC Cockpit, they are not editable using the JobScheduler Object Editor, JOE. Calendars are added to the inventory in the JobScheduler reporting database.

Calendars for Orders, Jobs and Schedules

The calendar user interface can be used to define the Run-Times, i.e the days and times at which Orders, Jobs and Schedules are to be run. Here the Run-Time is saved as part of the configuration of the Order, Job or Schedule in XML format in the JobScheduler's live folder. Run-Times set in this manner are persistent - that is, they will not be lost after a restart of the JobScheduler. 

Calendar Deployment

Export and import functions allow the bulk deployment of Calendars, for example, when updating non-working day information on a production system.

The Calendar deployment procedure is described in the xCalendar Management - Calendar Deployment article.

You will find more detailed information in the JS7 - Management of Calendars article.

Use with Schedules

Calendars specify the days for which orders can be created by Schedules.

Schedules can further limit the days as well as specifying the time at which orders are to be run.

You will find more detailed information in the JS7 - Schedules article.

Resources

...

Display children header