Versions Compared

Old Version 2

changes.mady.by.user IT Stonebranch

Saved on

compared with

New Version Current

changes.mady.by.user Stonebranch

Saved on

Key

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

...

<ul> <li> <code>task
  • task-instance=
</code> <br>Required; An

  • Required; An internal Universal Controller identifier

 
  • .

Description

Cancels the specified task instance.
 
See Cancelling a Task Instance for a description of behavior and restrictions.

Syntax

uagcmd ops-task-cancel global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name]
 

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.


Parameter

Html bobswift
. <li><code>task
Warning
titleDeprecated

Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.

Html bobswift
  • task-instance-id=
</code> <br> Required if <code>task

  • Required if task-instance-name=
</code>
  • is
  • not
  • specified;
  • sys_id
  • of
  • the
  • task
  • instance
  • to
  • run
  • the
  • command
  • on.
<li><code>task
  • task-instance-name=
</code> <br> Required if <code>task

  • Required if task-instance-id=
</code>
  • is
  • not
  • specified;
  • Name
  • of
  • the
  • task
  • instance
  • to
  • run
  • the
  • command
  • on.
  • (If
<code>instance
  • instance-criteria=
</code> is not
  • is not specified,
  • the
  • oldest
  • active
  • task
  • instance
  • with
  • the
  • matching
  • name
  • will
  • apply.)
<li><code>instance
  • instance-criteria=
</code> <br> Optional if <code>task

  • Optional if task-instance-name=
</code>
  • is
  • specified;
  • One
  • of
  • the
  • following
  • (not
  • case-sensitive):
<b>oldest
  • oldest_active_
instance</b>
  • instance (default),
<b>oldest_instance</b>, <b>newest
  • oldest_instance, newest_active_
instance</b>, <b>newest_instance</b> <li><code>workflow
  • instance, newest_instance
  • workflow-instance-name=
</code> <br> For a task instance in a workflow, optional; Name of the workflow instance. </ul>

  • For a task instance in a workflow, optional; Name of the workflow instance.

Example


<pre>uagcmd
uagcmd ops-task-cancel 
-c config.cfg
 task-instance-name=Task A
</pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-clear-dependencies
ops-task-clear-dependencies
Clear All Dependencies
     
Description
Clears all dependencies of a task instance.
Syntax
uagcmd ops-task-clear-dependencies global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] 
Parameters
  • task-instance-id= 
    Required if task-instance-name= is not specified; sys_id of the task instance to run the command on.
  • task-instance-name= 
    Required if task-instance-id= is not specified; Name of the task instance to run the command on. (If instance-criteria= is not specified, the oldest active task instance with the matching name will apply.)
  • instance-criteria= 
    Optional, if task-instance-name= is specified; One of the following (not case-sensitive): oldest_active_instance (default), oldest_instance, newest_active_instance, newest_instance.
  • workflow-instance-name= 
    For a task instance in a workflow, optional; Name of the workflow instance.
Example

<pre>uagcmd
uagcmd ops-task-clear-dependencies 
-c config.cfg
 task-instance-name=Task A 
</pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-clear-resources
ops-task-clear-resources
Clear Virtual Resource Dependencies
     
Description
Clears all virtual resource dependencies of a task instance.
Syntax
uagcmd ops-task-clear-resources global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] resource-name=name 
Parameters
  • task-instance-id= 
    Required if task-instance-name= is not specified; sys_id of the task instance to run the command on.
  • task-instance-name= 
    Required if task-instance-id= is not specified; Name of the task instance to run the command on. (If instance-criteria= is not specified, the oldest active task instance with the matching name will apply.)
  • instance-criteria= 
    Optional, if task-instance-name= is specified; One of the following (not case-sensitive): oldest_active_instance (default), oldest_instance, newest_active_instance, newest_instance.
  • workflow-instance-name= 
    For a task instance in a workflow, optional; Name of the workflow instance.
  • resource-name= 
    Required; One of the following:
    • Name of the virtual resource dependency to clear.
    • An asterisk ( * ) to clear all virtual resource dependencies.
