You can monitor the details of the taskflows that are running or have run in your organization in the All Jobs and Running Jobs page. The Started By column displays the name of the user who first started the taskflow even if the taskflow is restarted by another user.
The taskflow instance name appears in the All Jobs and the Running Jobs page in the following format:
<taskflow name>-<runID>
If you had added a custom name to a taskflow name by using an API or the RunAJob utility, the taskflow name appears in the following format:
<taskflow name>-<custom name>-<runID>
The following image shows the All Jobs page that displays a taskflow instance with a custom name added to the taskflow name:
To view detailed information about a taskflow instance, click the job name on the All Jobs or the Running Jobs page.
The following image shows the job details for a taskflow instance:
1Log panel. A chronological list of the activities that the taskflow has run.
2Design panel. A canvas view of the taskflow.
3Properties panel. The properties of the taskflow element that you select on the canvas. Click the Start step to view properties specific to the current taskflow instance. Click a Data Task step to see properties specific to the task.
4Variable. The input and temp variables used to run the taskflow instance. To update the variables and their associated values, click the Edit icon next to the Input or Temp variable in the Variable panel.
Start step properties
The Start step properties display information about the current run of a taskflow.
When you click the Start step, the properties panel displays the following information:
Property
Description
Current Run
You see the following properties:
- Instance ID. A unique number that identifies the current taskflow instance.
- Status. The state that the taskflow instance is in. Taskflows can be in the Running, Failed, Success or Suspended states.
- Last Fault Name. The cause for the fault occurrence. This field appears only when the taskflow fails.
- Error. Exception or error message.
- Start Date. The date and time at which the taskflow instance was started.
- End Date. The date and time at which the taskflow instance ended. You see an End Time value if a taskflow is in the Success or Failed states.
- Duration. The amount of time the taskflow instance ran before it completed. You see a Duration value if a taskflow is in the Success or Failed states.
- Username. The name of the user who ran this instance of the taskflow.
- Runtime Environment. The runtime environment in which the taskflow ran. You can run taskflows only in the Cloud environment.
Input Fields
Displays the name and value provided as input for the current taskflow instance.
Data Task properties
The Data Task step properties display details about the current run of the data task of a taskflow.
When you click a data task, the properties panel displays the following information:
Property
Description
Current Run
You see the following properties:
- Status. Indicates the status of the data integration task. A data integration task can be in the 0 (Faulted), 1 (Success), or 2 (Warning) states.
- Error. If the data integration task is in the 0 (Faulted) or 2 (Warning) states, the error message appears here.
- Start Date. The date and time that the data integration task started.
- End Date. The date and time that the data integration task ended or was suspended.
- Duration. The amount of time the data integration task ran before it completed or was suspended.
- Started By. The name of the taskflow that called the data integration task.
- Username. The name of the user who ran this instance of the taskflow.
General
The name and type of the Data Task step.
Data Task
You see the following properties:
- Name. The name of the data integration task.
- Type. Specifies whether the data integration task is a data transfer task, dynamic mapping task, mapping task, PowerCenter task, or synchronization task.
Input Fields
Properties specific to the data integration task that you added to a Data Task step.
You see the following properties:
- Wait for Task to Complete. Indicates if the Data Task step waits for the data integration task to complete. This value is always Yes.
- Max Wait (Seconds). The maximum length of time in seconds that the Data Task step waits for the data integration task to complete.
- Task Name. The name of the data integration task.
- GUID. The unique identifying number of the data integration task.
- Task Type. Indicates whether the data integration task is a data transfer task, dynamic mapping task, mapping task, PowerCenter task, or synchronization task.
- Has Inout Parameters. Indicates whether the data integration task contains input parameters or output parameters.
Output Fields
You see output field properties if the State of the data integration task is 1 (Success).
Properties specific to the completed data integration task appear here.
Note: If the data task is a mapping task that is based on a mapping in advanced mode, the output field properties include success target rows and error target rows, but they do not include success source rows and error source rows.
Fault
If the data integration task faulted, you see the following properties:
- Code. Indicates whether the fault is an error or a warning.
- Reason. Indicates the cause of the error or fault.
- Detail. Provides details about the error or fault.
You see the output field properties when the data integration task status is 3 (Failed) and one of the following conditions are met:
- The On Error field is set to Ignore or Custom error handling.
- The Fail taskflow on completion option is set to If this task fails.
IntegrationOps Task properties
The IntegrationOps Task step properties display details of the current run of the IntegrationOps task in a taskflow. The taskflow continues to run the subsequent steps even if the IntegrationOps task fails.
When you click the IntegrationOps task, the Properties panel displays the following properties:
Property
Description
Input Fields
Properties specific to the process you added to the IntegrationOps Task step.
Displays the following properties:
- Task Name. The name of the Application Integration process.
- GUID. The unique identifying number of the process.
- Task Type. The task type. For an IntegrationOps Task, the task type is always PROCESS.
- Agent Name. The Secure Agent name where the process ran.
Output Fields
Displays the output fields of the process along with their associated values.
The output fields are displayed only if the IntegrationOps task completed successfully.
Fault
If the IntegrationOps task is faulted, you see the following properties:
- Code. Indicates whether the fault is an error or a warning.
- Reason. Indicates the cause of the error or fault.
- Detail. Provides details about the error or fault.
Notification Task properties
The Notification Task step properties display details about the current run of the Notification Task of a taskflow.
When you click a Notification Task, the Properties panel displays the following information:
Property
Description
General
The name of the Notification Task step.
Details
Displays the following input fields of the Notification Task:
- Email To. The primary recipients for the email notification.
- Email Cc. The recipients who need to be sent a copy of the email notification.
- Email Bcc. The additional recipients who need to be sent a copy of the email notification. The recipients in the Email To and Email Cc fields will not be able to see the recipients in the Email Bcc field. If the field contains more than one recipient, the recipients will not be able to see the other recipients in the Email Bcc field.
- Email Subject. A short and descriptive subject that introduces the email.
- Email Content Type. The type of formatting that the email content uses.
- Email Body. The content that the email contains.
If you selected the email body as Content, the email content appears within HTML tags. For example, <p>Hello World</p>
Command Task step properties
The Command Task step properties display details of the current run of the command task in a taskflow.
When you click a command task in the taskflow, the Properties panel displays the following properties:
Property
Description
General
Displays the name of the command task.
Input Fields
Displays the value of the runtime environment, script file name, input arguments, and work directory that you configure for the command task. The fields also display the maximum length of time in seconds that the command task step waits for the task to complete.
Output Fields
Displays the value of the run ID, start and end time, exit code, execution status, and standard error. The output fields are displayed only if the command task executes successfully.
Fault
Displays the value of the run ID, start and end time, exit code, execution status, and standard error. The fault fields are displayed only if the command task fails due to a script failure. The details help you analyze the reason for the fault occurrence. You can then take an appropriate action on the faulted command task and proceed with the execution of the taskflow.
If the Command Task step contains multiple script files, you can view all the scripts in the taskflow instance as subtasks of the command task from the All Jobs, Running Jobs, or My Jobs page. If a script fails, the status of the script is set to failed. You can also download the log file to understand the reason for the script failure.
File Watch Task step properties
The File Watch Task step properties display details about the current run of the file watch task of a taskflow.
When you click a File Watch Task step, the Properties panel displays the following information:
Property
Description
Current Run
Displays the following details:
- Status. Status of the file watch task.
- Started By. Name of the taskflow that called the file watch task.
General
Displays the name of the File Watch Task step.
File Watch Task
Displays the name and type of the file listener that the File Watch Task step contains.
The type is always set to MI_FILE_LISTENER.
Input Fields
Displays the following input fields:
- Wait for Task to Complete. Indicates whether the File Watch Task step waits for the file listener to complete. This value is always set to true.
- Max Wait. Maximum time in seconds that the File Watch Task step waits for the file listener to complete. This value is always set to 604800 seconds, which is 7 days.
- Task Name. Name of the file listener.
- GUID. Unique identification number for the file listener.
- Task Type. Indicates the type of file listener that the File Watch Task step contains. This value is always set to MI_FILE_LISTENER.
- serviceProviderId. Service provider ID for the file listener. This value is always set to filelistener.
- serviceProviderContextPath. Service provider context path for the file listener. This value is always set to filelistener/.
Output Fields
Displays the following output fields if the File Watch Task step completed successfully:
- id. ID for the File Watch Task step run.
- monitorJobId. Job ID that you can use to check the status of the file listener in the File Transfer Logs tab of the Monitor service.
Append the monitorJobId to the file listener name to find out the instance name in the File Transfer Logs tab of the Monitor service.
For example, if the monitorJobId is 7500 and the name of the file listener is FL_Arrive, the instance name that you need to look for in the File Transfer Logs tab of the Monitor service would be FL_Arrive-7500.
- notificationTime. Timestamp when the File Watch Task step completed. The timestamp includes the date and time up to seconds.
- status. Status of the file watch task. This value is always set to Completed.
- fileEvents. Provides a list of files along with the following details:
- Event ID. Auto-generated ID for the event.
- Event type. Indicates the nature of the file event. You see one of the following values:
- ARRIVED
- UPDATED
- DELETED
- File last modified. Timestamp when the file was last modified. The timestamp includes the date and time up to seconds.
- File name. Name of the file that arrived, was updated, or deleted as part of the event.
- File path. Name of the file and the path where the file exists.
- File size. Size of the file in KB.
- Task Id. This value is always blank.
- Run Id. This field has the same value as the monitorJobId field.
Fault
If the file watch task faulted, you see the following properties:
- Code. Indicates whether the fault is an error or a warning.
- Reason. Cause of the error or fault.
- Details. Details about the error or fault.
Consider the following rules and guidelines when you monitor the File Watch Task step:
•The All Jobs page does not display the file watch task as a subtask. It always displays the number of rows processed as 0 if the taskflow includes a File Watch Task step.
•If the file watch task faulted and the On Error property was set to Suspend Taskflow, no information is displayed in the Properties panel.
Ingestion Task step properties
The Ingestion Task step properties display details about the current run of the Ingestion task of a taskflow.
When you click an Ingestion Task step, the Properties panel displays the following information:
Property
Description
Current Run
Displays the following details:
- Status. Status of the file ingestion task.
- Start Date. Date and time when the file ingestion task started.
- End Date. Date and time when the file ingestion task ended or was suspended.
- Duration. Amount of time in seconds that the file ingestion task ran before it completed or was suspended.
- Started By. Name of the taskflow that called the file ingestion task.
General
Displays the name of the Ingestion Task step.
Ingestion Task
Displays the name and type of the ingestion task that the Ingestion Task step contains.
The type is set to MI_TASK for file ingestion tasks.
Input Fields
Displays the following input fields:
- Wait for Task to Complete. Indicates whether the Ingestion Task step waits for the file ingestion task to complete. This value is always set to true.
- Max Wait. Maximum time in seconds that the Ingestion Task step waits for the file ingestion task to complete. This value is always set to 604800 seconds, which is 7 days.
- Task Name. Name of the file ingestion task.
- GUID. Unique identification number for the file ingestion task.
- Task Type. Indicates the type of task that the Ingestion Task step contains. This value is always set to MI_TASK for file ingestion tasks.
- serviceProviderId. Service provider ID for the file ingestion task. This value is always set to filelistener.
- serviceProviderContextPath. Service provider context path for the file ingestion task. This value is always set to mitask/.
Output Fields
Displays the following output fields if the Ingestion Task step completed successfully:
- endTime. Date and time when the file ingestion task completed.
- failedFiles. Number of failed files in the file ingestion task run.
- jobNumber. ID for the file ingestion task run.
- messageText. Indicates whether the job completed normally. This value is always set to Job completed normally.
- startTime. Date and time when the file ingestion task started.
- status. Indicates whether the Ingestion Task step completed. This value is always set to Success.
- successFiles. Number of files that were successfully processed in the file ingestion task.
- fileDetails. Provides a list of objects with the following details:
- Duration. Amount of time in seconds that the file ingestion task ran before it completed.
- Last modified. Date and time when the file was last modified.
- Path. Name of the file and the path where the file exists.
- Size. Size of the file in KB.
- Status. Indicates the status of the file transfer. This value is always set to Success.
- Transfer direction. Indicates the transfer direction for the file. You see one of the following values:
- DOWNLOAD. The file was downloaded from the source.
- UPLOAD. The file was uploaded to the target.
Fault
If the ingestion task faulted, you see the following properties:
- Code. Indicates whether the fault is an error or a warning.
- Reason. Cause of the error or fault.
Consider the following rules and guidelines when you monitor the Ingestion Task step:
•The All Jobs page does not display the ingestion task as a subtask. It always displays the number of rows processed as 0 if the taskflow includes an Ingestion Task step.
•If the ingestion task faulted and the On Error property was set to Suspend Taskflow, no information is displayed in the Properties panel.
Subtaskflow step properties
The Subtaskflow step properties display details about the current run of the subtaskflow.
When you click a Subtaskflow step, the Properties panel displays the following information:
Properties
Description
Input Fields
Displays the input fields that you had configured along with their associated values.
Fault
If the subtaskflow step faulted, you see the following properties:
- Code. Indicates whether the fault is an error or a warning.
- Reason. Indicates the cause of the error or fault.
- Source. Provides details about the error or fault. If a Data Task step that uses a mapping task fails, the subtaskflow name followed by the mapping task name is displayed.
Output Fields
Displays the output fields of the subtaskflow along with their associated values.
Throw step properties
The Throw step properties display the fault details for the taskflow or the step that is associated with the Throw step.
If the step preceding the Throw step or the step with which the Throw step is associated faulted, the Fault field in the Properties panel displays the following details:
•Code. Displays the fault code.
•Reason. Displays the cause of the fault.
•Details. Displays the details about the fault.
End step properties
The End step properties display details about the current run of the taskflow.
When you click an End step, the Properties panel displays the following information:
Properties
Description
Fault
If the End step faulted, you see the following properties:
- Code. Displays the fault code. The code is set to faultDueToNotRunOrFaulted if the subtaskflow associated with the Subtaskflow step failed or did not run.
- Reason. Indicates the cause of the error or fault.
- Source. Displays the path of the step that faulted
