Events
Events are dependencies between jobs or SMART folders on a shared Server. Events enable successor jobs or SMART folders (entities) to begin execution once their predecessor entities finish execution. This happens when these entities have fulfilled all other defined prerequisitesThe part of the job definition that controls the flow of your jobs, such as an event that controls flow sequence or a resource that controls load balancing.. An event is a type of prerequisite, along with scheduling criteria and resource requirements, that a job or SMART folder must fulfill before it can execute.
The following image shows a number of events, which appear as lines and arrowheads between predecessor and successor jobs:
Finance_Australia, Finance_UK, and Finance_USA jobs begin execution once Finance_Beginning_of_Month successfully completes execution—provided that the successor jobs have fulfilled their other prerequisites. Finance_End_of_Month begins execution once all three of its predecessor jobs successfully complete execution, and once it has fulfilled all other prerequisites.
The Events tool in the Tools domain enables you to add or delete events, monitor active events in your workflow, and search for specific event information, such as the date of an event.
You add an event in the following situations:
-
Your database goes down. You add an event that prevents job execution until the database is back up.
-
An event that a successor job is dependent on is not added automatically. You manually add an event to for a job to begin execution when a predecessor job completes execution.
The following video describes Control-M events:
Creating an Event
This procedure describes how to create an event as a dependency between two jobs, which enables the successor job to execute after its predecessor completes execution.
Begin
-
Hover your cursor over the predecessor job.
An arrowhead appears below the job.
-
Click and drag the arrowhead to the successor job.
The event line appears between the two jobs. Event attributes appear in the Prerequisites tab in the right pane, as described in Event Attributes. You can view information about the event by clicking the arrowhead, as shown below:
Pasting Jobs with Events
This procedure describes how to paste jobs with events, which eliminates the need to redefine the events connected with the jobs that were copied.
Begin
-
Right-click on the jobs that you intend to copy, and select Copy.
The jobs and their events are copied.
-
In the same SMART folder or in a different SMART folder, right-click and select Paste with Events.
The copied jobs and events are pasted to this location.
Wait for Event Attributes
The following table describes the Wait for Event attributes that a successor job must wait for before it can execute.
Attribute |
Description |
---|---|
Name |
Defines the name of the event. Rules:
The default event format is [Source Job Attribute: Job Name]-TO-[Target Job Attribute: Job Name]. You can redefine this format in one of the following ways:
|
Run Date |
Defines the date attribute associated with the event, as follows:
|
Delete |
Determines whether the event is deleted after the successor job completed execution. |
Relationship |
Determines the relationship between events where the successor is waiting for more than one event, as follows:
Default: AND Between All. |
AND/OR |
Defines the relationship between the previous event and the successive event. |
Event Attributes
The following table describes the event attributes added to a predecessor job after execution, which enables the successor job to execute.
Attribute |
Description |
---|---|
Name |
Defines the name of the event. Rules:
The default event format is [Source Job Attribute: Job Name]-TO-[Target Job Attribute: Job Name]. You can redefine this format in one of the following ways:
|
Run Date |
Defines the date when the event is added or deleted as follows:
|
Add/Delete |
Determines whether the event is added or deleted from the job after it finishes executing. Default: Add |