QSUB(1)

💖 NAME 💖

okay bestie, welcome to QSUB(1) — a User Contributed Perl Documentation page for qsub, aka the icon that submits a batch job in a familiar PBS format. no cap, this is the one. 🫶

✨ 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]

quick heads-up: -q destination, -W additional_attributes, and -h are living in the synopsis above; the OPTIONS section below is the OPTIONS section. iykyk. 💅

💅 DESCRIPTION 💅

qsub submits batch jobs. it’s aimed to be feature-compatible with PBS' qsub — yes, that PBS. slay. 💖

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

---

this manual is serving source/version perl v5.40.2, dated 2026-10-14 🎀✨