Home


About us
PALM
PALM-4U
Installation
Release notes
Documentation
Getting Help
Gallery
Developers area

Ignore:
Timestamp:
Mar 13, 2007 2:52:40 AM (18 years ago)
Author:
raasch
Message:

Id string added to all html files

File:
1 edited

Legend:

Unmodified
Added
Removed

  • palm/trunk/DOC/app/chapter_3.6.html

    r54 r62  
    11<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
    22<html><head>
    3   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=windows-1252">
    4  
    5   <title>PALM chapter 3.6</title><meta name="GENERATOR" content="StarOffice 7  (Win32)">
    6   <meta name="AUTHOR" content="Siegfried Raasch">
    7   <meta name="CREATED" content="20040809;10583400">
    8   <meta name="CHANGED" content="20041112;15013624">
    9   <meta name="KEYWORDS" content="parallel LES model">
    10   <style>
    11         <!--
    12                 @page { size: 21cm 29.7cm }
    13         -->
    14         </style></head>
    15 
    16 <body dir="ltr" lang="en-US">
    17 <h3 style="line-height: 100%;">3.6 Interactive mode and debugging</h3>
    18 <p style="line-height: 100%;">You can use <b>mrun</b> for running PALM
     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
    1912in batch mode as well as for running it interactively. For interactive
    2013runs, you must (naturally) be logged in on the respective computer. For
    2114this computer the subroutines of the model must have
    2215been precompiled (see <a href="chapter_5.0.html">chapter
    23 5.0</a>). Files containing user-defined code must be stored in the directory given by the variable<span style="font-family: Courier New,Courier,monospace;"> %add_source_path </span>in the mrun-configuration file<span style="font-family: Courier New,Courier,monospace;"> .mrun.config</span>.<span style="font-family: monospace;"></span> All output-files possibly
     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
    2421created by the model and requested by the user to be kept after the run
    2522are copied to
    … …  
    2724in 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>
    2825does not cause transfer to another computer). </p>
    29 <p style="line-height: 100%;">Since model runs usually require large
     26<p style="line-height: 100%;">Since model runs usually
     27require large
    3028amounts of CPU time, interactive runs may not be feasible, since
    3129in interactive mode CPU time
    … …  
    3937description is limited to the IBM Regatta "hanni" and "berni" of the
    4038HLRN. </p>
    41 <p style="line-height: 100%;">If certain routines of the model
     39<p style="line-height: 100%;">If certain routines of the
     40model
    4241are to be debugged for errors, the complete source code of
    4342the model, including the user-defined code, must be compiled
    4443with special debug compiler options. For this purpose, at least the
    45 following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration file:<br>
    46 </p>
    47 <p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name&nbsp;&nbsp;&nbsp;&nbsp;
     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;
    4847mpxlf95_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;
    4948ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
    … …  
    6261:invalid::enable:-qsigtrap:-lesslsmp&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    6362ibmh parallel debug</span><br style="font-family: monospace;">
    64 <br>
    65 </p>
    66 <p style="line-height: 100%;">(Attention: in the configuration file,
     63<br></p>
     64<p style="line-height: 100%;">(Attention: in the
     65configuration file,
    6766the compiler and linker options (<span style="font-family: Courier New,Courier,monospace;">fopts
    68 </span>and<span style="font-family: Courier New,Courier,monospace;"> lopts</span>) must be
     67</span>and<span style="font-family: Courier New,Courier,monospace;"> lopts</span>)
     68must be
    6969written in one line without any blank space before and after the
    7070colons!)<br>
    71 </p>
    72 <p style="line-height: 100%;">Using the compiler options "<span style="font-family: Courier New,Courier,monospace;">-g</span>" and "<span style="font-family: Courier New,Courier,monospace;">-C</span>", debugable code is created
     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
    7375and check of array bounds is
    74 switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>" initializes all
     76switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>"
     77initializes all
    7578automatic variables (unfortunately not the global values of modules) to
    76 NaN.The "<span style="font-family: Courier New,Courier,monospace;">-qflttrap</span>" and "<span style="font-family: Courier New,Courier,monospace;">-qsigtrap</span>" options are needed
     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
    7782in order to terminate the run in case of any floating point errors
    7883(otherwise the run will not terminate and errors can hardly be
    7984detected).<br>
    80 </p>
    81 <p style="line-height: 100%;">The <b>mrun </b>call for debugging
     85</p><p style="line-height: 100%;">The <b>mrun
     86</b>call for debugging
    8287needs
    83 an 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 ... -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 list all source code files of the default PALM code. </p>
    84 <p style="line-height: 100%;">After compiling, the debugger
    85 <b>TotalView</b> is automatically called by <span style="font-weight: bold;">mrun</span>. With its assistance the user
     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
    8695has to start
    8796the program execution manually, to set breakpoints, etc.. User manuals
    88 of <b>TotalView</b> are available <a href="http://www.hlrn.de/doc/totalview/index.html">online</a>. </p>
    89 <p style="line-height: 100%;">Program crashes caused by errors in the
     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
    90100user-defined code should usually be found
    91101unassisted. If the termination point lies outside the user code (in the
    92102default model code), the PALM&nbsp;group can be asked for
    93 assistance, but please do not expect any quick response. It is emphasized again that error tracing and programming
     103assistance, but please do not expect any quick response. It is
     104emphasized again that error tracing and programming
    94105of
    95106user-defined code requires more or less precise knowledge of the
    … …  
    971083.5</a>). <br>
    98109&nbsp; </p>
    99 <hr>
    100 <p style="line-height: 100%;"><br>
    101 <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>
    102 <p style="line-height: 100%;"><i>Last change:&nbsp;</i> 02/03/07 (SR)</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$</p>
    103113</body></html>
Note: See TracChangeset for help on using the changeset viewer.
                                                                                                                                                                                                                                                                                                                                                                               
  | Impressum | ©Leibniz Universität Hannover |