Ignore:
Timestamp:
Mar 2, 2007 6:32:25 AM (15 years ago)
Author:
raasch
Message:

documentation update for the new svn-based version and for 3.1c, update of .mrun.config.default, -u in mbuild only compiles scripts

File:
1 edited

Legend:

Unmodified
Added
Removed
  • palm/trunk/DOC/app/chapter_3.6.html

    r5 r40  
    11<!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.6</title>
    7   <meta name="GENERATOR" content="StarOffice 7  (Win32)">
     2<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)">
    86  <meta name="AUTHOR" content="Siegfried Raasch">
    97  <meta name="CREATED" content="20040809;10583400">
     
    1412                @page { size: 21cm 29.7cm }
    1513        -->
    16         </style>
    17 </head>
     14        </style></head>
     15
    1816<body dir="ltr" lang="en-US">
    1917<h3 style="line-height: 100%;">3.6 Interactive mode and debugging</h3>
     
    2321this computer the subroutines of the model must have
    2422been precompiled (see <a href="chapter_5.0.html">chapter
    25 5.0</a>). Furthermore, the working directory
    26 (<tt><font style="font-size: 10pt;" size="2">~/palm/current_version/SOURCE</font></tt>)
    27 must contain all default source code files of the model (<span
    28  style="font-family: monospace;">*.f90</span>), the <b>mrun</b>
    29 configuration file (<span style="font-family: monospace;">.mrun.config</span>)
    30 the Makefile (<span style="font-family: monospace;">Makefile</span>)
    31 and the files which contain the user-defined code (the default
    32 user-interface file <span style="font-family: monospace;">user_interface.f90</span>
    33 have to be removed from the directory). All output-files possibly
     235.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
    3424created by the model and requested by the user to be kept after the run
    3525are copied to
    3626directories on the local host corresponding to the specifications
    37 in the configuration file (in this case the file attribute <a
    38  href="http://www.muk.uni-hannover.de/institut/software/mrun_beschreibung.html#tr">tr</a>
     27in 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>
    3928does not cause transfer to another computer). </p>
    4029<p style="line-height: 100%;">Since model runs usually require large
    41 amounts of CPU time, interactive runs are usually not feasible, since
     30amounts of CPU time, interactive runs may not be feasible, since
    4231in interactive mode CPU time
    4332is strongly limited on many hosts and runs will be aborted
     
    5443the model, including the user-defined code, must be compiled
    5544with special debug compiler options. For this purpose, at least the
    56 following three lines must be included in the <span
    57  style="font-weight: bold;">mrun </span>configuration file:<br>
     45following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration file:<br>
    5846</p>
    59 <p style="line-height: 100%;"><span style="font-family: monospace;">%compiler_name&nbsp;&nbsp;&nbsp;&nbsp;
     47<p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name&nbsp;&nbsp;&nbsp;&nbsp;
    6048mpxlf95_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;
    61 ibmh parallel debug</span><br style="font-family: monospace;">
    62 <span style="font-family: monospace;">%fopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    63 -g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:<br>
     49ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
     50<span style="font-family: Courier New,Courier,monospace;">%fopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
     51-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;">
    6452&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    65 -qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:<br>
     53-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
    6654&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    6755:invalid::enable:-qsigtrap&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    68 ibmh parallel debug</span><br style="font-family: monospace;">
    69 <span style="font-family: monospace;">%lopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    70 -g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:<br>
     56ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
     57<span style="font-family: Courier New,Courier,monospace;">%lopts&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
     58-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;">
    7159&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    72 -qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:<br>
     60-qarch=pwr4:-qnosave:-qnoescape:-qflttrap=overflow::zerodivide:</span><br style="font-family: Courier New,Courier,monospace;"><span style="font-family: Courier New,Courier,monospace;">
    7361&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
    7462:invalid::enable:-qsigtrap:-lesslsmp&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
     
    7765</p>
    7866<p style="line-height: 100%;">(Attention: in the configuration file,
    79 the compiler and linker options (<span style="font-family: monospace;">fopts</span>
    80 and <span style="font-family: monospace;">lopts</span>) must be
     67the 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
    8169written in one line without any blank space before and after the
    8270colons!)<br>
    8371</p>
    84 <p style="line-height: 100%;">Using the compiler options "<span
    85  style="font-family: monospace;">-g</span>" and "<span
    86  style="font-family: monospace;">-C</span>", debugable code is created
     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
    8773and check of array bounds is
    88 switched on during run time. Option "-qinitauto=FF" initializes all
     74switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>" initializes all
    8975automatic variables (unfortunately not the global values of modules) to
    90 NaN.The "<span style="font-family: monospace;">-qflttrap</span>" and "<span
    91  style="font-family: monospace;">-qsigtrap</span>" options are needed
     76NaN.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
    9277in order to terminate the run in case of any floating point errors
    9378(otherwise the run will not terminate and errors can hardly be
     
    9681<p style="line-height: 100%;">The <b>mrun </b>call for debugging
    9782needs
    98 an extended argument for the option <tt><font style="font-size: 10pt;"
    99  size="2">-K</font></tt><font style="font-size: 10pt;" size="2">:</font>
    100 </p>
    101 <ul>
    102   <p style="line-height: 100%;"><tt><font style="font-size: 10pt;"
    103  size="2">mrun ... -K “parallel debug” -s ”*.f90" ... .<br>
    104   </font></tt></p>
    105 </ul>
    106 <p style="line-height: 100%;">The argument of option <tt><font
    107  style="font-size: 10pt;" size="2">-s</font></tt>
    108 must list all source code files of the model. </p>
     83an 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>
    10984<p style="line-height: 100%;">After compiling, the debugger
    110 <b>TotalView</b> is automatically called by <span
    111  style="font-weight: bold;">mrun</span>. With its assistance the user
     85<b>TotalView</b> is automatically called by <span style="font-weight: bold;">mrun</span>. With its assistance the user
    11286has to start
    11387the program execution manually, to set breakpoints, etc.. User manuals
    114 of <b>TotalView</b> are available <a
    115  href="http://www.hlrn.de/doc/totalview/index.html">online</a>. </p>
     88of <b>TotalView</b> are available <a href="http://www.hlrn.de/doc/totalview/index.html">online</a>. </p>
    11689<p style="line-height: 100%;">Program crashes caused by errors in the
    11790user-defined code should usually be found
    11891unassisted. If the termination point lies outside the user code (in the
    119 default model code), the PALM developer group had possibly be asked for
    120 assistance. It is emphasized again that error tracing and programming
     92default model code), the PALM&nbsp;group can be asked for
     93assistance, but please do not expect any quick response. It is emphasized again that error tracing and programming
    12194of
    12295user-defined code requires more or less precise knowledge of the
     
    12699<hr>
    127100<p style="line-height: 100%;"><br>
    128 <font color="#000080"><font color="#000080"><a href="chapter_3.5.5.html"><font
    129  color="#000080"><img src="left.gif" name="Grafik1" align="bottom"
    130  border="2" height="32" width="32"></font></a><a href="index.html"><font
    131  color="#000080"><img src="up.gif" name="Grafik2" align="bottom"
    132  border="2" height="32" width="32"></font></a><a href="chapter_3.7.html"><font
    133  color="#000080"><img src="right.gif" name="Grafik3" align="bottom"
    134  border="2" height="32" width="32"></font></a></font></font></p>
    135 <p style="line-height: 100%;"><i>Last change:&nbsp;</i> 15/04/05 (SR)</p>
    136 </body>
    137 </html>
     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>
     103</body></html>
Note: See TracChangeset for help on using the changeset viewer.