Host Groups

A host is a computer that can run A Control-M process that adds your job to the Run Queue of the day, according to automatic or manual scheduling, and which enables the job to execute after it fulfills its prerequisites. and execute jobs. A host group is a collection of Agents or Agentless Hosts that you group together, which enables you to define and run jobs on any of the hosts within the host group. This helps balance the load for resource-intensive workflows. To create a host group, see Creating a Host Group.

Participation Rules enable you to determine when any or all Agents or Agentless Hosts in the host group are available to run jobs and SMART folders, as described in Creating a Host Group.

Role Authorizations enable you to control the level of access for users and roles host groups, as described in Role Authorizations.

Creating a Host Group

This procedure describes how to create a host group, which enables you to execute a job or SMART folder on a group of Agents or Agentless Hosts, instead of on a specific host.

Begin

1. From the icon, select Configuration.

   The Configuration domain opens.

2. From the drop-down list, select Agents.

   The Agents page appears.

3. Click Manage, then select Host Group from the drop-down list.

4. Click .

5. In the Host Group Name field, type the name of the new host group.

6. (Optional) From the Tag drop-down list, select the tag A logical name that is used to label specific Agents in a group that has a specific authorization level. that is associated with the hosts that you want to add to the host group.

   A tag limits the selection to only the hosts that are associated with the tag. If you do not select a tag, you can add all hosts if you have the required authorizations.

7. In the Agents area, click and select the Agents or Agentless Hosts to add to this host group.

   You can search for existing Agents or Agentless Hosts in the Search Agents field.

8. Create participation rules, as follows:

   1. Select a host and click Add Rule.

      The Participation Rules dialog appears.

   2. Click Add Rule, then from the Rule Type area, select one of the following options:

      • Date & Time: Determines when the host can participate in a host group, as follows:

        1. From the Date Type drop-down list, select one of the following options:

           • Every Day: Host always participates.

           • Days of the Week: Host participates on the weekdays that you define.

           • Between Specific Calendar Days: Host participates between the dates that you define.

           • Between Specific Calendar Days & Times: Host participates between the times on the dates that you define.

           • Every Week between Days & Time: Host participates between the times on the weekdays that you define.

           • On Specific Calendar Days: Host participates on the specific dates that you define.

        2. From the Time area, select one of the following options:

           • All Hours: Host participates all hours of the dates that you have defined in Date & Time.

           • Between: Host participates between the times you define on the dates you have defined in Date & Time.

      • Event: Determines the event that allows the host to participate in a host group, as follows:
        

        1. In the Event Name field, type the name of an event.

        2. From the Run Date drop-down list, select one of the following options:

           • Run Date: Host participates in a host group when this event is added on the job run date.

           • Any Date: Host participates in a host group when this event is added on any date.

           • No Date: Host participates in a host group when this event is added.

           • Specific Date: Host participates in a host group when this event is added on a specific date.

           For more information, see Events.

      The Edit <Host_Group_Name> pane appears with the new participation rule.

9. Click Create.

   You can now define a job to run on this host group, instead of on a specific Agent or Agentless Host.