Panel | ||||
---|---|---|---|---|
|
...
Universal Controller supports the following RESTful-based web services for Task Instance operations, which are listed alphabetically on this page.
- Cancel a Task Instance
- Clear All Dependencies
- Clear Exclusive Dependencies
- Clear Predecessor Dependencies
- Clear Time Dependency
- Clear Virtual Resource Dependencies
- Delete a Task Instance 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- Force/Finish a Task Instance
- Force/Finish Cancel a Task Instance
- Hold a Task Instance
- Issue Set Completed Command for a Manual Task Instance
- Issue Set Started Command for a Manual Task Instance
- List Task Instances 17498168
- 17498168
- 17498168
- 17498168
- List Task Instances - Advanced
- List Task Instance Variables (Show Variables)
- Release a Task Instance from Hold
- Rerun a Task Instance
- Retrieve Task Instance Output
- Set or Modify Wait Time/Duration for Task Instance
- Set Priority for a Task Instance
- Skip a Task Instance
- Skip a Task Instance Path
- Unskip a Task Instance
- Update a Task Instance Operational Memo 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
- 17498168
Formatting specifications for each web service, including details about parameter requirements, are provided.
For RESTful-based web services for Workflow Task Instance operations, see Workflow Task Instance Web Services.
Anchor |
---|
...
|
The following table describes all possible task instance statuses for all task types.
Note | ||
---|---|---|
| ||
A Web Service Task instance cannot be cancelled if the specified Protocol is SOAP. |
...
Description
...
URI
...
...
HTTP Method
...
POST
...
Description
...
Cancel a task instance.
...
Example URI
...
Authentication
...
HTTP Basic
...
Consumes Content-Type
...
application/xml, application/json
...
Produces Content-Type
...
application/xml, application/json
...
Example Request
...
See Cancel a Task Instance: XML and JSON Examples.
...
Request Properties
...
See Cancel a Task Instance: Request Properties.
...
Example Response
...
See Cancel a Task Instance: XML and JSON Examples.
...
Examples
...
XML
...
JSON
...
Example Request
...
title | XML |
---|
<task-instance> <id>1464817327170011848D633V6106ENQ7</id> </task-instance>
...
<task-instance> <name>Timer 60</name> <criteria>Newest Instance</criteria> <workflowInstanceName>test</workflowInstanceName> </task-instance>
...
title | JSON |
---|
{ "name": "Timer 60", "criteria": "Newest Instance", "workflowInstanceName": "test" }
...
Example Response
Expand | ||
---|---|---|
| ||
<command-response>
<type>cancel</type>
<success>true</success>
<info>Command Cancel executed successfully against task instance "test".</info>
<errors />
</command-response> |
Expand | ||
---|---|---|
| ||
{
"type": "cancel",
"success": true,
"info": "Command Cancel executed successfully against task instance \"Timer 60\".",
"errors": ""
} |
...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
n/a
...
Specific task instance with this task instance name
that you want to cancel.
Valid values:
- As String = Oldest Active Instance, As Value = 1
- As String = Newest Active Instance, As Value = 2
- As String = Oldest Instance, As Value = 3
- As String = Newest Instance, As Value = 4
Default is Oldest Active Instance (1).
Note | ||
---|---|---|
| ||
Values with an underscore characters ( _ ) instead of spaces also are supported (for example, oldest_active_instance). |
...
N
...
n/a
...
sys_id used within the Controller to identify this task instance.
...
Y
(unless name
is specified)
...
name
...
Instance Name
...
Name of the task instance.
...
Y
(unless id
is specified)
...
id
...
Workflow
...
Name of the parent Workflow of the task instance.
...
You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details.
...
N
...
Description
...
URI
...
HTTP Method
...
POST
...
Description
...
Clears all dependencies of a task instance.
...
Example URI
...
Authentication
...
HTTP Basic
...
Consumes Content-Type
...
application/xml, application/json
...
Produces Content-Type
...
application/xml, application/json
...
Example Request
...
See Clear All Dependencies: XML and JSON Examples.
...
Request Properties
...
See Clear All Dependencies: Request Properties.
...
Example Response
...
See Clear All Dependencies: XML and JSON Examples.
...
Examples
...
XML
...
JSON
...
Example Request
...
title | XML |
---|
<task-instance> <id>1464817327170011848D633V6106ENQ7</id> </task-instance>
...
<task-instance> <name>Timer 60</name> <criteria>Newest Instance</criteria> <workflowInstanceName>test</workflowInstanceName> </task-instance>
...
title | JSON |
---|
{ "name": "Timer 60", "criteria": "Newest Instance", "workflowInstanceName": "Test" }
...
Example Response
...
title | XML |
---|
...
The format of multi-word task status names specified in the Task Instance Status Web Service differs from the format of task status names used in the Controller user interface. In Task Instance Status, the words are separated by an underscore character; in the user interface, they are separated by a space. |
Status Name | Status Code | Task Type | Description | ||||||
---|---|---|---|---|---|---|---|---|---|
Action_Required | 60 | Manual | When a manual task launches, it goes into Action Required status, meaning a user must perform some manual activity. For details, see Manual task. | ||||||
Cancel_Pending | 99 | A process running on the Agent needs to be terminated. When the Cancel command is issued, the task instance will go into a Cancel Pending status until the Agent reports back that the process has been cancelled. At that point, the task instance will transition into the Cancelled status. | |||||||
Cancelled | 130 | All | The task was cancelled by a user. | ||||||
Confirmation_Required | 125 | z/OS | If you make JCL changes and restart a z/OS task, Universal Controller will put the task into Confirmation Required status and prompt you for a confirmation. For detailed processing steps, see Rerunning a z/OS Task. | ||||||
| 0 | All | The new task instance has been created (the task has been launched). | ||||||
Exclusive_Requested | 22 | All | All tasks with a mutually exclusive task defined go immediately to a status of Exclusive Requested. If the task is available to run exclusively, the task then moves to the next appropriate processing status. | ||||||
Exclusive_Wait | 23 | All | The task is mutually exclusive with one or more other tasks, and it is waiting for those tasks to finish before it will run. | ||||||
Execution_Wait | 33 | The task must wait to be completed; either the Agent/Agent Cluster running the task has reached its Task Execution Limit, or the ability of the Agent/Agent Cluster to run tasks has been suspended. | |||||||
Failed | 140 | All* | The task ran to a failure status. | ||||||
| 190 | All | The task was forced by the user to finish. The user may do this in cases where the task had a Cancelled or Failed status, and the user needed to release other task instances depending on the successful completion of this task instance in a workflow. For more information, see Force Finishing a Task. | ||||||
| 20 | All | The task has been put on hold by a user. | ||||||
In_Doubt | 110 | The Agent is "in doubt" about the current status of the task instance. This may occur if an Agent or Agent connection goes down. In this case, the Agent restarts and reviews its data about tasks in progress. If the Agent finds a task still running, it resumes normal monitoring. If the Agent cannot find the task, this usually indicates that the task completed, but the Agent considers the task status to be "in doubt." | |||||||
Queued | 40 | The task has been queued on a resource. | |||||||
Resource_Requested | 25 | All | All tasks with a virtual resource defined go immediately to a status of Resource Requested. If the resource is available, the task then moves to the next appropriate processing status. | ||||||
Resource_Wait | 30 | All | All tasks with a virtual resource defined go immediately to a status of Resource Requested. If the resource is not available, the task goes to a status of Resource Wait. When the resource becomes available, the task moves to the next appropriate processing status | ||||||
| 80 | All | The task is running. For Agent-based tasks, the Agent has started running the program. | ||||||
| 81 | Workflow | One or more tasks within the workflow has one of the following statuses:
| ||||||
Skipped | 180 | All | The task was skipped by a user. | ||||||
| 120 | All | The task was unable to start. | ||||||
| 70 | Agent-based, Manual | The task has started. For Agent-based tasks, this means the Agent has received the task. | ||||||
Submitted | 43 | z/OS | The task has been submitted to the z/OS Job Entry subsystem and scheduled by the z/OS Job Scheduler. | ||||||
| 200 | All | The task has completed successfully. Workflows will transition to Success status when all of its tasks have transitioned to Success, Finished, or Skipped status. | ||||||
| 15 | All (except Timer) | The task is waiting to start based on a Wait To Start and/or Delay On Start specification. | ||||||
Undeliverable | 35 | The Agent is unavailable. | |||||||
Waiting | 10 | All | The task has been loaded by a workflow and is waiting on a predecessor. |
* Workflows cannot go to Failed status.
Anchor | ||||
---|---|---|---|---|
|
Note | ||
---|---|---|
| ||
A Web Service Task instance cannot be cancelled if the specified Protocol is SOAP. |
Description | |
---|---|
URI | |
HTTP Method | POST |
Description | Cancel a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/cancel |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor |
---|
...
|
...
|
...
Cancel a Task Instance: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
All Dependencies
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/clearexclusivecleardependencies |
HTTP Method | POST |
Description | Clears all exclusive dependencies of a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearexclusivecleardependencies |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Clear Exclusive All Dependencies: XML and JSON Examples. |
Request Properties | See Clear Exclusive All Dependencies: Request Properties. |
Example Response | See Clear Exclusive All Dependencies: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
All Dependencies: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
All Dependencies: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Exclusive Dependencies
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/clearpredecessorsclearexclusive |
HTTP Method | POST |
Description | Clears all predecessor exclusive dependencies of a task instance in a Workflow. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearpredecessorsclearexclusive |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Clear Predecessor Exclusive Dependencies: XML and JSON Examples. |
Request Properties | See Clear Predecessor Exclusive Dependencies: Request Properties. |
Example Response | See Clear Predecessor Exclusive Dependencies: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Exclusive Dependencies: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
Exclusive Dependencies: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | |||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| |||||||||||||
name | Instance Name | Name of the task instance. | Y |
| |||||||||||||
predecessorName workflowInstanceName | n/aWorkflow | Name of the parent Workflow of the predecessor task instance for which you want to clear dependency.* = Clears dependencies from all predecessor task instances. | Y | ||||||||||||||
Anchor | workflowInstanceName - CPD | workflowInstanceName - CPD | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Predecessor Dependencies
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/cleartimewaitclearpredecessors |
HTTP Method | POST |
Description | Clears the time dependency all predecessor dependencies of a task instance in a Workflow. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/cleartimewaitclearpredecessors |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Clear Time DependencyPredecessor Dependencies: XML and JSON Examples. |
Request Properties | See Clear Time Dependency Predecessor Dependencies: Request Properties. |
Example Response | See Clear Time DependencyPredecessor Dependencies: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Predecessor Dependencies: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
Predecessor Dependencies: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
predecessorName | n/a | Name of the predecessor task instance for which you want to clear dependency. | * = Clears dependencies from all predecessor task instances. | Y | ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Time Dependency
Description | ||
---|---|---|
URI | http://host_name/uc/resources/taskinstance/clearresourcescleartimewait | |
HTTP Method | POST | |
Description | Clears virtual resource dependencies the time dependency of a task instance. | |
Authentication | HTTP Basic | |
Example URI | http://localhost:8080/uc/resources/taskinstance/ | clearresourcescleartimewait |
Consumes Content-Type | application/xml, application/json | |
Produces Content-Type | application/xml, application/json | |
Example Request | See Clear Virtual Resource DependenciesTime Dependency: XML and JSON Examples. | |
Request Properties | See Clear Virtual Resource DependenciesTime Dependency : Request Properties. | |
Example Response | See Clear Virtual Resource DependenciesTime Dependency: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Time Dependency: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
Time Dependency: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||||||
resourceName | n/a | Name of the virtual resource for which you want to clear dependency. | * = Clears dependencies from all virtual resources. | Y |
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor |
---|
...
|
Description | ||
---|---|---|
URI | http://host_name/uc/resources/taskinstance/clearresources | |
HTTP Method | DELETEPOST | |
Description | Deletes the specified Clears virtual resource dependencies of a task instance. For Workflow task instances, if the | |
Authentication | HTTP Basic | |
Example URI | http://localhost:8080/uc/resources/taskinstance/clearresources | |
Consumes Content-Type | application/xml, application/json | |
Example URI | http://localhost:8080/uc/resources/taskinstance Produces Content-Type | application/xml, application/json |
Example Request | See Delete a Task Instance Clear Virtual Resource Dependencies: XML and JSON Examples. | |
Request Properties | See Delete a Task Instance Clear Virtual Resource Dependencies: Request Properties. | |
Example Response Status 200 /OKTask instance(s) deleted successfully | See Clear Virtual Resource Dependencies: XML and JSON Examples. |
Anchor |
---|
...
|
...
|
...
Clear Virtual Resource Dependencies: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
|
...
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anchor | | criteria - DTI | criteria - DTI |
|
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (31).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
recursive resourceName | n/a | For Workflow task instances only; Specification for whether or not to delete all children task instances Name of the virtual resource for which you want to clear dependency. | * = Clears dependencies from all virtual resources. | Y | ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | Boolean; Valid values: true/false. Default is falseYou can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor |
---|
...
|
...
|
...
Delete a Task Instance
Description | ||
---|---|---|
URI | http://host_name/uc/resources/taskinstance/forcefinish | |
HTTP Method | POSTDELETE | |
Description | Force Finish a Deletes the specified task instance. (To Force Finish (Halt) a task instance, set the halt property to true.) | |
Example URI | http://localhost:8080/uc/resources/taskinstance/forcefinish | |
Authentication | HTTP Basic | |
Consumes ContentFor Workflow task instances, if the | ||
Authentication | HTTP Basic | |
Consumes Content-Type | application/xml, application/json | Produces Content-Type |
application/xml, application/jsonExample URI | http://localhost:8080/uc/resources/taskinstance | |
Example Request | See Force Finish Delete a Task Instance: XML and JSON Examples. | |
Request Properties | See Force Finish Delete a Task Instance: Request Properties. | |
Example ResponseSee Force Finish a Task Instance: XML and JSON Examples |
|
Anchor |
---|
...
|
...
|
...
Delete a Task Instance: XML and JSON
...
Examples
XML | JSON | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| Example Response |
Expand | ||
---|---|---|
| ||
<command-response>
<type>force_finish</type>
<success>true</success>
<info>Command Force Finish executed successfully against task instance "test".</info>
<errors />
</command-response> |
Expand | ||
---|---|---|
| ||
{
"type": "force_finish",
"success": true,
"info": "Command Force Finish executed successfully against task instance \"Task 1\".",
"errors": ""
} |
...
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (13).
| N | ||||||||||||||||
halt | Prevents successor task instances of the specified task instance in a Workflow from being run. | Boolean. Valid values: true/false. Default is false. | N |
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||||||
workflowInstanceName recursive | Workflow | Name of the parent Workflow n/a | For Workflow task instances only; Specification for whether or not to delete all children task instances of the task instance.You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance | DetailsBoolean; Valid values: true/false. Default is false. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
a Task Instance
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/forcefinishcancelforcefinish |
HTTP Method | POST |
Description | Force Finish /Cancel a task instance. (To Force Finish /Cancel (Halt) a task instance, set the halt property to true.) |
Example URI | http://localhost:8080/uc/resources/taskinstance/forcefinishcancelforcefinish |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Force Finish Cancel a Task Instance: XML and JSON Examples. |
Request Properties | See Force Finish /Cancel a Task Instance: Request Properties. |
Example Response | See Force Finish Cancel a Task Instance: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
a Task Instance: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
a Task Instance: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
halt | n/a | Prevents successor task instances of the specified task instance in a Workflow from being run. | Boolean. Valid values: true/false. Default is false. | N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor |
---|
...
|
...
|
...
Force Finish/Cancel a Task Instance
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/holdforcefinishcancel |
HTTP Method | POST |
Description | Hold Force Finish/Cancel a task instance. (To Force Finish/Cancel (Halt) a task instance, set the halt property to true.) |
Example URI | http://localhost:8080/uc/resources/taskinstance/holdforcefinishcancel |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Hold Force Finish Cancel a Task Instance: XML and JSON Examples. |
Request Properties | See Hold Force Finish/Cancel a Task Instance: Request Properties. |
Example Response | See Hold Force Finish Cancel a Task Instance: XML and JSON Examples. |
Anchor |
---|
...
|
...
|
...
Force Finish/Cancel a Task Instance: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
Anchor |
---|
...
|
...
|
...
Force Finish/Cancel a Task Instance: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
halt | n/a | Prevents successor task instances of the specified task instance in a Workflow from being run. | Boolean. Valid values: true/false. Default is false. | N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor |
---|
...
|
...
|
...
|
...
|
...
Hold a
...
Task Instance
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setcompletedhold |
HTTP Method | POST |
Description | Issues a Set Completed command for a Manual Task Hold a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/setcompletedhold |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Issue Set Completed Command for Hold a Manual Task Instance: XML and JSON Examples. |
Request Properties | See Issue Set Completed Command for Hold a Manual Task Instance: Request Properties. |
Example Response | See Issue Set Completed Command for Hold a Manual Task Instance: XML and JSON Examples. |
Anchor |
---|
...
|
...
|
...
|
...
|
...
Hold a
...
Task Instance: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
Anchor |
---|
...
|
...
|
...
|
...
|
...
Hold a
...
Task Instance: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Completed Command for a Manual Task Instance
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setstartedsetcompleted |
HTTP Method | POST |
Description | Issues a Set Started Completed command for a Manual Task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/setstartedsetcompleted |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Issue Set Started Completed Command for a Manual Task Instance: XML and JSON Examples. |
Request Properties | See Issue Set Started Completed Command for a Manual Task Instance: Request Properties. |
Example Response | See Issue Set Started Completed Command for a Manual Task Instance: XML and JSON Examples. |
Anchor | ||
---|---|---|
|
...
|
...
|
...
Completed Command for a Manual Task Instance: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
Anchor | ||
---|---|---|
|
...
|
...
|
...
Completed Command for a Manual Task Instance: Request Properties
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor |
---|
...
|
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/listsetstarted |
HTTP Method | POST |
Description | Retrieves information on task instances matching specific search criteria. |
Authentication | HTTP Basic |
Issues a Set Started command for a Manual Task instance. | |
Example URI | http://localhost:8080/uc/resources/taskinstance/listsetstarted |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See List Task InstancesIssue Set Started Command for a Manual Task Instance: XML and JSON Request Examples. |
Request Properties | See List Task InstancesIssue Set Started Command for a Manual Task Instance: Request Properties. |
Example Response | See List Task InstancesIssue Set Started Command for a Manual Task Instance: XML and JSON Response Examples. |
Anchor |
---|
...
|
...
|
...
Issue Set Started Command for a Manual Task Instance: XML and JSON Examples
Examples | XML | JSON | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Anchor | List Task Instances Example Request | List Task Instances Example Request|||||||||||||||||||
Example Request |
Task instance with multiple query criteria.
| |||||||||||||||||||
Example Response |
<task-instance-query-filter> <sysId>1448396297341015141TB2QF51JBYM8V</sysId> </task-instance-query-filter> <task-instance-query-filter> <name>*</name> <status>110</status> <type>windows</type> <agentName>test agent</agentName> <lateStart>true</lateStart> <lateFinish>true</lateFinish> <earlyFinish>false</earlyFinish> </task-instance-query-filter> <task-instance-query-filter> <name>*</name> <late>true</late> </task-instance-query-filter> <task-instance-query-filter> <name>*</name> <lateEarly>true</lateEarly> </task-instance-query-filter> <task-instance-query-filter> <name>*</name> <late>false</late> </task-instance-query-filter> <task-instance-query-filter> <name>*</name> <lateEarly>false</lateEarly> </task-instance-query-filter>Task instance with the specified template name.
Task instance with updated time type: between.
|
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
criteria | n/a | Specific task instance with this task instance | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
id | n/a | sys_id used within the Controller to identify this task instance. | Y |
| ||||||||||||
name | Instance Name | Name of the task instance. | Y |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent Workflow of the task instance. | You can select to display the Workflow field on the Activity Monitor and/or Task Instances List; it is not displayed in the Task Instance Details. | N |
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/list |
HTTP Method | POST |
Description | Retrieves information on task instances matching specific search criteria. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/list |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Anchor | | List Task Instances Example Response | List Task Instances Example Response | Example Response
|
Expand | |||||
---|---|---|---|---|---|
| |||||
Panel |
Html bobswift |
---|
<pre>
<taskInstance>
<agent />
<credentials />
<customField1 label="Custom 1">My Custom Field #1</customField1>
<customField2 label="Custom 2">My Other Custom Field #2</customField2>
<earlyFinish>false</earlyFinish>
<endTime></endTime>
<executionUser>ops.admin</executionUser>
<exitCode>0</exitCode>
<finishedEarly>false</finishedEarly>
<finishedLate>false</finishedLate>
<instanceNumber>6</instanceNumber>
<lateFinish>false</lateFinish>
<lateStart>false</lateStart>
<launchTime>2019-06-27 11:18:41 -0400</launchTime>
<name>B-06884 - Timer - END - 15616456627821537077YBESF7H0KELV</name>
<queuedTime></queuedTime>
<startTime>2019-06-27 11:18:41 -0400</startTime>
<startedLate>false</startedLate>
<status>RUNNING</status>
<statusDescription />
<sysId>15616456627821537077YBESF7H0KELV</sysId>
<taskId>05564cd1f6c4484997cfb66782feb0d0</taskId>
<taskName>B-06884 - Timer - END - ${B_08477_WKFLW_ID}</taskName>
<templateId />
<templateName />
<triggerId />
<triggerName />
<triggerTime>2019-06-27 11:18:41 -0400</triggerTime>
<triggeredBy>Workflow: B-06884 - Main ${ops_task_ref_count}</triggeredBy>
<type>Timer</type>
<updatedTime>2019-06-27 11:18:41 -0400</updatedTime>
<workflowDefinitionId>36551ed5663042c2b79975ad6a23915e</workflowDefinitionId>
<workflowDefinitionName>B-06884 - Main ${ops_task_ref_count}</workflowDefinitionName>
<workflowInstanceId>15616456627821077078N9HWVH7SLHVT</workflowInstanceId>
<workflowInstanceName>B-06884 - Main 3</workflowInstanceName>
<businessServices>
<businessService>Accounting</businessService>
<businessService>QA Department</businessService>
</businessServices>
</taskInstance>
</taskInstance>
</pre> |
title | JSON |
---|
JSON |
Task instance with multiple query criteria.
{ "name": "*", "status": "!45", "instanceNumber": 2, "businessServices": "Rgr A", "customField2": "*Custom*" }
All task instances in the last three minutes.
{ "name": "*", "type": "Timer", "updatedTimeType": "offset", "updatedTime": "-3mn" }
Task instance with the specified id.
{ "sysId": "1513644026115413351LS9ACLESSKLXZ" }
Task instance with multiple query criteria.
{ "name": "*", "status": "200", "type": "windows", "agentName": "Mark-4 - AGNT0002", "lateStart": true, "lateFinish": false, "earlyFinish": false }
All task instances that either started late or finished late.
{ "name": "*", "late": true }
All task instances that either started late, finished late, or finished early.
{ "name": "*", "lateEarly": true }
All task instances that neither started late nor finished late.
{ "name": "*", "value
late": false"My
Custom}Field
#1"
},
All task instances that neither started late, finished late, nor finished early.
{"customField2": {
"
labelname": "Custom 2
*", "value
lateEarly":"My
falseOther
Custom}Field
#2"
},
"earlyFinishTask instance with the specified template name.
false
{
"name": "
*",
endTime
"
templateName":"2019-06-27 11:20:11 -0400", "executionUser": "ops.admin", "exitCode": "0", "finishedEarly": "false", "finishedLate": "false", "instanceNumber": 6, "lateFinish": "false", "lateStart": "false", "launchTime": "2019-06-27 11:18:41 -0400", "name": "B-06884 - Timer - END - 15616456627821537077YBESF7H0KELV", "queuedTime": "", "startTime": "2019-06-27 11:18:41 -0400", "startedLate": "false", "status": "SUCCESS", "statusDescription": null, "sysId": "15616456627821537077YBESF7H0KELV", "taskId": "05564cd1f6c4484997cfb66782feb0d0", "taskName": "B-06884 - Timer - END - ${B_08477_WKFLW_ID}", "templateId": null, "templateName": null, "triggerId": null, "triggerName": null, "triggerTime": "
Demo_Ext_1
}
Task instance with updated time type: between.
{
"name": "*",
"type": "Timer",
"updatedTimeType": "between",
"updatedTime": "2022-08-08 10:56:00 -0400,2022-08-10 10:56:00 -0400"
}
Anchor | ||||
---|---|---|---|---|
|
Expand | ||||
---|---|---|---|---|
| ||||
|
...
Property
...
UI Field Name
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
Agent
...
Name of the agent that this task instances is assigned to run on.
...
N
...
Member of Business Services
...
Business Services that this task instance belongs to.
...
Comma-separated list.
...
N
...
Custom 1 (default, which you can change in the User Defined Task Field Label 1 Universal Controller system property.)
...
User-defined task field 1.
...
Wildcards are supported.
...
N
...
Custom 2 (default, which you can change in the User Defined Task Field Label 2 Universal Controller system property.)
...
User-defined task field 2.
...
Wildcards are supported.
...
N
...
Execution User
...
Execution User of a task instance that determines the security context under which the task instance runs.
...
System-supplied.
...
N
...
Instance Number
...
Sequentially assigned number, maintained per task, representing the creation order of the instance.
...
Integer value.
...
N
...
Started Late / Finished Late
...
Indication of whether or not to list all task instances that started late or finished late.
...
Valid values: true/false.
...
N
...
Started Late / Finished Late / Finished Early
...
Indication of whether or not to list all task instances that started late, finished late, or finished early.
...
Valid values: true/false.
...
N
...
Instance name
...
Name or partial name of one or more task instances.
...
Wildcards are supported.
...
Y
(unless sysId
is specified)
...
sysId
...
Status
...
List of comma-separated task instance status codes and/or names (not case sensitive).
...
Specifying one or more statuses automatically excludes task instances in all other statuses.
To list task instances for all statuses, enter <status></status>
in the request.
To list task instances for all statuses except one or more specific statuses, enter the status code or name for each status to be excluded with a preceding exclamation mark ( ! ). For example, !200.
...
N
...
Status Description
...
Description (if any) of the current status of the Task Instance.
...
Wildcards are supported.
...
N
...
n/a
...
sys_id used within the Controller to identify a task instance.
...
Y
(unless name
is specified)
...
name
...
n/a
...
sys_id of the task definition that this Task Instance was created from.
...
N
...
taskName
...
n/a
...
Name of the task definition that this Task Instance was created from.
...
N
...
taskId
...
n/a
...
sys_id of the Trigger that launched the Task Instance (if it was invoked from a Trigger).
...
N
...
triggerName
...
n/a
...
Name of the Trigger that launched the Task Instance (if it was invoked from a Trigger.)
...
N
...
triggerId
...
n/a
...
Task type of this task instance.
...
Valid values: 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, sql, stored_procedure, system_monitor, task_monitor, timer, universal, unix, variable_monitor, web_service, windows, workflow, zos.
To list task instances for all task types, enter <type></type>
in the request.
...
N
...
n/a
...
If updatedTimeType
= Offset; -offset period.
Valid values:
- mn (minutes)
- h (hours)
- d (days)
Default is d.
Examples: -5d (last 5 days), -30mn (last 30 minutes), -6h (last 6 hours), -7 (last 7 days).
If updatedTimeType
is Since; date/time value
( yyyy-MM-dd [HH:mm:ss] )
If updatedTimeType
is Between; date/time values (start date/time inclusive, end date/time exclusive)
( yyyy-MM-dd [HH:mm:ss], yyyy-MM-dd [HH:mm:ss])
Note | ||
---|---|---|
| ||
The time is relative to the Time Zone specified for the User. |
...
Y
(if updatedTimeType
is Offset
, Since
,
or Older Than
.)
...
n/a
...
Type of updateTime
.
...
Valid values:
- As String = Today, As Value = 1
- As String = Offset, As Value = 2
- As String = Since, As Value = 3
- As String = Older Than, As Value = 4
- As String = Between, As Value = 5
...
N
...
n/a
...
sys_id of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow).
...
N
...
workflowDefinitionName
...
n/a
...
Name of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow).
...
N
...
workflowDefinitionId
...
n/a
...
Specification for how workflowInstanceName
finds the matching workflow.
Valid values:
- As String = Oldest Active Instance, As Value = 1
- As String = Newest Active Instance, As Value = 2
- As String = Oldest Instance, As Value = 3
- As String = Newest Instance, As Value = 4
Default is Oldest Active Instance (1).
Note | ||
---|---|---|
| ||
Values with an underscore characters ( _ ) instead of spaces also are supported (for example, oldest_active_instance). |
...
N
...
n/a
...
sys_id of the parent workflow task instance. Only task instances within this workflow task instance will be listed.
...
N
...
workflowInstanceName
...
Workflow
...
Name of the parent workflow task instance. Only task instances within this workflow task instance will be listed.
...
N
...
workflowInstanceId
...
The following table describes all possible task instance statuses for all task types.
Note | ||
---|---|---|
| ||
The format of multi-word task status names specified in the Task Instance Status Web Service differs from the format of task status names used in the Controller user interface. In Task Instance Status, the words are separated by an underscore character; in the user interface, they are separated by a space. |
...
Status Name
...
Status Code
...
Task Type
...
Description
...
Action_Required
...
60
...
Manual
...
When a manual task launches, it goes into Action Required status, meaning a user must perform some manual activity. For details, see Manual task.
...
Cancel_Pending
...
99
...
...
A process running on the Agent needs to be terminated. When the Cancel command is issued, the task instance will go into a Cancel Pending status until the Agent reports back that the process has been cancelled. At that point, the task instance will transition into the Cancelled status.
...
Cancelled
...
130
...
All
...
The task was cancelled by a user.
...
Confirmation_Required
...
125
...
z/OS
...
If you make JCL changes and restart a z/OS task, Universal Controller will put the task into Confirmation Required status and prompt you for a confirmation. For detailed processing steps, see Rerunning a z/OS Task.
...
0
...
All
...
The new task instance has been created (the task has been launched).
...
Exclusive_Requested
...
22
...
All
...
All tasks with a mutually exclusive task defined go immediately to a status of Exclusive Requested. If the task is available to run exclusively, the task then moves to the next appropriate processing status.
...
Exclusive_Wait
...
23
...
All
...
The task is mutually exclusive with one or more other tasks, and it is waiting for those tasks to finish before it will run.
...
Execution_Wait
...
33
...
...
The task must wait to be completed; either the Agent/Agent Cluster running the task has reached its Task Execution Limit, or the ability of the Agent/Agent Cluster to run tasks has been suspended.
...
Failed
...
140
...
All*
...
The task ran to a failure status.
...
190
...
All
...
The task was forced by the user to finish. The user may do this in cases where the task had a Cancelled or Failed status, and the user needed to release other task instances depending on the successful completion of this task instance in a workflow. For more information, see Force Finishing a Task.
...
20
...
All
...
The task has been put on hold by a user.
...
In_Doubt
...
110
...
...
The Agent is "in doubt" about the current status of the task instance. This may occur if an Agent or Agent connection goes down. In this case, the Agent restarts and reviews its data about tasks in progress. If the Agent finds a task still running, it resumes normal monitoring. If the Agent cannot find the task, this usually indicates that the task completed, but the Agent considers the task status to be "in doubt."
...
Queued
...
40
...
...
The task has been queued on a resource.
...
Resource_Requested
...
25
...
All
...
All tasks with a virtual resource defined go immediately to a status of Resource Requested. If the resource is available, the task then moves to the next appropriate processing status.
...
Resource_Wait
...
30
...
All
...
All tasks with a virtual resource defined go immediately to a status of Resource Requested. If the resource is not available, the task goes to a status of Resource Wait. When the resource becomes available, the task moves to the next appropriate processing status
...
80
...
All
...
The task is running. For Agent-based tasks, the Agent has started running the program.
...
81
...
Workflow
...
One or more tasks within the workflow has one of the following statuses:
- Cancelled
- Confirmation Required
- Failure
- In Doubt
- Running/Problems (for sub-workflows)
- Start Failure
- Undeliverable
...
Skipped
...
180
...
All
...
The task was skipped by a user.
...
120
...
All
...
The task was unable to start.
...
70
...
Agent-based, Manual
...
The task has started. For Agent-based tasks, this means the Agent has received the task.
...
Submitted
...
43
...
z/OS
...
The task has been submitted to the z/OS Job Entry subsystem and scheduled by the z/OS Job Scheduler.
...
200
...
All
...
The task has completed successfully. Workflows will transition to Success status when all of its tasks have transitioned to Success, Finished, or Skipped status.
...
15
...
All (except Timer)
...
The task is waiting to start based on a Wait To Start and/or Delay On Start specification.
...
Undeliverable
...
35
...
...
The Agent is unavailable.
...
Waiting
...
10
...
All
...
The task has been loaded by a workflow and is waiting on a predecessor.
...
|
|
Anchor | ||||
---|---|---|---|---|
|
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
agentName | Agent | Name of the agent that this task instances is assigned to run on. | N | |||||||||||||
businessServices | Member of Business Services | Business Services that this task instance belongs to. | Comma-separated list. | N | ||||||||||||
customField1 | Custom 1 (default, which you can change in the User Defined Task Field Label 1 Universal Controller system property.) | User-defined task field 1. | Wildcards are supported. | N | ||||||||||||
customField2 | Custom 2 (default, which you can change in the User Defined Task Field Label 2 Universal Controller system property.) | User-defined task field 2. | Wildcards are supported. | N | ||||||||||||
executionUser | Execution User | Execution User of a task instance that determines the security context under which the task instance runs. | System-supplied. | N | ||||||||||||
instanceNumber | Instance Number | Sequentially assigned number, maintained per task, representing the creation order of the instance. | Integer value. | N | ||||||||||||
late | Started Late / Finished Late | Indication of whether or not to list all task instances that started late or finished late. | Valid values: true/false. | N | ||||||||||||
lateEarly | Started Late / Finished Late / Finished Early | Indication of whether or not to list all task instances that started late, finished late, or finished early. | Valid values: true/false. | N | ||||||||||||
name | Instance name | Name or partial name of one or more task instances. | Wildcards are supported. | Y |
| |||||||||||
status | Status | List of comma-separated task instance status codes and/or names (not case sensitive). | Specifying one or more statuses automatically excludes task instances in all other statuses. | N | ||||||||||||
statusDescription | Status Description | Description (if any) of the current status of the Task Instance. | Wildcards are supported. | N | ||||||||||||
sysId | n/a | sys_id used within the Controller to identify a task instance. | Y |
| ||||||||||||
taskId | n/a | sys_id of the task definition that this Task Instance was created from. | N |
| ||||||||||||
taskName | n/a | Name of the task definition that this Task Instance was created from. | N |
| ||||||||||||
templateId | n/a | ID used within the controller to identify a template. | If a templateId or templateName is specified, List task returns a list of tasks associated with the Universal template. | N | templateName | |||||||||||
templateName | Template Name | Name of a template. | If a templateId or templateName is specified, List task returns a list of tasks associated with the Universal template. | N | templateId | |||||||||||
triggerId | n/a | sys_id of the Trigger that launched the Task Instance (if it was invoked from a Trigger). | N |
| ||||||||||||
triggerName | n/a | Name of the Trigger that launched the Task Instance (if it was invoked from a Trigger.) | N |
| ||||||||||||
type | n/a | Task type of this task instance. | Valid values: 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, sql, stored_procedure, system_monitor, task_monitor, timer, universal, unix, variable_monitor, web_service, windows, workflow, zos. | N | ||||||||||||
updatedTime | n/a | If | Valid values:
Default is d. If
| Y | ||||||||||||
updatedTimeType | n/a | Type of | Valid values:
| N | ||||||||||||
workflowDefinitionId | n/a | sys_id of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow). | N |
| ||||||||||||
workflowDefinitionName | n/a | Name of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow). | N |
| ||||||||||||
workflowInstanceCriteria | n/a | Specification for how | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
workflowInstanceId | n/a | sys_id of the parent workflow task instance. Only task instances within this workflow task instance will be listed. | N |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent workflow task instance. Only task instances within this workflow task instance will be listed. | N |
|
Anchor | ||||
---|---|---|---|---|
|
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/listadv http://host_name/uc/resources/taskinstance/listAdv |
HTTP Method | POST |
Description | List Task instance output details |
Example URI | |
Authentication | HTTP Basic |
Produces Content-Type | |
Consumes Content-Type | Application/XML & Application/JSON |
Example Request | See List Task Instances - Advanced: XML and JSON Request Examples. |
Example Response | See List Task Instances - Advanced: XML and JSON Response Examples. |
Request Properties |
Anchor | ||||
---|---|---|---|---|
|
...
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
agentName | Agent | Name of the agent that this task instances is assigned to run on. | N | |||||||||||||
businessServices | Member of Business Services | Business Services that this task instance belongs to. | Comma-separated list. | N | ||||||||||||
customField1 | Custom 1 (default, which you can change in the User Defined Task Field Label 1 Universal Controller system property.) | User-defined task field 1. | Wildcardsare supported. | N | ||||||||||||
customField2 | Custom 2 (default, which you can change in the User Defined Task Field Label 2 Universal Controller system property.) | User-defined task field 2. | Wildcards are supported. | N | ||||||||||||
executionUser | Execution User | Execution User of a task instance that determines the security context under which the task instance runs. | System-supplied. | N | ||||||||||||
instanceNumber | Instance Number | Sequentially assigned number, maintained per task, representing the creation order of the instance. | Integer value. | N | ||||||||||||
| Output Type | Type of task instance output to retrieve. | String; Valid values:
| N | ||||||||||||
late | Started Late / Finished Late | Indication of whether or not to list all task instances that started late or finished late. | Valid values: true/false. | N | ||||||||||||
lateEarly | Started Late / Finished Late / Finished Early | Indication of whether or not to list all task instances that started late, finished late, or finished early. | Valid values: true/false. | N | ||||||||||||
name | Instance name | Name or partial name of one or more task instances. | Wildcards are supported. | Y |
| |||||||||||
| N/A | Allowed Response fields | Comma separated list of any of the following fields can be viewed.
| N | ||||||||||||
status | Status | List of comma-separated task instance status codes and/or names (not case sensitive). | Specifying one or more statuses automatically excludes task instances in all other statuses. | N | ||||||||||||
statusDescription | Status Description | Description (if any) of the current status of the Task Instance. | Wildcards are supported. | N | ||||||||||||
sysId | n/a | sys_id used within the Controller to identify a task instance. | Y |
| ||||||||||||
taskId | n/a | sys_id of the task definition that this Task Instance was created from. | N |
| ||||||||||||
taskName | n/a | Name of the task definition that this Task Instance was created from. | N |
| ||||||||||||
templateId | n/a | ID used within the controller to identify a template. | If a templateId or templateName is specified, List task returns a list of tasks associated with the Universal template. | N | templateName | |||||||||||
templateName | Template Name | Name of a template. | If a templateId or templateName is specified, List task returns a list of tasks associated with the Universal template. | N | templateId | |||||||||||
triggerId | n/a | sys_id of the Trigger that launched the Task Instance (if it was invoked from a Trigger). | N |
| ||||||||||||
triggerName | n/a | Name of the Trigger that launched the Task Instance (if it was invoked from a Trigger.) | N |
| ||||||||||||
type | n/a | Task type of this task instance. | Valid values: 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, sql, stored_procedure, system_monitor, task_monitor, timer, universal, unix, variable_monitor, web_service, windows, workflow, zos. | N | ||||||||||||
updatedTime | n/a | If | Valid values:
Default is d. updatedTimeType is Between; date/time values (start date/time inclusive, end date/time exclusive)( yyyy-MM-dd [HH:mm:ss], yyyy-MM-dd [HH:mm:ss])
| Y | ||||||||||||
updatedTimeType | n/a | Type of | Valid values:
| N | ||||||||||||
workflowDefinitionId | n/a | sys_id of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow). | N |
| ||||||||||||
workflowDefinitionName | n/a | Name of the parent workflow task definition for the Task Instance (if it was invoked from a Worklfow). | N |
| ||||||||||||
workflowInstanceCriteria | n/a | Specification for how | Valid values:
Default is Oldest Active Instance (1).
| N | ||||||||||||
workflowInstanceId | n/a | sys_id of the parent workflow task instance. Only task instances within this workflow task instance will be listed. | N |
| ||||||||||||
workflowInstanceName | Workflow | Name of the parent workflow task instance. Only task instances within this workflow task instance will be listed. | N |
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/showvariables |
HTTP Method | GET |
Description | Retrieve the variables for a specific task instance. (Comparable to the Show Variables functionality in the user interface.) |
Authentication | HTTP Basic |
Example URI | |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example URI Properties | See List Task Instance Variables (Show Variables): Example URI Properties. |
Example Response | See List Task Instance Variables (Show Variables): XML and JSON Response Examples. |
Anchor | ||||
---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/release |
HTTP Method | POST |
Description | Releases the specified task instance from hold. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/release |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Release a Task Instance from Hold: XML and JSON Examples. |
Request Properties | |
Example Response | See Release a Task Instance from Hold: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/rerun |
HTTP Method | POST |
Description | Rerun a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/rerun |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | ||||||
---|---|---|---|---|---|---|
URI | http://host_name/uc/resources/taskinstance/retrieveoutput | |||||
HTTP Method | GET | |||||
Description | Retrieves the output of a task instance.
| |||||
Example URI | ||||||
Consumes Content-Type | n/a | |||||
Produces Content-Type | application/xml, application/json | |||||
Example URI Properties | ||||||
Example Response | See Retrieve Task Instance Output: XML and JSON Response Examples. |
Anchor | ||||
---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/settimewait |
HTTP Method | POST |
Description | Sets or modifies a wait time/duration for a task instance. |
Authentication | HTTP Basic |
Example URI | http://localhost:8080/uc/resources/taskinstance/settimewait |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Set or Modify Wait Time/Duration for Task Instance: XML and JSON Examples. |
Request Properties | See Set or Modify Wait Time/Duration for Task Instance: Request Properties. |
Example Response | See Set or Modify Wait Time/Duration for Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
| |||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/setpriority |
HTTP Method | POST |
Description | Set priority for a task instance (Linux/Unix, Windows, Universal, or z/OS). |
Example URI | http://localhost:8080/uc/resources/taskinstance/setpriority |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | See Set Priority for a Task Instance: XML and JSON Examples. |
Request Properties | |
Example Response | See Set Priority for a Task Instance: XML and JSON Examples. |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/skip |
HTTP Method | POST |
Description | Skip a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/skip |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/skippath |
HTTP Method | POST |
Description | Skip a task instance and all of its dependent task instances. |
Example URI | http://localhost:8080/uc/resources/taskinstance/skippath |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/taskinstance/unskip |
HTTP Method | POST |
Description | Unskip a task instance. |
Example URI | http://localhost:8080/uc/resources/taskinstance/unskip |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
Description | |
---|---|
URI | |
HTTP Method | PUT |
Description | Update the operational memo for a task instance record. |
Example URI | |
Authentication | HTTP Basic |
Consumes Content-Type | text/plain |
Produces Content-Type | text/plain |
Example URI Properties | See Update a Task Instance Operational Memo: Example URI Properties. |
Example Request Body | See Update a Task Instance Operational Memo: Text/Plain Examples. |
Example Response Body | See Update a Task Instance Operational Memo: Text/Plain Examples. |
Anchor | ||||
---|---|---|---|---|
|
...