← Back to branch summary

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

« back to all changes in this revision

Viewing changes to doc/man/man5/sge_request.5

  • 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/man5/sge_request.5
 
1
'\" t
 
2
.\"___INFO__MARK_BEGIN__
 
3
.\"
 
4
.\" Copyright: 2004 by Sun Microsystems, Inc.
 
5
.\"
 
6
.\"___INFO__MARK_END__
 
7
.\" $RCSfile$     Last Update: $Date$     Revision: $Revision$
 
8
.\"
 
9
.\"
 
10
.\" Some handy macro definitions [from Tom Christensen's man(1) manual page].
 
11
.\"
 
12
.de SB          \" small and bold
 
13
.if !"\\$1"" \\s-2\\fB\&\\$1\\s0\\fR\\$2 \\$3 \\$4 \\$5
 
14
..
 
15
.\"
 
16
.de T           \" switch to typewriter font
 
17
.ft CW          \" probably want CW if you don't have TA font
 
18
..
 
19
.\"
 
20
.de TY          \" put $1 in typewriter font
 
21
.if t .T
 
22
.if n ``\c
 
23
\\$1\c
 
24
.if t .ft P
 
25
.if n \&''\c
 
26
\\$2
 
27
..
 
28
.\"
 
29
.de M           \" man page reference
 
30
\\fI\\$1\\fR\\|(\\$2)\\$3
 
31
..
 
32
.TH xxQS_NAME_Sxx_REQUEST 5 "$Date$" "xxRELxx" "xxQS_NAMExx File Formats"
 
33
.\"
 
34
.SH NAME
 
35
xxqs_name_sxx_request \- xxQS_NAMExx default request definition file format
 
36
.\"
 
37
.\"
 
38
.SH DESCRIPTION
 
39
.I xxqs_name_sxx_request
 
40
reflects the format of the files to define default request profiles. If
 
41
available, default request files are read and processed during job
 
42
submission before any submit options embedded in the job script and
 
43
before any options in the
 
44
.M qsub 1
 
45
or
 
46
.M qsh 1
 
47
command-line are considered. Thus, the command-line and embedded script
 
48
options may overwrite the settings in the default request files (see
 
49
.M qsub 1
 
50
or
 
51
.M qsh 1
 
52
for details).
 
53
.PP
 
54
.PP
 
55
There is a cluster global, a user private and a working directory local
 
56
default request
 
57
definition file. The working directory local default request file has the
 
58
highest precedence and is followed by the user private and then the
 
59
cluster global default request file.
 
60
.PP
 
61
\fBNote\fP, that the
 
62
.I -clear
 
63
option to
 
64
.M qsub 1
 
65
or
 
66
.M qsh 1
 
67
can be used to discard any previous settings at any
 
68
time in a default request file, in the embedded script flags
 
69
or in a
 
70
.M qsub 1
 
71
or
 
72
.M qsh 1
 
73
command-line option.
 
74
.PP
 
75
.\"
 
76
.\"
 
77
.\"
 
78
The format of the default request definition files is:
 
79
.\"
 
80
.\"
 
81
.IP "\(bu" 3n
 
82
The default request files may contain an arbitrary number of lines.
 
83
Blank lines and lines with a '#' sign in the first column are skipped.
 
84
.\"
 
85
.\"
 
86
.IP "\(bu" 3n
 
87
Each line not to be skipped may contain any
 
88
.M qsub 1
 
89
option as described in
 
90
the xxQS_NAMExx Reference Manual. More than one option per line is
 
91
allowed. The batch script file and argument options to the batch script
 
92
are not considered as
 
93
.M qsub 1
 
94
options and thus are not allowed in a
 
95
default request file.
 
96
.\"
 
97
.\"
 
98
.\"
 
99
.SH "EXAMPLES"
 
100
.PP
 
101
The following is a simple example of a default request definition file:
 
102
.PP
 
103
.nf
 
104
 
 
105
=====================================================
 
106
# Default Requests File
 
107
 
 
108
# request group to be sun4 and a CPU-time of 5hr
 
109
-l arch=sun4,s_cpu=5:0:0
 
110
 
 
111
# don't restart the job in case of system crashes
 
112
-r n
 
113
=====================================================
 
114
 
 
115
.fi
 
116
.PP
 
117
Having defined a default request definition file like this and submitting a
 
118
job as follows:
 
119
.PP
 
120
.nf
 
121
qsub test.sh
 
122
.fi
 
123
.PP
 
124
would have precisely the same effect as if the job was submitted with:
 
125
.PP
 
126
.nf
 
127
qsub -l arch=sun4,s_cpu=5:0:0 -r n test.sh
 
128
.fi
 
129
.PP
 
130
.\"
 
131
.\"
 
132
.\"
 
133
.SH "FILES"
 
134
.nf
 
135
.ta \w'<xxqs_name_sxx_root>/   'u
 
136
\fI<xxqs_name_sxx_root>/<cell>/common/xxqs_name_sxx_request\fP
 
137
        global defaults file
 
138
.ta \w'$HOME/.xxqs_name_sxx_request   'u
 
139
\fI$HOME/.xxqs_name_sxx_request\fP      user private defaults file
 
140
\fI$cwd/.xxqs_name_sxx_request\fP       cwd directory defaults file
 
141
.fi
 
142
.\"
 
143
.\"
 
144
.\"
 
145
.SH "SEE ALSO"
 
146
.M xxqs_name_sxx_intro 1 ,
 
147
.M qsh 1 ,
 
148
.M qsub 1 ,
 
149
.I xxQS_NAMExx Installation and Administration Guide
 
150
.\"
 
151
.SH "COPYRIGHT"
 
152
See
 
153
.M xxqs_name_sxx_intro 1
 
154
for a full statement of rights and permissions.