Changeset 40 for palm/trunk/DOC/app/chapter_3.6.html
- Timestamp:
- Mar 2, 2007 6:32:25 AM (18 years ago)
- File:
-
- 1 edited
-
palm/trunk/DOC/app/chapter_3.6.html (modified) (7 diffs)
Legend:
- Unmodified
- Added
- Removed
-
palm/trunk/DOC/app/chapter_3.6.html
r5 r40 1 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.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)"> 8 6 <meta name="AUTHOR" content="Siegfried Raasch"> 9 7 <meta name="CREATED" content="20040809;10583400"> … … 14 12 @page { size: 21cm 29.7cm } 15 13 --> 16 </style> 17 </head> 14 </style></head> 15 18 16 <body dir="ltr" lang="en-US"> 19 17 <h3 style="line-height: 100%;">3.6 Interactive mode and debugging</h3> … … 23 21 this computer the subroutines of the model must have 24 22 been 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 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 34 24 created by the model and requested by the user to be kept after the run 35 25 are copied to 36 26 directories 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> 27 in 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> 39 28 does not cause transfer to another computer). </p> 40 29 <p style="line-height: 100%;">Since model runs usually require large 41 amounts of CPU time, interactive runs are usually notfeasible, since30 amounts of CPU time, interactive runs may not be feasible, since 42 31 in interactive mode CPU time 43 32 is strongly limited on many hosts and runs will be aborted … … 54 43 the model, including the user-defined code, must be compiled 55 44 with 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> 45 following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration file:<br> 58 46 </p> 59 <p style="line-height: 100%;"><span style="font-family: monospace;">%compiler_name 47 <p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name 60 48 mpxlf95_r 61 ibmh parallel debug</span><br style="font-family: monospace;">62 <span style="font-family: monospace;">%fopts 63 -g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:< br>49 ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;"> 50 <span style="font-family: Courier New,Courier,monospace;">%fopts 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;"> 64 52 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;"> 66 54 67 55 :invalid::enable:-qsigtrap 68 ibmh parallel debug</span><br style="font-family: monospace;">69 <span style="font-family: monospace;">%lopts 70 -g:-C:-qinitauto=FF:-qrealsize=8:-Q:-q64:-qmaxmem=-1:-qtune=pwr4:< br>56 ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;"> 57 <span style="font-family: Courier New,Courier,monospace;">%lopts 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;"> 71 59 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;"> 73 61 74 62 :invalid::enable:-qsigtrap:-lesslsmp … … 77 65 </p> 78 66 <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 be67 the 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 81 69 written in one line without any blank space before and after the 82 70 colons!)<br> 83 71 </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 87 73 and check of array bounds is 88 switched on during run time. Option " -qinitauto=FF" initializes all74 switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>" initializes all 89 75 automatic 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 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 92 77 in order to terminate the run in case of any floating point errors 93 78 (otherwise the run will not terminate and errors can hardly be … … 96 81 <p style="line-height: 100%;">The <b>mrun </b>call for debugging 97 82 needs 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> 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 “parallel debug” -s ”*.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> 109 84 <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 112 86 has to start 113 87 the 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> 88 of <b>TotalView</b> are available <a href="http://www.hlrn.de/doc/totalview/index.html">online</a>. </p> 116 89 <p style="line-height: 100%;">Program crashes caused by errors in the 117 90 user-defined code should usually be found 118 91 unassisted. If the termination point lies outside the user code (in the 119 default model code), the PALM developer group had possiblybe asked for120 assistance . It is emphasized again that error tracing and programming92 default model code), the PALM group can be asked for 93 assistance, but please do not expect any quick response. It is emphasized again that error tracing and programming 121 94 of 122 95 user-defined code requires more or less precise knowledge of the … … 126 99 <hr> 127 100 <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: </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: </i> 02/03/07 (SR)</p> 103 </body></html>
Note: See TracChangeset
for help on using the changeset viewer.
