Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

Anchor
ops-variable-list
ops-variable-list

List Variables

Description

Lists the specified variable(s).

Syntax

uagcmd ops-variable-list global parameters variable-name=name variable-scope=scope [task-name=name] [trigger-name=name] [options=v]
 

Note
titleNote

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


Parameters

  • variable-name=
    Optional; Name or partial name of one or more variables. Wildcards are supported.
  • variable-scope=
    Optional; One of the following (not case sensitive): global (default), task, trigger, local (task or trigger). Defines the type of variable being listed. A global variable is created independently by selecting Variables from the Universal Controller user interface navigator. A trigger variable is attached to a trigger; a task variable is attached to a task. A localvariable can be either a task or trigger variable.
  • task-name=
    Required if variable-scope=task; A single task name.
  • trigger-name=
    Required if variable-scope=trigger; A single trigger name.
  • options=
    Optional; v (Return verbose results.)

Example


Panel
uagcmd ops-variable-list -c config.cfg variable-name=abc variable-scope=task task-name=Task A


Anchor
ops-variable-set
ops-variable-set

Set Variables

Description

Sets the specified variable.

Syntax

uagcmd ops-variable-set global parameters variable-name=name variable-scope=scope variable-value=string [variable-description=description] [task-name=name] [trigger-name=name] create=option
 

Note
titleNote

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


Parameters

  • variable-name=
    Required; Name of a specific variable. The name must begin with an alphabetic character and can consist of: alphabetic characters (a-z, A-Z), numbers (0-9), _ (underscore). White spaces are not permitted; names are not case-sensitive.
  • variable-scope=
    Optional; One of the following (not case sensitive}: global (default), task, trigger. In cases where there may be more than one occurrence of the specified variable, variable-scope= defines which one should be set. A global variable is created independently by selecting Variables from the Universal Controller user interface navigation pane. A trigger variable is attached to a trigger; a task variable is attached to a task.
  • variable-value=
    Required; String that will become the value of the specified variable. UTF-8 character set is supported.
  • variable-description=
    Optional; Description of the variable.
  • task-name=
    Required if variable-scope=task; A single task name.
  • trigger-name=
    Required if variable-scope=trigger; A single trigger name.
  • create=
    Required; Specification (yes or no) for whether or not a new variable may be created for this request.

Example


Panel
uagcmd ops-variable-set -c config.cfg variable-name=myvar1 variable-value=mydata1 create=yes 


Warning
titleWarning

CLI supports modifying only certain types of variables - see Modifying Variables.


...