Defining Agent Groups

The steps for defining an Agent Group (HOSTG) are the same as for any other object. This section describes the settings that are specific to only Agent Group objects. For general information about the purpose of an Agent Group object, see Agent Groups (HOSTG).

An Agent Group definition is made up of the following pages:

• Standard pages that are always available, no matter what type of object you are defining:
• General Page
• Version Management Page
• Documentation Page
• Authorizations Page

• The object-specific page described here.

  In the Agent Group page you define the group settings and assign it the individual Agents.

Notes:

• Agent Groups of client 0 can also be used in other clients provided the administrator has set the relevant rights for the Agent Group. The client's Agent Group is used if the client 0 contains an Agent Group of the same name.

• An Agent Group of client 0 does not necessarily supply the same Agent in each client. Agents obtain client authorizations after installation which can differ from each other.

Accessing the User Definition Pages

1. Open the Process Assembly perspective by clicking + next to the Home icon on the menu bar at the top of your screen.
2. Click the Add Object button on the toolbar. On the Add Object dialog, select Agent Group and click OK.
3. On the dialog that is displayed, enter a Name and, optionally, a Title.

4. Enter the Name and (optionally) the Title and click OK. The Agent Group definition pages are displayed:

   • General Page
   • Authorizations Page
   • Agent Group page, described here
   • Agent Group Authorizations
   • Version Management Page
   • Documentation Page

Agent Group Page

On this page you define many of the most relevant properties of the object. It consists of the following elements:

Title bar

• Arrow back button that lets you go back to the page that you have previously visited
• Complete name of the object

Toolbar with the following buttons

• Edit

  Indicates whether the object is in edit or in read only mode

• Save

• (Client 0 only) Move

  Lets you move the Agent Group to a different folder

Defining an Agent Group consists of the following:Once you have created them in the Process Assembly perspective, you can also access and edit them in the Administration perspective.

Platform and Mode Section

In the Platform and Mode section you define the environment and the Agents in the group in which the tasks should be executed.

1. Select the Platform.

   You can only assign individual Agents to a group if they all have the same platform.

   This list is disabled as soon as you start assigning Agents to the group. You can only change the platform definition if you first remove all the Agents assigned to the group.

   Please note that Platform and OS are not the same. For example, an Agent Group in which the WINDOWS platform has been defined can only contain Windows Agents. However, an SAP Agent that runs on Windows cannot be assigned to this group, since in this case SAP is the platform.

2. In Mode you specify the method that the Agent Group will use to evaluate which Agent should be used to process each task:

   • Any

     Any Agent with enough resources is assigned for processing the task.

   • First

     On the first available Agent, depending on the order defined in the Assigned Agents table

   • Next listed

     On the next active Agent according to the order specified in the Assigned Agents table.

     In case of multiple tasks using the same Agent Group, a round robin system is applied. Thus, task A would start running on the first Agent and task B, which is started later, would run on the second Agent, and so on.

   • Load dependent

     On the Agent with the lowest workload in the group according to the data delivered by the resources allocation.

     The following is taken into consideration:

     • Preference is given to Agents without resource limits.
     • The Agent with the lowest workload is used if there are resource limits for all Agents in the group.

     In both cases, if Agents have the same resource limits, the Agent with the fewest active tasks is used.

     The criterion to select an Agent to execute a task is the start time defined for the task. You specify this on the Attributes Page of the executable object.

     You have two possibilities:

     • Late Agent assignment: Generate at runtime

       If you select this option, the Agent Group evaluates the available resources and assigns an Agent to the task only if it has enough resources. If this is the case, the resources are reserved immediately; if not, the Agent Group evaluation waits and the status of the task switches to Waiting for the host of an AgentGroup (1688).

     • Generate at activation time

       The start time of the task is used for Agent selection. The status of the task switches to Waiting for resource in case no sufficient resources are available on the Agent at that moment. It waits until processing is possible again. It does NOT change the Agent even if a different one had enough resources.

   • All active

     On all active Agents

   • All active and inactive

     On all Agents

   • Parallel task

     If tasks in this group are to be executed in All active or in All active and inactive Agents, you can also specify whether

     • tasks can run in parallel and, if so, how many
     • you want to prevent this group from processing tasks. Activate the Suspend task processing option for this purpose.

Assigned Agents Section

In this section you pick the individual Agents from the Available Agents list and insert them in the Assigned Agents one, where you can then rearrange them to meet the order of the Agents in the group. The order is important if you have previously selected Next listed as mode.

• Name

  Name of the Agent

• Version

  Version of the Agent including hot fix level

• Hardware

  Hardware information such as system type, number of processors, processor type.

• Software

  The OS

• Software Version

  Version of the OS

• Archive 1/2

  Archive keys are keywords you assign to the object. Later on you can perform searches or you can filter objects using them:

  • Archive Key 1 is limited to max. 60 characters
  • Archive Key 2 is limited to max. 20 characters

• Role

  Role of the Agent. The system administrator can determine roles for each Agent, which are stored in the UC_EX_HOST_ROLE Agent variable.

1. Optionally, select the Mode, that is, the Agent in the group on which the task will be executed.

   For details see the description on the first table above.
   

2. Refresh the list of Available Agents to make sure that it is up-to-date.

   The list displays all Agents that are available for the current client.

3. If necessary, you can restrict the number of Agents displayed in the list to only those that are relevant for this group.

   For this purpose, enter the name of the Agent in the search box.

   The content of the Agent list diminishes dynamically as you type.
   

4. You can select Agents individually or in bulk. Do one of the following:
• Activate the check box next to the Agents you want to assign
• Activate the check box on the list header row to select all the Agents in the list
5. Click Assign selected The Agent is inserted at the bottom of the Assigned Agents list.

Notes:

• Do not forget to define the proper order of the Agents in the group if you have selected First or Next listed above.

• You can also use the following script functions to assign Agents:

  • :PUT_ATT to assign a different Agent, but you cannot assign a different Agent Group.

  • PREP_PROCESS_AGENTGROUP to read the Agents of an Agent Group.

Arranging the Agents in the Group

The order in which the Agents are arranged in the group is relevant for Agent allocation (see Which Agent in the Group is Used?

For information on how to arrange the Agents, see Working with Tables.

See also:

• Agent Group Attributes
• Monitoring Agent Groups