Workload Policies

Workload Policies enable you to manage and balance resources and hosts for multiple jobs within or across Workspaces.

The Workload Policies Definitions tool enables you to schedule and apply Resource Pools, define job restrictions, and map hosts to a group of jobs that share similar Control-M/Servers, Applications, Sub-applications, folders, job types, or hosts. If multiple active Workload Policies are defined, you can prioritize the order that they run in. These tools eliminate the need to individually redefine, reschedule, and reroute multiple jobs.

Once a week, bike rental data for hundreds of stations in multiple cities is retrieved, processed, and analyzed by 20 Agents that are equally distributed in two locations, San Francisco and Seattle. Both locations usually have enough extra Agents available in case the machines in one location are unavailable. Workload Policies are created for the following three situations:

Host Mapping: During a major storm, all of the Seattle Agents go down. To process the data, a Workload Policy is created that reroutes (maps) the 10 Seattle Agent data analytics jobs to 10 available Agents in San Francisco.
Running Jobs Restrictions: The following day, the Seattle Agents are still down but the San Francisco Agents are unavailable. To deal with this restriction, a Workload Policy is created that restricts the number of concurrently executing jobs to 10, instead of the usual 20.
Scheduled Resource Pools: Bike rental company database can handle a maximum of 20 concurrent logins. However, the bike rental company needs to run five additional data visualization jobs, in addition to their 20 daily data analytics job runs. Since all 25 jobs are set to execute at the same time, and the database cannot handle more than 20 simultaneous logins, a Workload Policy Resource Pool is defined that allows a maximum of 20 database logins on the day that all 25 jobs are scheduled to run. This holds A job action that stops the job from executing or pauses a job that is currently executing. the extra five jobs until the resources become available.

The Workload Policies Monitor tool enables you to review the status of jobs grouped into Workload Policies.

You can assign a maximum of 20 Workload Policies to a job.
Critical jobs bypass Workload Policy rules that limit Lock Resources, as described in Lock Resources.

Creating Workload Policies Definitions

This procedure describes how to create Workload Policies Definitions. This enables you to group jobs with shared characteristics, or filters, and define Resource Pools, job restrictions, and host mapping.

Begin

From the Tools drop-down list, select Workload Policies Definitions.

The Workload Policies Definitions Workspace appears.
From the Workload Policies Definitions Workspace toolbar, select New.

The Workload Policies Definitions Details pane appears on the right.
Do the following:
1. In the Name field, type a name for the Workload Policy.
2. In the Description, describe the purpose of the Workload Policy.
In the Status attribute, select one of the following:
- Active
- Inactive
From the Filter field, type or select any of the following shared characteristics, or filters, where your jobs are grouped in the Workload Policy:
- Job Name or Member Name
- Server
- Application
- Sub Application
- Folder
- Job Type
- Host or Host Group
For a list of available filter wildcards, see Pattern-Matching Strings.
Define one or more of the following:
- Resource Pools: Defines Resource Pools for the Workload Policy, as described in Defining Resource Pools.
- Running Jobs: Defines Running Jobs for the Workload Policy, as described in Defining Running Jobs.
- Host Mapping: Defines Host Mapping for the Workload Policy, as described in Defining Host Mapping.
Click Save.

A confirmation message appears. The Workload Policy definition is now saved in the Server.
For a Workload Policy on a z/OS system, ensure that you have sufficient authorizations via the CTWSE02 security module. See Workload Policy Management Security in the INCONTROL documentation.

Defining Resource Pools

This procedure describes how to define Resource Pools in Workload Policies Definitions, which creates Resource Pools for a group of associated jobs for a defined period.

Begin

From Resource Pools, click .

The Resource Pool - Period Definition dialog box appears on the right.
Define the Resource Pools for the jobs in the Workload Policy, as described in Resource Pools.
From the Date Types drop-down list, select one of the following options to determine when the Resource Pools are enforced in the Workload Policy:
- All Days
- Every (Periodic Day of the Week)
- Between (Specific Days in the Calendar)
- Between (Specific Date and Time)
- Every Week Between (Day of Week and Times)
- On (Specific Days in the Calendar)
From the Time field, select one of the following time options:
- All Hours: Restrictions are enforced for all hours on the selected dates.
- Between: Restrictions are enforced for a period that you define on the selected dates.
Select Add.

The scheduled Resource Pools appears under Resource Pools.

Defining Running Jobs

This procedure describes how to define Running Jobs in Workload Policies Definitions, which limits the number of concurrently running jobs for a defined period.

Begin

From Running Jobs, click .

The Number of Running Jobs - Period Definition dialog box appears on the right.
From the Server drop-down list, select the Server where the restrictions on the number of running jobs are applied.
In the Running Jobs field, determine the maximum number of concurrently running jobs.
From the Date Types drop-down list, select one of the following options to determine when the maximum number of concurrently running jobs is enforced in the Workload Policy:
- All Days
- Every (periodic day of the week)
- Between (specific days in the calendar)
- Between (specific date and time)
- Every Week Between (day of week and times)
- On (specific days in the calendar)
From the Time field, select one of the following time options:
- All Hours: Restrictions are enforced for all hours on the selected dates.
- Between: Restrictions are enforced for a period that you define on the selected dates.
Select Add.

The scheduled running jobs restrictions appears under Running Jobs.

Defining Host Mapping

This procedure describes how to define Host Mapping in Workload Policies Definitions, which routes a group of associated jobs to a new host, or Agent.

Begin

From Host Mapping, click .
From the Control-M Server drop-down list, select the Server where the required Host Groups are located.
From the Host/Host Groups drop-down list, select the host or host group where the jobs are currently defined.
From the Map To drop-down list, select the host or host group that you want the jobs to run on.

The mapped hosts appear under Host Mapping.

Workload Policies Monitor

The Workload Policies Monitor enables you to review the status of jobs grouped into Workload Policies.

The Active Jobs panel displays the status of all active jobs across all Control-M/Servers, and not just the jobs defined in Workload Policies.

The following table describes the status columns that appear by default in the Workload Policies Monitor:

Column Name	Description
Name	Displays the Workload Policy name.
Wait Hosts	Displays the number of jobs in the Workload Policy that are waiting for host, or Agent, resources, due to one of the following reasons: An Agent is unavailable. An Agent is already running its maximum number of jobs. An Agent is currently at its maximum CPU usage restriction level.
Wait Workloads	Displays the number of jobs that are currently waiting because of defined Workload Policy restrictions.
Running Jobs	Displays the number of concurrently running jobs.