1QHOLD(1)                   Grid Engine User Commands                  QHOLD(1)
2
3
4

NAME

6       qhold - hold back Grid Engine jobs from execution
7

SYNTAX

9       qhold [ -h {u|o|s},...  ] [ -help ] [ job/task_id_list ]
10
11       qhold [ -h {u|o|s},...  ] [ -help ] -u user_list
12

DESCRIPTION

14       qhold  provides  a means for a user/operator/manager to place so called
15       holds on one or more jobs pending to be scheduled  for  execution.   As
16       long  as any type of hold is assigned to a job, the job is not eligible
17       for scheduling.
18
19       Holds can be removed with the qrls(1) or the qalter(1) command.
20
21       There are three different types of holds:
22
23       user   User holds can be assigned and removed  by  managers,  operators
24              and the owner of the jobs.
25
26       operator
27              Operator holds can be assigned and removed by managers and oper‐
28              ators.
29
30       system System holds can be assigned and removed by managers only.
31
32       If no hold type is specified with the -h option (see  below)  the  user
33       hold is assumed by default.
34
35       An  alternate  way  to  assign holds to jobs is the qsub(1) or the qal‐
36       ter(1) command (see the -h option).
37

OPTIONS

39       -h {u|o|s},...
40              Assign a u(ser), o(perator) or s(system) hold or  a  combination
41              thereof to one or more jobs.
42
43       -help  Prints a listing of all options.
44
45       -u username,...
46              Changes  are  only  made  on  those jobs which were submitted by
47              users specified in the list of usernames.  Managers are  allowed
48              to  use  the  qhold -u "*" command to set a hold for all jobs of
49              all users.
50
51              If a user uses the -u switch, the user may specify an additional
52              job/task_id_list.
53
54       job/task_id_list
55              Specified by the following form:
56
57                  job_id[.task_range][,job_id[.task_range],...]
58
59              If  present,  the  task_range  restricts the effect of the qhold
60              operation to the array job task range specified as suffix to the
61              job  id  (see  the  -t  option to qsub(1) for further details on
62              array jobs).
63
64              The task range specifier has the form n[-m[:s]]. The  range  may
65              be  a single number, a  simple range  of the form n-m or a range
66              with a step size.
67
68              Instead of job/task_id_list it is possible to  use  the  keyword
69              'all' to modify the hold state for all jobs of the current user.
70

ENVIRONMENTAL VARIABLES

72       SGE_ROOT       Specifies  the location of the Grid Engine standard con‐
73                      figuration files.
74
75       SGE_CELL       If set, specifies  the  default  Grid  Engine  cell.  To
76                      address  a  Grid Engine cell qhold uses (in the order of
77                      precedence):
78
79                             The name of the cell specified in the environment
80                             variable SGE_CELL, if it is set.
81
82                             The name of the default cell, i.e. default.
83
84
85       SGE_DEBUG_LEVEL
86                      If set, specifies that debug information should be writ‐
87                      ten to stderr. In addition the level of detail in  which
88                      debug information is generated is defined.
89
90       SGE_QMASTER_PORT
91                      If  set,  specifies the tcp port on which sge_qmaster(8)
92                      is expected to listen for communication requests.   Most
93                      installations will use a services map entry for the ser‐
94                      vice "sge_qmaster" instead to define that port.
95

SEE ALSO

97       sge_intro(1), qalter(1), qrls(1), qsub(1).
98

100       See sge_intro(1) for a full statement of rights and permissions.
101
102
103
104GE 6.1                   $Date: 2007/06/26 22:21:08 $                 QHOLD(1)
Impressum