qsub(1) - Linux man page

Prolog

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (consult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.

Name

qsub - submit a script

Synopsis

qsub [-a date_time][-A account_string][-c interval]
[-C directive_prefix][-e path_name][-h][-j join_list][-k keep_list]
[-m mail_options][-M mail_list][-N name]
[-o path_name][-p priority][-q destination][-r y|n]
[-S path_name_list][-u user_list][-v variable_list][-V]
[-z][script]

Description

To submit a script is to create a batch job that executes the script. A script is submitted by a request to a batch server. The qsub utility is a user-accessible batch client that submits a script.

Upon successful completion, the qsub utility shall have created a batch job that will execute the submitted script.

The qsub utility shall submit a script by sending a Queue Job Request to a batch server.

The qsub utility shall place the value of the following environment variables in the Variable_List attribute of the batch job: HOME, LANG, LOGNAME, PATH, MAIL, SHELL, and TZ. The name of the environment variable shall be the current name prefixed with the string PBS_O_.

Note:: If the current value of the HOME variable in the environment space of the qsub utility is /aa/bb/cc, then qsub shall place PBS_O_HOME = /aa/bb/cc in the Variable_List attribute of the batch job.

In addition to the variables described above, the qsub utility shall add the following variables with the indicated values to the variable list:

PBS_O_WORKDIR: The absolute path of the current working directory of the qsub utility process.
PBS_O_HOST: The name of the host on which the qsub utility is running.

Options

The qsub utility shall conform to the Base Definitions volume of IEEE Std 1003.1-2001, Section 12.2, Utility Syntax Guidelines.

The following options shall be supported by the implementation:

-a date_time: Define the time at which a batch job becomes eligible for execution.

The qsub utility shall accept an option-argument that conforms to the syntax of the time operand of the touch utility.

Table: Environment Variable Values (Utilities)

Note:The server that initiates execution of the batch job will add othervariables to the batch job's environment; see Batch Job Execution.The qsub utility shall set the Execution_Time attributeof the batch job to the number of seconds since the Epochthat is equivalent to the local time expressed by the value of thedate_time option-argument. The Epoch is defined in theBase Definitions volume of IEEE Std 1003.1-2001, Section 3.149,Epoch.Operands

Stdin

Input Files

Environment Variables

Asynchronous Events

Stdout

Stderr

Output Files

Extended Description

Script Preservation

Option Specification

*

*

Exit Status

Consequences of Errors

Application Usage

Examples

Rationale

Future Directions

Copyright

Referenced By

drmaa_attributes(3), drmaa_submit(3), jsv(1), jsv_script_interface(3), qacct(1), qdel-ge(1), qhold-ge(1), qhost(1), qmake-ge(1), qmod(1), qquota(1), qrdel(1), qrls-ge(1), qrstat(1), qrsub(1), qstat-ge(1), sge_accounting(5), sge_aliases(5), sge_checkpoint(5), sge_complex(5), sge_conf(5), sge_host_conf(5), sge_intro(1), sge_pe(5), sge_priority(5), sge_queue_conf(5), sge_reporting(5), sge_request(5), sge_sched_conf(5), sge_types(1)