Example

<pre>uagcmd
uagcmd ops-task-clear-resources 
-c config.cfg
 task-instance-name=Task A resource-name=Resource 
A</pre>
A
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-clear-exclusive
ops-task-clear-exclusive
Clear Exclusive Dependencies
     
Description
Clears all exclusive dependencies of a task instance.
Syntax
uagcmd ops-task-clear-exclusive global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] 
Parameters
  • task-instance-id= 
    Required if task-instance-name= is not specified; sys_id of the task instance to run the command on.
  • task-instance-name= 
    Required if task-instance-id= is not specified; Name of the task instance to run the command on. (If instance-criteria= is not specified, the oldest active task instance with the matching name will apply.)
  • instance-criteria= 
    Optional, if task-instance-name= is specified; One of the following (not case-sensitive): oldest_active_instance (default), oldest_instance, newest_active_instance, newest_instance.
  • workflow-instance-name= 
    For a task instance in a workflow, optional; Name of the workflow instance.
Example

<pre>uagcmd
uagcmd ops-task-clear-exclusive 
-c config.cfg
 task-instance-name=Task A 
</pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-clear-time
ops-task-clear-time
Clear Time Dependency
     
Description
Clears the time dependency of a task instance.
Syntax
uagcmd ops-task-clear-timewait global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] 
Parameters
  • task-instance-id= 
    Required if task-instance-name= is not specified; sys_id of the task instance to run the command on.
  • task-instance-name= 
    Required if task-instance-id= is not specified; Name of the task instance to run the command on. (If instance-criteria= is not specified, the oldest active task instance with the matching name will apply.)
  • instance-criteria= 
    Optional, if task-instance-name= is specified; One of the following (not case-sensitive): oldest_active_instance (default), oldest_instance, newest_active_instance, newest_instance.
  • workflow-instance-name= 
    For a task instance in a workflow, optional; Name of the workflow instance.
Example

<pre>uagcmd
uagcmd ops-task-clear-timewait 
-c config.cfg
 task-instance-name=Task A 
</pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-list
ops-task-list
Display All Tasks
     
Description
Displays all specified tasks.
Syntax
uagcmd ops-task-list global parameters task-name=name [task-type=type] 
 
 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
  • task-name= 
    Optional; Name or partial name of one or more tasks. Wildcards are supported.
  • task-type= 
    Optional; One of the following (not case sensitive): application_control, email, email_monitor, agent_file_monitor, ftp, remote_file_monitor, indesca / universal_command / ucmd, manual, sap, peoplesoft, sql, stored_procedure, system_monitor, task_monitor, timer, unix, variable_monitor, web_service, windows, workflow, zos.
Example

<pre>uagcmd
uagcmd ops-task-list 
-c config.cfg
 
 task-name=Task A task-type=timer 
</pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-status
ops-task-status
Display Task Instance Status
<ul>
<li> <code>task
  • task-name=
</code> <br>Required; Name or partial name of one or more tasks. 

  • Required; Name or partial name of one or more tasks.  Wildcards are supported.

  •   
     
