Changeset 1515 for palm/trunk/TUTORIAL/SOURCE/debugging.tex

Timestamp:

Jan 2, 2015 11:35:51 AM (9 years ago)

Author:

boeske

Message:

several updates in the tutorial

File:

• palm/trunk/TUTORIAL/SOURCE/debugging.tex (modified) (8 diffs)

palm/trunk/TUTORIAL/SOURCE/debugging.tex

@@ -6 +6 @@
 \usepackage{ngerman}
 \usepackage{pgf}
-\usetheme{Dresden}
 \usepackage{subfigure}
 \usepackage{units}
@@ -14 +13 @@
 \usepackage{xmpmulti}
 \usepackage{tikz}
-\usetikzlibrary{shapes,arrows,positioning,decorations.pathreplacing}
+\usetikzlibrary{shapes,arrows,positioning}
 \def\Tiny{\fontsize{4pt}{4pt}\selectfont}
-
-%---------- neue Pakete
 \usepackage{amsmath}
 \usepackage{amssymb}
 \usepackage{multicol}
 \usepackage{pdfcomment}
-\usepackage{xcolor}
-
-\institute{Institut fÌr Meteorologie und Klimatologie, Leibniz UniversitÀt Hannover}
+\usepackage{graphicx}
+\usepackage{listings}
+\lstset{showspaces=false,language=fortran,basicstyle=
+        \ttfamily,showstringspaces=false, captionpos=b,aboveskip=0pt,belowskip=0pt}
+
+
+\institute{Institute of Meteorology and Climatology, Leibniz UniversitÀt Hannover}
+\selectlanguage{english}
 \date{last update: \today}
 \event{PALM Seminar}
@@ -30 +32 @@
 \setbeamersize{text margin left=.5cm,text margin right=.2cm}
 \setbeamertemplate{footline}
-  {%
+  {
     \begin{beamercolorbox}[rightskip=-0.1cm]&
      {\includegraphics[height=0.65cm]{imuk_logo.pdf}\hfill \includegraphics[height=0.65cm]{luh_logo.pdf}}
     \end{beamercolorbox}
-    \begin{beamercolorbox}[ht=2.5ex,dp=1.125ex,%
-      leftskip=.3cm,rightskip=0.3cm plus1fil]{title in head/foot}%
-      {\leavevmode{\usebeamerfont{author in head/foot}\insertshortauthor} \hfill \eventname \hfill \insertframenumber \; / \inserttotalframenumber}%
-    \end{beamercolorbox}%
-%    \begin{beamercolorbox}[colsep=1.5pt]{lower separation line foot}%
-%    \end{beamercolorbox}
-  }%\logo{\includegraphics[width=0.3\textwidth]{luhimuk_logo.eps}}
+    \begin{beamercolorbox}[ht=2.5ex,dp=1.125ex,
+      leftskip=.3cm,rightskip=0.3cm plus1fil]{title in head/foot}
+      {\leavevmode{\usebeamerfont{author in head/foot}\insertshortauthor} \hfill \eventname \hfill \insertframenumber \; / \inserttotalframenumber}
+    \end{beamercolorbox}
+    \begin{beamercolorbox}[colsep=1.5pt]{lower separation line foot}
+    \end{beamercolorbox}
+  }
 
 \title[PALM - Debugging]{PALM - Debugging}
-\author{Siegfried Raasch}
+\author{PALM group}
 
 % Notes:
@@ -86 +88 @@
       \item<2->{\textbf{Find out the principal reason of the error(s):}}
       \begin{itemize}
+         \scriptsize
          \item<3->{ Carefully analyze the job protocol file (or messages on the terminal, in case of interactive runs) 
                for any error messages or unexpected behaviour.}
+               \vspace{1.5mm}
          \item<4->{In case of batch runs on a remote host, if the job protocol file is missing on the local host, 
                try if you can find it in {\tt $\sim$/job\_queue} on the remote host.}
+               \vspace{1.5mm}
          \item<5->{If the job has run into a time limit, no job protocol files or messages might be created at all (system depending).}
