1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
'\" t
.\"___INFO__MARK_BEGIN__
.\"
.\" Copyright: 2004 by Sun Microsystems, Inc.
.\"
.\"___INFO__MARK_END__
.\"
.\"
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
.\"
.de SB \" small and bold
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
..
.\" "
.de T \" switch to typewriter font
.ft CW \" probably want CW if you don't have TA font
..
.\"
.de TY \" put $1 in typewriter font
.if t .T
.if n ``\c
\\$1\c
.if t .ft P
.if n \&''\c
\\$2
..
.\"
.de M \" man page reference
\\fI\\$1\\fR\\|(\\$2)\\$3
..
.TH QRDEL 1 "2011-05-20" "xxRELxx" "xxQS_NAMExx User Commands"
.SH NAME
qrdel \- delete xxQS_NAMExx Advance Reservations (AR)
.SH SYNTAX
.B qrdel
.RB [ \-f ]
.RB [ \-help ]
.RB [ \-u
.IR wc_user_list ]
.I wc_ar_list
.\"
.\"
.SH DESCRIPTION
.I Qrdel
provides a means for a user/operator/manager to delete
one or more Advance Reservations (AR) referenced by numeric id or
name. A manager/operator can delete ARs belonging to any
user, while regular users can only delete their own ARs.
If a manager wants to delete another user's AR, the manager can specify
the AR id. By default, "qrdel wc_ar_name" will delete only the ARs belonging to
that user. A manager is able to delete another user's AR via "-u wc_user_list".
Jobs referring to an AR tagged for deletion will also be removed.
Only if all jobs referring to an AR are removed from the xxQS_NAMExx database
will the AR also be removed.
.I Qrdel
deletes ARs in the order in which the AR
identifiers are presented. Find additional information concerning
\fIwc_user_list\fP and \fIwc_ar_list\fP in
.M sge_types 5 .
.\"
.\"
.SH OPTIONS
.\"
.IP "\fB\-f\fP"
Force action. The AR and the jobs using the AR are deleted from the
xxQS_NAMExx queuing system even if the
.M xxqs_name_sxx_execd 8
controlling the AR jobs does not respond to the delete request sent by the
.M xxqs_name_sxx_qmaster 8 .
.br
Users who have with neither xxQS_NAMExx manager nor operator status
can only use the
.B \-f
option for their own ARs.
.\"
.IP "\fB\-help\fP"
Prints a list of all options.
.\"
.IP "\fB\-u wc_user_list\fP"
Deletes only those ARs which were submitted by
users specified in the list of usernames.
For managers, it is possible to use \fB\qrdel -u "*"\fP to delete
all ARs for all users. To delete a specific
AR for a user, a manager has to specify the user and the AR id. If no
AR is specified, all ARs belonging to that user are deleted.
.\"
.IP "\fBwc_ar_list\fP"
A list of ARs that should be deleted (either numeric or names assigned with
.BR "qrsub \-N" ).
.\"
.\"
.SH "ENVIRONMENT VARIABLES"
.\"
.IP "\fBxxQS_NAME_Sxx_ROOT\fP" 1.5i
Specifies the location of the xxQS_NAMExx standard configuration
files.
.\"
.IP "\fBxxQS_NAME_Sxx_CELL\fP" 1.5i
If set, specifies the default xxQS_NAMExx cell. To address a xxQS_NAMExx
cell
.I qrdel
uses (in the order of precedence):
.sp 1
.RS
.RS
The name of the cell specified in the environment
variable xxQS_NAME_Sxx_CELL, if it is set.
.sp 1
The name of the default cell, i.e. \fBdefault\fP.
.sp 1
.RE
.RE
.\"
.IP "\fBxxQS_NAME_Sxx_DEBUG_LEVEL\fP" 1.5i
If set, specifies that debug information
should be written to stderr. In addition the level of
detail in which debug information is generated is defined.
.\"
.IP "\fBxxQS_NAME_Sxx_QMASTER_PORT\fP" 1.5i
If set, specifies the tcp port on which the
.M xxqs_name_sxx_qmaster 8
is expected to listen for communication requests.
Most installations will use a service map entry for the
service "sge_qmaster" instead of defining the port.
.\"
.\"
.SH FILES
.nf
.ta \w'<xxqs_name_sxx_root>/ 'u
\fI<xxqs_name_sxx_root>/<cell>/common/act_qmaster\fP
xxQS_NAMExx master host file
.fi
.\"
.\"
.SH "SEE ALSO"
.M xxqs_name_sxx_intro 1 ,
.M qrstat 1 ,
.M qrsub 1 ,
.M qsub 1 ,
.M xxqs_name_sxx_qmaster 8 ,
.M xxqs_name_sxx_execd 8 .
.\"
.\"
.SH "COPYRIGHT"
See
.M xxqs_name_sxx_intro 1
for a full statement of rights and permissions.
|
