.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "QSUB 1"
.TH QSUB 1 2024-02-15 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
qsub \- submit a batch job in a familiar PBS format
.SH SYNOPSIS
.IX Header "SYNOPSIS"
qsub  [\-a start_time]
      [\-A account]
      [\-b y|n]
      [\-e err_path]
      [\-I]
      [\-l resource_list]
      [\-m mail_options] [\-M user_list]
      [\-N job_name]
      [\-o out_path]
      [\-p priority]
      [\-pe shm task_cnt]
      [\-P wckey]
      [\-q destination]
      [\-r y|n]
      [\-v variable_list]
      [\-V]
      [\-wd workdir]
      [\-W additional_attributes]
      [\-h]
      [script]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBqsub\fR submits batch jobs. It is aimed to be feature-compatible with PBS' qsub.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-a\fR 4
.IX Item "-a"
Earliest start time of job. Format: [HH:MM][MM/DD/YY]
.IP "\fB\-A account\fR" 4
.IX Item "-A account"
Specify the account to which the job should be charged.
.IP "\fB\-b y|n\fR" 4
.IX Item "-b y|n"
Whether to wrap the command line or not
.IP "\fB\-e err_path\fR" 4
.IX Item "-e err_path"
Specify a new path to receive the standard error output for the job.
.IP \fB\-I\fR 4
.IX Item "-I"
Interactive execution.
.IP "\fB\-J job_array\fR" 4
.IX Item "-J job_array"
Job array index values. The \-J and \-t options are equivalent.
.IP "\fB\-l resource_list\fR" 4
.IX Item "-l resource_list"
Specify an additional list of resources to request for the job.
.IP "\fB\-m mail_options\fR" 4
.IX Item "-m mail_options"
Specify a list of events on which email is to be generated.
.IP "\fB\-M user_list\fR" 4
.IX Item "-M user_list"
Specify a list of email addresses to receive messages on specified events.
.IP "\fB\-N job_name\fR" 4
.IX Item "-N job_name"
Specify a name for the job.
.IP "\fB\-o out_path\fR" 4
.IX Item "-o out_path"
Specify the path to a file to hold the standard output from the job.
.IP "\fB\-p priority\fR" 4
.IX Item "-p priority"
Specify the priority under which the job should run.
.IP "\fB\-pe shm cpus-per-task\fR" 4
.IX Item "-pe shm cpus-per-task"
Specify the number of cpus per task.
.IP "\fB\-P wckey\fR" 4
.IX Item "-P wckey"
Specify the wckey or project of a job.
.IP "\fB\-r y|n\fR" 4
.IX Item "-r y|n"
Whether to allow the job to requeue or not.
.IP "\fB\-t job_array\fR" 4
.IX Item "-t job_array"
Job array index values. The \-J and \-t options are equivalent.
.IP "\fB\-v\fR [variable_list]" 4
.IX Item "-v [variable_list]"
Export only the specified environment variables. This option can also be used
with the \-V option to add newly defined environment variables to the existing
environment. The variable_list is a comma delimited list of existing environment
variable names and/or newly defined environment variables using a name=value
format.
.IP \fB\-V\fR 4
.IX Item "-V"
The \-V option to exports the current environment, which is the default mode of
options unless the \-v option is used.
.IP "\fB\-wd workdir\fR" 4
.IX Item "-wd workdir"
Specify the workdir of a job.  The default is the current work dir.
.IP "\fB\-?\fR | \fB\-\-help\fR" 4
.IX Item "-? | --help"
brief help message
.IP \fB\-\-man\fR 4
.IX Item "--man"
full documentation