Changeset 1289 for palm/trunk/SCRIPTS/mrun

Timestamp:

Mar 4, 2014 7:12:34 AM (10 years ago)

Author:

raasch

Message:

script comments translated to English
version update to 3.10

File:

• palm/trunk/SCRIPTS/mrun (modified) (215 diffs)

palm/trunk/SCRIPTS/mrun

@@ -22 +22 @@
 # Current revisions:
 # ------------------
-# 
+# comments translated to English
+# necriam-, fimm-, ibmy-, and sgi-specific code removed
+# export of variables for palm and interpret_config removed
 #
 # Former revisions:
@@ -143 +145 @@
 
  
-    # VARIABLENVEREINBARUNGEN + DEFAULTWERTE
-
- set +o allexport    # SICHERHEITSHALBER UNTERBINDEN, DA SONST EVTL. STAGEOUT
-                     # NICHT LAUEFT (TOO MANY ARGUMENTS - PROBLEM)
- set +o noclobber    # EXISTIERENDE DATEIEN DUERFEN UEBERSCHRIEBEN WERDEN
+    # DECLARATION OF VARIABLES AND THEIR DEFUALT VALUES
+
+ set +o allexport    # SUPPRESS EXPORT OF ALL VARIABLES, SINCE IN THE PAST THIS
+                     # LES TO PROBLEMS IN ROUTINES CALLED BY MRUN
+                     # (TOO MANY ARGUMENTS - PROBLEM)
+ set +o noclobber    # EXISTING FILES ARE ALLOWED TO BE OVERWRITTEN
 
  AddFilenames=""
@@ -182 +185 @@
  fftw_lib=""
  fftw_support=false
- fimm=false
- fname=test
+  fname=test
  fromhost=""
  global_revision=""
@@ -199 +201 @@
  link_local_output=false
  localhost_realname=$(hostname)
- local_compile=false
  local_dvrserver_running=.FALSE.
  locat=normal
@@ -223 +224 @@
  output_list=""
  package_list=""
- punkte="..........................................................."
  queue=none
  read_from_config=""
@@ -248 +248 @@
  run_coupled_model=false
  run_mode=""
- scirocco=false
  store_on_archive_system=false
- striche="  ----------------------------------------------------------------------------"
+ dashes="  ----------------------------------------------------------------------------"
  silent=false
  source_list=""
@@ -261 +260 @@
  usern=$LOGNAME
  use_openmp=false
- version="MRUN  2.0 Rev$Rev$"
+ version="MRUN  2.1 Rev$Rev$"
  working_directory=`pwd`
  TOPT=""
@@ -268 +267 @@
 
  typeset -i  iec=0 iic=0 iin=0 ioc=0 iout=0 stagein_anz=0 stageout_anz=0
- typeset -x -i  memory=0   # has to be exported here, otherwise an unknown side
-                           # effect may cause data loss when getopts is reading the
-                           # script-option arguments
+ typeset -x -i  memory=0   # HAS TO BE EXPORTED HERE, OTHERWISE AN UNKNOWN SIDE
+                           # SIDE EFFECT MAY CAUSE DATA LOSS WHEN GETOPTS IS READING THE
+                           # SCRIPT-OPTION ARGUMENTS
  typeset -i  cputime i ii iia iii iio icycle inode ival jobges jobsek last_char_int maxcycle minuten nodes pes remaining_pes sekunden tp1
 
 
 
-
-    # EINZELNE VARIABLE FUER HAUPTPROGRAMM EXPORTIEREN
- export  cpurest fname host localhost return_addres return_username remotecall tasks_per_node
-
-    # FOLGENDE VARIABLEN MUESSEN FUER DIE INTERPRETATION DER KONFIGURATIONSDATEI
-    # EXPORTIERT WERDEN
- export  afname config_file cpp_opts cpumax do_batch do_trace fname fromhost
- export  group_number input_list numprocs output_list queue run_mode
-
-
- 
-    # FEHLERBEHANDLUNG
-    # BEI EXIT:
+    # ERROR HANDLING IN CASE OF EXIT
  trap 'rm -rf  $working_directory/tmp_mrun
-       if [[ $locat != localhost ]]
-       then
-#          if [[ ! -f ${mrun_path}/statistik/mrun_statistik ]]
-#          then
-#             cat  >  ${mrun_path}/statistik/mrun_statistik  <<  %STATEND%
-#MRUN-calls on $localhost
-#
-#date and time                      user        localhost   remotehost  termination mrun-command
-#--------------------------------------------------------------------------------------------------------------------
-#%STATEND%
-#             chmod  666  ${mrun_path}/statistik/mrun_statistik
-#          fi
-#
-#             # EINTRAG IN DIE STATISTIK-DATEI
-#          string1=`date`                  #-L35
-#          string2=$usern                  #-L12
-#          string3=$localhost_realname     #-L12
-#          string4=$host                   #-L12
-#          string5=$locat                  #-L12
-#          if [[ "$job_on_file" = ""  &&  $locat != control_c  &&  $locat != user_abort ]]
-#          then
-#             if [[ $do_batch = true ]]
-#             then
-#                printf "$string1$string2$string3$string4$string5$mrun_com \n"  >>  ${mrun_path}/statistik/mrun_statistik
-#             else
-#                printf "$string1$string2$string3$string4$string5$mc \n"  >>  ${mrun_path}/statistik/mrun_statistik
-#             fi
-#          fi
-          echo " " > /dev/null
-       fi
-
-       if [[ $locat != normal  &&  $locat != control_c  &&  $locat != local_compile ]]
-       then
-
-              # EVENTUELLE ERROR-KOMMANDOS ABARBEITEN
+       if [[ $locat != normal  &&  $locat != control_c ]]
+       then
+
+              # CARRY OUT ERROR-COMMANDS GIVEN IN THE CONFIGURATION FILE (EC:)
           (( i = 0 ))
           while (( i < iec ))
@@ -363 +319 @@
 
 
-    # BEI TERMINAL-BREAK:
+    # ACTIONS IN CASE OF TERMINAL-BREAK (CONTROL-C):
  trap 'rm -rf  $working_directory/tmp_mrun
        rm -rf  $working_directory/tmp_check_namelist_files
@@ -394 +350 @@
 
 
-    # SHELLSCRIPT-OPTIONEN EINLESEN UND KOMMANDO NEU ZUSAMMENSETZEN, FALLS ES
-    # FUER FOLGEJOBS BENOETIGT WIRD
+    # READ SHELLSCRIPT-OPTIONS AND REBUILD THE MRUN-COMMAND STRING (MC),
+    # WHICH WILL BE USED TO START RESTART-JOBS
  while  getopts  :a:AbBc:Cd:D:Fg:G:h:H:i:IkK:m:M:n:o:O:p:P:q:r:R:s:St:T:u:U:vw:xX:yY:zZ option
  do
@@ -447 +403 @@
 
 
-    # EVTL. POSITIONSPARAMETER EINLESEN
-    # ZUR ZEIT GIBT ES NUR DEN PARAMETER ? (=KURZINFO)
+    # SKIP GIVEN OPTIONS TO READ POSITIONAL PARAMETER, IF GIVEN
+    # CURRENTLY ONLY PARAMETER ? (TO OUTPUT A SHORT COMMAND INFO) IS ALLOWED
  (( to_shift = $OPTIND - 1 ))
  shift $to_shift
 
-    # KURZE AUFRUFBESCHREIBUNG WIRD HIER AUSGEGEBEN
+    # PRINT SHORT DESCRIPTION OF MRUN OPTIONS
  if [[ "$1" = "?" ]]
  then
@@ -515 +471 @@
 
 
-    # KURZE STARTMELDUNG
+    # SHORT STARTING MESSAGE
  printf "\n*** $version "
  printf "\n    will be executed.     Please wait ..."
@@ -521 +477 @@
 
 
-    # PRUEFEN, OB KONFIGURATIONS-DATEI VORHANDEN
+    # CHECK, IF CONFIGURATION FILE EXISTS
  if [[ ! -f $config_file ]]
  then
@@ -531 +487 @@
 
 
-    # HOST-IDENTIFIER (local_host) AUS KONFIGURATIONSDATEI BESTIMMEN
+    # DETERMINE THE HOST-IDENTIFIER (localhost) FROM THE CONFIGURATION FILE
  line=""
  grep  "%host_identifier"  $config_file  >  tmp_mrun
@@ -559 +515 @@
 
 
-    # HOSTSPEZIFISCHE VARIABLEN SETZEN
+    # SET HOST-SPECIFIC VARIABLES
  case  $localhost_realname  in
      (r1*|r2*|h01*|b01*)     archive_system=tivoli;;
      (cs*)                   archive_system=ut;;
-     (fimm.bccs.uib.no)      fimm=true;;
-     (gate|n-sx)             PATH=$PALM_BIN:$PATH:/usr/bin/nqsII;;
-     (scirocco)              scirocco=true;;
  esac
 
 
- 
-    # BASISNAME DER INPUT-DATEIEN GLEICH ALLGEMEINEM BASISNAMEN SETZEN,
-    # WENN NICHT VOM BENUTZER ANDERS BESTIMMT
+    # ??? THIS SHOULD BE DECRIBED IN THE MRUN DOCUMENTATION ??? 
+    # SET BASENAME OF THE INPUT-FILES TO THE GENERAL BASENAME (GIVEN BY OPTION -d),
+    # IF IT HAS NOT BEEN SET BY THE USER DIFFERENTLY (USING OPTION -a)
  [[ "$afname" = "" ]]  &&  afname=$fname
 
 
-    # EVTL. RUN-MODUS DEN I/O-LISTEN HINZUFUEGEN
+    # ADD RUN-FILE ACTIVATION STRINGS (GIVEN BY OPTION -r) TO THE
+    # RESPECTIVE LISTS FOR ACTIVATING THE INPUT/OUTPUT FILE CONNECTION
+    # STATEMENTS IN THE CONFIGURATION FILE
  if [[ "$run_mode" != "" ]]
  then
@@ -583 +538 @@
 
 
-    # RECHNERNAMEN ABSPEICHERN, VON DEM AUS JOB GESTARTET WIRD,
-    # ALLERDINGS NUR DANN, WENN NICHT PER OPTION -H BEREITS EIN WERT
-    # ZUGEWIESEN WURDE (MRUN MACHT DIES IMMER, WENN ES SELBST BATCH-JOBS
-    # STARTET)
+    # ??? is this (and the respective option -H) really required ???
+    # STORE HOSTNAME, FROM WHICH THE JOB IS STARTED,
+    # BUT ONLY IF IT HASN'T BEEN ALREADY SET BY OPTION -H
+    # (MRUN IS AUTOMATICALLY SETTING THIS OPTION IN THE MRUN-CALLS WITHIN
+    # THOSE BATCH-JOBS, WHICH ARE CREATED BY MRUN ITSELF)
  if [[ "$fromhost" = "" ]]
  then
@@ -593 +549 @@
 
 
-    # PRUEFEN, OB AUF REMOTE-MASCHINE GERECHNET WERDEN SOLL
-    # WERT VON do_remote WIRD FUER DATEIVERBINDUNGEN BENOETIGT.
-    # WENN AUF REMOTE-MASCHINE GERECHNET WIRD, IST GLEICHZEITIG KLAR,
-    # DASS EIN BATCH-JOB GESTARTET WERDEN MUSS
+    # CHECK, IF EXECUTION SHALL TO BE DONE ON THE REMOTE-MACHINE.
+    # VALUE OF do_remote IS IMPORTANT FOR THE FILE CONNECTIONS.
+    # IN CASE OF EXECUTION ON A REMOTE-MACHINE, A BATCH-JOB HAS
+    # TO BE SUBMITTED (I.E. do_bacth=true)
  if [[ -n $host  &&  "$host" != $localhost ]]
  then
@@ -602 +558 @@
     do_remote=true
     case  $host  in
