Reference

qsub(1)

submit a batch job in a familiar PBS format

NAME

qsub - submit a batch job in a familiar PBS format

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]

DESCRIPTION

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

History

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