← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/man/man1/qdel.1

  • 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/man/man1/qdel.1
 
1
'\" t
 
2
.\"___INFO__MARK_BEGIN__
 
3
.\"
 
4
.\" Copyright: 2004 by Sun Microsystems, Inc.
 
5
.\"
 
6
.\"___INFO__MARK_END__
 
7
.\"
 
8
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
 
9
.\"
 
10
.\"
 
11
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
 
12
.\"
 
13
.de SB          \" small and bold
 
14
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
 
15
..
 
16
.\"
 
17
.de T           \" switch to typewriter font
 
18
.ft CW          \" probably want CW if you don't have TA font
 
19
..
 
20
.\"
 
21
.de TY          \" put $1 in typewriter font
 
22
.if t .T
 
23
.if n ``\c
 
24
\\$1\c
 
25
.if t .ft P
 
26
.if n \&''\c
 
27
\\$2
 
28
..
 
29
.\"
 
30
.de M           \" man page reference
 
31
\\fI\\$1\\fR\\|(\\$2)\\$3
 
32
..
 
33
.TH QDEL 1 "$Date$" "xxRELxx" "xxQS_NAMExx User Commands"
 
34
.SH NAME
 
35
qdel \- delete xxQS_NAMExx jobs from queues
 
36
.SH SYNTAX
 
37
.B qdel
 
38
[
 
39
.B \-f
 
40
] [
 
41
.B \-help
 
42
] [
 
43
.B -u wc_user_list
 
44
] [
 
45
.B wc_job_range_list
 
46
]
 
47
.\" 
 
48
.SH DESCRIPTION
 
49
.I Qdel
 
50
provides a means for a user/operator/manager to delete
 
51
one or more jobs. A manager/operator can delete jobs belonging to any
 
52
user, while a regular user can only delete his or her own jobs.
 
53
If a manager wants to delete another user's job, the manager can specify
 
54
the job id. If the manager is using a job name or pattern, he or she
 
55
must also specify the user's name via "-u wc_user_list". A 
 
56
"qdel wc_job_name" will delete only the jobs of the 
 
57
calling user by default.
 
58
.I Qdel
 
59
deletes jobs in the order in which their job 
 
60
identifiers are presented. Find additional information concerning
 
61
\fIwc_user_list\fP and \fIwc_job_list\fP in
 
62
.M sge_types 1 .
 
63
.\"
 
64
.\"
 
65
.SH OPTIONS
 
66
.\"
 
67
.IP "\fB\-f\fP"
 
68
Force action for running jobs. The job(s) are deleted from the list of
 
69
jobs registered at
 
70
.M xxqs_name_sxx_qmaster 8
 
71
even if the
 
72
.M xxqs_name_sxx_execd 8
 
73
controlling the job(s) does not respond to the delete request sent by
 
74
.M xxqs_name_sxx_qmaster 8 .
 
75
.PP
 
76
Users which are neither xxQS_NAMExx managers nor operators can only use the
 
77
.B \-f
 
78
option (for their own jobs) if the cluster configuration entry
 
79
.B qmaster_params
 
80
contains the flag ENABLE_FORCED_QDEL (see
 
81
.M xxqs_name_sxx_conf 5 ).
 
82
However, behavior for administrative and
 
83
non-administrative users differs. Jobs are deleted from the xxQS_NAMExx
 
84
database immediately in case of administrators. Otherwise, a regular
 
85
deletion is attempted first and a forced cancellation is only executed if
 
86
the regular deletion was unsuccessful.
 
87
.\"
 
88
.IP "\fB\-help\fP"
 
89
Prints a listing of all options.
 
90
.\"
 
91
.IP "\fB\-u wc_user_list\fP"
 
92
Deletes only those jobs which were submitted by
 
93
users specified in the list of usernames.
 
94
For managers it is possible to use \fB\qdel -u "*"\fP to delete
 
95
all jobs of all users. If a manager wants to delete a specific
 
96
job of a user, he has to specify the user and the job. If no 
 
97
job is specified all jobs from that user are deleted.
 
98
.\"
 
99
.IP "\fBwc_job_range_list\fP"
 
100
A list of jobs, which should be deleted
 
101
.\"
 
102
.\"
 
103
.SH "ENVIRONMENTAL VARIABLES"
 
104
.\" 
 
105
.IP "\fBxxQS_NAME_Sxx_ROOT\fP" 1.5i
 
106
Specifies the location of the xxQS_NAMExx standard configuration
 
107
files.
 
108
.\"
 
109
.IP "\fBxxQS_NAME_Sxx_CELL\fP" 1.5i
 
110
If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx
 
111
cell
 
112
.I qdel
 
113
uses (in the order of precedence):
 
114
.sp 1
 
115
.RS
 
116
.RS
 
117
The name of the cell specified in the environment 
 
118
variable xxQS_NAME_Sxx_CELL, if it is set.
 
119
.sp 1
 
120
The name of the default cell, i.e. \fBdefault\fP.
 
121
.sp 1
 
122
.RE
 
123
.RE
 
124
.\"
 
125
.IP "\fBxxQS_NAME_Sxx_DEBUG_LEVEL\fP" 1.5i
 
126
If set, specifies that debug information
 
127
should be written to stderr. In addition the level of
 
128
detail in which debug information is generated is defined.
 
129
.\"
 
130
.IP "\fBxxQS_NAME_Sxx_QMASTER_PORT\fP" 1.5i
 
131
If set, specifies the tcp port on which
 
132
.M xxqs_name_sxx_qmaster 8
 
133
is expected to listen for communication requests.
 
134
Most installations will use a services map entry for the
 
135
service "sge_qmaster" instead to define that port.
 
136
.\"
 
137
.\"
 
138
.SH FILES
 
139
.nf
 
140
.ta \w'<xxqs_name_sxx_root>/     'u
 
141
\fI<xxqs_name_sxx_root>/<cell>/common/act_qmaster\fP
 
142
        xxQS_NAMExx master host file
 
143
.fi
 
144
.\"
 
145
.\"
 
146
.SH "SEE ALSO"
 
147
.M xxqs_name_sxx_intro 1 ,
 
148
.M qstat 1 ,
 
149
.M qsub 1 ,
 
150
.M xxqs_name_sxx_qmaster 8 ,
 
151
.M xxqs_name_sxx_execd 8 .
 
152
.\"
 
153
.\"
 
154
.SH "COPYRIGHT"
 
155
See
 
156
.M xxqs_name_sxx_intro 1
 
157
for a full statement of rights and permissions.