Description
Displays the status of all task instance(s) associated with the specified task.
Syntax
uagcmd ops-task-status global parameters task-instance-name=name [agent-name=name] [task-type=type] [task-status=status] [{workflow-instance-id=id] | [workflow-instance-name=name}] [workflow-instance-criteria=criteria] [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
 Html bobswift
<li> <code>task
 Warning
titleDeprecated
Replaced by task-instance-name= parameter; the command first will check for task-name=; if it is not specified, the command will check for task-instance-name=.
 Html bobswift
  • task-instance-name=
</code> <br>Optional; Name of the task 

  • Optional; Name of the task instance(s) 
 
  •  to 
 
  •  be 
 
  •  listed. 
  Html bobswift 
  •  are 
 
  •  supported.

<li> <code>agent
  • agent-name=
</code> <br>Optional; Name of the agent the task 

  • Optional; Name of the agent the task instance(s) 
 
  •  are 
 
  •  running 
 
  •  on.

<li> <code>task
  • task-type=
</code> <br>Optional; One of the following (not case 

  • Optional; One of the following (not case sensitive): 
 <b>application_control</b>, <b>email</b>, <b>email_monitor</b>, <b>agent file_monitor</b>, <b>ftp</b>, <b>remote_file_monitor</b>, <b>indesca</b> / <b>universal_command</b> / <b>ucmd</b>, <b>manual</b>, <b>sap</b>, <b>peoplesoft</b>, <b>sql</b>, <b>stored_procedure</b>, <b>system_monitor</b>, <b>task_monitor</b>, <b>timer</b>, <b>unix</b>, <b>variable_monitor</b>, <b>web_service</b>, <b>windows</b>, <b>workflow</b>, <b>zos</b>.
<li> <code>task-status=</code> <br>Optional; List of comma-separated 
  •  application_control, email, email_monitor, agent file_monitor, ftp, remote_file_monitor, indesca / universal_command / ucmd, manual, sap, peoplesoft, sql, stored_procedure, system_monitor, task_monitor, timer, unix, variable_monitor, web_service, windows, workflow, zos.
  • task-status= 
    Optional; List of comma-separated task status codes and/or names
 Html bobswift 
  •  (not 
 
  •  case 
 
  •  sensitive): 
 <i>status 
  • status code 
 
  •  or 
 name</i>,<i>status code or name</i>
  • name,status code or name,...,
<i>status 
  • status code 
 
  •  or 
 name</i>
  • name. 
 
  •  An 
 
  •  exclamation 
 
  •  mark 
 
  •  (!) 
 
  •  preceding 
 
  •  a 
 
  •  task 
 
  •  status 
 
  •  code 
 
  •  or 
 
  •  name 
 
  •  excludes 
 
  •  task 
 
  •  instances 
 
  •  with 
 
  •  that 
 
  •  status.

<li> <code>workflow
  • workflow-instance-id=
</code> <br>For a task instance in a workflow, optional if <code>workflow

  • For a task instance in a workflow, optional if workflow-instance-name=
</code> 
  •  is 
 
  •  not 
 
  •  specified; 
 
  •  sys_id 
 
  •  of 
 
  •  the 
 
  •  workflow 
 
  •  instance.

<li> <code>workflow
  • workflow-instance-name=
</code> <br>For a task instance in a workflow, optional if <code>workflow

  • For a task instance in a workflow, optional if workflow-instance-id=
</code> is not 
  •  is not specified; 
 
  •  Name 
 
  •  of 
 
  •  the 
 
  •  workflow 
 
  •  instance. 
 
  •  (If 
 <code>workflow
  • workflow-instance-criteria=
</code> 
  •  is 
 
  •  not 
 
  •  specified, 
 
  •  the 
 
  •  oldest 
 
  •  active 
 
  •  Workflow 
 
  •  instance 
 
  •  with 
 
  •  the 
 
  •  matching 
 
  •  name 
 
  •  will 
 
  •  apply.)

<li> <code>workflow
  • workflow-instance-criteria=
</code> <br>Optional, if <code>workflow

  • Optional, if workflow-instance-name=
</code> 
  •  is 
 
  •  specified; 
 
  •  One 
 
  •  of 
 
  •  the 
 
  •  following 
 
  •  (not 
 
  •  case-sensitive): 
 <b>oldest
  • oldest_active_
instance</b> 
  • instance (default), 
 <b>oldest_instance</b>, <b>newest
  •  oldest_instance, newest_active_
instance</b>, <b>newest_instance</b>.
<li> <code>options=</code> <br>Optional; <b>v</b> (Return verbose results.)
</ul>
  • instance, newest_instance.
  • options= 
    Optional; v (Return verbose results.)
Example

<pre>uagcmd
uagcmd ops-task-status 
-c config.cfg
 task-instance-name=mantask agent-name=managent task-type=
manual</pre>
manual
 Panel
 Html bobswift
 Html bobswift

 Anchor
Status Types
Status Types
Task Instance Status Types
...
<ul>
<li> <code>task
task-instance=
</code> <br>Required; An 

Required; An internal Universal Controller  identifier
Identifier 
     
Description
Force finishes the specified task instance. 
 
See Force Finishing a Task Instance for a description of behavior and restrictions.
Syntax
uagcmd ops-task-forcefinish global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] 
 
 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.

Parameter
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
  • task-instance-id=
</code> <br> Required if <code>task

  • Required if task-instance-name=
</code> 
  •  is 
 
  •  not 
 
  •  specified; 
 
  •  sys_id 
 
  •  of 
 
  •  the 
 
  •  task 
 
  •  instance 
 
  •  to 
 
  •  run 
 
  •  the 
 
  •  command 
 
  •  on.

<li><code>task
  • task-instance-name=
</code> <br> Required if <code>task

  • Required if task-instance-id=
</code> 
  •  is 
 
  •  not 
 
  •  specified; 
 
  •  Name 
 
  •  of 
 
  •  the 
 
  •  task 
 
  •  instance 
 
  •  to 
 
  •  run 
 
  •  the 
 
  •  command 
 
  •  on. 
 
  •  (If 
 <code>instance
  • instance-criteria=
</code> 
  •  is 
 
  •  not 
 
  •  specified, 
 
  •  the 
 
  •  oldest 
 
  •  active 
 
  •  task 
 
  •  instance 
 
  •  with 
 
  •  the 
 
  •  matching 
 
  •  name 
 
  •  will 
 
  •  apply.)

<li><code>instance
  • instance-criteria=
</code> <br> 

  • Optional, 
 
  •  if 
 <code>task
  • task-instance-name=
</code> 
  •  is 
 
  •  specified; 
 
  •  One 
 
  •  of 
 
  •  the 
 
  •  following 
 
  •  (not 
 
  •  case-sensitive): 
 <b>oldest
  • oldest_active_
instance</b> 
  • instance (default), 
 <b>oldest_instance</b>, <b>newest
  •  oldest_instance, newest_active_
instance</b>, <b>newest_instance</b> 
<li><code>workflow
  • instance, newest_instance
  • workflow-instance-name=
</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
</ul>

  • For a task instance in a workflow, optional; Name of the workflow instance.
Example

<pre>uagcmd
uagcmd ops-task-forcefinish 
-c config.cfg
 task-instance-id=
90079020d861e5e40128cbb3cdbe1cf3</pre>
90079020d861e5e40128cbb3cdbe1cf3
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-launch
ops-task-launch
Launch a Task
Wildcards
     
Description
Launches the specified task(s).
Syntax
uagcmd ops-task-launch global parameters [task-type=type] task-name=name {time-zone=Australia/Sydney] [hold=option] [task-variables=variables] [virtual-resource-priority=priority] [virtual-resources=resources] 
 
 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
html
  • task-
bobswift
<ul>
<li> <code>task-type</code>= <br>Optional; One of the following (not case sensitive): <b>timer</b>, <b>windows</b>, <b>unix</b>, <b>zos</b>, <b>agent_file_monitor</b>, <b>manual</b>, <b>email</b>, <b>email_monitor</b>, <b>ftp</b>, <b>sql</b>, <b>remote_file_monitor</b>, <b>task_monitor</b>, <b>stored_procedure</b>, <b>workflow</b>, <b>sap</b>, <b>peoplesoft</b>, <b>system_monitor</b>, <b>indesca</b> / <b>universal_command</b> / <b>ucmd</b>, <b>web_service</b>, <b>application_control</b>.
<li> <code>task-name=</code> <br>Required; Valid task name. 
 Html bobswift
 are supported. 
<li> <code>time-zone=</code> <br>Optional; Time zone in which the task is launched.  
<li> <code>hold=</code> <br>Optional; Specification for whether to place the task in 
Held
 Html bobswift status when it is launched. Valid values are (not case sensitive): yes/y/true. 
<li> <code>task-variables=</code> <br>Optional; Any variables specified in the task that need a value to run properly. 
<li> <code>virtual-resource-priority=</code> <br>Optional; 
Virtual resource priority of the task instance. Valid values are any integer between 1 and 20. Defaults to the virtual resource priority defined in the task Details.
<li> <code>virtual-resources=</code> <br>Optional; 
Comma-separated list of &lt;resource-name&gt;:&lt;amount&gt; pairs. For example, <b>VR1N</b>    <b>0</b>                
<br><br>
      <code>virtual</code>        
<ul>
<li>If a default virtual resource dependency already exists for a specified virtual resource amount, the virtual resource dependency is updated.
<li> Any virtual resource specified with an amount of <b>0</b> is dropped from the default virtual resource dependencies; if the virtual resource did not exist as a default dependency, the command will fail.
<li> If a default virtual resource dependency does not already exist for a specified virtual resource amount, the virtual resource dependency is added.
</ul></ul>
Example
(All variable=value pairs must be specified within one set of braces.)
 
<pre>uagcmd
uagcmd ops-task-launch 
-c config.cfg
 task-name=Windows Task A task-variables={variable1=first value variable2=second value}
 </pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-hold
ops-task-hold
Put Task on Hold
<ul>
<li> <code>task</code> <br>Required; An 
 
     
Description
Puts the specified task instance on hold. 
 
See Putting a Task Instance on Hold for a description of behavior and restrictions.
Syntax
uagcmd ops-task-hold global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] 
 
 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.

