Provided by: torque-client-x11_2.4.16+dfsg-1.5_amd64 bug

NAME

       qsub - submit pbs job

SYNOPSIS

       qsub [-a date_time] [-A account_string] [-b secs] [-c checkpoint_options] [-C directive_prefix] [-d path]
       [-D  path]  [-e  path]  [-f]  [-h]  [-I]  [-j  join]  [-k  keep] [-l resource_list] [-m mail_options] [-M
       user_list] [-N name] [-o path] [-p priority] [-P proxy_username[:group]]  [-q  destination]  [-r  c]  [-S
       path_list]  [-t  num_jobs] [-T prologue/epilogue script_name] [-u user_list] [-v variable_list] [-V] [-w]
       path [-W additional_attributes] [-x] [-X] [-z] [script]

DESCRIPTION

       To create a job is to submit an executable script to a batch  server.   The  batch  server  will  be  the
       default  server  unless  the  -q  option  is  specified.  See discussion of PBS_DEFAULT under Environment
       Variables below.  Typically, the script is a shell script which will be executed by a command shell  such
       as sh or csh.

       Options on the qsub command allow the specification of attributes which affect the behavior of the job.

       The  qsub  command  will  pass  certain  environment variables in the Variable_List attribute of the job.
       These variables will be available to the job.  The value for the following variables will be  taken  from
       the  environment  of the qsub command: HOME, LANG, LOGNAME, PATH, MAIL, SHELL, and TZ.  These values will
       be assigned to a new name which is the current name prefixed with the string "PBS_O_".  For example,  the
       job  will  have  access  to an environment variable named PBS_O_HOME which have the value of the variable
       HOME in the qsub command environment.

       In addition to the above, the following environment variables will be available to the batch job.

       PBS_O_HOST
              the name of the host upon which the qsub command is running.

       PBS_SERVER
              the hostname of the pbs_server which qsub submits the job to.

       PBS_O_QUEUE
              the name of the original queue to which the job was submitted.

       PBS_O_WORKDIR
              the absolute path of the current working directory of the qsub command.

       PBS_ARRAYID
              each member of a job array is assigned a unique identifier (see -t)

       PBS_ENVIRONMENT
              set to PBS_BATCH to indicate the job is a batch job, or to PBS_INTERACTIVE to indicate the job  is
              a PBS interactive job, see -I option.

       PBS_JOBID
              the job identifier assigned to the job by the batch system.

       PBS_JOBNAME
              the job name supplied by the user.

       PBS_NODEFILE
              the  name  of  the  file  contain  the list of nodes assigned to the job (for parallel and cluster
              systems).

       PBS_QUEUE
              the name of the queue from which the job is executed.