+               \vspace{1.5mm}
          \item<6->{Some typical errors which may occur during execution of mrun are automatically detected and displayed 
                by mrun in the job protocol or on the terminal: \\
                \par\medskip
                Respective error messages will begin with "'+++"'.} 
-         \item<7->{Compile and run time error messages will only appear in the job protocol or on the terminal (in case of interactive runs).}        
+               \vspace{1.5mm}
+         \item<7->{Compile and runtime error messages will only appear in the job protocol or on the terminal (in case of interactive runs).}
+               \vspace{1.5mm}
+         \item<8->{In case of runtime errors terminal messages may give first helpful hints about where errors are located.}        
       \end{itemize}
    \end{itemize}
@@ -122 +131 @@
 
 % Folie 5
-\begin{frame}
+\begin{frame}[fragile]
    \frametitle{Debugging Runtime Errors (II)}
    \small
-   \tikzstyle{box} = [rectangle, draw, text width=0.9\textwidth, font=\scriptsize]
-   \begin{itemize}
-      \item{The configuration file {\tt .mrun.config.default} looks like this:} 
-   \end{itemize}
-   \uncover<2->{
-   \begin{tikzpicture}      
-      \node[box](box){ \begin{tabbing} 
-         .\\
-         \# The next line is just an example. Add your own line below or replace this line. \\
-         \%host\_identifier \quad myhostname  \textless hi\textgreater \\
-         \# \\
-         \# The next block contains all informations for compiling the PALM code \\
-         \textbf{\# This is the block for the optimized version}
-         . \\
-         \%fopts \qquad \= -xS:-fpe0:-O3:-r8:... \qquad \textless hi\textgreater parallel \\
-         \%lopts \> -xS:-fpe0:-O3:-r8:... \qquad \textless hi\textgreater parallel \\
-         . \\
-         . \\
-         \textbf{\# This is the block for the debug version}
-         . \\
-         \%fopts \qquad \= -C:-fpe0:-debug:-traceback:-O0:... \qquad \textless hi\textgreater parallel \textbf{trace} \\
-         \%lopts \qquad \> -C:-fpe0:-debug:-traceback:-O0:... \qquad \textless hi\textgreater parallel \textbf{trace} \\
-         . \\
-        \end{tabbing}};
-   \end{tikzpicture}}
+   \tikzstyle{yellow} = [rectangle, draw, fill=yellow!30, text width=0.9\textwidth, font=\Tiny]
+   \tikzstyle{box} = [rectangle, draw, text width=0.95\textwidth, font=\scriptsize]
+   \begin{itemize}
+      \item{The configuration file {\tt .mrun.config.default} looks like this:} \\
+      \ \\
+      \onslide<2->
+      \begin{tikzpicture}
+         \node [yellow]{\begin{lstlisting}   
+.
+# The next line is just an example. Add your own line below or replace this line.
+%host_identifier   myhostname  lcmy
+#
+# The next block contains all informations for compiling the PALM code
+# This is the block for the optimized version
+%fopts             -I:<replace by mpi include path>:-fpe0:-O3:-xHost:...    <hi> parallel
+%lopts             -L:<replace by mpi library path>:-fpe0:-O3:-xHost:...    <hi> parallel
+.
+.
+# This is the block for the debug version
+%fopts             -C:-check:nooutput_conversion:-fpe0:-debug:...           <hi> parallel trace
+%lopts             -C:-check:nooutput_conversion:-fpe0:-debug:...           <hi> parallel trace
+.
+\end{lstlisting}
+         };
+      \end{tikzpicture}
+%   \begin{tikzpicture}      
+%      \node[box](box){ \begin{tabbing} 
+%         .\\
+%         \# The next line is just an example. Add your own line below or replace this line. \\
+%         \%host\_identifier \quad myhostname \quad lcmy \\
+%         \# \\
+%         \# The next block contains all informations for compiling the PALM code \\
+%         \textbf{\# This is the block for the optimized version}
+%         . \\
+%         \%fopts \quad \= -xS:-nbs:-convert:...   \qquad \= \textless hi\textgreater parallel \\
+%         \%lopts \> -xS:-nbs:-Vaxlib:-L:...        \> \textless hi\textgreater parallel \\
+%         . \\
+%         . \\
+%         \textbf{\# This is the block for the debug version}
+%         . \\
+%         \%fopts \quad \= -C:-check:nooutput\_conversion:-fpe0:-debug:-traceback:... \quad \textless hi\textgreater parallel \textbf{trace} \\
+%         \%lopts \quad \> -C:-check:nooutput\_conversion:-fpe0:-debug:-traceback:... \quad \textless hi\textgreater parallel \textbf{trace} \\
+%         . \\
+%        \end{tabbing}};
+%   \end{tikzpicture}
+   \end{itemize}
 \end{frame}
 
@@ -159 +189 @@
    \tikzstyle{green1} = [rectangle, draw, fill=green!75!black, text width=0.1\textwidth, font=\scriptsize]
    \tikzstyle{green2} = [rectangle, draw, fill=green!75!black, text width=0.15\textwidth, font=\scriptsize]
-   \tikzstyle{green3} = [rectangle, draw, fill=green!75!black, text width=0.35\textwidth, font=\scriptsize]
-   \tikzstyle{green4} = [rectangle, draw, fill=green!75!black, text width=0.4\textwidth, font=\scriptsize]
+   \tikzstyle{green3} = [rectangle, draw, fill=green!75!black, text width=0.34\textwidth, font=\scriptsize]
+   \tikzstyle{green4} = [rectangle, draw, fill=green!75!black, text width=0.41\textwidth, font=\scriptsize]
    \tikzstyle{line} = [draw, -]
    \tikzstyle{arrow} = [draw, -latex']
@@ -167 +197 @@
             The pre-compiled code will be put into different make depositories, one for each block:} 
    \end{itemize} 
+   \vspace{-5mm}
    \begin{center}
    \begin{tikzpicture} [auto]
@@ -218 +249 @@
          \footnotesize
          \item<4->{the print/write debugger}
-         \item<5->{debuggers like dbx or GUI-based debuggers like totalview \\(see \textbf{www.totalviewtech.com)}}
-         \item<6->{more detailed informations about using totalview on the HLRN system are given under:
+         \item<5->{debuggers like dbx or GUI-based debuggers like "'totalview"' or "'Allinea DDT"'}
+         \item<6->{more detailed informations about using Allinea DDT on the HLRN-III system are given under:
                \par\medskip 
-               \textbf{http://palm.muk.uni-hannover.de/wiki/doc/app/machine/hlrnII}}
+               \textbf{https://www.hlrn.de/home/view/System3/AllineaDDT}\\
+               \ \\}
+         \item<7->{\texttt{mrun}-script will soon be adjusted for allowing to use the "'Allinea DDT"' debugger.}
       \end{itemize}      
    \end{itemize}