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

char* work_queue_task::tag

An optional user-defined logical name for the task.

char* work_queue_task::command_line

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

int work_queue_task::worker_selection_algorithm

How to choose worker to run the task.

char* work_queue_task::output

The standard output of the task.

struct list* work_queue_task::input_files

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

struct list* work_queue_task::output_files

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

int work_queue_task::taskid

A unique task id number.

int work_queue_task::return_status

The exit code of the command line.

int work_queue_task::result

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

char* work_queue_task::host

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

char* work_queue_task::hostname

The name of the host on which it ran.

timestamp_t work_queue_task::time_committed

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

timestamp_t work_queue_task::time_task_submit

The time at which this task was submitted.

timestamp_t work_queue_task::time_task_finish

The time at which this task was finished.

timestamp_t work_queue_task::time_send_input_start

The time at which it started to transfer input files.

timestamp_t work_queue_task::time_send_input_finish

The time at which it finished transferring input files.

timestamp_t work_queue_task::time_execute_cmd_start

The time at which the task began.

timestamp_t work_queue_task::time_execute_cmd_finish

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

timestamp_t work_queue_task::time_receive_result_start

The time at which it started to transfer the results.

timestamp_t work_queue_task::time_receive_result_finish

The time at which it finished transferring the results.

timestamp_t work_queue_task::time_receive_output_start

The time at which it started to transfer output files.

timestamp_t work_queue_task::time_receive_output_finish

The time at which it finished transferring output files.

int64_t work_queue_task::total_bytes_received

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

int64_t work_queue_task::total_bytes_sent

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

int64_t work_queue_task::total_bytes_transferred

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

timestamp_t work_queue_task::total_transfer_time

Time comsumed in microseconds for transferring total_bytes_transferred.

timestamp_t work_queue_task::cmd_execution_time

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

int work_queue_task::total_submissions

The number of times the task has been submitted.

timestamp_t work_queue_task::total_cmd_execution_time

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

struct rmsummary* work_queue_task::resources_measured

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

double work_queue_task::priority

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

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

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