Agent Functions

Owned by Stonebranch (Deactivated)
Last updated: May 31, 2023
6 min read

Overview

The command line syntax for each execution of the CLI command, uagcmd, must specify a single CLI function, required / optional Global parameters, and required / optional function-specific parameters. You must use the required Global parameters to connect to OMS Servers and to log on to a Controller (User ID and Password).

Universal Controller supports the following CLI functions for Agents, which are listed alphabetically on this page.

Syntax, parameters, and examples for each function are provided.

Delete Agent

Description

Deletes an Agent record.

Syntax

uagcmd ops-delete-agent global parameters {agent-name=name | agent-id=ID }

Parameters
  • agent-name=
    Required if agent-id= is not specified; Agent name of the Agent to be deleted (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; Agent ID of the Agent to be deleted (agent-id= and agent-name= are mutually exclusive).

Example

 
uagcmd ops-delete-agent -c config.cfg agent-name=agent A

List Agents Status

Description

Lists the status of one or more Agents.

Syntax

uagcmd ops-agent-status global parameters [agent-name=name] agent-type=type [options=v]
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Optional; Name or partial name of one or more Agents. Wildcards are supported.
  • agent-type=
    Optional; One of the following (not case sensitive): windows, unix, linux, linux/unix, zos, z/os. (If not specified, status of all Agents are listed.)
  • options=
    Optional; v (Return verbose results.)

Example

 
uagcmd ops-agent-status -c config.cfg agent-type=windows

Resume Agent

Description

Resumes the ability of the identified Agent to run tasks.

Syntax

uagcmd ops-resume-agent global parameters {agent-name=name | agent-id=id }
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Required if agent-id= is not specified; Agent name of the Agent whose ability to run tasks is to be resumed (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; Agent ID of the Agent whose ability to run tasks is to be resumed (agent-id= and agent-name= are mutually exclusive).

Example

 
uagcmd ops-resume-agent -c config.cfg agent-name=agent A

Resume Agent Cluster

Description

Resumes the ability of the identified Agent Cluster to run tasks.

Syntax

uagcmd ops-resume-agent-cluster global parameters agent-cluster-name=name
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameter
  • agent-cluster-name=
    Required; Agent cluster name of the Agent Cluster whose ability to run tasks is to be resumed.

Example

 
uagcmd ops-resume-agent-cluster -c config.cfg agent-cluster-name=cluster A

Resume Agent Cluster Membership

Description

Resumes the membership of the identified Agent in the identified Agent Cluster.

Syntax

uagcmd ops-resume-agent-cluster-membership global parameters {agent-name=name | agent-id=ID} agent-cluster-name=name
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Required if agent-id= is not specified; Agent name of the Agent whose membership in the Agent Cluster is to be resumed (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; Agent ID of the Agent whose membership in the Agent Cluster is to be resumed (agent-id= and agent-name= are mutually exclusive).
  • agent-cluster-name=
    Required; Agent cluster name of the Agent Cluster in whose membership the identified Agent is to be resumed.

Example

 
uagcmd ops-resume-agent-cluster-membership -c config.cfg agent-name=agent A agent-cluster-name=cluster A

Set Agent Cluster Task Execution Limit

Description

Specifies whether or not an Agent Cluster has a task execution limit and, if so, sets the task execution limit.

Syntax

uagcmd ops-set-agent-cluster-task-execution-limit global parameters agent-cluster-name=name limit-type=type limit-amount=number
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-cluster-name=
    Required; Name of the Agent Cluster.
  • limit-type=
    Required; Specification for whether or not there is a limit to the number of tasks that can be run at the same time by the Agent Cluster. Allowable values (not case sensitive) are: limited, unlimited.
  • limit-amount=
    Required if limit-type=limited; Maximum number of tasks that can be run at the same time by the Agent Cluster.

Example

 
uagcmd ops-set-agent-cluster-task-execution-limit -c config.cfg agent-cluster-name=cluster A limit-type=limit limit-amount=500

Set Agent Task Execution Limit

Description

Specifies whether or not an Agent has a task execution limit and, if so, sets the task execution limit.

Syntax

uagcmd ops-set-agent-task-execution-limit global parameters {agent-name=name | agent-id=ID} limit-type=type limit-amount=number
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Required if agent-id= is not specified; Name of the Agent (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; ID of the Agent (agent-id= and agent-name= are mutually exclusive).
  • limit-type=
    Required; Specification for whether or not there is a limit to the number of tasks that can be run concurrently by the Agent. Allowable values (not case sensitive) are limited, unlimited.
  • limit-amount=
    Required if limit-type=limited; Maximum number of tasks that can be run at the same time by the Agent.

Example

 
uagcmd ops-set-agent-task-execution-limit -c config.cfg agent-name=agent A limit-type=limit limit-amount=500

Suspend Agent

Description

Suspends the ability of the identified Agent to run tasks.

Syntax

uagcmd ops-suspend-agent global parameters {agent-name=name | agent-id=ID }
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Required if agent-id= is not specified; Agent name of the Agent whose ability to run tasks is to be suspended (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; Agent ID of the Agent whose ability to run tasks is to be suspended (agent-id= and agent-name= are mutually exclusive).

Example

 
uagcmd ops-suspend-agent -c config.cfg agent-name=agent A

Suspend Agent Cluster

Description

Suspends the ability of the identified Agent Cluster to run tasks.

Syntax

uagcmd ops-suspend-agent-cluster global parameters agent-cluster-name=name
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameter
  • agent-cluster-name=
    Required; Agent cluster name of the Agent Cluster whose ability to run tasks is to be suspended.

Example

 
uagcmd ops-suspend-agent-cluster -c config.cfg agent-cluster-name=cluster A

Suspend Agent Cluster Membership

Description

Suspends the membership of the identified Agent in the identified Agent Cluster.

Syntax

uagcmd ops-suspend-agent-cluster-membership global parameters {agent-name=name | agent-id=ID} agent-cluster-name=name
 

Note

For backward-compatibility, you can exclude uagcmd from the command line for this function and all pre-6.2.0.0 CLI functions.

Parameters
  • agent-name=
    Required if agent-id= is not specified; Agent name of the Agent whose membership in the Agent Cluster is to be suspended (agent-name= and agent-id= are mutually exclusive).
  • agent-id=
    Required if agent-name= is not specified; Agent ID of the Agent whose membership in the Agent Cluster is to be suspended (agent-id= and agent-name= are mutually exclusive).
  • agent-cluster-name=
    Required; Agent cluster name of the Agent Cluster in whose membership the identified Agent is to be suspended.

Example

 
uagcmd ops-suspend-agent-cluster-membership -c config.cfg agent-name=agent A agent-cluster-name=cluster A