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 Triggers, which are listed alphabetically on this page.

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

See Import and Export Functions for these trigger-related functions:

Disable a Trigger

Description	Disables the specified trigger(s).
Syntax	`uagcmd ops-trigger-disable global parameters trigger-name=name [trigger-type=type]` 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	`trigger-name=` Name or partial name of one or more triggers. Wildcards are supported. `trigger-type=` Optional; If you used a wildcard in `trigger-name=`, you can use `trigger-type=` to narrow down the selection to a specific type of trigger. One of the following (not case-sensitive): cron, time, manual, temporary, agent_file_monitor, task_monitor, variable_monitor, email_monitor, composite, application_monitor.
Example	uagcmd ops-trigger-disable -c config.cfg trigger-name=Trigger A

Enable a Trigger

Description	Enables the specified trigger(s).
Syntax	`uagcmd ops-trigger-enable global parameters trigger-name=name [trigger-type=type]` 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	`trigger-name=` Name or partial name of one or more triggers. Wildcards are supported. `trigger-type=` Optional; If you used a wildcard in `trigger-name=`, you can use `trigger-type=` to narrow down the selection to a specific type of trigger. One of the following (not case-sensitive): cron, time, manual, temporary, agent_file_monitor, task_monitor, variable_monitor, email_monitor, composite, application_monitor.
Example	uagcmd ops-trigger-enable -c config.cfg trigger-name=Trigger A

Launch Trigger Tasks Now

Description	Marks all conditions as satisfied in the specified trigger(s) and launches its associated tasks.
Syntax	`uagcmd ops-trigger-now global parameters trigger-name=name [time-zone=US/Pacific] [trigger-type=type] [hold=option] [virtual-resource-priority=integer] [virtual-resources=list] [trigger-variables=variables]` 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	`trigger-name=` Required; Name or partial name of one or more triggers. Wildcards are supported. `time-zone=` Time zone in which the trigger is run. `trigger-type=` Optional; If you used a wildcard in `trigger-name=`, you can use `trigger-type=` to narrow down the selection to a specific type of trigger. One of the following (not case-sensitive): cron, time, manual, temporary, agent_file_monitor, task_monitor, variable_monitor, email_monitor, composite, application_monitor. `hold=` Optional; Specification for whether to place the task(s) in Held status when it is triggered. Valid values are (not case sensitive): yes/y/true. `virtual-resource-priority=` Optional; Virtual resource priority of all task instances specified for the trigger. Valid values are any integer between 1 and 20. Defaults to the virtual resource priority defined in the task Details. `virtual-resources=` Optional; Comma-separated list of <resource-name>:<amount> pairs. For example, VR1:10,VR2:20,...,VRN:N. An amount of 0 indicates the virtual resource should be dropped. Defaults to virtual resources defined in the task Details. The virtual resource dependencies specified in `virtual-resources=` are merged with the default virtual resource dependencies. If a default virtual resource dependency already exists for a specified virtual resource amount, the virtual resource dependency is updated. Any virtual resource specified with an amount of 0 is dropped from the default virtual resource dependencies; if the virtual resource did not exist as a default dependency, the command will fail. If a default virtual resource dependency does not already exist for a specified virtual resource amount, the virtual resource dependency is added. `trigger-variables=` Optional; Any variables specified in the task(s) being triggered that need a value to run properly.
Example	All variable=value pairs must be specified within one set of braces: uagcmd ops-trigger-now -c config.cfg trigger-name=Trigger A trigger-variables={variable1=first value variable2=second value}

List Triggers Status

Description	Lists the status of the specified trigger(s). Possible statuses are Enabled or Disabled.
Syntax	`uagcmd ops-trigger-status global parameters trigger-name=name [trigger-type=type] [trigger-status=status] [options=v]`
Parameters	`trigger-name=` Name or partial name of one or more triggers. Wildcards are supported. `trigger-type=` Optional; One of the following (not case-sensitive): cron, time, manual, temporary, agent_file_monitor, task_monitor, variable_monitor, email_monitor, composite, application_monitor. (If not specified, statuses for all Trigger types are listed.) `trigger-status=` Optional; One of the following (not case sensitive): enabled, disabled. `options=` Optional; v (Return verbose results.)
Example	uagcmd ops-trigger-status -c config.cfg trigger-name=Trigger A status=disabled

Modify Time of a Time Trigger

Description	Modifies the Time field of a Time Trigger with the Time Style field set to time.
Syntax	`uagcmd ops-trigger-set-time global parameters {trigger-id=ID \| trigger-name=name} time=time` 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	`trigger-id=` Required if `trigger-name=` is not specified; sys_id of the time trigger. `trigger-name=` Required if `trigger-id=` is not specified; Name of the time trigger. `time=` Required; New trigger time in format HH:MM.
Example	uagcmd ops-trigger-set-time -c config.cfg trigger-name=Trigger A time=15:00

Trigger Functions