.TH "torque_submit_workers" 1 "" "CCTools 7.0.9 FINAL" "Cooperative Computing Tools"
.SH NAME
.LP
\fBtorque_submit_workers\fP - submit work_queue_worker to a Torque cluster.

.SH SYNOPSIS
.LP
\FC\fBtorque_submit_workers [options] <servername> <port> <num-workers>\fP\FT

.SH DESCRIPTION
.LP
\FCtorque_submit_workers\FT schedules the execution of \fBwork_queue_worker(1)\fP
on the Torque batch system through its job submission interface, qsub.
The number of \fBwork_queue_worker\fP scheduled and run is given by the \fBnum-workers\fP
argument.

The \fBservername\fP and \fBport\fP arguments specify the hostname and port number of the
master for the work_queue_worker to connect. These two arguments become optional when the
auto mode option is specified for work_queue_worker.

.SH OPTIONS
.LP
.LP
.TP
.B \ -M
.
Name of the preferred master for worker.
.TP
.BI \ -N \ <name>
.
Preferred project name for work_queue_worker to connect.
.TP
.BI \ -c \ <cores>
.
Set the number of cores each worker should use (0=auto). (default=1)
.TP
.BI \ -C \ <catalog>
.
Set catalog server for work_queue_worker to <catalog>. <catalog> format: HOSTNAME:PORT.
.TP
.BI \ -t \ <seconds>
.
Abort work_queue_worker after this amount of idle time (default=900s).
.TP
.BI \ -d \ <subsystem>
.
Enable debugging on worker for this subsystem (try -d all to start).
.TP
.BI \ -w \ <size>
.
Set TCP window size
.TP
.BI \ -i \ <time>
.
Set initial value for backoff interval when worker fails to connect to a master. (default=1s)
.TP
.BI \ -b \ <time>
.
Set maxmimum value for backoff interval when worker fails to connect to a master. (default=60s)
.TP
.BI \ -z \ <size>
.
Set available disk space threshold (in MB). When exceeded worker will clean up and reconnect. (default=100MB)
.TP
.BI \ -A \ <arch>
.
Set architecture string for the worker to report to master instead of the value in uname.
.TP
.BI \ -O \ <os>
.
Set operating system string for the worker to report to master instead of the value in uname.
.TP
.BI \ -s \ <path>
.
Set the location for creating the working directory of the worker.
.TP
.BI \ -j \ <>
.
Use job array to submit workers.
.TP
.BI \ -p \ <parameters>
.
Torque qsub parameters.
.TP
.B \ -h
.
Show help message.


.SH EXIT STATUS
.LP
On success, returns zero. On failure, returns non-zero.

.SH EXAMPLES
.LP

Submit 10 worker instances to run on Torque and connect to a specific master:

.fam C
.nf
.nh
.IP "" 8
torque_submit_workers master.somewhere.edu 9123 10
.fi
.hy
.fam
.P

Submit 10 work_queue_worker instances to run on Torque in auto mode with their
preferred project name set to Project_A and abort timeout set to 3600 seconds:

.fam C
.nf
.nh
.IP "" 8
torque_submit_workers -a -t 3600 -M Project_A 10
.fi
.hy
.fam
.P

.SH COPYRIGHT
.LP
The Cooperative Computing Tools are Copyright (C) 2003-2004 Douglas Thain and Copyright (C) 2005-2015 The University of Notre Dame.  This software is distributed under the GNU General Public License.  See the file COPYING for details.

.SH SEE ALSO
.LP

.IP \(bu 4
\fBCooperative Computing Tools Documentation\fP
.IP \(bu 4
\fBWork Queue User Manual\fP
.IP \(bu 4
\fBwork_queue_worker(1)\fP \fBwork_queue_status(1)\fP \fBwork_queue_factory(1)\fP \fBcondor_submit_workers(1)\fP \fBsge_submit_workers(1)\fP \fBtorque_submit_workers(1)\fP