← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gridengine/utopic

« back to all changes in this revision

Viewing changes to doc/htmlman/htmlman1/qrls.html

  • Committer: Bazaar Package Importer
  • Author(s): Mark Hymers
  • Date: 2008-06-25 22:36:13 UTC
  • Revision ID: james.westby@ubuntu.com-20080625223613-tvd9xlhuoct9kyhm
Tags: upstream-6.2~beta2
Import upstream version 6.2~beta2

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/htmlman/htmlman1/qrls.html
 
1
<HTML>
 
2
<BODY BGCOLOR=white>
 
3
<PRE>
 
4
<!-- Manpage converted by man2html 3.0.1 -->
 
5
NAME
 
6
     qrls - release Grid Engine jobs from previous hold states
 
7
 
 
8
SYNTAX
 
9
     qrls [ -h {u|o|s},...  ] [ -help ] [ job/task_id_list ]
 
10
 
 
11
     qrls [ -h {u|o|s},...  ] [ -help ] -u user_list
 
12
 
 
13
DESCRIPTION
 
14
     <I>Qrls</I> provides a means for a user/operator/manager to release
 
15
     so  called  <I>holds</I>  from  one  or  more  jobs  pending  to be
 
16
     scheduled for execution.  As long as any  type  of  hold  is
 
17
     assigned to a job, the job is not eligible for scheduling.
 
18
 
 
19
     Holds can be assigned to jobs with the <B><A HREF="../htmlman1/qhold.html">qhold(1)</A></B>, <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>  or
 
20
     the <B><A HREF="../htmlman1/qalter.html">qalter(1)</A></B> command.
 
21
 
 
22
     There are three different types of holds:
 
23
 
 
24
     user User holds can be assigned  and  removed  by  managers,
 
25
          operators and the owner of the jobs.
 
26
 
 
27
     operator
 
28
          Operator holds can be assigned and removed by  managers
 
29
          and operators.
 
30
 
 
31
     system
 
32
          System holds can be assigned and  removed  by  managers
 
33
          only.
 
34
 
 
35
     If no hold type is specified with the -h option (see  below)
 
36
     the user hold is assumed by default.
 
37
 
 
38
     An alternate way to release holds is the  <B><A HREF="../htmlman1/qalter.html">qalter(1)</A></B>  command
 
39
     (see the -<I>h</I> option).
 
40
 
 
41
OPTIONS
 
42
     -h {u|o|s},...
 
43
          Releases a u(ser), o(perator) or s(system)  hold  or  a
 
44
          combination thereof from one or more jobs.
 
45
 
 
46
     -help
 
47
          Prints a listing of all options.
 
48
 
 
49
     -u username,...
 
50
          Modifies the hold state of those jobs which  were  sub-
 
51
          mitted  by  users  specified  in the list of usernames.
 
52
          Managers are allowed to use the qrls -u "*" command  to
 
53
          modify the hold state for jobs of all users.
 
54
 
 
55
          If a user uses the -u switch, the user may  specify  an
 
56
          additional <I>job</I>/<I>task</I>_<I>id</I>_<I>list</I>.
 
57
 
 
58
     job/task_id_list
 
59
          Specified by the following form:
 
60
 
 
61
              <I>job</I>_<I>id</I>[.<I>task</I>_<I>range</I>][,<I>job</I>_<I>id</I>[.<I>task</I>_<I>range</I>],...]
 
62
 
 
63
          If present, the <I>task</I>_<I>range</I> restricts the effect of  the
 
64
          operation to the array job task range specified as suf-
 
65
          fix to the job id (see the -t  option  to  <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>  for
 
66
          further details on array jobs).
 
67
 
 
68
          The task range specifier has the  form  n[-m[:s]].  The
 
69
          range  may  be a single number, a  simple range  of the
 
70
          form n-m or a range with a step size.
 
71
 
 
72
          Instead of <I>job</I>/<I>task</I>_<I>id</I>_<I>list</I> it is possible to  use  the
 
73
          keyword 'all' to modify all jobs of the current user.
 
74
 
 
75
ENVIRONMENTAL VARIABLES
 
76
     SGE_ROOT       Specifies the location  of  the  Grid  Engine
 
77
                    standard configuration files.
 
78
 
 
79
     SGE_CELL       If set, specifies  the  default  Grid  Engine
 
80
                    cell. To address a Grid Engine cell <I>qrls</I> uses
 
81
                    (in the order of precedence):
 
82
 
 
83
                         The name of the cell  specified  in  the
 
84
                         environment  variable SGE_CELL, if it is
 
85
                         set.
 
86
 
 
87
                         The  name  of  the  default  cell,  i.e.
 
88
                         default.
 
89
 
 
90
 
 
91
     SGE_DEBUG_LEVEL
 
92
                    If  set,  specifies  that  debug  information
 
93
                    should  be written to stderr. In addition the
 
94
                    level of detail in which debug information is
 
95
                    generated is defined.
 
96
 
 
97
     SGE_QMASTER_PORT
 
98
                    If set,  specifies  the  tcp  port  on  which
 
99
                    <B><A HREF="../htmlman8/sge_qmaster.html">sge_qmaster(8)</A></B> is expected to listen for com-
 
100
                    munication requests.  Most installations will
 
101
                    use  a  services  map  entry  for the service
 
102
                    "sge_qmaster" instead to define that port.
 
103
 
 
104
SEE ALSO
 
105
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>, <B><A HREF="../htmlman1/qalter.html">qalter(1)</A></B>, <B><A HREF="../htmlman1/qhold.html">qhold(1)</A></B>, <B><A HREF="../htmlman1/qsub.html">qsub(1)</A></B>.
 
106
 
 
107
COPYRIGHT
 
108
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
 
109
     sions.
 
110
</PRE>
 
111
<HR>
 
112
<ADDRESS>
 
113
Man(1) output converted with
 
114
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
 
115
</ADDRESS>
 
116
</BODY>
 
117
</HTML>