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...
 
struct listenv_list
 Environment variables applied to 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...
 
double priority
 The priority of this task relative to others in the queue: higher number run earlier. More...
 
struct rmsummaryresources_measured
 When monitoring is enabled, it points to the measured resources used by the task. 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.

struct list* work_queue_task::env_list

Environment variables applied to 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.

double work_queue_task::priority

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

struct rmsummary* work_queue_task::resources_measured

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

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: