Using Resource Controls

You can view, add, and edit resource controls on the Resource Controls > List page. On this page you can see the number of running and queued jobs assigned to each resource control, and any conflicts between resource controls. See About Resource Controls for more information.

Adding or Editing a Resource Control

A job resource control added or edited during a job run will affect that job. An Agent resource control added or edited during a job run will only take effect on subsequent runs of the same job.

To add or edit a resource control:

1. In your Manager, navigate to Administration > Resource Controls > List.
2. Click Add or Edit.

3. On the General tab, specify the following properties:

   • Name: Enter a unique name for the resource control.
   • Type: Select Job, Agent, or Media Exchange Transfer Job Group.
   • Scope: Select the job or Agent for the resource control.
   • Concurrency: Select the maximum allowable number of concurrent running jobs or job components. Those above the maximum will be queued. When concurrency is set to 0, no jobs are run. To disable restrictions on the number of concurrent running jobs/job components, select Unmanaged.

   • Aggregate Bandwidth: Select this check box to specify the following bandwidth options for the jobs/job components.

     • Job Priority Bandwidth Allocation: If selected, allocates bandwidth according to the job priority
     • Bandwidth Ceiling: Sets the maximum rate at which data should be sent
     • Bandwidth Floor: Sets the minimum rate at which the data should be sent

     To set a bandwidth ceiling and/or floor:

     1. Deselect Unmanaged.
     2. Enter the throttle rate. Entering a value of 0 allows auto-detection for the best bandwidth rate.

     3. Select the throttle rate unit. The default unit is Bps.

        You can also set bandwidth ceiling and floor values by clicking the slider icon. The slider sets the amount of bandwidth as a percentage of standard maximums. The percentage you select appears as a calculated rate in the Bandwidth Ceiling or Bandwidth Floor field.

     4. Bandwidth Throttle by Time of Day (in GMT time): Sets bandwidth limits based on time of day

     To set the bandwidth throttle by time of day:

     1. Enter the bandwidth throttle rate. A value of 0 allows automatic bandwidth rate detection.
     2. Select the bandwidth throttle rate unit. The default is Bps.
     3. Set a start and end time, and/or days of the week.

     To add or remove time parameters, click the add or remove icons.

4. If the resource control is an Agent job group with a configured scope, specify the following (optional):

   • In the Criteria section, select criteria for applying the resource control.
   • In the Advanced section, select a precedence value.
5. If monitoring is not enabled on the Agent/Alias specified in the Scope field, go to Agents > List, select the Agent/Alias and click Reconnect. You can also enable monitoring by editing the selected Agent. On the Network tab, choose Monitor and select the option(s) to monitor.

Resolving Conflicts Between Agent Resource Controls

When multiple controls are assigned to the same Agent, conflicts can occur. In the event of a conflict, a warning appears in the Resource Control List. You can resolve the conflict by specifying a precedence value for one or more of the Agent resource controls. To learn more about managing multiple resource controls, see About Resource Controls.

To specify a precedence value:

1. Navigate to Resource Controls > List.
2. In the Advanced section, enter a precedence value. The highest precedence is a value of 1.

Enabling Permissions

Once you have created a resource control, you can give a specific user or user group access to it. In order to have access to a resource control, the user or user group must also have access to the job group or Agents to which it is applied. For information on enabling permissions, see Understanding Users.

Removing a Resource Control

A resource control can be removed from a job or Agent either by disabling it or deleting it. It is recommended that you disable an unwanted resource control rather than deleting it. Deleting a job group, Agent, Agent Alias or load balanced Agent group that has an associated resource control will cause a resource control to be deleted.

When you delete a resource control, any limits on concurrent running jobs or bandwidth used will be removed immediately. If the deletion occurs while concurrent jobs are running, the jobs will continue to run at the resource limit at which they began the run. Subsequent runs of the same jobs will no longer be constrained by the deleted resource control. Any queued jobs will immediately be released from the queue and added to the concurrent jobs without bandwidth limits.

If you change the Agent in an Agent Resource Control, the limit on the number of concurrent running jobs using the original Agent and bandwidth limit will be removed immediately. The limit on the number of concurrent running jobs using the new Agent and the bandwidth limit will be applied to all subsequent job runs and all jobs that are queued. Any running jobs will not be counted in the concurrency limit applied.

To enable or disable a resource control:

1. In Administration > Resource Controls > List, select the resource control.
2. Toggle the Enable/Disable button.

To delete a resource control:

1. In Administration > Resource Controls > List, select the resource control and click Delete.
2. Click Yes to confirm the deletion.