1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
---|
2 | <html> |
---|
3 | <head> |
---|
4 | <meta http-equiv="CONTENT-TYPE" |
---|
5 | content="text/html; charset=windows-1252"> |
---|
6 | <title>PALM chapter 3.1</title> |
---|
7 | <meta name="GENERATOR" content="StarOffice 7 (Win32)"> |
---|
8 | <meta name="AUTHOR" content="Marcus Oliver Letzel"> |
---|
9 | <meta name="CREATED" content="20040806;13565279"> |
---|
10 | <meta name="CHANGED" content="20040806;13575492"> |
---|
11 | <meta name="KEYWORDS" content="parallel LES model"> |
---|
12 | </head> |
---|
13 | <body dir="ltr" lang="de-DE"> |
---|
14 | <h3 style="line-height: 100%;">3.1 Job control with mrun</h3> |
---|
15 | <p style="line-height: 100%;">The start of model runs in principle |
---|
16 | takes place via executing the shell script <a |
---|
17 | href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html">mrun.</a> |
---|
18 | With this script it is possible to operate the model both |
---|
19 | interactively and in batch mode. Batch operation is possible on the |
---|
20 | local computer as well as on a remote computer (supposed that a batch |
---|
21 | queuing system is available). Here only the batch operation on a remote |
---|
22 | computer is |
---|
23 | described, because this represents the usual mode of operation due to |
---|
24 | the large computing time requirements of the model. The interactive |
---|
25 | execution differs only in some points and is described in <a |
---|
26 | href="chapter_3.6.html">chapter |
---|
27 | 3.6</a>. </p> |
---|
28 | <p style="line-height: 100%;">By the call of <b>mrun </b>a complete |
---|
29 | batch job is produced, transferred to the user determined remote |
---|
30 | computer |
---|
31 | and submitted to its queuing system (LoadLeveler, PBS, etc.). |
---|
32 | After processing of the job, the so-called job protocol is sent back |
---|
33 | to the local computer of the user (the local computer is the |
---|
34 | computer, on which the user calls <b>mrun</b>). The following actions |
---|
35 | are implemented by the job, amongst other: </p> |
---|
36 | <ul> |
---|
37 | <li> |
---|
38 | <p style="margin-bottom: 0cm; line-height: 100%;">Change to a |
---|
39 | temporary working directory. </p> |
---|
40 | </li> |
---|
41 | <li> |
---|
42 | <p style="margin-bottom: 0cm; line-height: 100%;">The input files |
---|
43 | needed by the model are copied into this directory. These files are |
---|
44 | transferred from the local computer. </p> |
---|
45 | </li> |
---|
46 | <li> |
---|
47 | <p style="margin-bottom: 0cm; line-height: 100%;">Execute the |
---|
48 | model. </p> |
---|
49 | </li> |
---|
50 | <li> |
---|
51 | <p style="margin-bottom: 0cm; line-height: 100%;">Copy the output |
---|
52 | files produced by the model into the directories determined by the user |
---|
53 | (these are also allowed to lie on the local computer). Depending on the |
---|
54 | choice of the user, the files may also be saved on an archiving system |
---|
55 | (if existing). </p> |
---|
56 | </li> |
---|
57 | <li> |
---|
58 | <p style="margin-bottom: 0cm; line-height: 100%;">Delete the |
---|
59 | temporary working direction. </p> |
---|
60 | </li> |
---|
61 | <li> |
---|
62 | <p style="line-height: 100%;">Transfer the job protocol to the |
---|
63 | local computer. </p> |
---|
64 | </li> |
---|
65 | </ul> |
---|
66 | <p style="line-height: 100%;">From this list it becomes clear that two |
---|
67 | of the substantial functions of <b>mrun</b> are the supply of input |
---|
68 | files for the model and the storage of output files produced by the |
---|
69 | model. The model exclusively works with so-called local files, which |
---|
70 | lie in the temporary working directory created by <b>mrun.</b> The |
---|
71 | local names of these files are determined by the model |
---|
72 | (in the appropriate OPEN instructions). In <a href="chapter_3.4.html">chapter |
---|
73 | 3.4</a> all possible input and output filenames are specified. In |
---|
74 | contrast to this, the input files, made available by the user, |
---|
75 | usually lie in permanent directories (e.g. in the /home directory) and |
---|
76 | the output data, produced by the model, may also be |
---|
77 | stored there. The directory names are arbitrary. The actual file name |
---|
78 | (without path) of these input and output files is specified by an |
---|
79 | option of <b>mrun</b>. All input and output files of the model |
---|
80 | receive this file name (e.g. <i>abcde</i>), but each individual file |
---|
81 | is still provided with an extension (e.g. <i>abcde_par</i>, etc. |
---|
82 | <i>abcde_dat</i>) - otherwise the files would not be distinguishable. |
---|
83 | The linkage of local file names with the names of the permanent |
---|
84 | directories and the file name extensions takes place in a |
---|
85 | configuration file, which <b>mrun</b> expects to find in the |
---|
86 | respective current working directory of the user. A detailed |
---|
87 | description of this configuration file - which still offers a variety |
---|
88 | of further functions is found in the |
---|
89 | documentation of the shell script <a |
---|
90 | href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html">mrun</a> |
---|
91 | (sorry: this is only available in German, so far. If you think that you |
---|
92 | would profit from an English version, please give a message to the PALM |
---|
93 | group). |
---|
94 | In the next chapter a simple example of a minimum configuration file |
---|
95 | is described. </p> |
---|
96 | <p style="line-height: 100%;">A simple call of <b>mrun</b> could read |
---|
97 | as follows: </p> |
---|
98 | <ul> |
---|
99 | <p style="line-height: 100%;"><tt>mrun - h <i>ibmh</i> -d <i>abcde</i></tt></p> |
---|
100 | </ul> |
---|
101 | <p style="line-height: 100%;">The model is started by option -<tt>h |
---|
102 | <i>ibmh</i></tt> on the IBM Regatta hanni at the HLRN, i.e. on the |
---|
103 | local computer a batch job is generated, transferred to the remote |
---|
104 | computer (IBM) and submitted to a suitable queue of the queuing system. |
---|
105 | With the |
---|
106 | option <tt>-d</tt> the so-called basis file name (<i>abcde</i>) is |
---|
107 | specified, from which, together with the path names and file name |
---|
108 | extensions, the complete file names (including the path) of the |
---|
109 | permanent input and output files are <font color="#000000">formed.</font><font |
---|
110 | color="#800000"> |
---|
111 | </font>Usually the specification of a set of further options is |
---|
112 | necessary, e.g. the CPU time needed by the model and the memory size |
---|
113 | needed as well as, on parallel computers, the number of processing |
---|
114 | elements which are to be used (options <tt>-t</tt>, <tt>-m</tt> and |
---|
115 | <tt>-X</tt>). A precondition for the call of <b>mrun</b> of course is |
---|
116 | that the installation of the model on the local computer and the |
---|
117 | remote machine is complete (see <a href="chapter_5.0.html">chapter |
---|
118 | 5.0</a>). </p> |
---|
119 | <p>Beyond these options a variety of further options for model |
---|
120 | steering can be used in the call of <b>mrun</b>. These are fully |
---|
121 | described in the <a |
---|
122 | href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html">mrun</a> |
---|
123 | documentation (in German). <br> |
---|
124 | </p> |
---|
125 | <hr> |
---|
126 | <p><a href="chapter_3.0.html"><font color="#000080"><img src="left.gif" |
---|
127 | name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a |
---|
128 | href="index.html"><font color="#000080"><img src="up.gif" |
---|
129 | name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a |
---|
130 | href="chapter_3.2.html"><font color="#000080"><img src="right.gif" |
---|
131 | name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></p> |
---|
132 | <p><i>Last change: </i> 14/04/05 (SR)</p> |
---|
133 | </body> |
---|
134 | </html> |
---|