-        (ibm|ibmh|ibmkisti|ibmku|ibms|ibmy|nech|necriam|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|lcsgib|lcsgih|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
+        (ibm|ibmh|ibmkisti|ibmku|ibms|nech|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
         (*)  printf "\n"
              printf "\n  +++ sorry: execution of batch jobs on remote host \"$host\""
@@ -613 +569 @@
 
 
-     # ZUSATZBEDINGUNGEN (OPTION -K) AUSWERTEN
+     # EVALUATE ADDITIONAL CONDITIONS GIVEN BY OPTION -K
  if [[ -n $additional_conditions ]]
  then
-#    echo $additional_conditions | cut -d" " -f1-3 | read  cond1  cond2  dummy
     cond1=`echo $additional_conditions | cut -d" " -f1`
     cond2=`echo $additional_conditions | cut -d" " -s -f2`
@@ -630 +585 @@
 
 
-      # KOPPLUNGSEIGENSCHAFTEN (-Y) AUSWERTEN UND coupled_mode BESTIMMEN
+      # EVALUATE MODEL COUPLING FEATURES (OPTION -Y) AND DETERMINE coupled_mode
  if [[ $run_coupled_model = true ]] 
  then
 
-    if  [[ -n $coupled_dist ]]
-    then
-
-       numprocs_atmos=`echo $coupled_dist | cut -d" " -s -f1`
-       numprocs_ocean=`echo $coupled_dist | cut -d" " -s -f2`
-
-       if (( $numprocs_ocean + $numprocs_atmos != $numprocs ))
-       then
-
-          printf "\n  +++ number of processors does not fit to specification by \"-Y\"."
-          printf "\n      PEs (total)     : $numprocs"
-          printf "\n      PEs (atmosphere): $numprocs_atmos"
-          printf "\n      PEs (ocean)     : $numprocs_ocean"
-          locat=coupling; exit
-
-       fi
-
-    else
-
-       (( numprocs_ocean = $numprocs / 2 ))
-       (( numprocs_atmos = $numprocs / 2 ))
-
-    fi
-    coupled_dist=`echo "$numprocs_atmos $numprocs_ocean"`
+    numprocs_atmos=`echo $coupled_dist | cut -d" " -s -f1`
+    numprocs_ocean=`echo $coupled_dist | cut -d" " -s -f2`
+
+    if (( $numprocs_ocean + $numprocs_atmos != $numprocs ))
+    then
+
+       printf "\n  +++ number of processors does not fit to specification by \"-Y\"."
+       printf "\n      PEs (total)     : $numprocs"
+       printf "\n      PEs (atmosphere): $numprocs_atmos"
+       printf "\n      PEs (ocean)     : $numprocs_ocean"
+       locat=coupling; exit
+
+    fi
+
 
        # GET coupled_mode FROM THE CONFIG FILE
@@ -673 +618 @@
 
 
-    # PRUEFEN, OB EVTL. BEI VORHERGEHENDEM LAUF (KETTENJOB) EINE
-    # ARCHIVIERUNG FEHLGESCHLAGEN IST
+    # CHECK, IF FILE-ARCHIVING HAS FAILED IN PREVIOUS JOB (OF A JOB-CHAIN)
  if [[ -f ~/job_queue/ARCHIVE_ERROR_$fname ]]
  then
@@ -689 +633 @@
 
 
-    # WERTE VON MRUN-OPTIONEN SICHERN UND DAMIT GEGEBENENFALLS SPAETER DIE
-    # IN DER KONFIGURAIONSDATEI ANGEGEBENEN WERTE UEBERSTEUERN
+    # SAVE VALUES OF MRUN-OPTIONS SICHERN IN ORDER TO OVERWRITE
+    # THOSE VALUES GIVEN IN THE CONFIGURATION-FILE
  mrun_memory=$memory
  mrun_group_number=$group_number
@@ -697 +641 @@
 
 
-    # LESEN UND INTERPRETIEREN DER KONFIGURATIONS-DATEI VOM SHELLSCRIPT AUS
-    # VORUEBERGEHEND ZWINGEND AUF LINUX-RECHNERN
+    # READ AND EVALUATE THE CONFIGURATION-FILE FROM WITHIN THIS SHELLSCRIPT
+    # (OPTION -S). THE DEFAULT IS USING THE ROUTINE interpret_config
  if [[ "$read_from_config" = false ]]
  then
 
     [[ $silent = false ]]  &&  printf "\n    Reading the configuration file... "
+
+       # READ THE CONFIGURATION FILE LINE BY LINE
     while  read zeile
     do
@@ -708 +654 @@
 
 
-          # ZUERST EVENTUELL VORKOMMENDE ENVIRONMENT-VARIABLEN DURCH IHRE WERTE
-          # ERSETZEN
+          # FIRST REPLACE ENVIRONMENT-VARIABLES BY THEIR RESPECTIVE VALUES
        eval  zeile=\"$zeile\"
 
 
-          # INTERPRETATION DER ZEILE
+          # INTERPRET THE LINE
        if [[ "$(echo $zeile)" = "" ]]
        then
-             # LEERZEILE, KEINE AKTION
+             # EMPTY LINE, NO ACTION
           continue
 
@@ -722 +667 @@
        then
 
-             # ZEILE IST KOMMENTARZEILE
+             # LINE IS A COMMENT LINE
           true
 
@@ -728 +673 @@
        then
 
-             # ZEILE DEFINIERT ENVIRONMENT-VARIABLE
+             # LINE DEFINES AN ENVIRONMENT-VARIABLE
           zeile=$(echo $zeile | cut -c2-)
-#          echo $zeile | cut -d" " -f1-5 | read  var  value  for_host  for_cond1  for_cond2
           var=`echo $zeile | cut -d" " -f1`
           value=`echo $zeile | cut -d" " -s -f2`
@@ -740 +684 @@
           then
 
-                # BEI COMPILER- CPP- ODER LINKEROPTIONEN EVTL ":" DURCH " "
-                # ERSETZEN. "::" WIRD DURCH ":" ERSETZT.
+                # REPLACE ":" BY " " IN COMPILER- CPP- OR LINKER-OPTIONS,
+                # "::" IS REPLACED BY ":".
              value=`echo $value | sed 's/::/%DUM%/g' | sed 's/:/ /g' | sed 's/%DUM%/:/g'`
 
 
-                # ENVIRONMENT-VARIABLE WIRD WERT AUS KONFIGURATIONSDATEI
-                # ZUGEWIESEN, WENN SIE SELBST NOCH KEINEN WERT UEBER DIE
-                # ENTSPRECHENDE SCRIPT-OPTION ERHALTEN HAT. SOLCHE
-                # VARIABLEN HAETTEN DANN DEN WERT "" ODER IM INTEGER-FALL DEN
-                # WERT 0.  ALLGEMEINE REGEL ALSO: SCRIPT-OPTION GEHT UEBER
-                # KONFIGURATIONSDATEI
+                # VALUE FROM THE CONFIGURATION-FILE IS ASSIGNED TO THE
+                # ENVIRONMENT-VARIABLE, BUT ONLY IF NO VALUE HAS BEEN ALREADY
+                # ASSIGNED WITHIN THIS SCRIPT (E.G. BY SCRIPT-OPTIONS).
+                # NON-ASSIGNED VARIABLES HAVE VALUE "" OR 0 (IN CASE OF INTEGER).
+                # HENCE THE GENERAL RULE IS: SCRIPT-OPTION OVERWRITES THE
+                # CONFIGURATION-FILE.
              if [[ "$(eval echo \$$var)" = ""  ||  "$(eval echo \$$var)" = "0" ]]
              then
                 eval  $var=\$value
 
-                   # EVTL. BILDSCHIRMAUSGABEN DER ENVIRONMENT-VARIABLEN
+                   # TERMINAL OUTPUT OF ENVIRONMENT-VARIABLES, IF TRACEBACK IS SWITCHED on
                 if [[ $do_trace = true ]]
                 then
@@ -762 +706 @@
              fi
 
-                # WENN ENVIRONMENT-VARIABLE HOST VEREINBART, DANN SOFORT AUSWERTEN
-                # WERT VON do-remote WIRD BEI DATEIVERBINDUNGEN BENOETIGT
-                # WENN AUF REMOTE-MASCHINE GERECHNET WIRD, IST GLEICHZEITIG KLAR,
-                # DASS EIN BATCH-JOB GESTARTET WERDEN MUSS
+                # IF AN ENVIRONMENT-VARIABLE DETERMINES THE HOST, THEN EVALUATE IT IMMEDIATELY:
+                # VALUE OF do-remote IS REQUIRED FOR THE FILE CONNECTIONS (COPY OF I/O FILES).
+                # IF EXECUTION IS SCHEDULED FOR A REMOTE-MASCHINE, A BATCH-JOB
+                # MUST HAVE TO BE STARTED
              if [[ $var = host ]]
              then
@@ -773 +717 @@
                    do_remote=true
                    case  $host  in
-                       (ibm|ibmh|ibmkisti|ibmku|ibms|ibmy|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|lcsgib|lcsgih|nech|necriam|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
+                       (ibm|ibmh|ibmkisti|ibmku|ibms|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|nech|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
                        (*)  printf "\n  +++ sorry: execution of batch jobs on remote host \"$host\""
                             printf "\n      is not available"
@@ -783 +727 @@
              fi
 
-                # VOM BENUTZER DEFINIERTE ENVIRONMENT VARIABLEN MUESSEN PRINZIPIELL
-                # EXPORTIERT WERDEN, DA SIE VIELLEICHT IN WEITER UNTEN AUFZURUFEN-
-                # DEN PROGRAMMEN BENOETIGT WERDEN
+                # USER-DEFINED ENVIRONMENT VARIABLES MUST BE EXPORTED,
+                # BECAUSE THEY MAY BE REQUIRED IN OTHER SCRIPTS CALLED
+                # BY MRUN (E.G. subjob)
              export  $var
           fi
@@ -795 +739 @@
        then
 
-             # ZEILE DEFINIERT ERROR-KOMMANDO
+             # LINE DEFINES ERROR-COMMAND
           (( iec = iec + 1 ))
           zeile=$(echo $zeile | cut -c4-)
@@ -803 +747 @@
        then
 
-             # ZEILE DEFINIERT INPUT-KOMMANDO
+             # LINE DEFINES INPUT-COMMAND
           (( iic = iic + 1 ))
           zeile=$(echo $zeile | cut -c4-)
@@ -811 +755 @@
        then
 
-             # ZEILE DEFINIERT OUTPUT-KOMMANDO
+             # LINE DEFINES OUTPUT-COMMAND
           (( ioc = ioc + 1 ))
           zeile=$(echo $zeile | cut -c4-)
@@ -818 +762 @@
        else
 
-             # ZEILE DEFINIERT DATEIVERBINDUNG. EINLESEN DER DATEIEIGENSCHAFTEN
-             # s2a: in/out - Feld
-             # s2b: loc    - Feld (optional)
-             # s2c: tr/ar  - Feld (optional)
-#          echo $zeile | cut -d" " -f1-2 | read  s1  s2
+             # LINE DEFINES FILE CONNECTION. READ THE FILE ATTRIBUTES.
+             # s2a: in/out - field
+             # s2b: loc    - field (optional)
+             # s2c: tr/ar  - field (optional)
           s1=`echo $zeile | cut -d" " -f1`
           s2=`echo $zeile | cut -d" " -s -f2`
@@ -831 +774 @@
              s2c=""
           else
-#             echo $s2 | cut -d":" -f2-3 | sed 's/:/ /g' | read  s2b  s2c
              s2b=`echo $s2 | cut -d":" -f2 | sed 's/:/ /g'`
              s2c=`echo $s2 | cut -d":" -s -f3 | sed 's/:/ /g'`
           fi
-#          echo $zeile | cut -d" " -f3-6 | read  s3  s4  s5  s6
           s3=`echo $zeile | cut -d" " -f3`
           s4=`echo $zeile | cut -d" " -s -f4`
@@ -842 +783 @@
 
        
-             # ABSPEICHERN DER DATEIVERBINDUNG, FALLS IN INPUT- ODER OUTPUT-LIST
-             # VERMERKT. VARIABLE S3 KANN AUCH LISTE ENTHALTEN (FELDTRENNER ":")
-             # DATEIVERBINDUNG WIRD DANN NICHT ABGESPEICHERT UND GEPRUEFT, WENN
-             # PROGRAMMLAUF AUF REMOTE-MASCHINE ERFOLGT UND DATEI NUR LOKAL VOR-
-             # HANDEN SEIN MUSS (D.H. s2b = loc)
+             # STORE FILE CONNECTION, IF ACTIVATED BY ACTIVATION-STRING FROM
+             # INPUT- OR OUTPUT-LIST.
+             # VARIABLE S3 MAY CONTAIN A LIST OF ACTIVATION STRINGS (FIELD-SEPERATOR ":").
+             # IF EXECUTION IS SCHEDULED FOR A REMOTE-MACHINE AND THE FILE IS ONLY
+             # LOCALLY REQUIRED ON THAT MACHINE (I.E. s2b = loc), THE FILE CONNECTION
+             # IS NOT CHECKED AND STORED.
           IFSALT="$IFS"; IFS="$IFS:"
           if [[ "$s2a" = in  &&  ! ( $do_remote = true  &&  ( "$s2b" = loc  ||  "$s2b" = locopt ) ) ]]
@@ -894 +836 @@
 
 
-       # INTERPRETATION DER KONFIGURATIONSDATEI MITTELS FORTRAN 90 - PROGRAMM
+       # EVALUATE THE CONFIGURATION-FILE BY FORTRAN-PROGRAM
     [[ $silent = false ]]  &&  printf "..."
-    export  cond1 cond2 config_file do_remote do_trace input_list localhost output_list
-    export  interpreted_config_file=.icf.$RANDOM
-
-
-
-       # ENVIRONMENT-VARIABLEN FUER INTERPRET_CONFIG UEBER NAMELIST_DATEI ZUR
-       # VERFUEGUNG STELLEN
+    interpreted_config_file=.icf.$RANDOM
+
+
+
+       # PROVIDE VALUES OF ENVIRONMENT-VARIABLE FOR interpret_config VIA NAMELIST-FILE
     cat  >  .mrun_environment  <<  %%END%%
  &mrun_environment  cond1 = '$cond1', cond2 = '$cond2', 
@@ -912 +852 @@
 %%END%%
 
-    if [[ $localhost_realname = "sx-fep" ]]
-    then
-       /home/COAR/NC/raasch/pub/interpret_config_necriam.x
+    if [[ "$host" != $localhost ]]
+    then
+
+          # REMOTE JOB FROM LOCAL HOST: JUST TAKE THE FIRST EXECUTABLE FOUND
+       interpret_config_executable=`ls -1 ${PALM_BIN}/interpret_config*.x 2>/dev/null`
+       if [[ $? != 0 ]]
+       then
+          printf "\n\n  +++ no interpret_config found"
+          printf "\n      run \"mbuild -u -h ...\" to generate utilities for this host"
+          locat=interpret_config; exit
+       fi
+       interpret_config_executable=`echo $interpret_config_executable | cut -d" " -f1`
+       $interpret_config_executable
+
     else
 
-       if [[ "$host" != $localhost ]]
-       then
-
-             # REMOTE JOB FROM LOCAL HOST: JUST TAKE THE FIRST EXECUTABLE FOUND
-          interpret_config_executable=`ls -1 ${PALM_BIN}/interpret_config*.x 2>/dev/null`
-          if [[ $? != 0 ]]
-          then
-             printf "\n\n  +++ no interpret_config found"
-             printf "\n      run \"mbuild -u -h ...\" to generate utilities for this host"
-             locat=interpret_config; exit
-          fi
-          interpret_config_executable=`echo $interpret_config_executable | cut -d" " -f1`
-          $interpret_config_executable
-
+          # CHECK, IF THERE IS AN EXECUTABLE FOR THE BLOCK
+       if [[ ! -f ${PALM_BIN}/interpret_config${block}.x ]]
+       then
+          printf "\n\n  +++ no interpret_config found for given block \"$cond1 $cond2\""
+          printf "\n      run \"mbuild -u -h ...\" to generate utilities for this block"
+          locat=interpret_config; exit
        else
-
-             # CHECK, IF THERE IS AN EXECUTABLE FOR THE BLOCK
-          if [[ ! -f ${PALM_BIN}/interpret_config${block}.x ]]
-          then
-             printf "\n\n  +++ no interpret_config found for given block \"$cond1 $cond2\""
-             printf "\n      run \"mbuild -u -h ...\" to generate utilities for this block"
-             locat=interpret_config; exit
-          else
-             interpret_config${block}.x
-          fi
-
-       fi
+          interpret_config${block}.x
+       fi
+
     fi
     rm .mrun_environment
 
 
-       # AUSFUEHRUNG DER GENERIERTEN SHELL-KOMMANDOS IN DIESER SHELL
+       # EXECUTE SHELL-COMMANDS GENERATED BY interpret_config WITHIN THIS SHELL
     chmod  u+x  $interpreted_config_file
     export PATH=$PATH:.
@@ -957 +891 @@
 
 
-    # OPTIONSWERTE UEBERSTEUERN KONFIGURATIONSDATEI
+    # VALUES OF MRUN-OPTIONS OVERWRITE THOSE FROM THE CONFIGURATION-FILE
  [[ $mrun_memory     != 0   ]]  &&  memory=$mrun_memory
  [[ "$mrun_group_number" != "none" ]]  &&  group_number=$mrun_group_number
@@ -966 +900 @@
 
 
-    # QUELLTEXTVERZEICHNIS AUF LOKALER MASCHINE AUS KONFIGURATIONSDATEI
-    # BESTIMMEN (WUERDE SONST EVTL. DAS VERZEICHNIS DES JEWEILS UNTER -h
-    # ANGEGEBENEN REMOTE-RECHNERS SEIN)
-    # BEI BATCH-JOBS SIND DIE ZU UEBERSETZENDEN PROGRAMMTEILE SCHON KOMPLETT
+    # ON THE LOCAL MACHINE, DETERMINE (FROM THE CONFIGURATION-FILE) THE PATH
+    # FOR SOURCE-FILES TO BE COMPILED. 
+    # IN A BATCH-JOB, SOURCES (ROUTINES TO BE COMPILED) ARE COMPLETE ALREADY.
+    # BEFORE MRUN IS CALLED IN THE JOB, SOURCES_COMPLETE = true IS ASSIGNED (SEE FURTHER BELOW).
  if [[ "$SOURCES_COMPLETE" = "" ]]
  then
 
-       # ZUERST PRUEFEN, OB EIN GLOBALER QUELLTEXTPFAD FUER ALLE RECHNER
-       # VEREINBART WURDE
+       # FIRST CHECK, IF A GLOBAL SOURCE PATH (TO BE USED FOR ALL HOSTS)
+       # HAS BEEN DEFINED
     source_path=""
     line=""
@@ -1031 +965 @@
 
 
-    # GLOBALE REVISIONSNUMMER ERMITTELN (FORTSETZUNGSLAEUFEN WIRD DIESE
-    # DURCH OPTION -G MITGETEILT)
- if [[ "$global_revision" = ""   &&  $host != "ibmkisti" ]]
+    # GET THE GLOBAL REVISION-NUMBER OF THE SVN-REPOSITORY
+    # (HANDED OVER TO RESTART-RUNS USING OPTION -G)
+ if [[ "$global_revision" = ""  &&  $host != "ibmkisti" ]]
  then
     global_revision=`svnversion $source_path  2>/dev/null`
@@ -1040 +974 @@
 
 
-    # NOCHMAL PRUEFEN, OB AUF REMOTE-MASCHINE GERECHNET WERDEN SOLL
-    # (HOST KANN IN KONFIGURATIONSDATEI ANDERS FESTGELEGT WORDEN SEIN)
-    # WERT VON do_remote WIRD FUER DATEIVERBINDUNGEN BENOETIGT.
-    # WENN AUF REMOTE-MASCHINE GERECHNET WIRD, IST GLEICHZEITIG KLAR,
-    # DASS EIN BATCH-JOB GESTARTET WERDEN MUSS
+    # ??? das darf doch eigentlich garnicht passieren, weil optionen config-datei uebersteuern ???
+    # CHECK AGAIN, IF EXECUTION SHALL BE DONE ON A REMOTE-HOST (BATCH-JOB).
+    # (HOST MAY HAVE CHANGED DUE TO SETTINGS IN THE CONFIGURATION-FILE)
  if [[ -n $host  &&  "$host" != $localhost ]]
  then
@@ -1050 +982 @@
     do_remote=true
     case  $host  in
-        (ibm|ibmh|ibmkisti|ibmku|ibms|ibmy|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|lcsgib|lcsgih|nech|necriam|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
+        (ibm|ibmh|ibmkisti|ibmku|ibms|lccrayb|lccrayh|lccrayf|lcflow|lckyoto|nech|unics|lcxe6|lcxt5m|lck|lckiaps|lckordi|lckyuh|lckyut|lcsb)  true;;
         (*)  printf "\n"
              printf "\n  +++ sorry: execution of batch jobs on remote host \"$host\""
@@ -1061 +993 @@
 
 
-    # PRUEFUNG EINIGER PROZESSORZAHLANGABEN BEI RECHNUNGEN AUF PARALLELRECHNERN
+    # IN CASE OF PARALLEL EXECUTION, CHECK SOME SPECIFICATIONS CONCERNING PROCESSOR NUMBERS
  if [[ "$cond1" = parallel  ||  "$cond2" = parallel ]]
  then
 
-       # PRUEFEN, OB DIE ANZAHL DER ZU VERWENDENDEN PES ANGEGEBEN WURDE
+       # CHECK, IF NUMBER OF CORES TO BE USED HAS BEEN GIVEN
     if [[ ! -n $numprocs ]]
     then
@@ -1076 +1008 @@
     fi
 
-       # PRUEFEN, OB DIE PROZESSORANZAHL PRO KNOTEN ANGEGEBEN WURDE (GGF.
-       # DEFAULT-WERT SETZEN) UND OB SIE EIN GANZZAHLIGER TEILER DER
-       # GESAMTPROZESSORANZAHL IST
+       # CHECK, IF THE NUMBER OF CORES PER NODE HAS BEEN GIVEN UND IF IT IS AN
+       # INTEGRAL DIVISOR OF THE TOTAL NUMBER OF CORES GIVEN BY OPTION -X
     if [[ "$tasks_per_node" = ""  &&  $host != lcflow  &&  $host != lcxt5m ]]
     then
@@ -1114 +1045 @@
 
 
-       # IBMY HAT NUR EINEN KNOTEN
-    if [[ $host = ibmy ]]
-    then
-       if [[ "$tasks_per_node" != ""  &&  "$tasks_per_node" != "$numprocs" ]]
-       then
-          printf "\n"
-          printf "\n  +++ on ibmy, tasks per node (option \"-T\") must be equal to the"
-          printf "\n      total number of processors (option \"-X\")"
-          printf "\n      values of this mrun-call: \"-T $tasks_per_node\" \"-X $numprocs\""
-          locat=tasks_per_node; (( iec = 0 )); exit 
-       fi
-    fi
-
-
        # SETTINGS FOR SUBJOB-COMMAND
     OOPT="-O $threads_per_task"
 
-       # GESAMTZAHL DER KNOTEN BESTIMMEN
+       # SET THE TOTAL NUMBER OF NODES, REQUIRED FOR THE SUBJOB-COMMAND (SEE FURTHER BELOW)
     if [[ "$tasks_per_node" != "" ]]
     then
@@ -1137 +1054 @@
     fi
 
-       # PRUEFEN, OB NODE USAGE EINEN ERLAUBTEN WERT HAT BZW. DEN DEFAULT
-       # SETZEN
+       # CHECK node_usage FOR ALLOWED VALUES AND SET DEFAULT VALUE, IF NECESSARY
     if [[ $node_usage = default ]]
     then
@@ -1144 +1060 @@
        then
           node_usage=shared
-       elif [[ $(echo $host | cut -c1-5) = lcsgi ]]
-       then
-          node_usage=singlejob
        else
           node_usage=not_shared
@@ -1162 +1075 @@
  fi
 
-    # PRUEFEN, OB HOSTFILE EXISTIERT
+    # CHECK IF HOSTFILE EXISTS
  if [[ -n $hostfile ]]
  then
@@ -1173 +1086 @@
  fi
 
-    # PRUEFEN, OB RHOSTS DATEI EXISTIERT. GEGEBENENFALLS ANLEGEN BZW. ERWEITERN
- if [[ $host = ibmy  &&  $do_remote = false ]]
- then
-    if [[ ! -f $HOME/.rhosts ]]
-    then
-       echo  "gfdl5.yonsei.ac.kr"  >  $HOME/.rhosts
-       printf "\n\n  *** file:"
-       printf "\n           $HOME/.rhosts"
-       printf "\n      was created\n"
-    fi
-    if [[ $(grep -c gfdl5.yonsei.ac.kr $HOME/.rhosts) = 0 ]]
-    then
-       echo  "gfdl5.yonsei.ac.kr"  >>  $HOME/.rhosts
-       printf "\n\n  *** file:"
-       printf "\n           $HOME/.rhosts"
-       printf "\n      was extended by the name of the current host\n"
-    fi
- fi
-
-
-    # Set default value for the maximum number of parallel io streams
+
+    # SET DEFAULT VALUE FOR THE MAXIMUM NUMBER OF PARALLEL IO STREAMS
  if [[ "$maximum_parallel_io_streams" = "" ]]
  then
@@ -1200 +1094 @@
 
 
-    # Set port number option for calls of ssh/scp, subjob and batch_scp scripts
+    # SET PORT NUMBER OPTION FOR CALLS OF SSH/SCP, subjob AND batch_scp SCRIPTS
  if [[ "$scp_port" != "" ]]
  then
@@ -1208 +1102 @@
 
 
-    # FALLS NICHT VORGEGEBEN, DEFAULT-QUEUE AUF DER ZIELMASCHINE FESTLEGEN
+    # SET DEFAULT-QUEUE, IF NOT GIVEN
  if [[ $queue = none ]]
  then
@@ -1214 +1108 @@
         (ibmh)       queue=cluster;;
         (ibmkisti)   queue=class.32plus;;
-        (ibmy)       queue=parallel;;
         (lckiaps)    queue=normal;;
         (lckyoto)    queue=ph;;
         (lckyuh)     queue=fx-single;;
         (lckyut)     queue=cx-single;;
-        (lcsgib)     queue=testq;;
-        (lcsgih)     queue=testq;;
         (lctit)      queue=S;;
         (nech)       queue=none;;
-        (necriam)    queue=SP;;
         (unics)      queue=unics;;
     esac
@@ -1229 +1119 @@
 
 
-    # VOLLSTAENDIGE DATEINAMEN DER INPUT-FILES BILDEN,
-    # INPUT-DATEIEN AUF VORHANDENSEIN PRUEFEN UND EVTL. HOECHSTE ZYKLUSNUMMER
-    # ERMITTELN
+    # GENERATE FULL FILENAMES OF INPUT-FILES, INCLUDING THEIR PATH
+    # CHECK, IF INPUT-FILES EXIST, AND DETERMINE HIGHEST CYCLE NUMBER (IF CYCLES EXIST)
  (( i = 0 ))
  while (( i < iin ))
@@ -1238 +1127 @@
     (( maxcycle = 0 ))
 
-       # NAMENSBILDUNG (EVTL. IST FESTER DATEINAME VORGEGEBEN)
+       # GENERATE PATH AND FULL FILE NAME (then-BRANCH: FIXED FULL NAME IS GIVEN, I.E. THE
+       # FILE IDENTIFIER IS NOT PART OF THE FILENAME))
     if [[ "${actionin[$i]}" = di ]]
     then
-       remotepathin[$i]=${pathin[$i]}/${endin[$i]}  # REMOTE-PFAD ERST AUF
-                                                    # REM-MASCHINE AUSWERTEN
+       remotepathin[$i]=${pathin[$i]}/${endin[$i]}  # EVALUATE REMOTE-PATH ON THE REMOTE
+                                                    # HOST ONLY
        eval filename=${pathin[$i]}/${endin[$i]}
     else
-       remotepathin[$i]=${pathin[$i]}/${afname}${endin[$i]}  # REMOTE-PFAD ERST AUF
-                                                             # REM-MASCHINE AUSWERTEN
+       remotepathin[$i]=${pathin[$i]}/${afname}${endin[$i]}  # EVALUATE REMOTE-PATH ON THE REMOTE
+                                                             # HOST ONLY
        eval filename=${pathin[$i]}/${afname}${endin[$i]}
     fi
     eval pathname=${pathin[$i]}
 
-#   SAVE INPUT FILE NAME FOR PARAMETER FILE CHECK
+       # SAVE INPUT FILE NAME FOR PARAMETER FILE CHECK
     if [[ ("${transin[$i]}" = job) && (-f $filename) ]]
     then
@@ -1257 +1147 @@
     fi
 
-       # PRUEFEN AUF VORHANDENSEIN
+       # CHECK IF FILE EXISTS
     if [[ $(ls $filename* 2>&1 | grep -c "not found") = 1  || \
           $(ls $filename* 2>&1 | grep -c "nicht gefunden") = 1  || \
@@ -1263 +1153 @@
           $(ls $filename* 2>&1 | grep -c "does not exist") = 1 ]]
     then
-          # DATEIEN MIT EXTENSION (Z.B. NC) MUESSEN NICHT ZWINGEND VORHANDEN
-          # SEIN, DESHALB IN SOLCHEN FAELLEN KEIN ABBRUCH. DIES IST NUR EINE
-          # VORUEBERGEHENDE LOESUNG (OKT 05). NICHT ZWINGEND BENOETIGTE
-          # EINGABEDATEIEN SOLLTEN EINE SPEZIELLE OPTION IN DER DATEI-
-          # VERBINDUNGSANWEISUNG BEKOMMEN (Z.B. inopt?)
+
+          # FILES WITH ATTRIBUTE locopt ARE OPTIONAL. NO ABORT, IF THEY DO NOT EXIST.
        if [[ "${transin[$i]}" != "locopt" ]]
        then
@@ -1284 +1171 @@
     else
 
-          # ZYKLUSNUMMER FESTSTELLEN
+          # DETERMINE THE FILE'S CYCLE NUMBER
        ls -1 -d $filename    >   filelist  2>/dev/null
        ls -1 -d $filename.*  >>  filelist  2>/dev/null
@@ -1307 +1194 @@
        rm filelist
 
-          # EVTL. ZYKLUSNUMMER AN DATEINAMEN ANFUEGEN
+          # APPEND CYCLE NUMBER TO FILENAME
        if (( maxcycle > 0 ))
        then
@@ -1323 +1210 @@
        fi
        
-          # DATEINAMEN OHNE PFAD ABER MIT ZYKLUSNUMMER ABSPEICHERN,
-          # DA SPAETER BEI RUECKSPEICHERN VOM ARCHIVSYSTEM EVTL. BENOETIGT
+          # STORE FILENAME WITHOUT PATH BUT WITH CYCLE NUMBER,
+          # BECAUSE IT MIGHT BE REQUIRED LATER TO RESTORE THE FILE FROM AN ARCHIVE-SYSTEM
        absnamein[$i]=$filename
        if (( maxcycle > 0 ))
@@ -1346 +1233 @@
  done
     
-    # VOLLSTAENDIGE DATEINAMEN (OHNE $ ODER ~) DER OUTPUT-FILES BILDEN,
-    # OUTPUT-DATEIEN AUF VORHANDENSEIN PRUEFEN UND EVTL. HOECHSTE ZYKLUSNUMMER
-    # ERMITTELN ODER, FALLS NICHT VORHANDEN, PRUEFEN, OB SIE SICH ANLEGEN LASSEN
-    # DIESE AKTIONEN FINDEN NICHT STATT, WENN PROGRAMM AUF REMOTE-MASCHINE
-    # RECHNET UND DATEI ANSCHLIESSEND TRANSFERIERT WERDEN SOLL!
+    # GENERATE FULL FILENAMES OF OUTPUT-FILES (WITHOUT $ OR ~),
+    # CHECK, IF OUTPUT-FILES EXIST, AND DETERMINE HIGHEST CYCLE NUMBER (IF CYCLES EXIST),
+    # OR, IN CASE THAT FILE DOES NOT EXIST, CHECK, IF IT CAN BE CREATED  
+    # THESE ACTIONS ARE NOT CARRIED OUT, IF FILES SHALL BE TRASFERRED FROM THE REMOTE TO
+    # THE LOCAL HOST (BECAUSE THEIR IS NO DIRECT ACCESS TO THE LOCAL DIRECTORIES FROM THE
+    # REMOTE HOST)
  (( i = 0 ))
  while (( i < iout ))
@@ -1376 +1264 @@
        then
       
-             # OUTPUT-DATEI NICHT VORHANDEN. PRUEFEN, OB ANLEGEN MOEGLICH.
+             # IF OUTPUT-FILE DOES NOT EXIST CHECK, IF IT CAN BE CREATED
           if  cat /dev/null > $filename  
           then
@@ -1382 +1270 @@
           else
 
-                # PRUEFEN, OB KATALOG VORHANDEN UND EVTL. DIESEN ANLEGEN
+                # CHECK, IF THE DIRECTORY WHERE FILE SHALL BE COPIED TO EXISTS
+                # IF IT DOES NOT EXIST, TRY TO CREATE IT
              if [[ ! -d $catalogname ]]
              then
@@ -1408 +1297 @@
        else
 
-             # ZYKLUSNUMMER FESTSTELLEN
+             # DETERMINE THE CYCLE NUMBER
           ls -1 -d $filename    >   filelist  2>/dev/null
           ls -1 -d $filename.*  >>  filelist  2>/dev/null
@@ -1428 +1317 @@
        fi
 
-          # EVTL. ZYKLUSNUMMER AN DATEINAMEN ANFUEGEN UND PRUEFEN, OB SICH
-          # DATEI AUCH WIRKLICH ANLEGEN LAESST. IM APPEND-FALL MUSS AN DEN
-          # HOECHSTEN VORHANDENEN ZYKLUS-ANGEHAENGT WERDEN. ANLAGEPRUEFUNG
-          # IST DANN NATUERLICH NICHT ZULAESSIG BZW. MOEGLICH
+          # APPEND CYCLE NUMBER TO FILENAME AND CHECK, IF FILE CAN BE CREATED
+          # IN CASE OF FILE-APPEND, FILE MUST BE APPENDED TO THE ONE WITH HIGHEST CYCLE NUMBER
        if [[ "${actionout[$i]}" != a ]]
        then
@@ -1455 +1342 @@
        fi
        
-          # DATEINAMEN OHNE PFAD ABER MIT ZYKLUSNUMMER ABSPEICHERN,
-          # DA SPAETER BEI ABLAGE AUF ARCHIVSYSTEM BZW. FUER
-          # DATEI OUTPUT_FILE_CONNECTIONS EVTL. BENOETIGT
+          # STORE FILENAME WITHOUT PATH BUT WITH CYCLE NUMBER,
+          # BECAUSE IT MIGHT BE REQUIRED LATER TO STORE THE FILE ON AN ARCHIVE-SYSTEM
+          # OR TO PUT THIS FILENAME ON FILE OUTPUT_FILE_CONNECTIONS
        pathout[$i]=$filename
        if (( maxcycle > 0 ))
@@ -1470 +1357 @@
 
 
-     # DAS DVR-PAKET ERFORDERT EINE ENTSPRECHENDE BIBLIOTHEK
+     # THE DVR-PACKAGE REQUIRES ITS OWN LIBRARY
  if [[ $(echo $package_list | grep -c dvrp_graphics) != 0 ]]
  then
@@ -1488 +1375 @@
 
 
-     # PRUEFEN, OB ENTWEDER HAUPTPROGRAMM ODER NUR EIN AUSFUEHRBARES
-     # PROGRAMM VEREINBART WURDE (IN DIESEM FALL BRAUCHT IM WEITEREN NICHT
-     # UEBERSETZT ZU WERDEN)
+     # CHECK, WETHER A MAIN PROGRAM OR AN EXECUTABLE HAVE BEEN DECLARED.
+     # EXECUTABLES DO NOT NEED TO BE COMPILED.
  if [[ "$mainprog" = ""  &&  "$executable" = "" ]]
  then
@@ -1505 +1391 @@
 
 
-    # SOURCE-VERZEICHNIS ZUM AUFSAMMELN DER ZU UEBERSETZENDEN PROGRAMMTEILE
-    # ERZEUGEN. HIERHIN WERDEN SPAETER IM FALL VON BATCH-JOBS AUCH DAS MRUN-
-    # SCRIPTS SOWIE DIE KONFIGURATIONSDATEI KOPIERT
+    # CREATE SOURCE-DIRECTORY TO COLLECT ROUTINES TO BE COMPILED.
+    # LATER THE MRUN-SCRIPT AND CONFIGURATION-FILE WILL ALSO BE COPIED TO THIS DIRECTORY.
  if [[ $restart_run != true  &&  "$SOURCES_COMPLETE" = "" ]]
  then
@@ -1515 +1400 @@
 
 
-    # ALLE ZU UEBERSETZENDEN PROGRAMMTEILE ZUSAMMENSAMMELN
-    # BEI BATCH-JOBS IST DIES NICHT NOETIG, WEIL DIE PROGRAMMTEILE BEREITS DURCH
-    # DEN MRUN-AUFRUF ERMITTELT SIND, DER DEN BATCH-JOB GENERIERT HAT, UND
-    # IM VERZEICHNIS SOURCES_FOR_RUN_... ABGELEGT SIND
+    # COLLECT ALL ROUTINES TO BE COMPILED
+    # THIS IS NOT REQUIRED WITHIN BATCH-JOBS, BECAUSE ROUTINES HAVE ALREADY BEEN COLLECTED
+    # BY THE MRUN-CALL WHICH CREATED THE BATCH-JOB.
  if [[ $do_compile = true  &&  "$SOURCES_COMPLETE" = "" ]]
  then
@@ -1527 +1411 @@
     then
 
-          # MODIFIZIERTE DATEIEN DER SVN-ARBEITSKOPIE BESTIMMEN
+          # DETERMINE MODIFIED FILES OF THE SVN WORKING COPY
        source_list=""
        cd  $source_path
 
 
-          # PRUEFEN, OB VERZEICHNIS UEBERHAUPT UNTER SVN-KONTROLLE STEHT
+          # CHECK, IF DIRECTORY IS UNDER SVN CONTROL
        if [[ ! -d .svn ]]
        then
@@ -1542 +1426 @@
 
 
-          # ALLE MODIFIZIERTEN QUELLCODEDATEIEN AUFLISTEN
+          # LIST ALL MODIFIED SOURCE CODE FILES
        Filenames=""
        svn status  >  tmp_mrun
@@ -1560 +1444 @@
 
 
-          # DATEIEN NACH SOURCES_FOR_RUN_... KOPIEREN
+          # COPY FILES TO SOURCES_FOR_RUN_...
        for  dateiname  in  $Filenames
        do
@@ -1570 +1454 @@
 
 
-       # MITTELS OPTION -s ANGEGEBENE DATEIEN NACH SOURCES_FOR_RUN_... KOPIEREN
-       # BEI AUTOMATISCHEN FORTSETZUNGSLAEUFEN SIND DORT SCHON ALLE DATEIEN
-       # VORHANDEN
+       # COPY FILES GIVEN BY OPTION -s TO DIRECTORY SOURCES_FOR_RUN_...
+       # AUTOMATIC RESTART RUNS JUST ACCESS THE DIRECTORY CREATED BY THE INITIAL RUN
     elif [[ "$source_list" != ""  &&  $restart_run != true ]]
     then
@@ -1581 +1464 @@
        do
 
-             # QUELLTEXT-DATEI DARF KEINE PFADE BEINHALTEN
+             # SOURCE CODE FILE IS NOT ALLOWED TO INCLUDE PATH
           if [[ $(echo $filename | grep -c "/") != 0 ]]
           then
@@ -1605 +1488 @@
 
 
-       # PRUEFEN, OB ENTWEDER HAUPTPROGRAMM VORHANDEN UND ES EVTL. IN DER
-       # LISTE DER ZU UEBERSETZENDEN PROGRAMMTEILE MIT ENTHALTEN IST (WENN
-       # NICHT, WIRD ES DIESER LISTE HINZUGEFUEGT)
+       # CHECK, IF A MAIN PROGRAM EXISTS AND IF IT IS PART OF THE LIST OF FILES
+       # TO BE COMPILED. IF NOT, ADD IT TO THE LIST.
     if [[ $restart_run != true ]]
     then
@@ -1627 +1509 @@
 
 
-       # MAKEFILE AUF VORHANDENSEIN PRUEFEN UND KOPIEREN
-       # BEI RESTART-LAEUFEN LIEGT ES SCHON IM VERZEICHNIS SOURCES_FOR_RUN...
+       # CHECK, IF MAKEFILE EXISTS AND COPY IT TO THE SOURCES_FOR_RUN... DIRECTORY
+       # NOT REQUIRED FOR RESTART RUNS, SOURCES_FOR_RUN... HAS BEEN CREATED BY THE INITIAL RUN
     if [[ "$restart_run" != true ]]
     then
@@ -1642 +1524 @@
 
 
-       # DATEIEN AUS ZUSAETZLICHEM QUELLVERZEICHNIS HINZUFUEGEN
+       # COPY FILES FROM OPTIONAL SOURCE PATH GIVEN IN THE CONFIGURATION FILE
     if [[ $restart_run != true  &&  "$add_source_path" != "" ]]
     then
 
-          # GIBT ES DAS VERZEICHNIS UEBERHAUPT?
+          # DOES THE DIRECTORY EXIST?
        if [[ ! -d $add_source_path ]]
        then
@@ -1711 +1593 @@
              else
 
-                # Default User-Interface von der Liste entfernen, falls Datei
-                # ein User-Interface enthaelt
-#             if [[ $( cat $dateiname | grep -c "END SUBROUTINE user_parin" ) != 0 ]]
-#             then
-#                if [[ $dateiname != user_interface.f90  &&  -f user_interface.f90 ]]
-#                then
-#                   rm -rf  user_interface.f90
-#                   source_list=`echo $source_list | sed -e 's/user_interface.f90//'`
-#                   printf "\n\n  *** default \"user_interface.f90\" removed from the files to be translated"
-#                   printf "\n      since a user-interface is found in file"
-#                   printf "\n      \"$add_source_path/$dateiname\" \n"
-#                   sleep 3
-#                else
                 if [[ $found = false ]]
                 then
@@ -1744 +1613 @@
 
 
-       # ALLE UNTERPROGRAMME, DIE ZU VEREINBARTEN SOFTWAREPAKETEN GEHOEREN,
-       # DER LISTE DER ZU UEBERSETZENDEN DATEIEN HINZUFUEGEN
+       # ADD ALL ROUTINES BELONGING TO SOFTWARE PACKAGES (GIVEN BY OPTION -p)
+       # TO THE LIST OF FILES TO BE COMPILED
     if [[ $restart_run != true  &&  -n $package_list ]]
     then
@@ -1756 +1625 @@
           [[ $package = "dvrp_graphics+1PE" ]]  &&  package=dvrp_graphics
 
-             # ERMITTELE ALLE DATEIEN, DIE ZUM PAKET GEHOEREN
-             # FEHLERMELDUNGEN WERDEN ABGEFANGEN, DA * AUCH VERZEICHNISSNAMEN
-             # LIEFERT
+             # DETERMINE FILES BELONGING TO THE PACKAGE
+             # ERROR MESSAGE ARE REDIRECTED TO /dev/null, BECAUSE WILDCARD (*) ALSO GIVES
+             # THE NAME OF THE DIRECTORY
           package_source_list=`grep "defined( __$package " * 2>/dev/null | cut -f1 -d:`
 
 
-             # FUEGE DIESE DATEIEN DER LISTE DER ZU UEBERSETZENDEN DATEIEN
-             # HINZU, FALLS SIE NOCH NICHT DAZUGEHOEREN
+             # ADD THESE FILES TO THE LIST OF FILES TO BE COMPILED,
+             # IF THEY ARE NOT ALREADY PART OF THE LIST
           for  source_list_name  in  $package_source_list
           do
@@ -1769 +1638 @@
              then
 
-                    # NUR DATEIEN MIT GUELTIGEN ENDUNGEN VERWENDEN
+                    # ONLY TAKE FILES WITH VALID SUFFIX
                 ending=`echo $source_list_name | cut -f2 -d.`
                 if [[ "$ending" = f90  ||  "$ending" = F90  ||  "$ending" = f  ||  "$ending" = F  ||  "$ending" = c ]]
@@ -1783 +1652 @@
     fi
 
-
-       # MAKEFILE AUF VORHANDENSEIN PRUEFEN UND KOPIEREN
-       # BEI RESTART-LAEUFEN LIEGT ES SCHON IM VERZEICHNIS SOURCES_FOR_RUN...
-#    if [[ "$restart_run" != true ]]
-#    then
-#       [[ "$makefile" = "" ]]  &&  makefile=$source_path/Makefile
-#       if [[ ! -f $makefile ]]
-#       then
-#          printf "\n  +++ file \"$makefile\" does not exist"
-#          locat=make; exit
-#       else
-#          cp  $makefile  SOURCES_FOR_RUN_$fname/Makefile 
-#       fi
-#    fi
-
  fi  # do_compile=true
 
 
-    # FALLS PROGRAMMTEILE UEBERSETZT WERDEN SOLLEN, FOLGEN JETZT EINIGE
-    # UEBERPRUEFUNGEN UND DAS SETZEN DER PRAEPROZESSOR-DIREKTIVEN
+    # IF SOURCE CODE IS TO BE COMPILED, DO SOME MORE CHECKS
+    # AND SET PRE-PROCESSOR DIRECTIVES
  if [[ $do_compile = true  ||  $create_executable_for_batch = true ]]
  then
 
-       # PRAEPROZESSOR-DIREKTIVEN ZUM SELEKTIVEN AUSWAEHLEN VON CODETEILEN
-       # ZUSAMMENSETZEN
-       # DIREKTIVEN ZUM AKTIVIEREN VON RECHNERSPEZIFISCHEM CODE
+       # SET PREPROCESSOR-DIRECTIVES TO SELECT OPERATING SYSTEM SPECIFIC CODE
     if [[ $(echo $localhost | cut -c1-3) = ibm ]]
     then
@@ -1822 +1674 @@
     fi
 
-       # DIREKTIVEN DIE DURCH OPTION -K BESTIMMT WERDEN (Z.B. PARALLEL)
+       # SET DIRECTIVES GIVEN BY OPTION -K (E.G. parallel)
     if [[ $(echo $localhost | cut -c1-3) = ibm ]]
     then
@@ -1832 +1684 @@
     fi
 
-       # DIREKTIVEN DIE SOFTWAREPAKETE AKTIVIEREN (OPTION -p)
+       # SET DIRECTIVES FOR ACTIVATING SOFTWARE-PACKAGES (OPTION -p)
     if [[ -n $package_list ]]
     then
@@ -1858 +1710 @@
     fi
 
-       # DIREKTIVEN DIE DURCH OPTION -D FESTGELEGT SIND
+       # SET DIRECTIVES GIVEN BY OPTION -D
     if [[ -n $cpp_opts ]]
     then
@@ -1875 +1727 @@
 
 
-       # BEI LOKALEN RECHNUNGEN PRUEFEN, OB EXECUTABLE VORHANDEN
+       # FOR LOCAL RUNS CHECK AGAIN, IF EXECUTABLE EXISTS
     if [[ $do_remote = false ]]
     then
@@ -1888 +1740 @@
 
 
-    # JOBMODUS FESTSTELLEN 
+    # DETERMINE THE JOB MODE
  if [[ "$ENVIRONMENT" = BATCH ]]
  then
@@ -1897 +1749 @@
 
 
-    # no interactive runs on lctit
+    # NO INTERACTIVE RUNS ALLOWED ON LCTIT 
  if [[ $host = lctit  &&  $jobmo = INTERACTIVE  &&  $do_batch = false ]]
  then
@@ -1906 +1758 @@
 
 
-    # HOSTSPEZIFISCHE DEFAULT-COMPILER SETZEN, FALLS NICHT BEREITS
-    # DURCH BENUTZER ANDERWEITIG VEREINBART
+    # CHECK, IF USER DEFINED A COMPILER
  if [[ "$compiler_name" = "" ]]
  then
@@ -1917 +1768 @@
 
 
-    # COMPILER AUF RIAMS NEC UEBERSCHREIBEN
- [[ $localhost = necriam ]]  &&  compiler_name=mpif90
-
-
-
-    # TEMPORAEREN KATALOGNAMEN BESTIMMEN
+    # DETERMINE THE NAME OF MRUN'S TEMPORARY WORKING DIRECTORY
  kennung=$RANDOM
  if [[ "$tmp_user_catalog" = "" ]]
@@ -1939 +1785 @@
 
 
-    # KATALOGNAMEN FUER ZWISCHENSPEICHERUNG VON FORTSETZUNGSLAUFDATEIEN
-    # BESTIMMEN
+    # DETERMINE THE NAME OF THE DIRECTORY WHICH IS USED TO TEMPORARILY STORE DATA FOR RESTART RUNS
  if [[ "$tmp_data_catalog" = "" ]]
  then
@@ -1952 +1797 @@
 
 
-    # EVENTUELL BEI LOKALEN RECHNUNGEN $-ZEICHEN IN ENVIRONMENT-VARIABLEN
-    # ERSETZEN
+    # IN CASE OF LOCAL RUNS REPLACE ENVIRONMENT VARIABLES BY THEIR VALUES
  if [[ $do_remote = false  &&  $do_compile = true  ||  $create_executable_for_batch = true ]]
  then
@@ -1962 +1806 @@
 
 
-    # COMPILE- UND LINK-OPTIONEN BESTIMMEN
+    # DETERMINE COMPILE- AND LINK-OPTIONS
  fopts="$fopts $netcdf_inc $fftw_inc $dvr_inc"
  lopts="$lopts $netcdf_lib $fftw_lib $dvr_lib"
  ROPTS="$ropts"
-# if [[ ( $(echo $host | cut -c1-3) = nec  ||  $(echo $host | cut -c1-3) = ibm  ||  $host = lckyoto  ||  $host = lcsgih  ||  $host = lcsgib  ||  $host = lctit  ||  $host = lcfimm  ||  $host = lcflow  ||  $host = lcxe6 ||  $host = lcxt5m || $host = lck || $host = lckiaps || $host = lckordi || $host = lcsb || $host )  &&  -n $numprocs ]]
+# if [[ ( $(echo $host | cut -c1-3) = nec  ||  $(echo $host | cut -c1-3) = ibm  ||  $host = lckyoto  ||  $host = lctit  ||  $host = lcflow  ||  $host = lcxe6 ||  $host = lcxt5m || $host = lck || $host = lckiaps || $host = lckordi || $host = lcsb || $host )  &&  -n $numprocs ]]
 # then
     XOPT="-X $numprocs"
@@ -1973 +1817 @@
 
 
-    # PRUEFEN DER CPU-ZEIT. (CPUMAX WIRD ALS ENV-VARIABLE VOM HAUTPRO-
-    # GRAMM BENOETIGT
+    # CHECK THE CPU-LIMIT. IT MUST BE GIVEN FOR BATCH-JOBS AND IS COMMUNICATED TO THE
+    # EXECUTABLE VIA NAMELIST-PARAMETER cputime
  done=false
  while [[ $done = false ]]
@@ -2000 +1844 @@
 
 
-    # PRUEFEN DER KERNSPEICHERANFORDERUNG
+    # CHECK THE MEMORY DEMAND
  if [[ $do_batch = true ]]
  then
@@ -2019 +1863 @@
 
 
-    # PRUEFEN, OB FUER REMOTE-RECHNUNGEN EIN BENUTZERNAME ANGEGEBEN WURDE
+    # IN CASE OF REMOTE-JOBS CHECK, IF A USERNAME FOR THE REMOTE HOST IS GIVEN
  if [[ $do_remote = true  &&  -z $remote_username ]]
  then
@@ -2039 +1883 @@
 
 
-    # set module load command and export for subjob
+    # SET THE MODULE-LOAD COMMAD AND EXPORT IT FOR subjob
  if [[ "$modules" != "" ]]
  then
@@ -2050 +1894 @@
  fi
 
-    # bugfix for wrong netcdf module and for netCDF4 usage in case of mpt
- if [[ $host = lcsgib  ||  $host = lcsgih ]]
- then
-    if [[ $(echo $module_calls | grep -c netcdf/3.6.3-intel) != 0 ]]
-    then
-       export module_calls="$module_calls export LD_LIBRARY_PATH=/sw/dataformats/netcdf/3.6.3-intel/lib:\$LD_LIBRARY_PATH;"
-    fi
-#     if [[ $(echo $module_calls | grep -c mpt) != 0 ]]
-#     then
-#        export module_calls="$module_calls export LD_LIBRARY_PATH=/sw/sgi/mpt/2011-02-07/lib:\$LD_LIBRARY_PATH;"
-#        echo "*** module_calls = $module_calls"
-#     fi
- fi
-
-
-    # SET DEFAULT VALUE FOR MPI MODULE TO BE USED ON SGI-ALTIX
- if [[ $host = lcsgib  ||  $host = lcsgih ]]
- then
-    if [[ $(echo $modules | grep -c mpt ) != 0 ]]
-    then
-       mpilib=mpt
-    elif [[ $(echo $modules | grep -c mvapich ) != 0 ]]
-    then
-       mpilib=mvapich
-    elif [[ $(echo $modules | grep -c impi ) != 0 ]]
-    then
-       mpilib=impi
-    fi
- fi
-
-
-
-###########################################################################
-# HEADER-AUSGABE
-###########################################################################
-
-
+
+
+    # OUTPUT OF THE MRUN-HEADER
  calltime=$(date)
  printf "\n"
-# [[ $silent = false ]]  &&  clear
  printf "#------------------------------------------------------------------------# \n"
  printf "| %-35s%35s | \n" "$version" "$calltime"
@@ -2095 +1904 @@
  spalte1="called on:"; spalte2=$localhost_realname
  printf "| %-25s%-45s | \n" "$spalte1" "$spalte2"
- if [[ $local_compile = false ]]
- then
-    if [[ $do_remote = true ]]
-    then
-       spalte1="execution on:"; spalte2="$host (username: $remote_username)"
-    else
-       spalte1="execution on:"; spalte2="$host ($localhost_realname)"
-    fi
+ if [[ $do_remote = true ]]
+ then
+    spalte1="execution on:"; spalte2="$host (username: $remote_username)"
  else
-    spalte1="compiling test only!"; spalte2=""
+    spalte1="execution on:"; spalte2="$host ($localhost_realname)"
  fi
  printf "| %-25s%-45s | \n" "$spalte1" "$spalte2"
@@ -2246 +2050 @@
 
 
-    # BEDINGTE AUSGABE DER DATEIVERBINDUNGEN
+    # OUTPUT OF FILE CONNECTIONS IN CASE OF TRACEBACK
  if [[ $do_trace = true ]]
  then
@@ -2292 +2096 @@
 
 
-    # ABFRAGEN BEI AUFRUF AUF LOKALER MASCHINE 
+    # QUERY FOR CONTINUE (ON LOCAL MACHINES ONLY)
  if [[ $remotecall = false  &&  $silent = false  &&  $jobmo != BATCH ]]
  then
@@ -2315 +2119 @@
        printf " >>> batch-job will be created and submitted"
     else
-       if [[ $local_compile = false ]]
-       then
-          printf " >>> MRUN will now continue to execute on this machine"
-       else
-          printf " >>> a test compilation will now be carried out on this machine"
-       fi
+       printf " >>> MRUN will now continue to execute on this machine"
     fi
  fi
@@ -2544 +2343 @@
           if [[ "$line" != ""  &&  $(echo $line | cut -c1) != "#" ]]
           then
-                # EVENTUELLE DOPPELPUNKTE AUS OPTIONSSTRING UND ALLE -D ENTFERNEN
+                # REMOVE COLONS FROM OPTION-STRING, REMOVE ALL -D OPTIONS
              line="$line "
              copts_check=`echo $line | cut -d" " -s -f2 | sed 's/::/%DUM%/g' | sed 's/:/ /g' | sed 's/%DUM%/:/g' | sed 's/-D[^ ]* //g' | sed 's/ -D.*//g'`
@@ -2821 +2620 @@
 
 
-    # FALLS AUF DIESER MASCHINE GERECHNET WERDEN SOLL, WERDEN JETZT ENTSPRE-
-    # CHENDE AKTIONEN DURCHGEFUEHRT
+    # NOW PERFORM THOSE ACTIONS REQUIRED TO EXECUTE THE PROGRAM (PALM) ON THIS MACHINE
+    # (COMPILING/LINKING, EXECUTING, COPYING I/O FILES)
  if [[ $do_batch = false ]]
  then
 
 
-       # TEMPORAEREN KATALOG ERZEUGEN
+       # CREATE THE TEMPORARY WORKING DIRECTORY
     mkdir -p  $TEMPDIR
     chmod  go+rx  $TEMPDIR
@@ -2833 +2632 @@
 
 
-       # SAEMTLICHE QUELLTEXT-DATEIEN BZW. AUSFUEHRBARES PROGRAMM IN 
-       # TEMPORAERES VERZEICHNIS KOPIEREN
+       # COPY EITHER THE COMPLETE SOURCE CODE FILES TO BE COMPILED OR THE EXECUTABLE 
+       # INTO THE TEMPORARY WORKING DIRECTORY
     if [[ $do_compile = true ]]
     then
@@ -2878 +2677 @@
 
 
-       # WECHSEL IN TEMPORAEREN KATALOG
+       # CHANGE TO THE TEMPORARY WORKING DIRECTORY
     cd  $TEMPDIR
     printf "\n  *** changed to temporary directory: $TEMPDIR"
 
 
-       # OUTPUT-DATEI-VERBINDUNGEN AUF TEMPORAERER DATEI ABLEGEN
-       # DIESE DATEI KANN VON SPAETER AUFZURUFENDEN BENUTZERPROZEDUREN GELESEN
-       # WERDEN, UM ZU LOKALEN DATEINAMEN GEHOERENDE PERMANENTE NAMEN ZU
-       # ERMITTELN
+       # THE FOLLOWING IS REQUIRED FPR AVS-OUTPUT WITH PALM  ??? REMOVE ???
+       # WRITE INFORMATIONS ABOUT THE OUTPUT-FILE CONNECTIONS TO A TEMPORARY FILE
+       # THIS FILE CAN LATER BE READ FROM USER-DEFINED CODE TO DETERMINE THE
+       # RELATION BETWEEN THE LOCAL TEMPORARY AND PERMANENT FILE NAMES
     (( i = 0 ))
     while (( i < iout ))
@@ -2900 +2699 @@
 
 
-       # IF REQUIRED, START WITH COMPILING ACTIONS
+       # IF REQUIRED, START WITH COMPILING
     if [[ $do_compile = true ]]
     then
@@ -2915 +2714 @@
 
              # COMPILING WITH MAKE (ON NEC COMPILER IS CALLED ON HOST CROSS)
-          printf "\n\n\n  *** compilation starts \n$striche\n"
+          printf "\n\n\n  *** compilation starts \n$dashes\n"
           printf "  *** compilation with make using following options:\n"
           printf "      make depository:          $make_depository"
@@ -2943 +2742 @@
              ssh  $SSH_PORTOPT  plogin1  -l $usern  "$init_cmds export PATH=/sw/ibm/xlf/13.1.0.8/usr/bin:$PATH; $module_calls cd $TEMPDIR; make $mopts -f Makefile PROG=a.out  F90=$compiler_name  COPT=\"$cpp_options\"  F90FLAGS=\"$fopts\"  LDFLAGS=\"$lopts\" "
              [[ ! -f a.out ]]  &&  compile_error=true
-             continue   # ANDERENFALLS IST STATUS=1, FALLS A.OUT VORHANDEN
-          elif [[ $localhost = lcsgib ]]
-          then
-             printf "      compiler is called via ssh on \"bicegate0\" \n"
-             ssh  $SSH_PORTOPT  bicegate0  -l $usern  "$init_cmds $module_calls cd $TEMPDIR; make $mopts -f Makefile PROG=a.out  F90=$compiler_name  COPT=\"$cpp_options\"  F90FLAGS=\"$fopts\"  LDFLAGS=\"$lopts\" "
-             [[ ! -f a.out ]]  &&  compile_error=true
-             continue   # ANDERENFALLS IST STATUS=1, FALLS A.OUT VORHANDEN
-          elif [[ $localhost = lcsgih ]]
-          then
-             printf "      compiler is called via ssh on \"hicegate0\" \n"
-             ssh  $SSH_PORTOPT  hicegate0  -l $usern  "$init_cmds $module_calls cd $TEMPDIR; make $mopts -f Makefile PROG=a.out  F90=$compiler_name  COPT=\"$cpp_options\"  F90FLAGS=\"$fopts\"  LDFLAGS=\"$lopts\" 2>&1 "
-             [[ ! -f a.out ]]  &&  compile_error=true
-             continue   # ANDERENFALLS IST STATUS=1, FALLS A.OUT VORHANDEN
+             continue   # STATUS=1, IF a.out EXISTS
           elif [[ $localhost = lcflow ]]
           then 
@@ -2962 +2749 @@
              check_for_file=`/usr/bin/ssh $SSH_PORTOPT flow02.hpc.uni-oldenburg.de -l $usern "ls $TEMPDIR/a.out 2> /dev/null"`
              [[ "$check_for_file" = "" ]]  &&  compile_error=true
-             continue   # ANDERENFALLS IST STATUS=1, FALLS A.OUT VORHANDEN
+             continue   # STATUS=1, IF a.out EXISTS
           elif [[ $localhost = lccrayb  ||  $localhost = lccrayf ||  $localhost = lccrayh ]]
           then
@@ -2979 +2766 @@
              exit
           else
-             printf "$striche\n  *** compilation finished \n"
-          fi
-
-       fi
-
-    fi
-
-
-       # FALLS NUR TESTWEISE KOMPILIERT WERDEN SOLLTE, IST MRUN JETZT FERTIG
-    if [[ $local_compile = true ]]
-    then
-       cd  $HOME
-       rm -rf $TEMPDIR
-       locat=local_compile; exit
-    fi
-
-
-       # BEREITSTELLEN DER INPUT-DATEIEN
-       # SCHLEIFE UEBER ALLE VOM BENUTZER ANGEGEBENEN DATEIEN
+             printf "$dashes\n  *** compilation finished \n"
+          fi
+
+       fi
+
+    fi
+
+
+       # PROVIDE THE INPUT FILES
+       # LOOP OVER ALL ACTIVATED FILES (LISTED IN THE CONFIGURATION FILE)
     (( i = 0 ))
     while (( i < iin ))
@@ -3004 +2782 @@
        if (( i == 1 ))
        then
-          printf "\n\n  *** providing INPUT-files:\n$striche"
-       fi
-
-
-          # OPTIONALE DATEIEN BEI NICHTVORHANDENSEIN UEBERGEHEN
+          printf "\n\n  *** providing INPUT-files:\n$dashes"
+       fi
+
+
+          # SKIP OPTIONAL FILES, IF THEY DO NOT EXIST
        if [[ "${transin[$i]}" = unavailable ]]
        then
@@ -3022 +2800 @@
        fi
 
-          # PRUEFEN, OB EINZELDATEI ODER DATEI PRO PROZESSOR
+          # CHECK FOR SINGLE FILE (SERIAL RUN) OR DIRECTORY (ONE FILE PER CORE FOR PARELLEL EXECUTION)
        files_for_pes=false; datentyp=file
        if [[ "${actionin[$i]}" = pe  &&  -n $numprocs ]]
@@ -3054 +2832 @@
        fi
 
-          # INPUT-DATEI FUER EINEN FORTSETZUNGSLAUF. ES WIRD GEPRUEFT,
-          # OB DIESE DATEI NOCH AUF DEM TEMPORAEREN DATENKATALOG VORHANDEN
-          # IST. FALLS NICHT, WIRD VERSUCHT, SIE ANSCHLIESSEND VOM ARCHIV-
-          # SERVER ZU HOLEN
+          # INPUT-FILE FOR A RESTART RUN.
+          # CHECK, IF THIS FILE STILL EXISTS ON THE TEMPORARY DATA DIRECTORY.
+          # IF NOT, TRY TO GET IT FROM THE ARCHIVE SYSTEM
        if [[ "${actionin[$i]}" = fl ]]
        then
@@ -3104 +2881 @@
 
 
-          # DATEI LIEGT AUF ARCHIV-SERVER
+          # FILE IS STORED ON THE ARCHIVE SYSTEM
        if [[ "${actionin[$i]}" = ar ]]
        then
@@ -3162 +2939 @@
              if [[ $files_for_pes = false ]]
              then
-                if [[ $localhost = lcsgih ]]
-                then
-                   ssh  $SSH_PORTOPT  $usern@hicedata.hlrn.de  "cp  $PERM/${frelin[$i]}  $PWD"
-                else
-                   ssh  $SSH_PORTOPT  $usern@bicedata.hlrn.de  "cp  $PERM/${frelin[$i]}  $PWD"
-                fi
+                ssh  $SSH_PORTOPT  $usern@bicedata.hlrn.de  "cp  $PERM/${frelin[$i]}  $PWD"
              else
                 (( inode = 0 ))
                 while (( inode < nodes ))
                 do
-                   if [[ $localhost = lcsgih ]]
-                   then
-                      ssh  $SSH_PORTOPT  $usern@hicedata.hlrn.de  "cd $PWD; tar  xf  $PERM/${frelin[$i]}/${frelin[$i]}.node_$inode.tar"
-                   else
-                      ssh  $SSH_PORTOPT  $usern@bicedata.hlrn.de  "cd $PWD; tar  xf  $PERM/${frelin[$i]}/${frelin[$i]}.node_$inode.tar"
-                   fi
+                   ssh  $SSH_PORTOPT  $usern@bicedata.hlrn.de  "cd $PWD; tar  xf  $PERM/${frelin[$i]}/${frelin[$i]}.node_$inode.tar"
                    (( inode = inode + 1 ))
                 done
@@ -3205 +2972 @@
           then
 
-                # DATEI AUCH AUF TEMPORAERES DATENVERZEICHNIS LEGEN, DAMIT
-                # SIE BEI WEITEREN ZUGRIFFEN NOCH VORHANDEN IST
+                # PUT FILE ON THE TEMPORARY DATA DIRECTORY TOO.
+                # THIS WILL MAKE FILE ACCESS EASIER FOR LATER RUNS 
              [[ ! -d $tmp_data_catalog ]]  &&  mkdir -p  $tmp_data_catalog; chmod  g+rx  $tmp_data_catalog
              if [[ $files_for_pes = false ]]
@@ -3217 +2984 @@
              got_tmp[$i]=true
 
-                # DATEI UNTER LOKALEM NAMEN ZUR VERFUEGUNG STELLEN
+                # PROVIDE THE FILE UNDER ITS LOCAL NAME
              mv  ${frelin[$i]}  ${localin[$i]}
 
@@ -3224 +2991 @@
 
 
-          # DATEI LIEGT IM VOM BENUTZER ANGEGEBENEN VERZEICHNIS
+          # FILE IS STORED IN THE RESPECTIVE DIRECTORY GIVEN IN THE CONFIGURATION FILE
        if [[ "${actionin[$i]}" = ""  ||  "${actionin[$i]}" = "di"  ||  "${actionin[$i]}" = "npe" ]]
        then
@@ -3231 +2998 @@
           then
 
-                # DATEI WIRD FUER DIE PROZESSOREN EINES PARALLERECHNERS BEREITGESTELLT
+                # FILE COPIES ARE PROVIDED FOR ALL CORES
+                # EACH FILE GETS A UNIQUE FILENAME WITH A FOUR DIGIT NUMBER
              printf "\n      file will be provided for $numprocs processors"
              mkdir  ${localin[$i]}
@@ -3258 +3026 @@
              then
 
-                   # DIE DEN PROZESSOREN EINES PARALLELRECHNERS ZUGEHOERIGEN
-                   # DATEIEN WERDEN BEREITGESTELLT, INDEM ZUERST DER GESAMTE
-                   # KATALOGINHALT KOPIERT UND DANN DIE EINZELNEN DATEIEN
-                   # PER MOVE UMBENANNT WERDEN
+                   # PROVIDE FILES FOR EACH CORE
+                   # FIRST CREATE THE LOCAL DIRECTORY, THEN COPY FILES
+                   # FROM THE PERMANENT DIRECTORY BY LINKING THEM TO THE LOCAL ONE
                 printf "\n      providing $numprocs files for the respective processors"
                 mkdir  ${localin[$i]}
@@ -3274 +3041 @@
                     cd $TEMPDIR
                 fi
-                # If "ln -f" fails of if "$link_local_input = false" do a normal "cp -r"
+
+                   # IF "ln -f" FAILED OR IF "$link_local_input = false" DO A NORMAL "cp -r"
                 if [[ ! -f "${localin[$i]}/_0000" ]]
                     then
@@ -3285 +3053 @@
 
              else
-                   # BEREITSTELLUNG AUF EINPROZESSORRECHNERN
+
+                   # PROVIDE FILE FOR RUNS ON A SINGLE CORE
                 if [[ $link_local_input = true ]]
                 then
@@ -3307 +3076 @@
     if (( i != 0 ))
     then
-       printf "\n$striche\n  *** all INPUT-files provided \n"
-    fi
-
-
-       # EVENTUELLE INPUT-KOMMANDOS ABARBEITEN
+       printf "\n$dashes\n  *** all INPUT-files provided \n"
+    fi
+
+
+       # EXECUTE INPUT-COMMANDS GIVEN IN THE CONFIGURATION FILE
     (( i = 0 ))
     while (( i < iic ))
@@ -3318 +3087 @@
        if (( i == 1 ))
        then
-          printf "\n\n  *** execution of INPUT-commands:\n$striche"
+          printf "\n\n  *** execution of INPUT-commands:\n$dashes"
        fi
        printf "\n  >>> ${in_command[$i]}"
@@ -3324 +3093 @@
        if (( i == iic ))
        then
-          printf "\n$striche\n"
+          printf "\n$dashes\n"
        fi
     done
 
 
-       # VERBLEIBENDE CPU-ZEIT BERECHNEN
+       # SET THE REMAINING CPU-TIME
     cpurest=${cpumax}.
 
@@ -3341 +3110 @@
           printf "\n\n  *** preparing the dvr streaming server configuration file"
 
-             # Check, if a dvr server is already running
+             # CHECK, IF A DVR SERVER IS ALREADY RUNNING
           running_dvrserver_id=`echo $(ps -edaf | grep .dvrserver.config | grep -v grep) | cut -d" " -f2`
           if [[ "$running_dvrserver_id" != "" ]]
@@ -3357 +3126 @@
                 cp  ${PALM_BIN}/.dvrserver.config  .
 
-                   # Entering the BASEDIR, UID and GID into this file
+                   # ENTERING THE BASEDIR, UID AND GID INTO THIS FILE
                 user_id=`id -u`
                 group_id=`id -g`
-                   # & is needed as seperator, because TEMPDIR contains /
+
+                   # "&" IS REQUIRED AS A SEPERATOR, BECAUSE TEMPDIR CONTAINS "/"
                 sed "s&<replace by dvr data directory>&${TEMPDIR}&g" .dvrserver.config > .dvrserver.1
                 sed "s/<replace by user id>/$user_id/g"    .dvrserver.1 > .dvrserver.2
@@ -3367 +3137 @@
                 rm  .dvrserver.1  .dvrserver.2
 
-                   # Start dvr server in background, get his id and print on terminal
+                   # START DVR SERVER IN BACKGROUND, GET HIS ID AND PRINT ON TERMINAL
                 $dvr_server  .dvrserver.config  >>  DVR_LOGFILE  2>&1  &
                 dvrserver_id=`echo $(ps -edaf | grep .dvrserver.config) | cut -d" " -f2`
@@ -3387 +3157 @@
 
 
-       # NAMELIST-DATEI MIT WERTEN VON ENVIRONMENT-VARIABLEN ERZEUGEN (ZU
-       # LESEN VON PALM)
+       # CREATE THE NAMELIST-FILE WITH VALUES OF ENVIRONMENT-VARIABLES REQUIRED BY PALM
+       # (FILE ENVPAR WILL BE READ BY PALM)
     cat  >  ENVPAR  <<  %%END%%
  &envpar  run_identifier = '$fname', host = '$localhost',
@@ -3400 +3170 @@
 
 
-       # PROGRAMMSTART
-    printf "\n\n  *** execution starts in directory\n      \"`pwd`\"\n$striche\n"
+       # STARTING THE EXECUTABLE
+    printf "\n\n  *** execution starts in directory\n      \"`pwd`\"\n$dashes\n"
     PATH=$PATH:$TEMPDIR
 
-       # MPI debug option (argument checking, slows down execution due to increased latency)
+       # MPI DEBUG OPTION (ARGUMENT CHECKING, SLOWS DOWN EXECUTION DUE TO INCREASED LATENCY)
     if [[ "$mpi_debug" = true ]]
     then
@@ -3423 +3193 @@
        if [[ "$ENVIRONMENT" = BATCH ]]
        then
-          if [[ $(echo $localhost | cut -c1-5) != lcsgi ]]
-          then
-             printf "\n  +++ debug is allowed in interactive mode only"
-             locat=debug
-             exit
-          fi
+          continue
        fi
        if [[ $localhost = ibmh ]]
@@ -3464 +3229 @@
              totalview   poe  -a a.out  -procs $numprocs  -rmpool 0  -nodes 1   $ROPTS
           fi
-       elif [[ $(echo $localhost | cut -c1-5) = lcsgi ]]
-       then
-             # CURRENTLY NO DEBUGGER ON LCSGI
-          if [[ $run_coupled_model = true ]]
-          then
-             printf "\n  +++ no debug in coupled mode available on \"$localhost\" "
-             locat=debug
-             exit
-          else
-             echo "no_coupling"  >  runfile_atmos
-          fi
-          (( ii = $numprocs / $threads_per_task ))
-          export OMP_NUM_THREADS=$threads_per_task
-          echo "OMP_NUM_THREADS=$OMP_NUM_THREADS"
-          if [[ $threads_per_task != 1 ]]
-          then
-             printf "\n      threads per task: $threads_per_task"
-          fi
-          printf "\n\n"
-          if [[ $( echo $mpilib | cut -c1-3 ) = mpt ]]
-          then
-#             export MPI_LAUNCH_TIMEOUT=360
-             if [[ "$totalview" = true ]]
-             then
-                printf "\n     running totalview debugger"
-                mpiexec_mpt $tv_opt -n $ii   ./a.out  $ROPTS  < runfile_atmos
-             else
-                mpiexec_mpt -np $ii   ./a.out  $ROPTS  < runfile_atmos
-             fi
-          elif [[ $( echo $mpilib | cut -c1-3 ) = mva ]]
-          then
-#             ulimit -s 300000   # A too large stack size causes problems
-#             export MV2_NUM_PORTS=2
-#             export MV2_CPU_MAPPING=0:1:2:3
-             if [[ "$totalview" = true ]]
-             then
-                printf "\n     running totalview debugger"
-                mpiexec $tv_opt ./a.out  $ROPTS  < runfile_atmos
-             else
-                mpiexec    ./a.out  $ROPTS  < runfile_atmos
-             fi
-          fi
-       else 
-          printf "\n  +++ no debug available on \"$localhost\" "
-          printf "\n      or not implemented in mrun so far"
-          locat=debug
-          exit
-       fi
-
-       # end debug mode
+
+       # END DEBUG MODE
     else
 
-          # normal execution
+          # NORMAL EXECUTION
        if [[ -n $numprocs ]]
        then
+
              # RUNNING THE PROGRAM ON PARALLEL MACHINES
           if [[ $(echo $host | cut -c1-3) = ibm ]]
           then
+
                 # SETUP THE IBM MPI ENVIRONMENT
              if [[ $host != ibmh  &&  $host != ibmkisti ]]
@@ -3533 +3252 @@
                 #  export MP_PRINTENV=yes
 
-                   # TUNING-VARIABLEN ZUR VERBESSERUNG DER KOMMUNIKATION
-                   # ZEIGEN ABER DERZEIT (SEP 04, FEDERATION) KAUM WIRKUNG
+                   # TUNING-VARIABLES TO IMPROVE COMMUNICATION SPEED
+                   # DO NOT SHOW SIGNIFICANT EFFECTS (SEP 04, FEDERATION-SWITCH)
                 export MP_WAIT_MODE=poll
                 [[ $node_usage = not_shared ]]  &&  export MP_SINGLE_THREAD=yes
@@ -3581 +3300 @@
                 then
                    poe  a.out  -procs $numprocs  -nodes 1  -rmpool 0  $ROPTS
-                elif [[ $localhost = ibmkisti  ||  $localhost = ibmku  ||  $localhost = ibmy ]]
+                elif [[ $localhost = ibmkisti  ||  $localhost = ibmku ]]
                 then
                    if [[ -f $hostfile ]]
@@ -3611 +3330 @@
                       echo "coupled_run $iia $iio"  >  runfile_atmos
                    fi
-                   if [[ $localhost = ibmy ]]
-                   then
-                      ./a.out  -procs $tasks_per_node  $ROPTS  <  runfile_atmos
-                   else
-                      poe  ./a.out  -procs $numprocs $ROPTS  <  runfile_atmos 
-                   fi
+
+                   poe  ./a.out  -procs $numprocs $ROPTS  <  runfile_atmos 
 
                 else
@@ -3631 +3346 @@
                 fi
              fi
-          elif [[ $host = nech  ||  $host = necriam ]]
+          elif [[ $host = nech ]]
           then
              (( ii = nodes ))
@@ -3689 +3404 @@
                 # COPY HOSTFILE FROM SOURCE DIRECTORY OR CREATE IT, IF IT
                 # DOES NOT EXIST
-             if [[  $host != lccrayb  &&$host != lccrayf  && $host != lccrayh  &&  $host != lcsgih  &&  $host != lcsgib  &&  $host != lckyuh  &&  $host != lckyut ]]
+             if [[  $host != lccrayb  &&$host != lccrayf  && $host != lccrayh  &&  $host != lckyuh  &&  $host != lckyut ]]
              then
                 if [[ -f $hostfile ]]
@@ -3709 +3424 @@
              (( ii = $numprocs / $threads_per_task ))
              export OMP_NUM_THREADS=$threads_per_task
-             # echo "*** OMP_NUM_THREADS=$OMP_NUM_THREADS"
+
              if [[ $threads_per_task != 1 ]]
              then
-                   # increase stack size to unlimited, because large runs
-                   # may abort otherwise
+                   # INCREASE STACK SIZE TO UNLIMITED, BECAUSE OTHERWISE LARGE RUNS
+                   # MAY ABORT
                 ulimit -Ss unlimited
                 printf "\n      threads per task: $threads_per_task  stacksize: unlimited"
@@ -3726 +3441 @@
                 fi
                 printf "\n\n"
-                if [[ $host = lcsgih  ||  $host = lcsgib ]]
-                then
-                   if [[ $( echo $mpilib | cut -c1-3 ) = mpt ]]
-                   then
-                          # MPI_DSM_DISTRIBUTE not necessary when MPI_DSM_CPULIST is set
-                          # export MPI_DSM_DISTRIBUTE=1
-                          # MPI_DSM_CPULIST: pin MPI processes to cores
-                      if [[ $use_openmp = false ]]
-                      then
-                         if [[ "$sgi_feature" = ice2 ]]
-                         then
-                            export MPI_DSM_CPULIST="0,4,1,5,2,6,3,7:allhosts"
-                         else
-                            export MPI_DSM_CPULIST="0,1,4,5,2,3,6,7:allhosts"
-                         fi
-                      else
-                         unset MPI_DSM_CPULIST
-                      fi
-                          # MPI_IB_RAILS: use both IB rails on ICE2
-                      export MPI_BUFS_PER_HOST=512
-                      export MPI_IB_RAILS=2
-                          # NECESSARY, IF MORE THAN 4096 PEs ARE USED
-                      export MPI_CONNECTIONS_THRESHOLD=8192
-                  #    echo "*** MPI_DSM_CPULIST=$MPI_DSM_CPULIST"
-                      export MPI_TYPE_DEPTH=20
-                  #    echo "*** MPI_TYPE_DEPTH=$MPI_TYPE_DEPTH"
-                      export MPI_GROUP_MAX=64
-                  #    echo "*** MPI_GROUP_MAX=$MPI_GROUP_MAX"
-                      if [[ $use_openmp = true ]]
-                      then
-                         echo " mpiexec -npernode $tasks_per_node  ./a.out  $ROPTS  <  runfile_atmos"
-                         mpiexec -npernode $tasks_per_node $tv_opt ./a.out  $ROPTS  <  runfile_atmos
-                      else
-                         mpiexec_mpt -np $ii $tv_opt  ./a.out  $ROPTS  < runfile_atmos
-                      fi
-
-                          # next is test for openmp usage
-                  #     echo "mpiexec -npernode $tasks_per_node  ./a.out  $ROPTS  < runfile_atmos"
-                  #     mpiexec -npernode $tasks_per_node  ./a.out  $ROPTS  < runfile_atmos
-                   elif [[ $( echo $mpilib | cut -c1-3 ) = mva ]]
-                   then
-                      export MV2_NUM_PORTS=2
-                      #  The default setting of MV2_CPU_MAPPING gives best results
-                      # export MV2_ENABLE_AFFINITY=1
-                      #  export MV2_CPU_MAPPING=0,1,4,5,2,3,6,7
-               #       if [[ "$sgi_feature" = ice2 ]]
-               #       then
-               #          export MV2_CPU_MAPPING=0,4,1,5,2,6,3,7
-               #       else
-               #          export MV2_CPU_MAPPING=0,1,4,5,2,3,6,7
-               #       fi
-                      if [[ $use_openmp = true ]]
-                      then
-                         unset MV2_CPU_MAPPING
-                         export MV2_ENABLE_AFFINITY=0
-                      fi
-                      echo "*** MV2_CPU_MAPPING=$MV2_CPU_MAPPING"
-                      echo "*** MV2_ENABLE_AFFINITY=$MV2_ENABLE_AFFINITY"
-                      if [[ $use_openmp = true ]]
-                      then
-                         echo " mpiexec -npernode $tasks_per_node  ./a.out  $ROPTS  <  runfile_atmos"
-                         mpiexec -npernode $tasks_per_node $tv_opt ./a.out  $ROPTS  <  runfile_atmos
-                      else
-                         mpiexec -np $ii $tv_opt ./a.out  $ROPTS  < runfile_atmos
-                      fi
-                   elif [[ "$mpilib" = impi ]]
-                   then
-                      echo "mpirun -np $ii inspxe-cl -r result -collect mi3 -- ./a.out  <  runfile_atmos"
-                      mpirun -np $ii inspxe-cl -r result -collect mi3 -- ./a.out  <  runfile_atmos
-                   fi
-                elif [[ $host = lccrayb || $host = lccrayh ]]
+
+                if [[ $host = lccrayb || $host = lccrayh ]]
                 then
                     echo "--- aprun  -n $ii  -N $tasks_per_node  a.out  $ROPTS  < runfile_atmos"
@@ -3824 +3470 @@
              else
 
-                    # currently there is no full MPI-2 support on ICE and XT4
+                    # CURRENTLY THERE IS NO FULL MPI-2 SUPPORT ON ICE AND XT4
                 (( iia = $numprocs_atmos / $threads_per_task ))
                 (( iio = $numprocs_ocean / $threads_per_task ))
@@ -3835 +3481 @@
                    echo "atmosphere_to_ocean $iia $iio"  >  runfile_atmos
                    echo "ocean_to_atmosphere $iia $iio"  >  runfile_ocean
-                   if [[ $host = lcsgih  ||  $host = lcsgib ]]
-                   then
-
-                      if [[ $( echo $mpilib | cut -c1-3 ) = mpt ]]
-                      then
-#                         export MPI_LAUNCH_TIMEOUT=360
-                         mpiexec_mpt -np $iia  ./a.out  $ROPTS < runfile_atmos &
-                         mpiexec_mpt -np $iio  ./a.out  $ROPTS < runfile_ocean &
-                      elif [[ $( echo $mpilib | cut -c1-3 ) = mva ]]
-                      then
-#                         ulimit -s 300000   # A too large stack size causes problems
-#                         export MV2_NUM_PORTS=2
-#                         export MV2_CPU_MAPPING=0:1:2:3
-                         mpiexec -n $iia  ./a.out  $ROPTS < runfile_atmos &
-                         mpiexec -n $iio  ./a.out  $ROPTS < runfile_ocean &
-                      fi
-
-                   elif [[ $host = lccrayf  ||  $host = lcxe6  ||  $host = lcxt5m ]]
+
+                   if [[ $host = lccrayf  ||  $host = lcxe6  ||  $host = lcxt5m ]]
                    then
 
@@ -3870 +3500 @@
 
                    echo "coupled_run $iia $iio"  >  runfile_atmos
-                   if [[ $host = lcsgih  ||  $host = lcsgib ]]
-                   then
-
-                      if [[ $( echo $mpilib | cut -c1-3 ) = mpt ]]
-                      then
-#                         export MPI_LAUNCH_TIMEOUT=360
-                         mpiexec_mpt -np $ii  ./a.out  $ROPTS < runfile_atmos
-                      elif [[ $( echo $mpilib | cut -c1-3 ) = mva ]]
-                      then
-#                         ulimit -s 300000   # A too large stack size causes problems
-#                         export MV2_NUM_PORTS=2
-#                         export MV2_CPU_MAPPING=0:1:2:3
-                         mpiexec  ./a.out  $ROPTS < runfile_atmos
-                      fi
-
-                   elif [[ $host = lccrayf  ||  $host = lcxe6  ||  $host = lcxt5m ]]
+
+                   if [[ $host = lccrayf  ||  $host = lcxe6  ||  $host = lcxt5m ]]
                    then
 
@@ -3905 +3521 @@
 
              fi
+
           elif [[ $host = lckyoto ]]
           then
@@ -3930 +3547 @@
              fi
              set +xv
+
           elif [[ $host = lctit ]]
           then
@@ -3947 +3565 @@
              mpprun  -n $numprocs  a.out  $ROPTS
           fi
-          [[ $? != 0 ]]  &&  execution_error=true
-
-
-             # PERFORMANCE-AUSWERTUNG MIT APPRENTICE
-          if [[ "$cond1" = apprentice  ||  "$cond2" = apprentice ]]
-          then
-             apprentice
-          fi
        else
           a.out  $ROPTS
        fi
     fi
-    if [[ $? != 0  ||  $execution_error = true ]]
-    then
-
-          # ABBRUCH BEI LAUFZEITFEHLER
-#       [[ ! ( "$cond1" = debug  ||  "$cond2" = debug ) ]]  &&  cat  aout_output*
+
+    if [[ $? != 0 ]]
+    then
+
+          # ABORT IN CASE OF RUNTIME ERRORS
        printf "\n  +++ runtime error occured"
        locat=execution
        exit
+
     else
-#       [[ ! ( "$cond1" = debug  ||  "$cond2" = debug ) ]]  &&  cat  aout_output*
-       printf "\n$striche\n  *** execution finished \n"
-
-          # Stop the dvr streaming server and process the dvr output in order
-          # to create dvrs- and html-files containing all streams
+
+       printf "\n$dashes\n  *** execution finished \n"
+
+          # STOP THE DVR STREAMING SERVER AND PROCESS THE DVR OUTPUT IN ORDER
+          # TO CREAT DVRS- AND HTML-FILES CONTAINING ALL STREAMS
        if [[ "$dvrserver_id" != "" ]]
        then
@@ -3978 +3589 @@
           printf "\n  *** dvr server with id=$dvrserver_id has been stopped"
 
-             # If there is a directory, data have been output by the
-             # streaming server. Otherwise, user has chosen dvrp_output=local
+             # IF THERE IS A DIRECTORY, DATA HAVE BEEN OUTPUT BY THE
+             # STREAMING SERVER. OTHERWISE, USER HAS CHOSEN dvrp_output=local
           if [[ -d DATA_DVR ]]
           then
 
-                # Add the current dvr configuration file to the dvr output
-                # directory
+                # ADD THE CURRENT DVR CONFIGURATION FILE TO THE DVR OUTPUT
+                # DIRECTORY
              cp  .dvrserver.config  DATA_DVR
 
-                # Process the dvr output (option -s for also generating
-                # sequence mode data)
+                # PROCESS THE DVR OUTPUT (OPTION -s FOR GENERATING
+                # SEQUENCE MODE DATA TOO)
              process_dvr_output  -d DATA_DVR  -f $fname  -s
 
           else
 
-                # Process the local output
+                # PROCESS THE LOCAL OUTPUT
              process_dvr_output  -l  -d DATA_DVR  -f $fname
 
@@ -4001 +3612 @@
        then
 
-             # Process dvr output generated in local mode (dvrp_output=local)
+             # PROCESS DVR OUTPUT GENERATD IN LOCAL MODE (dvrp_output=local)
           process_dvr_output  -l  -d DATA_DVR  -f $fname
 
@@ -4009 +3620 @@
 
 
-       # Call of combine_plot_fields in order to merge single files written
-       # by each PE into one file.
+       # CALL OF combine_plot_fields IN ORDER TO MERGE SINGLE FILES WRITTEN
+       # BY EACH CORE INTO ONE FILE
    if [[ ! -f ${PALM_BIN}/combine_plot_fields${block}.x ]]
    then
@@ -4027 +3638 @@
       fi
    else
-#     Temporary solution to skip combine_plot_fields. This is necessary in case of huge amount of
-#     data output. To do: extend this branch by creating a batch job for combine_plot_fields.
+
+         # TEMPORARY SOLUTION TO SKIP combine_plot_fields. THIS IS REQUIRED IN CASE OF HUGE AMOUNT OF
+         # DATA OUTPUT. TO DO: EXTEND THIS BRANCH BY CREATING A BATCH JOB for combine_plot_fields.
+         # ??? koennen wir das streichen ???
       printf "\n\n\n *** post-processing: skipping combine_plot_fields (-Z option set) ..."
    fi
@@ -4034 +3647 @@
 
 
-       # EVENTUELLE OUTPUT-KOMMANDOS ABARBEITEN
+       # EXECUTE OUTPUT-COMMANDS GIVEN IN THE CONFIGURATION FILE
     (( i = 0 ))
     while (( i < ioc ))
@@ -4041 +3654 @@
        if (( i == 1 ))
        then
-          printf "\n\n  *** execution of OUTPUT-commands:\n$striche"
+          printf "\n\n  *** execution of OUTPUT-commands:\n$dashes"
        fi
        printf "\n  >>> ${out_command[$i]}"
@@ -4047 +3660 @@
        if (( i == ioc ))
        then
-          printf "\n$striche\n"
+          printf "\n$dashes\n"
        fi
     done
 
 
-       # EVTL. INHALT DES AKTUELLEN VERZEICHNISSES AUSGEBEN
+       # IN TRACE-MODE PRINT CONTENTS OF THE CURRENT (TEMPORARY) WORKING DIRECTORY
     if [[ $do_trace = true ]]
     then
@@ -4061 +3674 @@
 
 
-       # OUTPUT-DATEIEN AN IHRE ZIELORTE KOPIEREN
+       # COPY LOCAL OUTPUT-FILES TO THEIR PERMANENT DESTINATIONS
     (( i = 0 ))
     while (( i < iout ))
@@ -4068 +3681 @@
        if (( i == 1 ))
        then
-          printf "\n\n  *** saving OUTPUT-files:\n$striche"
-       fi
-
-          # PRUEFEN, OB EINZELDATEI ODER DATEI PRO PROZESSOR
+          printf "\n\n  *** saving OUTPUT-files:\n$dashes"
+       fi
+
+          # CHECK FOR SINGLE FILE (SERIAL RUN) OR DIRECTORY (ONE FILE PER CORE FOR PARELLEL EXECUTION)
        files_for_pes=false; filetyp=file
        if [[ "${actionout[$i]}" = pe  &&  -n $numprocs ]]
@@ -4112 +3725 @@
 
 
-             # KOPIEREN PER FTP/SCP (IMMER IM BINAERMODUS, -M: FALLS ZIELKATALOG
-             # NICHT VORHANDEN, WIRD VERSUCHT, IHN ANZULEGEN), ABER NUR BEI
-             # REMOTE-RECHNUNGEN
+             # COPY VIA SCP TO LOCAL HOST (ALWAYS IN BINARY MODE USING batch_scp option -m)
+             # IF TARGET DIRECTORY DOES NOT EXISTS, TRY TO CREATE IT
           if [[ "${actionout[$i]}" = tr ]]
           then
@@ -4130 +3742 @@
                 then
 
-                      # TRANSFER IN EIGENSTAENDIGEM JOB
-                      # ZUERST KOPIE DER DATEI INS TEMPORAERE DATENVERZEICHNIS
+                      # TRANSFER IN SEPERATE JOB
+                      # FIRST COPY FILE TO TEMPORY DATA DIRECTORY
                    [[ ! -d $tmp_data_catalog/TRANSFER ]]  &&  mkdir -p  $tmp_data_catalog/TRANSFER
                    file_to_transfer=${fname}_${localout[$i]}_to_transfer_$kennung
@@ -4166 +3778 @@
                 else
 
-                      # TRANSFER INNERHALB DIESES JOBS
+                      # TRANSFER WITHIN THIS JOB
                    transfer_failed=false
                    printf "\n  >>> OUTPUT: ${localout[$i]}$cst  by SCP to"
@@ -4181 +3793 @@
                    [[ $? != 0 ]]  &&  transfer_failed=true
 
-                      # BEI FEHLGESCHLAGENEM TRANSFER SICHERUNGSKOPIE AUF
-                      # LOKALER MASCHINE ANLEGEN
+                      # IF TRANSFER FAILED, CREATE BACKUP COPY ON THIS MACHINE
                    if [[ $transfer_failed = true ]]
                    then
-                      printf "  +++ transfer failed. Trying to save a copy on the local host under:\n"
+                      printf "  +++ transfer failed. Trying to save a copy on this host under:\n"
                       printf "      ${pathout[$i]}/${localhost}_${fname}${endout[$i]}_$kennung\n"
 
-                         # ERSTMAL PRUEFEN, OB VERZEICHNIS EXISTIERT. GEGEBENENFALLS
-                         # ANLEGEN.
+                         # FIRST CHECK, IF DIRECTORY EXISTS, AND CREATE IT, IF NECESSARY
                       eval  local_catalog=${pathout[$i]}
                       if [[ ! -d $local_catalog ]]
@@ -4203 +3813 @@
              else
 
-                   # WERTZUWEISUNG, SO DASS WEITER UNTEN NUR KOPIERT WIRD
+                   # UNSET actionout. DUE TO THIS SETTING, FILE WILL LATER JUST BE COPIED ON THIS MACHINE
                 actionout[$i]=""
              fi
@@ -4209 +3819 @@
 
 
-             # APPEND PER FTP/SCP (IMMER IM BINAERMODUS, -M: FALLS ZIELKATALOG
-             # NICHT VORHANDEN, WIRD VERSUCHT, IHN ANZULEGEN), ABER NUR BEI
-             # REMOTE-RECHNUNGEN
+             # APPEND VIA SCP TO LOCAL HOST (ALWAYS IN BINARY MODE USING batch_scp option -m)
+             # IF TARGET DIRECTORY DOES NOT EXISTS, TRY TO CREATE IT
           if [[ "${actionout[$i]}" = tra ]]
           then
@@ -4219 +3828 @@
                 then
 
-                      # TRANSFER IN EIGENSTAENDIGEM JOB
-                      # ZUERST KOPIE DER DATEI INS TEMPORAERE DATENVERZEICHNIS
+                      # TRANSFER IN SEPERATE JOB
+                      # FIRST COPY FILE TO TEMPORY DATA DIRECTORY
                    [[ ! -d $tmp_data_catalog/TRANSFER ]]  &&  mkdir -p  $tmp_data_catalog/TRANSFER
                    file_to_transfer=${fname}_${localout[$i]}_to_transfer_$kennung
@@ -4249 +3858 @@
                 else
 
-                      # TRANSFER INNERHALB DIESES JOBS
+                      # TRANSFER WITHIN THIS JOB
                    transfer_failed=false
                    printf "\n  >>> OUTPUT: ${localout[$i]}  append by SCP to"
@@ -4264 +3873 @@
                    [[ $? != 0 ]]  &&  transfer_failed=true
 
-                      # BEI FEHLGESCHLAGENEM TRANSFER SICHERUNGSKOPIE AUF
-                      # LOKALER MASCHINE ANLEGEN
+                      # IF TRANSFER FAILED, CREATE BACKUP COPY ON THIS MACHINE
                    if [[ $transfer_failed = true ]]
                    then
-                      printf "  +++ transfer failed. Trying to save a copy on the local host under:\n"
+                      printf "  +++ transfer failed. Trying to save a copy on this host under:\n"
                       printf "      ${pathout[$i]}/${localhost}_${fname}${endout[$i]}_$kennung\n"
 
-                         # ERSTMAL PRUEFEN, OB VERZEICHNIS EXISTIERT. GEGEBENENFALLS
-                         # ANLEGEN
+                         # FIRST CHECK, IF DIRECTORY EXISTS, AND CREATE IT, IF NECESSARY
                       eval  local_catalog=${pathout[$i]}
                       if [[ ! -d $local_catalog ]]
@@ -4287 +3894 @@
              else
 
-                   # WERTZUWEISUNG, SO DASS WEITER UNTEN NUR APPEND AUF
-                   # LOKALER MASCHINE DURCHGEFUEHRT WIRD
+                   # RESET actionout. DUE TO THIS SETTING, FILE WILL LATER JUST BE APPENDED ON THIS MACHINE
                 actionout[$i]=a
              fi
@@ -4294 +3900 @@
 
 
-             # OUTPUT-DATEI FUER EINEN FORTSETZUNGSLAUF. DATEI WIRD PER
-             # LINK AUF DEN TEMPORAEREN DATENKATALOG GELEGT. OPTION -f WIRD
-             # VERWENDET, FALLS DORT NOCH EINE DATEI GLEICHEN NAMENS VORHANDEN
-             # SEIN SOLLTE. ANSCHLIESSEND WIRD SEINE ARCHIVIERUNG ANGESTOSSEN
+             # OUTPUT-FILE FOR A RESTART-RUN.
+             # FILE IS MOVED TO THE TEMPORARY DATA DIRECTORY USING link COMMAND.
+             # OPTION -f IS USED TO OVERWRITE EXISTING FILES.
+             # AS LAST ACTION, ARCHIVING IS INITIATED.
           if [[ "${actionout[$i]}" = fl ]]
           then
@@ -4320 +3926 @@
 
 
-                # ARCHIVIERUNGSJOB WIRD ERZEUGT UND ABGESCHICKT
+                # CREATE AND SUBMIT ARCHIVING-JOB
              if [[ $store_on_archive_system = true ]]
              then
@@ -4360 +3966 @@
                       exit
                    else
+                         # ??? nicht benötigte Archiv-Systeme entfernen ???
                          # FUER RECHNER IN JUELICH. DORT KOENNTEN AUCH
                          # EINZELNE DATEIEN GESICHERT WERDEN (SPAETER KORR.)
@@ -4370 +3977 @@
                    if [[ $files_for_pes = false ]]
                    then
-                         # EVENTUELL NOCH VORHANDENE DATEI IM ARCHIV LOSCHEN
+                         # REMOVE EXISTING OLD FILES FROM THE ARCHIVE
                       echo "set -x"                                   >> archive_${frelout[$i]}
                       echo "rm  -rf  \$PERM/${frelout[$i]}"           >> archive_${frelout[$i]}
@@ -4386 +3993 @@
                       while (( inode < nodes ))
                       do
-#                         echo "*** all_files = \"$all_files\" "
                          files=`echo $all_files | cut -d" " -f1-$tasks_per_node`
                          all_files=`echo $all_files | cut -d" " -f$tp1-`
-#                         echo "*** tasks_per_node = \"$tasks_per_node\" "
-#                         echo "*** files = \"$files\" "
-#                         echo "*** all_files = \"$all_files\" "
-                        echo "tar  cvf \$PERM/${frelout[$i]}/${frelout[$i]}.node_$inode.tar $files"   >> archive_${frelout[$i]}
-                        ### echo "tar  cvf ${frelout[$i]}.node_$inode.tar $files"   >> archive_${frelout[$i]}
-                        ### echo "cp ${frelout[$i]}.node_$inode.tar \$PERM/${frelout[$i]}/"   >> archive_${frelout[$i]}
-                         ###echo "rm ${frelout[$i]}.node_$inode.tar"   >> archive_${frelout[$i]}
-#                         echo "dsmc incremental  \$PERM/${frelout[$i]}/${frelout[$i]}.node_$inode.tar" >> archive_${frelout[$i]}
-#                         echo "dsmmigrate \$PERM/${frelout[$i]}/${frelout[$i]}.node_$inode.tar"        >> archive_${frelout[$i]}
+                         echo "tar  cvf \$PERM/${frelout[$i]}/${frelout[$i]}.node_$inode.tar $files"   >> archive_${frelout[$i]}
                          (( inode = inode + 1 ))
                       done
-#                      echo "rm  -rf  \$PERM/${frelout[$i]}.tar"       >> archive_${frelout[$i]}
-#                      echo "tar  cvf \$PERM/${frelout[$i]}.tar ${frelout[$i]}" >> archive_${frelout[$i]}
                    fi
                 elif [[ $archive_system = ut ]]
@@ -4408 +4004 @@
                    if [[ $files_for_pes = false ]]
                    then
-                         # EVENTUELL NOCH VORHANDENE DATEI IM ARCHIV LOSCHEN
+                         # REMOVE EXISTING OLD FILES FROM THE ARCHIVE
                       echo "set -x"                                 >> archive_${frelout[$i]}
                       echo "rm  -rf  \$UT/${frelout[$i]}"           >> archive_${frelout[$i]}
@@ -4437 +4033 @@
                 if [[ $archive_system != none ]]
                 then
-                   if [[ $localhost = lcsgih  ||  $localhost = lcsgib ]]
-                   then
-#                      subjob  -d  -v  -q cdata  -X 0  -m 1000  -t 43200  -c $job_catalog  $PORTOPT  archive_${frelout[$i]}
-                      subjob   -v  -q permq  -X 1 -T 1  -m 1000  -t 172800  -c $job_catalog  $PORTOPT  archive_${frelout[$i]}
-                   elif [[ $localhost = nech ]]
+                   if [[ $localhost = nech ]]
                    then
                       subjob  -d  -c /pf/b/$usern/job_queue  -v  -q pp  -X 0  -m 1000  -t 7200  $PORTOPT  archive_${frelout[$i]}
@@ -4452 +4044 @@
 
 
-                # LEERDATEI IM BENUTZERVERZEICHNIS ANLEGEN, DAMIT BEKANNT IST,
-                # WIE DIE HOECHSTE ZYKLUSNUMMER AUF DEM ARCHIV-SYSTEM LAUTET
+                # CREATE AN EMPTY DIRECTORY IN THE USERS PERMANENT DIRECTORY,
+                # IN ORDER TO NOTE THE RESPECTIVE CYCLE NUMBER ON THE ARCHIVE SYSTEM
+                # RESTART-JOBS ARE USING THESE EMPTY-DIRECTORIES TO GET THE CURRENT HIGHEST
+                # CYCLE NUMBER ON THE ARCHIVE SYSTEM (IN CASE THAT INFORMATIONS ARE DIFFICULT TO
+                # TO ACCESS FROM THE ARCHIVE-SYSTEM DIRECTLY))
              if [[ $files_for_pes = false ]]
              then
@@ -4464 +4059 @@
 
 
-             # KOPIEREN AUF LOKALER MASCHINE ZUM ARCHIV-SYSTEM
-             # AUSSERDEM MUSS LEERDATEI ANGELEGT WERDEN, DAMIT BEKANNT IST,
-             # WIE DIE HOECHSTE ZYKLUSNUMMER AUF DEM ARCHIV-SYSTEM LAUTET
-             # FALLS IRGENDEINE (VON MEHREREN) ARCHIVIERUNGEN SCHIEF GEHT,
-             # WIRD FLAG GESETZT UND BLEIBT AUCH BEI WEITEREN ORDNUNGS-
-             # GEMAESSEN ARCHIVIERUNGEN GESETZT
+             # COPY FROM THIS HOST TO THE ARCHIVE-SYSTEM
+             # IF ANY ARCHIVING FAILS, AN ERROR-FLAG-FILE IS SET
+             # THIS FILE REMAINS TO BE SET, EVEN IF ARCHIVING OF FURTHER FILES IS SUCCESSFULL
           if [[ "${actionout[$i]}" = ar ]]
           then
@@ -4536 +4128 @@
              elif [[ $archive_system = tivoli ]]
              then
-                   # ARCHIVIERUNG NUR PER BATCH-JOB MOEGLICH
-                   # DATEI MUSS ZWISCHENZEITLICH INS TEMPORAERE DATENVERZEICHNIS
-                   # GELEGT WERDEN
+                   # ARCHIVING ONLY POSSIBLE VIA BATCH-JOB
+                   # IN THE MEANTIME, FILE IS STORED IN THE TEMPORARY DATA DIRECTORY,
+                   # BECAUSE MRUN'S CURRENT TEMPORARY WORKING DIRECTORY MAY ALREADY BE DELETED
+                   # WHEN THE ARCHIVE-JOB IS EXECUTED
                 [[ ! -d $tmp_data_catalog ]]  &&  mkdir -p  $tmp_data_catalog
                 chmod  g+rx  $tmp_data_catalog
@@ -4549 +4142 @@
                 fi
 
-                   # BATCH JOB GENERIEREN UND ABSCHICKEN; DATEI MUSS WIEDER
-                   # AUS TEMPORAEREM DATENVERZEICHNIS ENTFERNT WERDEN
+                   # GENERATE AND SUBMIT BATCH-JOB
+                   # FILE HAS TO BE DELETED FROM THE TEMPORARY DATA DIRECTORY
+                   # DELETE OLD EXISTING FILES FROM THE ARCHIVE
                 echo "cd  $tmp_data_catalog"                       >  archive_${frelout[$i]}
                 if [[ $files_for_pes = false ]]
                 then
-                      # EVENTUELL NOCH VORHANDENE DATEI IM ARCHIV LOSCHEN
                    echo "rm  -rf  \$PERM/${frelout[$i]}"           >> archive_${frelout[$i]}
                    echo "cp  ${frelout[$i]} \$PERM/${frelout[$i]}" >> archive_${frelout[$i]}
@@ -4570 +4163 @@
              elif [[ $archive_system = ut ]]
              then
-                   # ARCHIVIERUNG NUR PER BATCH-JOB MOEGLICH
-                   # DATEI MUSS ZWISCHENZEITLICH INS TEMPORAERE DATENVERZEICHNIS
-                   # GELEGT WERDEN
+                   # ARCHIVING ONLY POSSIBLE VIA BATCH-JOB
+                   # IN THE MEANTIME, FILE IS STORED IN THE TEMPORARY DATA DIRECTORY,
+                   # BECAUSE MRUN'S CURRENT TEMPORARY WORKING DIRECTORY MAY ALREADY BE DELETED
+                   # WHEN THE ARCHIVE-JOB IS EXECUTED
                 [[ ! -d $tmp_data_catalog ]]  &&  mkdir -p  $tmp_data_catalog
                 chmod  g+rx  $tmp_data_catalog
@@ -4583 +4177 @@
                 fi
 
-                   # BATCH JOB GENERIEREN UND ABSCHICKEN; DATEI MUSS WIEDER
-                   # AUS TEMPORAEREM DATENVERZEICHNIS ENTFERNT WERDEN
+                   # GENERATE AND SUBMIT BATCH-JOB
+                   # FILE HAS TO BE DELETED FROM THE TEMPORARY DATA DIRECTORY
+                   # DELETE OLD EXISTING FILES FROM THE ARCHIVE
                 echo "cd  $tmp_data_catalog"                       >  archive_${frelout[$i]}
                 if [[ $files_for_pes = false ]]
                 then
-                      # EVENTUELL NOCH VORHANDENE DATEI IM ARCHIV LOSCHEN
                    echo "rm  -rf  \$UT/${frelout[$i]}"           >> archive_${frelout[$i]}
                    echo "cp  ${frelout[$i]} \$UT/${frelout[$i]}" >> archive_${frelout[$i]}
@@ -4606 +4200 @@
                 archive_save=false
              fi
+
+                # CREATE EMPTY FLAG-FILE OR -DIRECTORY
+                # IN ORDER TO NOTE THE RESPECTIVE CYCLE NUMBER ON THE ARCHIVE SYSTEM
+                # RESTART-JOBS ARE USING THESE EMPTY-DIRECTORIES TO GET THE CURRENT HIGHEST
+                # CYCLE NUMBER ON THE ARCHIVE SYSTEM (IN CASE THAT INFORMATIONS ARE DIFFICULT TO
+                # TO ACCESS FROM THE ARCHIVE-SYSTEM DIRECTLY))
              if [[ $file_saved = true ]]
              then
@@ -4615 +4215 @@
                 fi
              fi
-          fi
-
-             # APPEND AUF LOKALER MASCHINE
+
+          fi
+
+             # APPEND ON THIS MACHINE
           if [[ "${actionout[$i]}" = "a" ]]
           then
@@ -4630 +4231 @@
           fi
 
-             # KOPIEREN AUF LOKALER MASCHINE
-             # ES MUSS KOPIERT WERDEN, DA MOVE NICHT UEBER FILESYSTEM HINAUS MOEGLICH
+             # COPY ON THIS MACHINE
+             # COPY HAS TO BE USED, BECAUSE MOVE DOES NOT WORK IF FILE-ORIGIN AND TARGET ARE
+             # ON DIFFERENT FILE-SYSTEMS
           if [[ "${actionout[$i]}" = ""  &&  $files_for_pes = false ]]
           then
 
-                # KOPIEREN AUF EINPROZESSORMASCHINE
+                # COPY IN CASE OF RUNS ON SINGLE CORES
              if [[ "${extout[$i]}" != " "  &&  "${extout[$i]}" != "" ]]
              then
@@ -4674 +4276 @@
           then
 
-                # DIE DEN PROZESSOREN EINES PARALLELRECHNERS ZUGEHOERIGEN
-                # DATEIEN WERDEN ERST IN EINEM KATALOG GESAMMELT UND DIESER
-                # WIRD DANN KOPIERT
-                # PER MOVE UMBENANNT WERDEN
+                # FILES FROM THE DIFFERENT CORES ARE MOVED WITH ln-COMMAND TO THE PERMANENT DIRECTORY
+                # AS A FIRST STEP, THE PERMANENT DIRECTORY IS CREATED
              printf "\n  >>> OUTPUT: ${localout[$i]}/_....  to  ${pathout[$i]}\n"
              if [[ $link_local_output = true ]]
@@ -4690 +4290 @@
                  cd $TEMPDIR
              fi
-             # If "ln -f" fails of if "$link_local_output = false" do a normal "cp -r"
+
+                # IF "ln -f" HAS FAILED OR IF "$link_local_output = false" DO A NORMAL COPY "cp -r"
              if [[ ! -f "${pathout[$i]}/_0000" ]]
              then
@@ -4707 +4308 @@
        if [[ $transfer_problems = true ]]
        then
-          printf "\n$striche\n  *** OUTPUT-files saved"
+          printf "\n$dashes\n  *** OUTPUT-files saved"
           printf "\n  +++ WARNING: some data transfers failed! \n"
        else
-          printf "\n$striche\n  *** all OUTPUT-files saved \n"
-       fi
-    fi
-
-
-       # EVENTUELL FOLGEJOB STARTEN
-       # DATEI CONTINUE_RUN MUSS VOM BENUTZERPROGRAMM AUS ERZEUGT WERDEN
+          printf "\n$dashes\n  *** all OUTPUT-files saved \n"
+       fi
+    fi
+
+
+       # IF REQUIRED, START A RESTART-JOB
+       # FILE CONTINUE_RUN MUST HAVE BEEN CREATED BY THE EXECUTABLE (PALM)
     if [[ -f CONTINUE_RUN ]]
     then
@@ -4723 +4324 @@
        then
 
-             # ZUERST IN MRUN-AUFRUF OPTIONEN FUER FORTSETZUNGSLAUF, FUER
-             # STILLES ABARBEITEN (OHNE INTERAKTIVE RUECKFAGEN) UND FUER
-             # BATCH-BETRIEB (NUR WICHTIG, FALLS BATCH AUF LOKALER MASCHINE
-             # DURCHGEFUEHRT WERDEN SOLL) EINFUEGEN, FALLS NICHT BEREITS VOR-
-             # HANDEN
+             # ADD RESTART-OPTIONS TO THE MRUN-CALL (IF THEY ARE NOT USED ALREADY):
+             # -C TELLS MRUN THAT IT IS A RESTART-RUN
+             # -v SILENT MODE WITHOUT INTERACTIVE QUERIES
+             # -n BATCH-MODE (IMPORTANT ONLY IN CASE OF BATCH JOBS ON THE LOCAL MACHINE)
           [[ $(echo $mc | grep -c "\-C") = 0 ]]  &&  mc="$mc -C"
           [[ $(echo $mc | grep -c "\-v") = 0 ]]  &&  mc="$mc -v"
@@ -4737 +4337 @@
 
 
-             # JOB STARTEN
+             # START THE RESTART-JOB
           printf "\n\n  *** initiating restart-run on \"$return_addres\" using command:\n"
           echo "      $mc"
-          printf "\n$striche\n"
+          printf "\n$dashes\n"
           if [[ $localhost != $fromhost ]]
           then
 
-             if [[ $localhost = lcsgih  ||  $localhost = lccrayb  ||  $localhost = lccrayh  ||  $localhost = nech  ||  $localhost = ibmh  ||  $localhost = ibmkisti  ||  $localhost = ibmku  ||  $localhost = ibms  ||  $localhost = lcflow  ||  $localhost = lckyu* ]]
+             if [[ $localhost = lccrayh  ||  $localhost = nech  ||  $localhost = ibmh  ||  $localhost = ibmkisti  ||  $localhost = ibmku  ||  $localhost = ibms  ||  $localhost = lcflow  ||  $localhost = lckyu* ]]
              then
                 echo "*** ssh will be used to initiate restart-runs!"
@@ -4786 +4386 @@
              fi
 
-                # WARTEN, DAMIT SICH RESTART JOB IN QUEUE EINREIHEN KANN, BEVOR
-                # DER AKTUELLE JOB ENDET
+                # WAIT TO ALLOW THE RESTART-JOB TO BE QUEUED, BEFORE THE CURRENT JOB IS FINISHED
              if [[ $queue = special1q ]]
              then
@@ -4797 +4396 @@
           else
 
-                # BEI RECHNUNGEN AUF LOKALER MASCHINE KANN MRUN DIREKT AUFGE-
-                # RUFEN WERDEN, AUSSER AUF lcfimm
+                # JOBS RUNNING (AND STARTED) ON THE LOCAL MACHINE CAN DIRECTLY CALL MRUN (WITHOUT
+                # USING SSH)
              cd $LOCAL_PWD
-             if [[ $localhost = lcfimm ]]
-             then
-                ssh $SSH_PORTOPT $return_addres -l $return_username "PATH=\$PATH:$LOCAL_MRUN_PATH;export PALM_BIN=$LOCAL_MRUN_PATH;cd $LOCAL_PWD; $mc " 
-             elif [[ $localhost = lckyuh ]]
+             if [[ $localhost = lckyuh ]]
              then
                 printf "\n  +++ WARNING: no restart mechanism available for host \"$localhost\" "
@@ -4809 +4405 @@
                 printf "\n               \"$mc\" "
              else
-                eval  $mc                # ' MUESSEN AUSGEWERTET WERDEN
+                eval  $mc                # THE ' MUST BE EVALUATED
              fi
              cd -  > /dev/null
@@ -4815 +4411 @@
           if [[ $localhost = lckyuh ]]
           then
-             printf "\n$striche\n  *** restart-run to be initiated manually\n"
+             printf "\n$dashes\n  *** restart-run to be initiated manually\n"
           else
-             printf "\n$striche\n  *** restart-run initiated \n"
-          fi
-
-
-             # EVENTUELL INPUT-DATEIEN, DIE VON TEMPORAEREM DATENVERZEICHNIS
-             # GEHOLT WORDEN SIND, LOESCHEN
+             printf "\n$dashes\n  *** restart-run initiated \n"
+          fi
+
+
+             # DELETE INPUT-(RESTART)FILES, WHICH HAVE BEEN FETCHED FROM THE TEMPORARY DATA
+             # DIRECTORY, BACAUSE THEY ARE NOT REQUIRED BY THE RESTART-JOB.
+             # THIS IS DONE IN ORDER TO AVOID EXCEEDING DISC QUOTAS OR DISC SPACE (RESTART-FILES
+             # MAY BE VERY HUGE)
           (( i = 0 ))
           while (( i < iin ))
@@ -4843 +4441 @@
 
     
-       # EVTL. EMAIL-BENACHRICHTIGUNG UEBER ABGESCHLOSSENEN LAUF
+       # SEND EMAIL NOTIFICATION ABOUT THE FINISHED RUN
     if [[ "$email_notification" != "none" ]]
     then
@@ -4866 +4464 @@
 
 
-       # ALLE ARBEITEN BEENDET. TEMPORAERER KATALOG KANN GELOESCHT WERDEN
+       # ALL ACTIONS FINISHED, TEMPORARY WORKING-DIRECTORY CAN BE DELETED
     cd  $HOME
     [[ $delete_temporary_catalog = true ]]  &&  rm -rf $TEMPDIR
@@ -4873 +4471 @@
 
 
-       # FALLS AUF REMOTE-MASCHINE GERECHNET WERDEN SOLL, WERDEN JETZT ENTSPRE-
-       # CHENDE AKTIONEN DURCHGEFUEHRT
-
-       # MRUN-BEFEHL FUER REMOTE-MASCHINE ZUSAMMENSTELLEN
+       # PREPARING ACTIONS,
+       # IF A BATCH-JOB IS TO BE GENERATED AND STARTED ON A REMOTE-MACHINE GERECHNET
+
+       # BUILD THE MRUN-COMMAND TO BE CALLED IN THE BATCH-JOB ON THE REMOTE-MACHINE
     mrun_com="$mrun_script_name -a $afname -c $config_file -d $fname -h $host -H $fromhost -m $memory -t $cpumax -q $queue -R $return_addres -U $return_username -u $remote_username"
     [[ "$cpp_opts" != "" ]]       &&  mrun_com=${mrun_com}" -D \"$cpp_opts\""
@@ -4886 +4484 @@
     [[ $keep_data_from_previous_run = true ]]  &&  mrun_com=${mrun_com}" -k"
     [[ "$additional_conditions" != "" ]]  &&  mrun_com=${mrun_com}" -K \"$additional_conditions\""
-#    [[ "$makefile" != "$source_path/Makefile" ]]  &&  mrun_com=${mrun_com}" -M \"$makefile\""
     [[ "$output_list" != "" ]]    &&  mrun_com=${mrun_com}" -o \"$output_list\""
     [[ "$read_from_config" = false ]]  &&  mrun_com=${mrun_com}" -S"
@@ -4912 +4509 @@
 
 
-       # create executable for batch job
+       # CREATE EXECUTABLE FOR BATCH JOB
     if [[ $create_executable_for_batch = true  &&  $restart_run != true ]]
     then
@@ -4918 +4515 @@
        printf "\n  *** creating the executable for batch job\n"
 
-          # method only works for batch jobs on local hosts
+          # METHOD ONLY WORKS FOR BATCH JOBS ON LOCAL HOSTS
        if [[ $host != $localhost ]]
        then
@@ -4951 +4548 @@
 
 
-       # ZUSAMMENSTELLUNG DES JOBSCRIPTS AUF DATEI jobfile
+       # BUILD THE JOB-SCRIPTS ON FILE jobfile
     jobfile=jobfile.$RANDOM
 
 
-       # TEMPORAERES VERZEICHNIS GENERIEREN UND NACH DORT WECHSELN
+       # CREATE TEMPORARY DIRECTORY AND SWITCH TO IT
     echo  "mkdir  $TEMPDIR"      >>  $jobfile
     echo  "cd  $TEMPDIR"         >>  $jobfile
 
 
-       # EVENTUELL FEHLERVERFOLGUNG AKTIVIEREN
+       # ACTIVATE ERROR-TRACEBACK
     if [[ $do_trace = true ]]
     then
@@ -4969 +4566 @@
 
 
-       # initialize the environment and load modules
+       # INITIALIZE THE ENVIRONMENT AND LOAD MODULES
     if [[ "$init_cmds" != "" ]]
     then
@@ -4980 +4577 @@
 
 
-       # BEREITSTELLUNG VON QUELLTEXTEN, MRUN-SCRIPTS UND KONFIGURATIONS-
-       # DATEI FUER DEN JOB
-    if [[ $( echo $host | cut -c1-5 ) = lcsgi  ||  $host = ibmkisti  ||  $host = lccrayb  ||  $host = lccrayf  ||  $host = lccrayh ]]
-    then
-
-          # KONFIGURATIONSDATEI UND MRUN_SCRIPT IN DAS SOURCE-VERZEICHNIS
-          # KOPIEREN
+       # PROVIDE SOURCE-CODE FILES, MRUN-SCRIPT AND CONFIGURATION-FILE FOR THE JOB
+       # then-CLAUSE: FILES ARE COLLECTED IN THE SOURCES_FOR_RUN_... DIRECTORY ON THE LOCAL HOST,
+       #              WHICH IS THEN FETCHED FROM THE BATCH-JOB BY USING cp/scp
+       #              THE SOURCE-CODE FILES ALREADY EXIST IN THIS DIRECTORY
+       # else-CLAUSE: FILE-CONTENTS ARE PUT INTO THE JOB-FILE AS HERE-DOCUMENTS
+       #              THIS MAY CREATE A QUITE LARGE JOB-FILE, WHICH CAN CAUSE PROBLEMS WITH SOME
+       #              QUEUEING-SYSTEMS
+    if [[ $host = ibmkisti  ||  $host = lccrayb  ||  $host = lccrayf  ||  $host = lccrayh ]]
+    then
+
+          # COPY CONFIGURATION-FILE AND MRUN-SCRIPT INTO THE SOURCES_FOR_RUN... DIRECTORY
        if [[ $restart_run != true ]]
        then
@@ -4993 +4594 @@
        fi
 
-          # SOURCE-VERZEICHNIS VOM LOKALEN RECHNER PER SCP TRANSFERIEREN
-          # (BEI JOBS AUF LOKALEM RECHNER REICHT CP)
+          # COPY THE SOURCES_FOR_RUN... DIRECTORY FROM THE LOCAL HOST TO THE JOB VIA scp
+          # (then-CLAUSE: JOBS ON THE LOCAL HOST CAN JUST USE cp)
        echo  "set -x"  >>  $jobfile
        if [[ $host = $localhost ]]
@@ -5011 +4612 @@
           if [[ $host = ibmkisti ]]
           then
-                # on KISTI's IBM firewall is only opened on interactive node
+                # ON KISTI'S IBM FIREWALL IS ONLY OPENED ON INTERACTIVE NODE
              echo  "localdir=\`pwd\`"                            >>  $jobfile
              echo  "ssh $SSH_PORTOPT $remote_username@gaiad \"cd \$localdir; scp $PORTOPT -r  $return_username@$return_addres:$working_directory/SOURCES_FOR_RUN_$fname .\" "  >>  $jobfile
@@ -5029 +4630 @@
        echo  "export SOURCES_COMPLETE=true"                      >>  $jobfile
 
-          # QUELLTEXTE, MRUN-SCRIPT UND KONFIGURATIONSDATEI IN DAS AKTUELLE
-          # ARBEITSVERZEICHNIS VERSCHIEBEN
+          # MOVE MRUN-SCRIPT AND CONFIGURATION-FILE FROM THE SOURCES_FOR_RUN... DIRECTORY TO THE
+          # WORKING DIRECTORY OF THE JOB
        echo  "mv  SOURCES_FOR_RUN_$fname/$config_file  . "       >>  $jobfile
        echo  "mv  SOURCES_FOR_RUN_$fname/$mrun_script_name  . "  >>  $jobfile
@@ -5039 +4640 @@
     else
 
-          # ABSPEICHERN DER QUELLTEXTE (NUR FALLS UEBERSETZT WERDEN SOLL)
-          # SOWIE GEGEBENENFALLS DES MAKEFILES
+          # PROVIDE SOURCE-CODE FILES AND MAKEFILE AS HERE DOCUMENT
        if [[ $do_compile = true ]]
        then
@@ -5046 +4646 @@
           source_catalog=SOURCES_FOR_RUN_$fname
 
-              # UNTERVERZEICHNIS FUER QUELLTEXTE UND MAKEFILE ANLEGEN
-              # MRUN WIRD DIESES VRZEICHNIS UEBER ENVIRONMENT VARIABLE
-              # MITGETEILT (UEBERSTEUERT ANGABE IN KONFIGURATIONSDATEI)
+              # CREATE SOURCES_FOR_RUN... DIRECTORY TO STORE THE SOURCE CODE FILES AND THE MAKEFILE
           echo  "mkdir  SOURCES_FOR_RUN_$fname"                >>  $jobfile
           echo  "export SOURCES_COMPLETE=true"                 >>  $jobfile
@@ -5055 +4653 @@
           for  filename  in  $source_list
           do
-                # ABDECKZEICHEN VERHINDERN, DASS ERSETZUNGEN ERFOLGEN
+                # BACKSLASH IS USED FOR MASKING
              echo  "cat > $filename << \"%END%\""              >>  $jobfile
              cat   $source_catalog/$filename                   >>  $jobfile
@@ -5063 +4661 @@
           done
 
-             # ABDECKZEICHEN VERHINDERN, DASS ERSETZUNGEN ERFOLGEN
+             # BACKSLASH IS USED FOR MASKING
           echo  "cat > Makefile << \"%END%\""               >>  $jobfile
           cat   $source_catalog/Makefile                    >>  $jobfile
@@ -5075 +4673 @@
 
 
-          # ABSPEICHERN DER KONFIGURATIONSDATEI
-          # ABDECKZEICHEN VERHINDERN, DASS ERSETZUNGEN ERFOLGEN
-          # Lines with #$ coming from the svn keyword substitution are
-          # removed from the config file in order to avoid problems
-          # with the SGE batch system
+          # PROVIDE THE CONFIGURATION-FILE AS HERE-DOCUMENT
+          # BACKSLASH IS USED FOR MASKING
+          # LINES WITH #$ IN THE CONFIGURATION-FILE, COMING FROM THE SVN KEYWORD SUBSTITUTION,
+          # ARE REMOVED FROM THE FILE IN ORDER TO AVOID PROBLEMS WITH THE SGE BATCH SYSTEM
        echo  "cat > $config_file << \"%END%\""      >>  $jobfile
        if [[ $host = lckyuh ]]
        then
-             # no cross compiler on compute node
+             # NO CROSS-COMPILER ON COMPUTE NODE
           sed  's/frtpx/frt/g'  $config_file        >>  $jobfile
        else
@@ -5092 +4689 @@
 
 
-          # ABSPEICHERN DER AKTUELLEN MRUN-VERSION
-          # ABDECKZEICHEN VERHINDERN, DASS ERSETZUNGEN ERFOLGEN
+          # PROVIDE THE MRUN-SCRIPTS AS HERE-DOCUMENT
+          # BACKSLASH IS USED FOR MASKING
        echo  "cat > $mrun_script_name <<\"%END%\""  >>  $jobfile
        if [[ $host = lckyuh ]]
@@ -5109 +4706 @@
 
 
-       # EVTL. BENOETIGTE INPUT-DATEIEN PER FTP HOLEN ODER DEM JOB DIREKT
-       # MITGEBEN UND AUF DEM REMOTE-RECHNER IM BENUTZERVERZEICHNIS ABLEGEN
-       # FALLS DIESES NICHT EXISTIERT, WIRD VERSUCHT, DAS JEWEILS LETZTE
-       # UNTERVERZEICHNIS DES PFADNAMENS ANZULEGEN
+       # GET REQUIRED INPUT-FILES BY SCP OR BY SENDING THEM WITH THE JOB AS HERE-DOCUMENT
+       # PUT THESE FILES INTO THE USER'S RESPECTIVE PERMANENT DIRECTORIES ON THE REMOTE-HOST
+       # IF THE DIRECTORIES DO NOT EXIST, TRY TO CREATE THEM
     if [[ $do_remote = true ]]
     then
@@ -5130 +4726 @@
           fi
 
-             # UEBERPRUEFEN, OB DATEI ANGELEGT WERDEN KONNTE
+             # CHECK, IF FILE COULD BE CREATED
           echo  "if [[ \$? = 1 ]]"                    >>  $jobfile
           echo  "then"                                >>  $jobfile
@@ -5142 +4738 @@
     fi
 
-       # ARBEITSKATALOG AUF DER LOKALEN MASCHINE FUER EVENTUELLE 
-       # FORTSETZUNGSLAUEFE PER ENV-VARIABLE UEBERGEBEN
+       # PROVIDE NAME OF THE CURRENT WORKING-DIRECTORY ON THE LOCAL MACHINE (FROM WHERE THE JOB IS
+       # STARTED) BY SETTING AN ENVIRONMENT-VARIABLE. THIS INFORMATION IS USED IN THE JOB BY MRUN
+       # IN CASE THAT RESTART-RUNS HAVE TO BE GENERATED
     echo  "LOCAL_PWD=$working_directory"                >>  $jobfile
     echo  "export LOCAL_PWD"                            >>  $jobfile
 
-       # EBENSO LOKALEN MRUN-KATALOG UEBERGEBEN 
+       # PROVIDE THE PATH OF THE LOCAL MRUN-SCRIPT FOR THE SAME REASON 
     echo  "LOCAL_MRUN_PATH=$PALM_BIN"                   >>  $jobfile
     echo  "export LOCAL_MRUN_PATH"                      >>  $jobfile
 
-       # WORKAROUND FUER RIAM-NEC-JOBS WEGEN PROFILE-SCHWIERIGKEITEN
-    if [[ $localhost_realname = "gate"  ||  $localhost = lctit ]]
-    then
-       echo  "export PALM_BIN=$PALM_BIN"                >>  $jobfile
-    elif [[ $host = lcflow  ||  $localhost = lcflow ]]
+       # lcflow ALSO REQUIRES TO PROVIDE PATH FOR THE PALM-SCRIPTS
+    if [[ $host = lcflow  ||  $localhost = lcflow ]]
     then
        echo  "export PALM_BIN=$PALM_BIN" | sed -e 's:'$HOME':$HOME:'   >>  $jobfile
@@ -5161 +4755 @@
     fi
 
-       # MRUN AUF ZIELRECHNER AUFRUFEN (queue is workaround for ibmkisti)
+       # CALL MRUN WITHIN THE JOB (SETTING QUEUE IS A WORKAROUND FOR ibmkisti)
+       # AS FINAL ACTION, REMOVE THE TEMPORARY DIRECTORY CREATED AT THE BEGINNING OF THE JOB
     echo  "set -x"                                        >>  $jobfile
     echo  "queue=$queue"                                  >>  $jobfile
@@ -5172 +4767 @@
 
 
-       # JOB PER SUBJOB STARTEN
+       # START THE JOB USING SUBJOB-COMMAND
     if [[ $silent = false ]]
     then
@@ -5184 +4779 @@
 
 
- fi  # ENDE REMOTE-TEIL
-
-
-
-     # ENDE DER PROZEDUR
+ fi  # END OF REMOTE-PART