...
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.
Anchor |
---|
| ops-delete-agent |
---|
| ops-delete-agent |
---|
|
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 | |
---|
Anchor |
---|
| ops-agent-status |
---|
| ops-agent-status |
---|
|
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]
|
---|
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 | |
---|
Anchor |
---|
| ops-resume-agent |
---|
| ops-resume-agent |
---|
|
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 }
|
---|
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 | |
---|
Anchor |
---|
| ops-resume-agent-cluster |
---|
| ops-resume-agent-cluster |
---|
|
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
|
---|
Parameter | agent-cluster-name = Required; Agent cluster name of the Agent Cluster whose ability to run tasks is to be resumed.
|
---|
Example |
Panel |
---|
uagcmd ops-resume-agent-cluster -c config.cfg agent-cluster-name=cluster A |
|
---|
Anchor |
---|
| ops-resume-agent-cluster-membership |
---|
| ops-resume-agent-cluster-membership |
---|
|
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
|
---|
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 |
Panel |
---|
uagcmd ops-resume-agent-cluster-membership -c config.cfg agent-name=agent A agent-cluster-name=cluster A |
|
---|
Anchor |
---|
| ops-set-agent-cluster-task-execution-limit |
---|
| ops-set-agent-cluster-task-execution-limit |
---|
|
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
|
---|
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 |
Panel |
---|
uagcmd ops-set-agent-cluster-task-execution-limit -c config.cfg agent-cluster-name=cluster A limit-type=limit limit-amount=500 |
|
---|
Anchor |
---|
| ops-set-agent-task-execution-limit |
---|
| ops-set-agent-task-execution-limit |
---|
|
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
|
---|
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 |
Panel |
---|
uagcmd ops-set-agent-task-execution-limit -c config.cfg agent-name=agent A limit-type=limit limit-amount=500 |
|
---|
Anchor |
---|
| ops-suspend-agent |
---|
| ops-suspend-agent |
---|
|
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 }
|
---|
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 | |
---|
Anchor |
---|
| ops-suspend-agent-cluster |
---|
| ops-suspend-agent-cluster |
---|
|
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
|
---|
Parameter | agent-cluster-name = Required; Agent cluster name of the Agent Cluster whose ability to run tasks is to be suspended.
|
---|
Example |
Panel |
---|
uagcmd ops-suspend-agent-cluster -c config.cfg agent-cluster-name=cluster A |
|
---|
Anchor |
---|
| ops-suspend-agent-cluster-membership |
---|
| ops-suspend-agent-cluster-membership |
---|
|
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
|
---|
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 |
Panel |
---|
uagcmd ops-suspend-agent-cluster-membership -c config.cfg agent-name=agent A agent-cluster-name=cluster A |
|
---|
...