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 three 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	User-defined during installation; name used within the Controller to identify this Agent.
Host Name	User-provided during installation; IP address or domain/name of the host machine where the resource resides.
Type	All Agents list only; Agent's platform: Linux/Unix, Windows, or z/OS.
Agent ID	Unique ID for this Agent, created during installation.
Version	System-supplied; version number of the Agent program.
Last Heartbeat	System-supplied; date and time the most recent heartbeat was received from the resource.
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	System-supplied; status of the Agent. Active: the Agent is running. Offline: the Agent is not running.
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