qsub(1)

qsub1

Submit a batch job in a familiar pbs format

Usage

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]

Overview

The qsub submits batch jobs. It is aimed to be feature-compatible with PBS' qsub.

Options

-a

Earliest start time of job. Format: [HH:MM][MM/DD/YY]

-A account

Specify the account to which the job should be charged.

-b y|n

Whether to wrap the command line or not

-e err_path

Specify a new path to receive the standard error output for the job.

-I

Interactive execution.

-J job_array

Job array index values. The -J and -t options are equivalent.

-l resource_list

Specify an additional list of resources to request for the job.

-m mail_options

Specify a list of events on which email is to be generated.

-M user_list

Specify a list of email addresses to receive messages on specified events.

-N job_name

Specify a name for the job.

-o out_path

Specify the path to a file to hold the standard output from the job.

-p priority

Specify the priority under which the job should run.

-pe shm cpus-per-task

Specify the number of cpus per task.

-P wckey

Specify the wckey or project of a job.

-r y|n

Whether to allow the job to requeue or not.

-t job_array

Job array index values. The -J and -t options are equivalent.

-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.

-V

The -V option to exports the current environment, which is the default mode of options unless the -v option is used.

-wd workdir

Specify the workdir of a job. The default is the current work dir.

-? | --help

brief help message

--man

full documentation

Releases

9 releases since Debian 5.0 (Lenny); the text changed 7 times.

  1. 5.0
  2. 6.0–7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13

--help since Debian 8 (Jessie); --man since Debian 8 (Jessie); -? since Debian 8 (Jessie); -I since Debian 8 (Jessie); -J since Debian 8 (Jessie); -P since Debian 9 (Stretch); -V since Debian 8 (Jessie); -b since Debian 9 (Stretch); -r since Debian 9 (Stretch); -v since Debian 8 (Jessie); -wd since Debian 9 (Stretch).

-@ until Debian 7 (Wheezy); -C until Debian 7 (Wheezy); -R until Debian 7 (Wheezy); -S until Debian 7 (Wheezy); -ac until Debian 7 (Wheezy); -ar until Debian 7 (Wheezy); -c until Debian 7 (Wheezy); -ckpt until Debian 7 (Wheezy); -clear until Debian 7 (Wheezy); -cwd until Debian 7 (Wheezy); -dc until Debian 7 (Wheezy); -display until Debian 7 (Wheezy); -dl until Debian 7 (Wheezy); -h until Debian 7 (Wheezy); -hard until Debian 7 (Wheezy); -help until Debian 7 (Wheezy); -hold_jid until Debian 7 (Wheezy); -hold_jid_ad until Debian 7 (Wheezy); -i until Debian 7 (Wheezy); -inherit until Debian 7 (Wheezy); -j until Debian 7 (Wheezy); -js until Debian 7 (Wheezy); -jsv until Debian 7 (Wheezy); -masterq until Debian 7 (Wheezy); -noshell until Debian 7 (Wheezy); -nostdin until Debian 7 (Wheezy); -notify until Debian 7 (Wheezy); -now until Debian 7 (Wheezy); -ot until Debian 7 (Wheezy); -pty until Debian 7 (Wheezy); -q until Debian 7 (Wheezy); -sc until Debian 7 (Wheezy); -shell until Debian 7 (Wheezy); -soft until Debian 7 (Wheezy); -sync until Debian 7 (Wheezy).

From slurm-wlm-torque 24.11.5-4 in Debian 13 (Trixie). Parsed by carta from the page's man source.