work_queue_task Struct Reference

A task description. More...

#include <work_queue.h>

Data Fields

char * tag
 An optional user-defined logical name for the task.
char * command_line
 The program(s) to execute, as a shell command line.
int worker_selection_algorithm
 How to choose worker to run the task.
char * output
 The standard output of the task.
struct listinput_files
 The files to transfer to the worker and place in the executing directory.
struct listoutput_files
 The output files (other than the standard output stream) created by the program expected to be retrieved from the task.
struct listenv_list
 Environment variables applied to the task.
int taskid
 A unique task id number.
int return_status
 The exit code of the command line.
int result
 The result of the task (successful, failed return_status, missing input file, missing output file).
char * host
 The address and port of the host on which it ran.
char * hostname
 The name of the host on which it ran.
timestamp_t time_committed
 The time at which a task was committed to a worker.
timestamp_t time_task_submit
 The time at which this task was submitted.
timestamp_t time_task_finish
 The time at which this task was finished.
timestamp_t time_send_input_start
 The time at which it started to transfer input files.
timestamp_t time_send_input_finish
 The time at which it finished transferring input files.
timestamp_t time_execute_cmd_start
 The time at which the task began.
timestamp_t time_execute_cmd_finish
 The time at which the task finished (discovered by the master).
timestamp_t time_receive_result_start
 The time at which it started to transfer the results.
timestamp_t time_receive_result_finish
 The time at which it finished transferring the results.
timestamp_t time_receive_output_start
 The time at which it started to transfer output files.
timestamp_t time_receive_output_finish
 The time at which it finished transferring output files.
int64_t total_bytes_received
 Number of bytes received since task has last started receiving input data.
int64_t total_bytes_sent
 Number of bytes sent since task has last started sending input data.
int64_t total_bytes_transferred
 Number of bytes transferred since task has last started transferring input data.
timestamp_t total_transfer_time
 Time comsumed in microseconds for transferring total_bytes_transferred.
timestamp_t cmd_execution_time
 Time spent in microseconds for executing the command on the worker.
int total_submissions
 The number of times the task has been submitted.
timestamp_t total_cmd_execution_time
 Time spent in microseconds for executing the command on any worker, including resubmittions of the task.
double priority
 The priority of this task relative to others in the queue: higher number run earlier.
struct rmsummaryresources_measured
 When monitoring is enabled, it points to the measured resources used by the task.
timestamp_t time_app_delay

Detailed Description

A task description.

This structure should only be created with work_queue_task_create and delete with work_queue_task_delete. You may examine (but not modify) this structure once a task has completed.


Field Documentation

An optional user-defined logical name for the task.

The program(s) to execute, as a shell command line.

How to choose worker to run the task.

The standard output of the task.

The files to transfer to the worker and place in the executing directory.

The output files (other than the standard output stream) created by the program expected to be retrieved from the task.

Environment variables applied to the task.

A unique task id number.

The exit code of the command line.

The result of the task (successful, failed return_status, missing input file, missing output file).

The address and port of the host on which it ran.

The name of the host on which it ran.

The time at which a task was committed to a worker.

The time at which this task was submitted.

The time at which this task was finished.

The time at which it started to transfer input files.

The time at which it finished transferring input files.

The time at which the task began.

The time at which the task finished (discovered by the master).

The time at which it started to transfer the results.

The time at which it finished transferring the results.

The time at which it started to transfer output files.

The time at which it finished transferring output files.

Number of bytes received since task has last started receiving input data.

Number of bytes sent since task has last started sending input data.

Number of bytes transferred since task has last started transferring input data.

Time comsumed in microseconds for transferring total_bytes_transferred.

Time spent in microseconds for executing the command on the worker.

The number of times the task has been submitted.

Time spent in microseconds for executing the command on any worker, including resubmittions of the task.

The priority of this task relative to others in the queue: higher number run earlier.

When monitoring is enabled, it points to the measured resources used by the task.

Deprecated:
The time spent in upper-level application (outside of work_queue_wait).

The documentation for this struct was generated from the following file:

Generated on 29 Jun 2015 for cctools by  doxygen 1.6.1