5 1 0:Blocking Events

From SEPsesam


Welcome to the latest SEP sesam documentation version 5.1.0 Apollon. For previous documentation version(s), check documentation archive.


Overview


SEP sesam provides options to prevent the activation of events on specific days or at certain hours. You can create and schedule a blocking event. A blocking event is any type of event that prevents another event from starting, allowing you to control the execution of tasks. You can create and schedule blocking events to achieve the following:

To create a blocking event, you can configure it during the initial setup of an event or modify the event properties. Blocking events are scheduled in the same way as other events, and you can define the desired timeframe and recurrence pattern. You can choose to use the default calendar or create a custom calendar using the User Defined option.

To resolve scheduling, determine which events get blocked and correctly queue events in a backup day, event priority is used. The priority of a blocking event must be higher than the priorities of the events it is intended to block. Event priorities in SEP sesam range from the lowest priority of 1 to the highest priority of 99. Note that priority 0 cannot be used for blocking events. For more information see Event Priority.

Key features

The main characteristics of a blocking event are:

  • A blocking event is created by enabling the Blocking date checkbox during the configuration of an event.
  • When a schedule is deactivated (Execution off option in the schedule), it stops the execution of all events associated with that schedule, including blocking events.
  • A blocking event impacts other events when their schedules overlap.
  • On a SEP sesam backup day, a blocking event suppresses the execution of other events, regardless of whether they are scheduled to run before, during, or after the blocking event.

Blocking a task or task group on a certain date

You can create an event that will block scheduled events of a specific task or task group from running on specified dates. A blocking event is based on a task or a task group, and it will block execution of equal events with lower priority on the days when schedules overlap. This is useful, for example, to exclude holidays or other special occasions, when certain tasks should not run.

For example, a backup event that executes the task server_backup is configured to run daily with priority 2. A second backup event for the same task server_backup is only scheduled for December 24th every year as a blocking event with priority 9. On December 24th, the priority check detects the server_backup event with higher priority and blocks the execution of the daily backup.

To create a blocking event for a task or task group, perform the following steps:

  1. From Main selection -> Scheduling -> Schedules, select and right-click a schedule. Then select the event type you want to add (for example, New Backup Event).
  2. Under Sequence control, set up the Priority of your blocking event. SEPuler always executes the events with the highest priority first. Then select the Blocking date check box. When using this option, make sure you assign a high priority that overrides the priority of the event you intend to block.
  3. Under Object, select the task or task group to which you want to link this event.
  4. Click OK to save the event.

Screenshots

For more information on creating an event, refer to article for your event type in Standard event types.

Blocking a task or task group within a specific timeframe

You can define a time range to block the execution of a specific event or task group within a designated timeframe. This feature is particularly useful when you want to restrict the execution of tasks to specific hours of the day, ensuring that they do not overlap with other critical activities.

For example, database transaction logs are typically backed up continuously throughout the day because they are crucial for maintaining data integrity. A backup event that executes the task PRD_HDB_Logs is configured to run daily every 15 minutes with priority 3. A second backup event for the same task PRD_HDB_Logs is scheduled to run daily between 12 PM and 2 PM as a blocking event with priority 9. During this timeframe the priority check detects the PRD_HDB_Logs event with higher priority and prevent backups of the transaction logs.

To create a blocking event that will prevent execution of other events of the same type during a specific time period of a day, you first need to set the SEP sesam profile to change the default setting, and then add a database key to the SEP sesam database. Then you create a custom schedule that defines the prohibited time period and add the blocking event to this schedule.

Warning
To enable the blocking event within the specified hours, the SEP sesam database table defaults must contain an entry suppress_with_timerange with the value yes. Without this entry, the blocking event will prevent related jobs from being activated for the entire sesam backup day.

To create a blocking event for a task or task group within a timeframe, perform the following steps (note that it is assumed the regular backup task is already scheduled):

  1. Set a SEP sesam profile as described in What happens when I set a profile.
  2. Run the following command to insert a database key to the SEP sesam database:
  3.  sm_db "INSERT INTO defaults (key,user_name,value) VALUES ('suppress_with_timerange','sesam','yes');"
  4. Create a schedule that defines the required timeframe. For example, you can create a weekly execution schedule from Monday to Friday with a starting time of 12:00 PM and a duration of 2 hours.
  5. Screenshots

  6. Right-click this schedule and select the event type you want to add (for example, New Backup Event).
  7. Under Sequence control, set up the Priority of your blocking event and select the Blocking date check box. Make sure to assign a priority that overrides the priority of the event you intend to block.
  8. Configure the event as required and click OK to save it.

Blocking any or all types of events on a certain date

You have the option to block the activation of individual event types or all types of events on a specific date. This provides you with precise control over task execution and enables effective management of event dependencies.

To achieve this, use a Newday event as blocking event and select the types of events you want to block. You can select only certain event types or block all SEP sesam events. A Newday blocking event will prevent the execution of all scheduled events of the selected type on the designated day.

Screenshots

For detailed instructions on creating a Newday event to block any or all types of events on a specific date, refer to Newday event as blocking event.


See also

Managing Events - Managing Schedules - NEWDAY Events

Copyright © SEP AG 1999-2024. All rights reserved.
Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.