source: palm/tags/release-3.2/DOC/app/chapter_3.6.html @ 818

Last change on this file since 818 was 62, checked in by raasch, 17 years ago

Id string added to all html files

  • Property svn:keywords set to Id
File size: 8.0 KB
Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html><head>
3<meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252"><title>PALM
4chapter 3.6</title> <meta name="GENERATOR" content="StarOffice 7 (Win32)"> <meta name="AUTHOR" content="Siegfried Raasch"> <meta name="CREATED" content="20040809;10583400"> <meta name="CHANGED" content="20041112;15013624"> <meta name="KEYWORDS" content="parallel LES model"> <style>
5<!--
6@page { size: 21cm 29.7cm }
7-->
8</style></head>
9<body style="direction: ltr;" lang="en-US"><h3 style="line-height: 100%;">3.6 Interactive mode and debugging</h3>
10<p style="line-height: 100%;">You can use <b>mrun</b>
11for running PALM
12in batch mode as well as for running it interactively. For interactive
13runs, you must (naturally) be logged in on the respective computer. For
14this computer the subroutines of the model must have
15been precompiled (see <a href="chapter_5.0.html">chapter
165.0</a>). Files containing user-defined code must be stored in
17the directory given by the variable<span style="font-family: Courier New,Courier,monospace;">
18%add_source_path </span>in the mrun-configuration file<span style="font-family: Courier New,Courier,monospace;">
19.mrun.config</span>.<span style="font-family: monospace;"></span>
20All output-files possibly
21created by the model and requested by the user to be kept after the run
22are copied to
23directories on the local host corresponding to the specifications
24in the configuration file (in this case the file attribute <a href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html#tr">tr</a>
25does not cause transfer to another computer). </p>
26<p style="line-height: 100%;">Since model runs usually
27require large
28amounts of CPU time, interactive runs may not be feasible, since
29in interactive mode CPU time
30is strongly limited on many hosts and runs will be aborted
31after the time limit has been exceeded. However, an interactive run
32makes sense if a suitable debugger is available,
33which may be used for error tracing in the model (here, error tracing
34in
35the user-defined software is meant). The preparations neccessary for
36debugging are described in the following. This
37description is limited to the IBM Regatta "hanni" and "berni" of the
38HLRN. </p>
39<p style="line-height: 100%;">If certain routines of the
40model
41are to be debugged for errors, the complete source code of
42the model, including the user-defined code, must be compiled
43with special debug compiler options. For this purpose, at least the
44following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration
45file:<br>
46</p><p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name&nbsp;&nbsp;&nbsp;&nbsp;
47mpxlf95_r&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
48ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
49<span style="font-family: Courier New,Courier,monospace;">%fopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
50-g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
51&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
52-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
53&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
54:invalid::enable:-qsigtrap&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
55ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
56<span style="font-family: Courier New,Courier,monospace;">%lopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
57-g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
58&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
59-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
60&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
61:invalid::enable:-qsigtrap:-lesslsmp&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
62ibmh parallel debug</span><br style="font-family: monospace;">
63<br></p>
64<p style="line-height: 100%;">(Attention: in the
65configuration file,
66the compiler and linker options (<span style="font-family: Courier New,Courier,monospace;">fopts
67</span>and<span style="font-family: Courier New,Courier,monospace;"> lopts</span>)
68must be
69written in one line without any blank space before and after the
70colons!)<br>
71</p><p style="line-height: 100%;">Using the compiler
72options "<span style="font-family: Courier New,Courier,monospace;">-g</span>"
73and "<span style="font-family: Courier New,Courier,monospace;">-C</span>",
74debugable code is created
75and check of array bounds is
76switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>"
77initializes all
78automatic variables (unfortunately not the global values of modules) to
79NaN.The "<span style="font-family: Courier New,Courier,monospace;">-qflttrap</span>"
80and "<span style="font-family: Courier New,Courier,monospace;">-qsigtrap</span>"
81options are needed
82in order to terminate the run in case of any floating point errors
83(otherwise the run will not terminate and errors can hardly be
84detected).<br>
85</p><p style="line-height: 100%;">The <b>mrun
86</b>call for debugging
87needs
88an extended argument for the option<span style="font-family: Courier New,Courier,monospace;"> </span><font style="font-size: 10pt; font-family: Courier New,Courier,monospace;" size="2">-K</font>:</p><div style="margin-left: 40px; font-family: Courier New,Courier,monospace;">mrun
89... -K &ldquo;parallel debug&rdquo; -s &rdquo;*.f90" ... .</div><p style="line-height: 100%;">The argument of option<span style="font-family: Courier New,Courier,monospace;"> -s </span><span style="font-family: Courier New,Courier,monospace;"></span>must
90list all source code files of the default PALM code. </p>
91<p style="line-height: 100%;">After compiling, the
92debugger
93<b>TotalView</b> is automatically called by <span style="font-weight: bold;">mrun</span>. With its
94assistance the user
95has to start
96the program execution manually, to set breakpoints, etc.. User manuals
97of <b>TotalView</b> are available <a href="http://www.hlrn.de/doc/totalview/index.html">online</a>.
98</p><p style="line-height: 100%;">Program crashes
99caused by errors in the
100user-defined code should usually be found
101unassisted. If the termination point lies outside the user code (in the
102default model code), the PALM&nbsp;group can be asked for
103assistance, but please do not expect any quick response. It is
104emphasized again that error tracing and programming
105of
106user-defined code requires more or less precise knowledge of the
107internal structure of PALM (see beginning of <a href="chapter_3.5.html">chapter
1083.5</a>). <br>
109&nbsp; </p>
110<hr><p style="line-height: 100%;"><br>
111<font color="#000080"><font color="#000080"><a href="chapter_3.5.5.html"><font color="#000080"><img src="left.gif" name="Grafik1" align="bottom" border="2" height="32" width="32"></font></a><a href="index.html"><font color="#000080"><img src="up.gif" name="Grafik2" align="bottom" border="2" height="32" width="32"></font></a><a href="chapter_3.7.html"><font color="#000080"><img src="right.gif" name="Grafik3" align="bottom" border="2" height="32" width="32"></font></a></font></font></p><p style="line-height: 100%;"><i>Last change:&nbsp;</i>
112$Id: chapter_3.6.html 62 2007-03-13 02:52:40Z maronga $</p>
113</body></html>
Note: See TracBrowser for help on using the repository browser.