Parameter
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance</code> <br>   <code>task</code>         <b>oldest_instance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
</ul>
Example

<pre>uagcmd
uagcmd ops-task-hold 
-c config.cfg
 task-instance=
90079020d861e5e40128cbb3cdbe1cf3</pre>
90079020d861e5e40128cbb3cdbe1cf3
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-release
ops-task-release
Release a Task from Hold
<ul>
<li> <code>task</code> <br>Required; An 
 
     
Description
Releases the specified task instance from hold. 
 
See Releasing a Task Instance from Hold for a description of behavior and restrictions.
Syntax
uagcmd ops-task-release global parameters {task-instance-id=ID | task-instance-id=name} [instance-criteria=criteria] [workflow-instance-name] [recursive=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.

Parameter
 Html bobswift
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
.
<li><code>task
.
</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance</code> <br>   <code>task</code>         <b>oldestinstance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
<li><code>recursive=</code> <br> Optional; Specification (yes or no), if the task instance specified in <code>task</code> or <code>task</code>                         <code>recursive=</code> is ignored.
</ul>
Example

<pre>uagcmd
uagcmd ops-task-release 
-c config.cfg
 task-instance-id=90079020d861e5e40128cbb3cdbe1cf3
 </pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-rerun
ops-task-rerun
Rerun a Task
<ul>
<li> <code>task</code> <br>Required; An  identifier
 
     
Description
Reruns the specified Task instance. 
 
See Re-running a Task Instance for a description of behavior and restrictions.
Syntax
uagcmd ops-task-rerun global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] {[task-status=status [recursive=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.

Parameter
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
id=</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance</code> <br>   <code>task=</code>         <b>oldestinstance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br>      
<li><code>task</code> <br>              &ltname&gt;,&lt;statusname&gt;&lt;statusname&gt;              
<br><br>
                      <code>recursive=</code> parameter controls whether or not tasks within         
<ul>
<li>   
<li>   
<li>   
<li>   
<li>  
</ul>
<li><code>recursive=</code> <br> Optional if <code>task</code>                        </ul>
Example

<pre>uagcmd
uagcmd ops-task-rerun 
-c config.cfg
 task-instance=8fda93dcd861e5e4005bf48e2cad6206 task-status=
140</pre>
140
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-manual-setstarted
ops-manual-setstarted
Set Manual Task to Started
<ul>
<li> <code>task</code> <br>Required; An 
 
     
Description
For a Manual task, changes its status from Action Required to Started. This allows you to acknowledge the Manual task and indicate that the manual procedures have been started.
Syntax
uagcmd ops-manual-setstarted global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name] 
 
 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.

Parameter
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance=</code> <br>   <code>task</code>         <b>oldestinstance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
</ul>
Example

<pre>uagcmd
uagcmd ops-manual-setstarted 
-c config.cfg
 task-instance=8fda93dcd861e5e4005bf48e2cad6206
 </pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-manual-setcompleted
ops-manual-setcompleted
Set Manual Task to Success
<ul>
<li> <code>task
     
Description
For a Manual task, sets its status to Success.
Syntax
uagcmd ops-manual-setcompleted global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name] 
 
 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.

Parameter
 Html bobswift
  • task-instance=
</code> <br>Required; An 

  • Required; An internal Universal Controller identifier

 
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
  • task-instance-id=
</code> <br> Required if <code>task

  • Required if task-instance-name=
</code> 
  •  is 
 
  •  not 
 
  •  specified; 
 
  •  sys_id 
 
  •  of 
 
  •  the 
 
  •  task 
 
  •  instance 
 
  •  to 
 
  •  run 
 
  •  the 
 
  •  command 
 
  •  on.

<li><code>task
  • task-instance-name=
</code> <br> Required if <code>task

  • Required if task-instance-id=
</code> 
  •  is 
 
  •  not 
 
  •  specified; 
 
  •  Name 
 
  •  of 
 
  •  the 
 
  •  task 
 
  •  instance 
 
  •  to 
 
  •  run 
 
  •  the 
 
  •  command 
 
  •  on. 
 
  •  (If 
 <code>instance
  • instance-criteria=
<code> 
  •  is 
 
  •  not 
 
  •  specified, 
 
  •  the 
 
  •  oldest 
 
  •  active 
 
  •  task 
 
  •  instance 
 
  •  with 
 
  •  the 
 
  •  matching 
 
  •  name 
 
  •  will 
 
  •  apply.)

<li><code>instance
  • instance-criteria=
</code> <br> 

  • Optional, 
 
  •  if 
 <code>task
  • task-instance-name=
</code> 
  •  is 
 
  •  specified; 
 
  •  One 
 
  •  of 
 
  •  the 
 
  •  following 
 
  •  (not 
 
  •  case-sensitive): 
 <b>oldest
  • oldest_active_
instance</b> 
  • instance (default), 
 <b>oldest_instance</b>, <b>newest
  •  oldest_instance, newest_active_
instance</b>, <b>newest_instance</b> 
<li><code>workflow
  • instance, newest_instance
  • workflow-instance-name=
</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
</ul>

  • For a task instance in a workflow, optional; Name of the workflow instance.
Example

<pre>uagcmd
uagcmd ops-manual-setcompleted 
-c config.cfg
 task-instance=8fda93dcd861e5e4005bf48e2cad6206
 </pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-set-time
ops-task-set-time
Set or Modify Wait Time for a Task Instance
     
Description
Sets or modifies the Wait time for a task instance that specifies how long it will wait to run after it has become eligible to run.
Syntax
uagcmd ops-task-set-timewait global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name=name] {wait-type=type [wait-day-constraint=constraint] {wait-time=wait time | wait-duration=duration | wait-seconds=duration in seconds} | delay-type=type {delay-duration=duration | delay-seconds=duration in seconds }}
Parameters
  • task-instance-id= 
    Required if task-instance-name= is not specified; sys_id of the task instance.
  • task-instance-name= 
    Required if task-instance-id= is not specified; Name of the time task instance. (If instance-criteria= is not specified, the oldest active task instance with the matching name will apply.)
  • instance-criteria= 
    Optional, if task-instance-name= is specified; One of the following (not case-sensitive): oldest_active_instance (default), oldest_instance, newest_active_instance, newest_instance.
  • workflow-instance-name= 
    For a task instance in a workflow, optional; Name of the workflow instance. (The most recently created workflow instance with the matching name will apply.)
  • wait-type= 
    Required if delay-type= is not specified; one of the following (not case sensitive): none, time, relative_time, duration, seconds.
  • wait-time= 
    Required if wait-type=time or relative_time; Wait time in format HH:MM. Variables are supported.
  • wait-day-constraint= 
    Optional if wait-type=time or relative_time; One of the following (not case sensitive): none, same day/same_day, next day/next_day, next business day/next_business_day, sunday, monday, tuesday, wednesday, thursday, friday, saturday.
  • wait-duration= 
    Required if wait-type=duration; Wait duration in format DD:HH:MM:SS.
  • wait-seconds= 
    Required if wait-type=seconds; Wait duration in format SS. Variables are supported.
  • delay-type= 
    Required if wait-type= is not specified; One of the following (not case sensitive): none, duration, seconds.
  • delay-duration= 
    Required if delay_type=duration; Specific delay duration in format DD:HH:MM:SS.
  • delay-seconds= 
    Required if delay_type=seconds; Specific delay duration in format SS. Variables are supported.
