source: palm/trunk/DOC/app/chapter_3.6.html @ 448

Last change on this file since 448 was 83, checked in by raasch, 18 years ago

New:
---

Changed:


PALM can be generally installed on any kind of Linux-, IBM-AIX-, or NEC-SX-system by adding appropriate settings to the configuration file.

Scripts are also running under the public domain ksh.

All system relevant compile and link options as well as the host identifier (local_host) are specified in the configuration file.

Filetransfer by ftp removed (options -f removed from mrun and mbuild).

Call of (system-)FLUSH routine moved to new routine local_flush.

return_addres and return_username are read from ENVPAR-NAMELIST-file instead of using local_getenv.

Preprocessor strings for different linux clusters changed to "lc", some preprocessor directives renamed (new: intel_openmp_bug), preprocessor directives for old systems removed

advec_particles, check_open, cpu_log, cpu_statistics, data_output_dvrp, flow_statistics, header, init_dvrp, init_particles, init_1d_model, init_dvrp, init_pegrid, local_getenv, local_system, local_tremain, local_tremain_ini, modules, palm, parin, run_control

new:
local_flush

mbuild, mrun

Errors:


  • Property svn:keywords set to Id
File size: 7.9 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 chapter 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>
4<!--
5@page { size: 21cm 29.7cm }
6-->
7</style></head>
8<body style="direction: ltr;" lang="en-US"><h3 style="line-height: 100%;">3.6 Interactive mode and debugging</h3>
9<p style="line-height: 100%;">You can use <b>mrun</b>
10for running PALM
11in batch mode as well as for running it interactively. For interactive
12runs, you must (naturally) be logged in on the respective computer. For
13this computer the subroutines of the model must have
14been precompiled (see <a href="chapter_5.0.html">chapter
155.0</a>). Files containing user-defined code must be stored in
16the directory given by the variable<span style="font-family: Courier New,Courier,monospace;">
17%add_source_path </span>in the mrun-configuration file<span style="font-family: Courier New,Courier,monospace;">
18.mrun.config</span>.<span style="font-family: monospace;"></span>
19All output-files possibly
20created by the model and requested by the user to be kept after the run
21are copied to
22directories on the local host corresponding to the specifications
23in the configuration file (in this case the file attribute<span style="font-family: Courier New,Courier,monospace;"> tr&nbsp;</span>does not cause transfer to another computer). </p>
24<p style="line-height: 100%;">Since model runs usually
25require large
26amounts of CPU time, interactive runs may not be feasible, since
27in interactive mode CPU time
28is strongly limited on many hosts and runs will be aborted
29after the time limit has been exceeded. However, an interactive run
30makes sense if a suitable debugger is available,
31which may be used for error tracing in the model (here, error tracing
32in
33the user-defined software is meant). The preparations neccessary for
34debugging are described in the following. This
35description is limited to the IBM Regatta "hanni" and "berni" of the
36HLRN. </p>
37<p style="line-height: 100%;">If certain routines of the
38model
39are to be debugged for errors, the complete source code of
40the model, including the user-defined code, must be compiled
41with special debug compiler options. For this purpose, at least the
42following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration
43file:<br>
44</p><p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name&nbsp;&nbsp;&nbsp;&nbsp;
45mpxlf95_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;
46ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
47<span style="font-family: Courier New,Courier,monospace;">%fopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
48-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;">
49&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
50-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</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:invalid::enable:-qsigtrap&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
53ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
54<span style="font-family: Courier New,Courier,monospace;">%lopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
55-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;">
56&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
57-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</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:invalid::enable:-qsigtrap:-lesslsmp&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
60ibmh parallel debug</span><br style="font-family: monospace;">
61<br></p>
62<p style="line-height: 100%;">(Attention: in the
63configuration file,
64the compiler and linker options (<span style="font-family: Courier New,Courier,monospace;">fopts
65</span>and<span style="font-family: Courier New,Courier,monospace;"> lopts</span>)
66must be
67written in one line without any blank space before and after the
68colons!)<br>
69</p><p style="line-height: 100%;">Using the compiler
70options "<span style="font-family: Courier New,Courier,monospace;">-g</span>"
71and "<span style="font-family: Courier New,Courier,monospace;">-C</span>",
72debugable code is created
73and check of array bounds is
74switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>"
75initializes all
76automatic variables (unfortunately not the global values of modules) to
77NaN.The "<span style="font-family: Courier New,Courier,monospace;">-qflttrap</span>"
78and "<span style="font-family: Courier New,Courier,monospace;">-qsigtrap</span>"
79options are needed
80in order to terminate the run in case of any floating point errors
81(otherwise the run will not terminate and errors can hardly be
82detected).<br>
83</p><p style="line-height: 100%;">The <b>mrun
84</b>call for debugging
85needs
86an 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
87... -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
88list all source code files of the default PALM code. </p>
89<p style="line-height: 100%;">After compiling, the
90debugger
91<b>TotalView</b> is automatically called by <span style="font-weight: bold;">mrun</span>. With its
92assistance the user
93has to start
94the program execution manually, to set breakpoints, etc.. User manuals
95of <b>TotalView</b> are available <a href="http://www.hlrn.de/doc/totalview/index.html">online</a>.
96</p><p style="line-height: 100%;">Program crashes
97caused by errors in the
98user-defined code should usually be found
99unassisted. If the termination point lies outside the user code (in the
100default model code), the PALM&nbsp;group can be asked for
101assistance, but please do not expect any quick response. It is
102emphasized again that error tracing and programming
103of
104user-defined code requires more or less precise knowledge of the
105internal structure of PALM (see beginning of <a href="chapter_3.5.html">chapter
1063.5</a>). <br>
107&nbsp; </p>
108<hr><p style="line-height: 100%;"><br>
109<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>
110$Id: chapter_3.6.html 83 2007-04-19 16:27:07Z raasch $</p>
111</body></html>
Note: See TracBrowser for help on using the repository browser.