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



NNAAMMEE
       qrsub   - Submit an Advance Reservation (AR) to Grid Engine.

SSYYNNTTAAXX
       qqrrssuubb  [[--aa  ddaattee__ttiimmee]]  [[--AA aaccccoouunntt__ssttrriinngg]] [[--cckkpptt cckkpptt__nnaammee]] [[--dd ttiimmee]]
       [[--ee ddaattee__ttiimmee]] [[--hhee  yyeess||nnoo]]  [[--hheellpp]]  [[--ll  rreessoouurrccee__lliisstt]]  [[--nnooww]]  [[--MM
       uusseerr[[@@hhoosstt]],,......]]   [[--NN  aarr__nnaammee]]  [[--ww ee||vv]] [[--ppee ppee__nnaammee sslloott__rraannggee]] [[--qq
       wwcc__qquueeuuee__lliisstt]] [[--uu wwcc__uusseerr__lliisstt]]

DDEESSCCRRIIPPTTIIOONN
       _Q_r_s_u_b provides a means for operators, managers or users  referenced  in
       the  ACL (see _a_c_c_e_s_s___l_i_s_t(5)) "aarruusseerrss" 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 _q_r_d_e_l _.  In both cases, first all jobs requesting the
       AR will be removed and then AR itself. Already granted ARs can be shown
       with _q_r_s_t_a_t(.)

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

OOPPTTIIOONNSS
       --aa ddaattee__ttiimmee
              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 _s_g_e___t_y_p_e_s(1)

       --AA aaccccoouunntt__ssttrriinngg
              Identifies  the account to which the resource reservation of the
              AR should be charged. For "aaccccoouunntt__ssttrriinngg" value details  please
              see  the  "nnaammee"  definition in _s_g_e___t_y_p_e_s(1).  In the absence of
              this parameter Grid Engine will place the default account string
              "ge" in the accounting record of the AR.

       --cckkpptt cckkpptt__nnaammee
              Selects the checkpointing environment (see _c_h_e_c_k_p_o_i_n_t(5)) the AR
              jobs may request. Using this option guarantees queues that  only
              providing this checkpoint environment will be reserved.

       --dd ttiimmee
              Defines the duration of the AR. The use of "--dd ttiimmee" is optional
              if "--ee ddaattee__ttiimmee" is requested.  For details about  "ttiimmee" defi-
              nition please see _s_g_e___t_y_p_e_s(1).

       --ee ddaattee__ttiimmee
              Defines  the  end  date  and  time  of  an  AR.  The  use of "--ee
              ddaattee__ttiimmee" is optional if "--dd ttiimmee" is requested.   For  details
              about "ddaattee__ttiimmee" definition please see _s_g_e___t_y_p_e_s(1).

       --hhee yy[[eess]]||nn[[oo]]
              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, "--hhee yyeess", means as long as the  AR  is  in  error
              state  no  jobs  using the AR will be scheduled.  If soft error,
              "--hhee nnoo", is specified the AR stays usable  with  the  remaining
              resources.
              By default soft error handling is used.


       --hheellpp  Prints a list of all options.

       --ll rreessoouurrccee==vvaalluuee,...
              Creates  an  AR  in  a  Grid  Engine  queue, providing the given
              resource request list.   _c_o_m_p_l_e_x(5)  describes  how  a  list  of
              available  resources and their associated valid value specifiers
              can be obtained.
              There may be multiple --ll switches in a single command.

       --mm bb||ee||aa||nn
              Defines or redefines under which circumstances  mail  is  to  be
              sent  to the AR owner or to the users defined with the --MM option
              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 _q_r_s_u_b

       --MM uusseerr[[@@hhoosstt]],,......
              Defines  or  redefines  the  list  of users to which the qmaster
              sends mail.

       --mmaasstteerrqq wwcc__qquueeuuee__lliisstt
              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 _w_c___q_u_e_u_e___l_i_s_t can be found in _s_g_e___t_y_p_e_s(1).

       --nnooww yy[[eess]]||nn[[oo]]
              This options impacts the queues selection for reservation.
              With  the  "--nnooww yy" option, only queues with the qtype "INTERAC-
              TIVE" assigned will be considered for reservation.  "--nnooww nn"  is
              the default for _q_r_s_u_b.

       --NN nnaammee
              The  name  of  the  AR.  The name, if requested, must conform to
              "nnaammee" as defined in _s_g_e___t_y_p_e_s(1).  Invalid names will be denied
              at submit time.

       --ww ee||vv Specifies 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 _q_r_s_u_b

       --ppee ppaarraalllleell__eennvv nn[[--[[mm]]]]||[[--]]mm,,......
              Parallel programming environment (PE) to select for the AR queue
              reservation.  Please see the details of a PE in _s_g_e___p_e(5).

       --qq wwcc__qquueeuuee__lliisstt
              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 _w_c___q_u_e_u_e___l_i_s_t in  _s_g_e___t_y_p_e_s(1).   This  parameter
              has  all the properties of a resource request and will be merged
              with requirements derived from the --ll option described above.

       --uu [[uusseerrnnaammee||@@aacccceessss__lliisstt]],,......
              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 _a_c_c_e_s_s___l_i_s_t(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 _q_u_e_u_e___c_o_n_f(5)).

EENNVVIIRROONNMMEENNTTAALL VVAARRIIAABBLLEESS
       GGEE__RROOOOTT        Specifies  the location of the Grid Engine standard con-
                      figuration files.

       GGEE__CCEELLLL        If set, specifies  the  default  Grid  Engine  cell.  To
                      address  a Grid Engine cell, _q_s_u_b, _q_s_h, _q_l_o_g_i_n or _q_a_l_t_e_r
                      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. ddeeffaauulltt.

       GGEE__DDEEBBUUGG__LLEEVVEELL If 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.

       GGEE__QQMMAASSTTEERR__PPOORRTT
                      If set, specifies the TCP port on which _g_e___q_m_a_s_t_e_r(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.

FFIILLEESS
       _$_G_E___R_O_O_T_/_$_G_E___C_E_L_L_/_c_o_m_m_o_n_/_s_g_e___a_r___r_e_q_u_e_s_t
                     global defaults file
       _$_H_O_M_E_/_._s_g_e___a_r___r_e_q_u_e_s_t
                     user private defaults file

SSEEEE AALLSSOO
       _q_r_d_e_l(1), _q_r_s_t_a_t(1), _q_s_u_b(1), _s_g_e___t_y_p_e_s(1), _c_h_e_c_k_p_o_i_n_t(5),  _c_o_m_p_l_e_x(5),
       _q_u_e_u_e___c_o_n_f(5), _s_g_e___p_e(5), _s_g_e___r_e_s_o_u_r_c_e___q_u_o_t_a(5).

CCOOPPYYRRIIGGHHTT
       See _g_e___i_n_t_r_o(1) for a full statement of rights and permissions.




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