Example

<pre>uagcmd
uagcmd ops-task-set-timewait 
-c config.cfg
 task-instance-name=Task 5A workflow-instance-name=Workflow A wait-type=time wait-time=18:00
 </pre>
 Panel
 Html bobswift
 Html bobswift

 Anchor
ops-task-setpriority
ops-task-setpriority
Set Task Priority
<ul>
<li> <code>task</code> <br>Required; An 
 
     
Description
For Agent-based tasks (Linux/Unix, Universal, Windows, and z/OS), changes the priority on the specified task instance. 
 
See Changing the Priority of a Task Instance for a description of behavior and restrictions.
Syntax
uagcmd ops-task-setpriority global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name] priority=priority 
Parameters
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance</code> <br>   <code>task</code>         <b>oldestinstance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br>For a task instance in a workflow, optional; Name of the workflow instance.
<li><code>priority=</code> <br> Required; One of the following (not case sensitive): <b>high</b>, <b>medium</b>, <b>low</b>. 
</ul>
Example
 Panel Html bobswift<pre>uagcmd
Example

 task-instance=90079026d861e5e400bba81913a4fdd0 priority=
high</pre>
high
 Panel
uagcmd ops-task-setpriority 
-c config.cfg
 Html bobswift

 Anchor
ops-task-skip
ops-task-skip
Skip a Task
<ul>
<li> <code>task</code> <br>Required; An 
 
     
Description
Skips the specified task instance. 
 
See Skipping a Task Instance for a description of behavior and restrictions.
Syntax
uagcmd ops-task-skip global parameters {task-instance-id=ID | task-instance-name=name} [instance-criteria=criteria] [workflow-instance-name] 
Parameter
 Html bobswift
.
<li><code>task
 Warning
titleDeprecated
Replaced by task-instance-id= parameter; the command first will check for task-instance=; if it is not specified, the command will check for task-instance-id=.
 Html bobswift
</code> <br> Required if <code>task</code>             
<li><code>task</code> <br> Required if <code>task</code>               <code>instance</code>              
<li><code>instance</code> <br>   <code>task</code>         <b>oldestinstance</b>  <b>oldest_instance</b>, <b>newestinstance</b>, <b>newest_instance</b> 
<li><code>workflow</code> <br> For a task instance in a workflow, optional; Name of the workflow instance.
</ul>
Example

<pre>uagcmd
uagcmd ops-task-skip 
-c config.cfg
 task-instance=90079026d861e5e400bba81913a4fdd0 
</pre>
 Panel
 Html bobswift
 Html bobswift