QRSUB(1)                   Grid Engine User Commands                  QRSUB(1)



[1mNAME[0m
       qrsub   - Submit an Advance Reservation (AR) to Grid Engine.

[1mSYNTAX[0m
       [1mqrsub  [-a  date_time]  [-A account_string] [-ckpt ckpt_name] [-d time][0m
       [1m[-e date_time] [-he  yes|no]  [-help]  [-l  resource_list]  [-now]  [-M[0m
       [1muser[@host],...]   [-N  ar_name]  [-w e|v] [-pe pe_name slot_range] [-q[0m
       [1mwc_queue_list] [-u wc_user_list][0m

[1mDESCRIPTION[0m
       [4mQrsub[24m provides a means for operators, managers or users  referenced  in
       the  ACL (see [4maccess_list[24m(5)) "[1marusers[22m" to create a Advance Reservation
       (AR) in the Grid Engine queuing system. ARs allow to reserve particular
       consumable  resources for future use. These reserved resources are only
       available for jobs requesting the AR  and  the  scheduler  ensures  the
       availability  of  the  resources  when  the  start time is reached. Job
       requesting the AR can only use the reserved consumable resources.

       During AR submit time the Grid Engine queuing system selects  the  best
       suited  queues  for the AR request and then reserves the desired amount
       of resources.  For a reservation, all queues that are not  in  orphaned
       state  are  considered  as  suited.  Only if the AR request can be ful-
       filled, the AR will be granted.

       ARs will be deleted either automatically when the end time is  reached,
       or manually using [4mqrdel[24m [4m.[24m  In both cases, first all jobs requesting the
       AR will be removed and then AR itself. Already granted ARs can be shown
       with [4mqrstat[24m(.)

       Note: To make AR behavior predictable, it is necessary to have reserved
       resources available at the time of AR start. This is  done  by  keeping
       jobs with a unlimited runtime limit separated from ARs, and not consid-
       ering resources used by such jobs for reservation.

       Note: Resource Quotas are not considered for AR queue selection and nor
       for jobs requesting a AR.

       When  an  AR  was  successfully added to the Grid Engine queuing system
       [4mqrsub[24m returns a unique integer ID referring the the newly  created  AR.
       The  highest  AR  ID  is 9999999. If the highest ID is reached, a wrap-
       around happens and the next unused ID, starting with 1, will be used.

       For [4mqrsub[24m, the administrator and the user may  define  default  request
       files  (analogous  to  Grid Engine_request for qsub), which can contain
       any of the possible command line options.
       A cluster wide default request file is optional.   If  such  a  default
       request file is used, it must be placed under
       $GE_ROOT/$GE_CELL/common/sge_ar_request (global defaults file).
       A user private default request file is optional. If it is used, it must
       be placed under
       $HOME/.sge_ar_request (user private defaults file).

[1mOPTIONS[0m
       [1m-a date_time[0m
              Defines the activation (start) date and  time  of  an  AR.   The
              option  is  not  mandatory. If omitted, the current date_time is
              assumed. Either a duration or end date_time must also be  speci-
              fied. For details about date_time please see [4msge_types[24m(1)

       [1m-A account_string[0m
              Identifies  the account to which the resource reservation of the
              AR should be charged. For "[1maccount_string[22m" value details  please
              see  the  "[1mname[22m"  definition in [4msge_types[24m(1).  In the absence of
              this parameter Grid Engine will place the default account string
              "ge" in the accounting record of the AR.

       [1m-ckpt ckpt_name[0m
              Selects the checkpointing environment (see [4mcheckpoint[24m(5)) the AR
              jobs may request. Using this option guarantees queues that  only
              providing this checkpoint environment will be reserved.

       [1m-d time[0m
              Defines the duration of the AR. The use of "[1m-d time[22m" is optional
              if "[1m-e date_time[22m" is requested.  For details about  "[1mtime[22m" defi-
              nition please see [4msge_types[24m(1).

       [1m-e date_time[0m
              Defines  the  end  date  and  time  of  an  AR.  The  use of "[1m-e[0m
              [1mdate_time[22m" is optional if "[1m-d time[22m" is requested.   For  details
              about "[1mdate_time[22m" definition please see [4msge_types[24m(1).

       [1m-he y[es]|n[o][0m
              Specifies the behavior when the AR goes into an error state. The
              AR goes into error state when a reserved host goes into  unknown
              state,  a  queue  error  happens, or when a queue is disabled or
              suspended.

              A hard error, "[1m-he yes[22m", means as long as the  AR  is  in  error
              state  no  jobs  using the AR will be scheduled.  If soft error,
              "[1m-he no[22m", is specified the AR stays usable  with  the  remaining
              resources.
              By default soft error handling is used.


       [1m-help  [22mPrints a list of all options.

       [1m-l resource=value[22m,...
              Creates  an  AR  in  a  Grid  Engine  queue, providing the given
              resource request list.   [4mcomplex[24m(5)  describes  how  a  list  of
              available  resources and their associated valid value specifiers
              can be obtained.
              There may be multiple [1m-l [22mswitches in a single command.

       [1m-m b|e|a|n[0m
              Defines or redefines under which circumstances  mail  is  to  be
              sent  to the AR owner or to the users defined with the [1m-M [22moption
              described below. The option arguments have the  following  mean-
              ing:

              `b'     Mail is sent at the beginning of the AR
              `e'     Mail is sent at the end of the AR
              `a'     Mail is sent when the AR goes into error state
              `n'     No mail is sent, default for [4mqrsub[0m

       [1m-M user[@host],...[0m
              Defines  or  redefines  the  list  of users to which the qmaster
              sends mail.

       [1m-masterq wc_queue_list[0m
              Only meaningful for a parallel AR request together with the  -pe
              option.

              This  option  is used to reserve the proper queues to match this
              request if it would be requested by a  qsub.   A  more  detailed
              description of [4mwc_queue_list[24m can be found in [4msge_types[24m(1).

       [1m-now y[es]|n[o][0m
              This options impacts the queues selection for reservation.
              With  the  "[1m-now y[22m" option, only queues with the qtype "INTERAC-
              TIVE" assigned will be considered for reservation.  "[1m-now n[22m"  is
              the default for [4mqrsub[24m.

       [1m-N name[0m
              The  name  of  the  AR.  The name, if requested, must conform to
              "[1mname[22m" as defined in [4msge_types[24m(1).  Invalid names will be denied
              at submit time.

       [1m-w e|v [22mSpecifies the validation level applied to the AR request.

              The specifiers e and v define the following validation modes:

              `v'  verify - does not submit the AR but prints
                   an extensive validation report
              `e'  error - rejects request if requirements cannot
                   be fulfilled, default for [4mqrsub[0m

       [1m-pe parallel_env n[-[m]]|[-]m,...[0m
              Parallel programming environment (PE) to select for the AR queue
              reservation.  Please see the details of a PE in [4msge_pe[24m(5).

       [1m-q wc_queue_list[0m
              Defines or redefines a list of cluster queues, queue domains  or
              queue  instances,  that may be reserved by the AR. Please find a
              description of [4mwc_queue_list[24m in  [4msge_types[24m(1).   This  parameter
              has  all the properties of a resource request and will be merged
              with requirements derived from the [1m-l [22moption described above.

       [1m-u [username|@access_list],...[0m
              Defines the users allowed to submit jobs requesting the AR.  The
              access  is  specified  by a comma separated list containing UNIX
              users or ACLs (see [4maccess_list[24m(5)).  prefixing the ACL name with
              an '@' sign.
              By  default only the AR owner is allowed to submit jobs request-
              ing the AR.

              Note: Only queues, where all users specified in  the  list  have
              access, are considered for reservation (see [4mqueue_conf[24m(5)).

[1mENVIRONMENTAL VARIABLES[0m
       [1mGE_ROOT        [22mSpecifies  the location of the Grid Engine standard con-
                      figuration files.

       [1mGE_CELL        [22mIf set, specifies  the  default  Grid  Engine  cell.  To
                      address  a Grid Engine cell, [4mqsub[24m, [4mqsh[24m, [4mqlogin[24m or [4mqalter[0m
                      use (in the order of precedence):

                             The name of the cell specified in the environment
                             variable GE_CELL, if it is set.

                             The name of the default cell, i.e. [1mdefault[22m.

       [1mGE_DEBUG_LEVEL [22mIf set, specifies that debug information should be writ-
                      ten to stderr. In addition the level of detail in  which
                      debug information is generated is defined.

       [1mGE_QMASTER_PORT[0m
                      If set, specifies the TCP port on which [4mge_qmaster[24m(8) is
                      expected to listen  for  communication  requests.   Most
                      installations will use a services map entry for the ser-
                      vice "sge_qmaster" instead of defining the port.

[1mFILES[0m
       [4m$GE_ROOT/$GE_CELL/common/sge_ar_request[0m
                     global defaults file
       [4m$HOME/.sge_ar_request[0m
                     user private defaults file

[1mSEE ALSO[0m
       [4mqrdel[24m(1), [4mqrstat[24m(1), [4mqsub[24m(1), [4msge_types[24m(1), [4mcheckpoint[24m(5),  [4mcomplex[24m(5),
       [4mqueue_conf[24m(5), [4msge_pe[24m(5), [4msge_resource_quota[24m(5).

[1mCOPYRIGHT[0m
       See [4mge_intro[24m(1) for a full statement of rights and permissions.




GE 6.2u2                 $Date: 2008/05/21 09:47:34 $                 QRSUB(1)