OPTIONS

       -a date_time
               Declares the time after which the job is eligible for execution.

               The date_time argument is in the form: [[[[CC]YY]MM]DD]hhmm[.SS]

               Where CC is the first two digits of the year (the century), YY is the second two  digits  of  the
               year,  MM  is the two digits for the month, DD is the day of the month, hh is the hour, mm is the
               minute, and the optional SS is the seconds.

               If the month, MM, is not specified, it will default to the current month if the specified day DD,
               is in the future.  Otherwise, the month will be set to next month.  Likewise, if the day, DD,  is
               not  specified,  it  will default to today if the time hhmm is in the future.  Otherwise, the day
               will be set to tomorrow.  For example, if you submit a job at 11:15am with a time of -a 1110, the
               job will be eligible to run at 11:10am tomorrow.

       -A account_string
               Defines the account string associated with the job.  The account_string is an undefined string of
               characters and is interpreted by the server which executes the job.  See section 2.7.1 of the PBS
               ERS.

       -b seconds
               Defines the maximum number of seconds qsub will  block  attempting  to  contact  pbs_server.   If
               pbs_server  is  down,  or  for  a  variety of communication failures, qsub will continually retry
               connecting to pbs_server for job submission.  This value overrides the CLIENTRETRY  parameter  in
               torque.cfg.   This  is  a  non-portable  TORQUE  extension.  Portability-minded users can use the
               PBS_CLIENTRETRY environmental variable.  A  negative  value  is  interpreted  as  infinity.   The
               default is 0.

       -c checkpoint_options
               Defines  the  options that will apply to the job.  If the job executes upon a host which does not
               support checkpoint, these options will be ignored.

               Valid checkpoint options are:

               none
                  No checkpointing is to be performed.

               enabled
                  Specify that checkpointing is allowed but must be explicitly invoked by either  the  qhold  or
                  qchkpt commands.

               shutdown
                  Specify that checkpointing is to be done on a job at pbs_mom shutdown.

               periodic
                  Specify  that periodic checkpointing is enabled. The default interval is 10 minutes and can be
                  changed by the $checkpoint_interval option in the mom config file or by specifying an interval
                  when the job is submitted

               interval=minutes
                  Checkpointing is to be performed at an interval of minutes, which is  the  integer  number  of
                  minutes of wall time used by the job.  This value must be greater than zero.

               depth=number
                  Specify a number (depth) of checkpoint images to be kept in the checkpoint directory.

               dir=path
                  Specify a checkpoint directory (default is /var/spool/torque/checkpoint).

       -C directive_prefix
               Defines the prefix that declares a directive to the qsub command within the script file.  See the
               paragraph on script directives in the Extended Description section.

               If the -C option is presented with a directive_prefix argument that is the null string, qsub will
               not scan the script file for directives.

       -d path Defines  the  working  directory path to be used for the job.  If the -d option is not specified,
               the default working directory is the home directory.  This option sets the  environment  variable
               PBS_O_INITDIR.

       -D path Defines  the  root  directory  to be used for the job.  This option sets the environment variable
               PBS_O_ROOTDIR.

       -e path Defines the path to be used for the standard error stream of the batch job.  The path argument is
               of the form:
                   [hostname:][path_name]
               where hostname is the name of a host to which the file will be returned and path_name is the path
               name on that host in the syntax recognized  by  POSIX.   The  argument  will  be  interpreted  as
               follows:

               path_name
                      Where  path_name  is not an absolute path name, then the qsub command will expand the path
                      name relative to the current working directory of the command.  The  command  will  supply
                      the name of the host upon which it is executing for the hostname component.

               hostname:path_name
                      Where  path_name  is  not an absolute path name, then the qsub command will not expand the
                      path name relative to the current working directory of the command.  On  delivery  of  the
                      standard  error,  the  path name will be expanded relative to the user's home directory on
                      the hostname system.

               path_name
                      Where path_name specifies an absolute path name, then the qsub will supply the name of the
                      host on which it is executing for the hostname

               hostname:path_name
                      Where path_name specifies an absolute path name, the  path  will  be  used  as  specified.
                      hostname.

               hostname:
                      Where  hostname  specifies  the  name of the host that the file should be returned to. The
                      path will be the default file name.

               If the -e option is not specified or the path_name is not specified or  is  specified  and  is  a
               directory,  the  default  file name for the standard error stream will be used.  The default name
               has the following form:
                   job_name.esequence_number
               where job_name is the name of the job, see -N option,  and  sequence_number  is  the  job  number
               assigned when the job is submitted.

       -f      Specifies that the job is fault tolerant. The fault_tolerant attribute will be set to true, which
               indicates  that  the  job can survive the loss of a mom other than the "mother superior" mom (the
               first node in the exec hosts )

       -h      Specifies that a user hold be applied to the job at submission time.

       -I      Declares that the job is to be run "interactively".  The job will be queued and scheduled as  any
               PBS  batch  job,  but when executed, the standard input, output, and error streams of the job are
               connected through qsub to the terminal session in which qsub is running.   Interactive  jobs  are
               forced  to  not  rerunable.  See the "Extended Description" paragraph for addition information of
               interactive jobs.

       -j join Declares if the standard error stream of the job will be merged with the standard  output  stream
               of the job.

               An  option  argument  value  of  oe  directs  that the two streams will be merged, intermixed, as
               standard output.  An option argument value of eo directs that the two  streams  will  be  merged,
               intermixed, as standard error.

               If  the  join  argument is n or the option is not specified, the two streams will be two separate
               files.

       -k keep Defines which (if either) of standard output or standard error will be retained on the  execution
               host.   If  set  for  a stream, this option overrides the path name for that stream.  If not set,
               neither stream is retained on the execution host.

               The argument is either the single letter "e" or "o", or the  letters  "e"  and  "o"  combined  in
               either order.  Or the argument is the letter "n".

               e  The standard error stream is to retained on the execution host.  The  stream will be placed in
                  the  home  directory  of the user under whose user id the job executed.  The file name will be
                  the default file name given by: job_name.esequence where job_name is the  name  specified  for
                  the job, and sequence is the sequence number component of the job identifier.

               o  The  standard  output stream is to retained on the execution host.  The  stream will be placed
                  in the home directory of the user under whose user id the job executed.  The file name will be
                  the default file name given by: job_name.osequence where job_name is the  name  specified  for
                  the job, and sequence is the sequence number component of the job identifier.

               eo Both the standard output and standard error streams will be retained.

               oe Both the standard output and standard error streams will be retained.

               n  Neither stream is retained.

       -l resource_list
               Defines  the  resources  that  are  required  by the job and establishes a limit to the amount of
               resource that can be consumed.  If not set for a generally available resource, such as CPU  time,
               the limit is infinite.  The resource_list argument is of the form:
                   resource_name[=[value]][,resource_name[=[value]],...]

       -m mail_options
               Defines the set of conditions under which the execution server will send a mail message about the
               job.  The mail_options argument is a string which consists of either the single character "n", or
               one or more of the characters "a", "b", and "e".

               If the character "n" is specified, no mail will be sent.

               For the letters "a", "b", and "e":

               a  mail is sent when the job is aborted by the batch system.

               b  mail is sent when the job begins execution.

               e  mail is sent when the job terminates.

               If the -m option is not specified, mail will be sent if the job is aborted.

       -M user_list
               Declares  the list of users to whom mail is sent by the execution server when it sends mail about
               the job.

               The user_list argument is of the form:
                   user[@host][,user[@host],...]
               If unset, the list defaults to the submitting user at the qsub host, i.e. the job owner.

       -N name Declares a name for the job.  The name specified may be up to  and  including  15  characters  in
               length.   It  must  consist  of  printable,  non  white space characters with the first character
               alphabetic.

               If the -N option is not specified, the job name will be the base name  of  the  job  script  file
               specified on the command line.  If no script file name was specified and the script was read from
               the standard input, then the job name will be set to STDIN.

       -o path Defines  the  path to be used for the standard output stream of the batch job.  The path argument
               is of the form:
                   [hostname:][path_name]
               where hostname is the name of a host to which the file will be returned and path_name is the path
               name on that host in the syntax recognized  by  POSIX.   The  argument  will  be  interpreted  as
               follows:

               path_name
                      Where  path_name  is not an absolute path name, then the qsub command will expand the path
                      name relative to the current working directory of the command.  The  command  will  supply
                      the name of the host upon which it is executing for the hostname component.

               hostname:path_name
                      Where  path_name  is  not an absolute path name, then the qsub command will not expand the
                      path name relative to the current working directory of the command.  On  delivery  of  the
                      standard  output,  the path name will be expanded relative to the user's home directory on
                      the hostname system.

               path_name
                      Where path_name specifies an absolute path name, then the qsub will supply the name of the
                      host on which it is executing for the hostname

               hostname:path_name
                      Where path_name specifies an absolute path name, the  path  will  be  used  as  specified.
                      hostname.

               hostname:
                      Where  hostname  specifies  the  name of the host that the file should be returned to. The
                      path will be the default file name.

               If the -o option is not specified or the path_name is not specified or  is  specified  and  is  a
               directory,  the  default file name for the standard output stream will be used.  The default name
               has the following form:
                   job_name.osequence_number
               where job_name is the name of the job, see -N option,  and  sequence_number  is  the  job  number
               assigned when the job is submitted.

       -p priority
               Defines the priority of the job.  The priority argument must be a integer between -1024 and +1023
               inclusive.  The default is no priority which is equivalent to a priority of zero.

       -P proxy_user[:group]
               Proxy  user  for  whom  the job should be submitted.  This option is only available for the super
               user.

       -q destination
               Defines the destination of the job.  The destination names a queue, a server, or  a  queue  at  a
               server.

               The  qsub  command  will submit the script to the server defined by the destination argument.  If
               the destination is a routing queue, the job may be routed by the server to a new destination.

               If the -q option is not specified, the qsub command will submit the script to the default server.
               See PBS_DEFAULT under the Environment Variables section on this man page and the PBS ERS  section
               2.7.4, "Default Server".

               If the -q option is specified, it is in one of the following three forms:
                   queue
                   @server
                   queue@server

               If  the  destination argument names a queue and does not name a server, the job will be submitted
               to the named queue at the default server.

               If the destination argument names a server and does not name a queue, the job will  be  submitted
               to the default queue at the named server.

               If  the  destination  argument  names both a queue and a server, the job will be submitted to the
               named queue at the named server.

       -r y|n  Declares whether the job is rerunable.  See the qrerun command.  The option argument is a  single
               character, either y or n.

               If  the argument is "y", the job is rerunable.  If the argument is "n", the job is not rerunable.
               The default value is 'y', rerunable.

       -S path_list
               Declares the shell that interprets the job script.

               The option argument path_list is in the form:
                   path[@host][,path[@host],...]
               Only one path may be specified for any host named.  Only one path may be  specified  without  the
               corresponding  host  name.  The path selected will be the one with the host name that matched the
               name of the execution host.  If no matching host is found, then the path specified without a host
               will be selected, if present.

               If the -S option is not specified, the option argument is the null string, or no entry  from  the
               path_list is selected, the execution will use the user's login shell on the execution host.

       -t array_request
               Specifies the task ids of a job array.  Single task arrays are allowed.

               The array_request argument is an integer id or a range of integers. Multiple ids or id ranges can
               be combined in a comma delimted list. Examples : -t 1-100 or -t 1,10,50-100

       -T script_name
               Allows for per job prologue and epilogue scripts. The full script name will be prologue.[name] or
               epilogue.[name].  For  the  job  submission,  only  request  the name of the prologue or epilogue
               script.

               Example: qsub -T prescript
               Specifies to use the script prologue.prescript

       -u user_list
               Defines the user name under which the job is to run on the execution system.

               The user_list argument is of the form:
                   user[@host][,user[@host],...]
               Only one user name may be given per specified host.  Only one of the user specifications  may  be
               supplied without the corresponding host specification.  That user name will used for execution on
               any  host  not  named  in the argument list.  If unset, the user list defaults to the user who is
               running qsub.

       -v variable_list
               Expands the list of environment variables that are exported to the job.

               In addition to the variables described in the "Description" section  above,  variable_list  names
               environment  variables from the qsub command environment which are made available to the job when
               it executes.  The variable_list is a comma separated list of strings  of  the  form  variable  or
               variable=value.  These variables and their values are passed to the job.

       -V      Declares  that  all environment variables in the qsub command's environment are to be exported to
               the batch job.

       -w path Defines the working directory path to be used for the job.  If the -w option  is  not  specified,
               the  default  working  directory  is  the  current  directory.   This option sets the environment
               variable PBS_O_WORKDIR.

       -W additional_attributes
               The -W option allows for the specification of additional job attributes.  The general  syntax  of
               the -W is in the form:
                   -W attr_name=attr_value[,attr_name=attr_value...]
               Note  if  white  space  occurs anywhere within the option argument string or the equal sign, "=",
               occurs within an attribute_value string, then the string must be enclosed with either  single  or
               double quote marks.

               PBS currently supports the following attributes within the -W option.

               depend=dependency_list
               Defines the dependency between this and other jobs.  The dependency_list is in the form:
               type[:argument[:argument...][,type:argument...].
               The  argument  is  either  a  numeric count or a PBS job id according to type .  If argument is a
               count, it must be greater than 0.  If it is a  job  id  and  not  fully  specified  in  the  form
               seq_number.server.name,  it will be expanded according to the default server rules which apply to
               job IDs on most commands.  If argument is null (the preceding colon need not be  specified),  the
               dependency of the corresponding type is cleared (unset).

                   synccount:count
                       This  job  is  the  first in a set of jobs to be executed at the same time.  Count is the
                       number of additional jobs in the set.

                   syncwith:jobid
                       This job is an additional member of a set of jobs to be executed at the  same  time.   In
                       the above and following dependency types, jobid is the job identifier of the first job in
                       the set.

                   after:jobid[:jobid...]
                       This  job  may  be  scheduled  for  execution  at any point after jobs jobid have started
                       execution.

                   afterok:jobid[:jobid...]
                       This job may be scheduled for execution only after jobs jobid  have  terminated  with  no
                       errors.  See the csh warning under "Extended Description".

                   afternotok:jobid[:jobid...]
                       This  job  may  be  scheduled  for  execution  only after jobs jobid have terminated with
                       errors.  See the csh warning under "Extended Description".

                   afterany:jobid[:jobid...]
                       This job may be scheduled for execution after jobs jobid have terminated, with or without
                       errors.

                   on:count
                       This job may be scheduled for execution after count dependencies on other jobs have  been
                       satisfied.  This form is used in conjunction with one of the before forms, see below.

                   before:jobid[:jobid...]
                       When this job has begun execution, then jobs jobid... may begin.

                   beforeok:jobid[:jobid...]
                       If  this  job terminates execution without errors, then jobs jobid... may begin.  See the
                       csh warning under "Extended Description".

                   beforenotok:jobid[:jobid...]
                       If this job terminates execution with errors, then jobs jobid... may begin.  See the  csh
                       warning under "Extended Description".

                   beforeany:jobid[:jobid...]
                       When this job terminates execution, jobs jobid... may begin.

                       If  any  of  the  before  forms  are  used,  the  jobs referenced by jobid must have been
                       submitted with a dependency type of on.

                       If any of the before forms are used, the jobs referenced by  jobid  must  have  the  same
                       owner as the job being submitted.  Otherwise, the dependency is ignored.

                   Error  processing  of  the  existence,  state,  or  condition  of  the job on which the newly
                   submitted job is a deferred service, i.e. the check is performed after the job is queued.  If
                   an error is detected, the new job will be deleted by the server.  Mail will be  sent  to  the
                   job submitter stating the error.

                   Dependency examples:
                   qsub -W depend=afterok:123.big.iron.com /tmp/script
                   qsub -W depend=before:234.hunk1.com:235.hunk1.com /tmp/script

               group_list=g_list
               Defines  the  group  name  under  which  the  job  is to run on the execution system.  The g_list
               argument is of the form:
               group[@host][,group[@host],...]
               Only one group name may be given per specified host.  Only one of the group specifications may be
               supplied without the corresponding host specification.  That group name will used  for  execution
               on  any  host not named in the argument list.  If not set, the group_list defaults to the primary
               group of the user under which the job will be run.

               interactive=true
               If the interactive attribute is specified, the job is an interactive job.  The  -I  option  is  a
               alternative method of specifying this attribute.

               stagein=file_list
               stageout=file_list
               Specifies  which  files  are  staged  (copied)  in  before  job start or staged out after the job
               completes execution.  On completion of the job, all staged-in and staged-out  files  are  removed
               from the execution system.  The file_list is in the form
               local_file@hostname:remote_file[,...]
               regardless  of  the  direction  of  the copy.  The name local_file is the name of the file on the
               system where the job executed.  It may be an absolute path or relative to the home  directory  of
               the  user.   The name remote_file is the destination name on the host specified by hostname.  The
               name may be absolute or relative to the user's home directory on the destination host.   The  use
               of  wildcards  in  the file name is not recommended.  The file names map to a remote copy program
               (rcp) call on the execution system in the follow manner:
               For stagein:   rcp hostname:remote_file local_file
               For stageout:  rcp local_file hostname:remote_file
               Data staging examples:
               -W stagein=/tmp/input.txt@headnode:/home/user/input.txt
               -W stageout=/tmp/output.txt@headnode:/home/user/output.txt
               If TORQUE has been compiled with wordexp support, then variables can be  used  in  the  specified
               paths.  Currently only $PBS_JOBID, $HOME, and $TMPDIR are supported for stagein.

               umask=XXX
               Sets  umask  used  to  create  stdout  and  stderr spool files in pbs_mom spool directory. Values
               starting with 0 are treated as octal values, otherwise the value is treated as  a  decimal  umask
               value.

       -x      When  running an interactive job, the -x flag makes it so that the script won't be parsed for PBS
               directives, but instead will be a command that is launched once the interactive job has  started.
               The job will terminate at the completion of this command.

       -X      Enables X11 forwarding.  The DISPLAY environment variable must be set.

       -z      Directs  that  the  qsub  command  is  not to write the job identifier assigned to the job to the
               command's standard output.

OPERANDS

       The qsub command accepts a script operand that is the path to the script of the  job.   If  the  path  is
       relative, it will be expanded relative to the working directory of the qsub command.

       If  the script operand is not provided or the operand is the single character "-", the qsub command reads
       the script from standard input.  When the script is being read from Standard Input, qsub  will  copy  the
       file  to  a  temporary  file.  This temporary file is passed to the library interface routine pbs_submit.
       The temporary file is removed by qsub after pbs_submit returns or upon the  receipt  of  a  signal  which
       would cause qsub to terminate.

STANDARD INPUT

       The  qsub command reads the script for the job from standard input if the script operand is missing or is
       the single character "-".

INPUT FILES

       The script file is read by the qsub command.  Qsub acts upon any directives found in the script.

       When the job is created, a copy of the script file is made and that copy cannot be modified.

STANDARD OUTPUT

       Unless the -z option is set, the job identifier assigned to the job will be written to standard output if
       the job is successfully created.

STANDARD ERROR

       The qsub command will write a diagnostic message to standard error for each error occurrence.

ENVIRONMENT VARIABLES

       The values of some or all of the variables in the qsub command's environment are exported with  the  job,
       see the -v and -V options.

       The  environment variable PBS_DEFAULT defines the name of the default server.   Typically, it corresponds
       to the system name of the host on which the server is running.  If PBS_DEFAULT is not set, the default is
       defined by an administrator established file.

       The environment variable PBS_DPREFIX determines the prefix string  which  identifies  directives  in  the
       script.

       The  environment variable PBS_CLIENTRETRY defines the maximum number of seconds qsub will block.  See the
       -b option above.  Despite the name, currently qsub is the only client that supports this option.

TORQUE.CFG

       The torque.cfg file, located in PBS_SERVER_HOME (/var/spool/torque by default) controls the  behavior  of
       the qsub command. This file contains a list of parameters and values separated by whitespace

       QSUBSLEEP  takes  an  integer  operand  which specifies time to sleep when running qsub command.  Used to
       prevent users from overwhelming the scheduler.

       SUBMITFILTER specifies the path to the submit filter used to pre-process job submission. The default path
       is $(libexecdir)/qsub_filter, which  falls  back  to  /usr/local/sbin/torque_submitfilter  for  backwards
       compatibility. This torque.cfg parameter overrides this default.

       SERVERHOST specifies the value for the PBS_SERVER environment variable

       QSUBHOST specifies the hostname for the jobs QSUB_O_HOST variable

       QSUBSENDUID specifies a uid to use for the jobs PBS_O_UID variable

       XAUTHPATH specifies the path to xauth

       CLIENTRETRY specifies the integer seconds between retry attempts to communicate with pbs_server

       VALIDATEGROUP set this parameter to force qsub to verify the submitter's group id

       DEFAULTCKPT  specifies the default value for the jobs checkpoint attribute.  The user overrides this with
       the -c qsub option.

       VALIDATEPATH set this parameter to force qsub to validate local existence of a "-d" working directory

       RERUNNABLEBYDEFAULT this parameter specifies if a job is rerunnable by  default.  The  default  is  true,
       setting  this  to  false  causes  the  rerunnable  attribute value to be false unless the users specifies
       otherwise with the -r option

       FAULT_TOLERANT_BY_DEFAULT this parameter specifies if a job is fault tolerant by  default.   The  default
       value  for  the  fault_tolerant job attribute is false, setting this parameter to true causes the default
       value of the attribute to be true. The user can specify their preference with the -f qsub option.

       For example:
              QSUBSLEEP  2
              RERUNNABLEBYDEFAULT  false

EXTENDED DESCRIPTION

       Script Processing:

       A job script may consist of PBS directives, comments and executable statements.  A PBS directive provides
       a way of specifying job attributes in addition to the command line options.  For example:
              :
              #PBS -N Job_name
              #PBS -l walltime=10:30,mem=320kb
              #PBS -m be
              #
              step1 arg1 arg2
              step2 arg3 arg4

       The qsub command scans the lines of the script file for directives.  An initial line in the  script  that
       begins  with  the  characters  "#!" or the character ":" will be ignored and scanning will start with the
       next line.  Scanning will continue until the first executable line, that is a line that is not blank, not
       a directive line, nor a line whose first non white space  character  is  "#".   If  directives  occur  on
       subsequent lines, they will be ignored.

       A  line  in  the  script  file  will  be  processed  as  a directive to qsub if and only if the string of
       characters starting with the first non white space character on the line and of the same  length  as  the
       directive prefix matches the directive prefix.

       The  remainder of the directive line consists of the options to qsub in the same syntax as they appear on
       the command line.  The option character is to be preceded with the "-" character.

       If an option is present in both a directive and on the command line, that option  and  its  argument,  if
       any, will be ignored in the directive.  The command line takes precedence.

       If an option is present in a directive and not on the command line, that option and its argument, if any,
       will be processed as if it had occurred on the command line.

       The directive prefix string will be determined in order of preference from:

           The value of the -C option argument if the option is specified on the command line.

           The value of the environment variable PBS_DPREFIX if it is defined.

           The four character string #PBS.

       If the -C option is found in a directive in the script file, it will be ignored.

       User Authorization:

       When the user submits a job from a system other than the one on which the PBS Server is running, the name
       under which the job is to be executed is selected according to the rules listed under the -u option.  The
       user  submitting  the  job  must  be  authorized  to  run  the  job  under the execution user name.  This
       authorization is provided if

              (1)  The host on which qsub is run is trusted by the execution host (see /etc/hosts.equiv),

              (2)  The execution user has an .rhosts file naming the submitting user on the submitting host.

       C-Shell .logout File:

       The following warning applies for users of the c-shell, csh.  If the job is executed under the csh and  a
       .logout  file  exists in the home directory in which the job executes, the exit status of the job is that
       of the .logout script, not the job script.  This may impact any inter-job dependencies.  To preserve  the
       job  exit  status,  either  remove  the .logout file or place the following line as the first line in the
       .logout file
          set EXITVAL = $status
       and the following line as the last executable line in .logout
          exit $EXITVAL

       Interactive Jobs:

       If the -I option is specified on the command line or in a script directive, or if the  "interactive"  job
       attribute declared true via the -W option, -W interactive=true, either on the command line or in a script
       directive,  the  job is an interactive job.  The script will be processed for directives, but will not be
       included with the job.  When the job begins execution, all input to the job is from the terminal  session
       in which qsub is running.

       When  an  interactive  job  is  submitted, the qsub command will not terminate when the job is submitted.
       Qsub will remain running until the job terminates, is aborted, or the user interrupts qsub with an SIGINT
       (the control-C key).  If qsub is interrupted prior to job start, it will query  if  the  user  wishes  to
       exit.  If the user response "yes", qsub exits and the job is aborted.

       Once  the  interactive  job  has  started  execution, input to and output from the job pass through qsub.
       Keyboard generated interrupts are passed to the job.  Lines entered  that  begin  with  the  tilde  ('~')
       character and contain special sequences are escaped by qsub.  The recognized escape sequences are:

              ~.     Qsub terminates execution.  The batch job is also terminated.

              ~susp  Suspend  the  qsub  program if running under the C shell.  "susp" is the suspend character,
                     usually CNTL-Z.

              ~asusp Suspend the input half of qsub (terminal to job),  but  allow  output  to  continue  to  be
                     displayed.   Only  works  under  the  C shell.  "asusp" is the auxiliary suspend character,
                     usually CNTL-Y.

EXIT STATUS

       Upon successful processing, the qsub exit status will be a value of zero.

       If the qsub command fails, the command exits with a value greater than zero.

SEE ALSO

       qalter(1B), qdel(1B),  qhold(1B),  qmove(1B),  qmsg(1B),  qrerun(1B),  qrls(1B),  qselect(1B),  qsig(1B),
       qstat(1B),  pbs_connect(3B),  pbs_job_attributes(7B),  pbs_queue_attributes(7B), pbs_resources_irix5(7B),
       pbs_resources_sp2(7B),  pbs_resources_sunos4(7B),  pbs_resources_unicos8(7B),  pbs_server_attributes(7B),
       and pbs_server(8B)

Local                                                                                                   qsub(1B)