Home

Context Navigation

chapter_3.6.html @ 2101

Last change on this file since 2101 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

Rev	Line
[5]	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
[40]	2	<html><head>
[83]	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>
[62]	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>
	10	for running PALM
[5]	11	in batch mode as well as for running it interactively. For interactive
	12	runs, you must (naturally) be logged in on the respective computer. For
	13	this computer the subroutines of the model must have
	14	been precompiled (see <a href="chapter_5.0.html">chapter
[62]	15	5.0</a>). Files containing user-defined code must be stored in
	16	the 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>
	19	All output-files possibly
[5]	20	created by the model and requested by the user to be kept after the run
	21	are copied to
	22	directories on the local host corresponding to the specifications
[83]	23	in the configuration file (in this case the file attribute<span style="font-family: Courier New,Courier,monospace;"> tr </span>does not cause transfer to another computer). </p>
[62]	24	<p style="line-height: 100%;">Since model runs usually
	25	require large
[40]	26	amounts of CPU time, interactive runs may not be feasible, since
[5]	27	in interactive mode CPU time
	28	is strongly limited on many hosts and runs will be aborted
	29	after the time limit has been exceeded. However, an interactive run
	30	makes sense if a suitable debugger is available,
	31	which may be used for error tracing in the model (here, error tracing
	32	in
	33	the user-defined software is meant). The preparations neccessary for
	34	debugging are described in the following. This
	35	description is limited to the IBM Regatta "hanni" and "berni" of the
	36	HLRN. </p>
[62]	37	<p style="line-height: 100%;">If certain routines of the
	38	model
[5]	39	are to be debugged for errors, the complete source code of
	40	the model, including the user-defined code, must be compiled
	41	with special debug compiler options. For this purpose, at least the
[62]	42	following three lines must be included in the <span style="font-weight: bold;">mrun </span>configuration
	43	file:<br>
	44	</p><p style="line-height: 100%;"><span style="font-family: Courier New,Courier,monospace;">%compiler_name
[5]	45	mpxlf95_r
[40]	46	ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
	47	<span style="font-family: Courier New,Courier,monospace;">%fopts
	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;">
[5]	49
[40]	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;">
[5]	51
	52	:invalid::enable:-qsigtrap
[40]	53	ibmh parallel debug</span><br style="font-family: Courier New,Courier,monospace;">
	54	<span style="font-family: Courier New,Courier,monospace;">%lopts
	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;">
[5]	56
[40]	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;">
[5]	58
	59	:invalid::enable:-qsigtrap:-lesslsmp
	60	ibmh parallel debug</span><br style="font-family: monospace;">
[62]	61	<br></p>
	62	<p style="line-height: 100%;">(Attention: in the
	63	configuration file,
[40]	64	the compiler and linker options (<span style="font-family: Courier New,Courier,monospace;">fopts
[62]	65	</span>and<span style="font-family: Courier New,Courier,monospace;"> lopts</span>)
	66	must be
[5]	67	written in one line without any blank space before and after the
	68	colons!)<br>
[62]	69	</p><p style="line-height: 100%;">Using the compiler
	70	options "<span style="font-family: Courier New,Courier,monospace;">-g</span>"
	71	and "<span style="font-family: Courier New,Courier,monospace;">-C</span>",
	72	debugable code is created
[5]	73	and check of array bounds is
[62]	74	switched on during run time. Option "<span style="font-family: Courier New,Courier,monospace;">-qinitauto=FF</span>"
	75	initializes all
[5]	76	automatic variables (unfortunately not the global values of modules) to
[62]	77	NaN.The "<span style="font-family: Courier New,Courier,monospace;">-qflttrap</span>"
	78	and "<span style="font-family: Courier New,Courier,monospace;">-qsigtrap</span>"
	79	options are needed
[5]	80	in order to terminate the run in case of any floating point errors
	81	(otherwise the run will not terminate and errors can hardly be
	82	detected).<br>
[62]	83	</p><p style="line-height: 100%;">The <b>mrun
	84	</b>call for debugging
[5]	85	needs
[62]	86	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
	87	... -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
	88	list all source code files of the default PALM code. </p>
	89	<p style="line-height: 100%;">After compiling, the
	90	debugger
	91	<b>TotalView</b> is automatically called by <span style="font-weight: bold;">mrun</span>. With its
	92	assistance the user
[5]	93	has to start
	94	the program execution manually, to set breakpoints, etc.. User manuals
[62]	95	of <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
	97	caused by errors in the
[5]	98	user-defined code should usually be found
	99	unassisted. If the termination point lies outside the user code (in the
[40]	100	default model code), the PALM group can be asked for
[62]	101	assistance, but please do not expect any quick response. It is
	102	emphasized again that error tracing and programming
[5]	103	of
	104	user-defined code requires more or less precise knowledge of the
	105	internal structure of PALM (see beginning of <a href="chapter_3.5.html">chapter
	106	3.5</a>). <br>
	107	</p>
[62]	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: </i>
	110	$Id: chapter_3.6.html 83 2007-04-19 16:27:07Z suehring $</p>
[40]	111	</body></html>

Note: See TracBrowser for help on using the repository browser.

Context Navigation

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

Download in other formats: