1 Agents
2 Displaying Agent Details
- 2.1 Agents List Column Descriptions
- 2.2 Agent Details Field Descriptions
3 Starting and Stopping Agents
4 Suspending Agents, Agent Clusters, and Agent Cluster Memberships
- 4.1 Suspending an Agent
  - 4.1.1 Resuming an Agent
- 4.2 Suspending an Agent Cluster
  - 4.2.1 Resuming an Agent Cluster
- 4.3 Suspending an Agent Cluster Membership
  - 4.3.1 Suspending an Agent Cluster Membership Due to Decommissioning
  - 4.3.2 Resuming an Agent Cluster Membership
5 Resetting the Current Task Count
6 Sending Notifications on Status of an Agent

Agents

Agent resources refer to Universal Agents, running programs on one or more remote machines, connected to the Controller via Universal Message Service (OMS).

OMS must be running in order for you to run tasks on an Agent.

There are four types of Agents:

Displaying Agent Details

When you start an Agent for the first time, the Controller automatically creates a database record for that Agent. You can view these records for details and status information.

(You also can view status information about Agents from the Command Line Interface (CLI).)

Step 1

From the Agents & Connections navigation pane, select Agents > All Agents or Agents > <type of agent>. An Agents list displays:

See Agents List Field Descriptions, below, for a description of the columns on an Agent List.

Step 2

To display Details about an Agent on the list, click the details icon or click anywhere in the Agent row.

Most fields are display-only; however, you can make the following changes:

Add a Description.
Add a Member of Business Services.
Assign Credentials.
Change the heartbeat interval. The heartbeat is a status message sent from the Agent to the Controller.
Change the heartbeat grace period. The heartbeat grace period is the time that the Controller will allow for a delayed heartbeat message.
Change the default Log Level.
Select whether or not to apply a Task Execution Limit (and Limit Amount) on the Agent.

You also can choose to:

Temporarily suspend the agent's ability to run tasks.

For information on how to access additional details - such as Metadata and complete database Details - for Agent (or any type of record), see Records.

Agents List Column Descriptions

The following table describes the default display columns on an Agents list.

Column	Description

Column	Description
Name
Host Name
Type
Agent ID
Version
Last Heartbeat
Current Task Count	System supplied; current number of tasks currently being run by this Agent.
Suspended	Specification (true or false) for whether or not this Agent has been suspended from the ability to run tasks.
Status
Started Date	Time stamp of when the Agent started or connected.
Updated By	User that last updated this record.
Updated	Date when this record was last updated.
Member of Business Service	Business Services that this Agent belongs to.

Agents Overview

Agents

Displaying Agent Details

Agents List Column Descriptions