Index: palm/trunk/SCRIPTS/batch_scp
===================================================================
--- palm/trunk/SCRIPTS/batch_scp	(revision 2718)
+++ palm/trunk/SCRIPTS/batch_scp	(revision 3549)
@@ -27,4 +27,7 @@
 # -----------------
 # $Id$
+# english translation of german comments / variable names
+# 
+# 2718 2018-01-02 08:49:38Z maronga
 # Corrected "Former revisions" section
 # 
@@ -87,5 +90,5 @@
 
  
-    # VARIABLENVEREINBARUNGEN + DEFAULTWERTE 
+    # VARIABLE DECLARATIONS + DEFAULT VALUES 
  random=$RANDOM
 
@@ -111,6 +114,7 @@
  typeset -i iii icycle maxcycle=0 usecycle wait=0
 
-    # FEHLERBEHANDLUNG
-    # BEI EXIT:
+
+    # ERROR HANDLING IN CASE ...
+    # ... EXIT
  trap 'if [[ $locat != normal ]]
        then
@@ -125,5 +129,5 @@
 
 
-    # BEI TERMINAL-BREAK:
+    # ... TERMINAL-BREAK:
  trap 'rm -rf $filelist $errfile
        printf " +++ BATCH_SCP terminated \n\n"
@@ -132,5 +136,5 @@
 
 
-    # SHELLSCRIPT-OPTIONEN EINLESEN
+    # READ SHELLSCRIPT-OPTIONS
  while  getopts  :aAbcCdgmnoP:qsu:U:w:  option
  do
@@ -164,5 +168,5 @@
 
  
-    # KURZE AUFRUFBESCHREIBUNG WIRD HIER AUSGEGEBEN
+    # LIST SHORT DESCRIPTION OF AVAILABLE OPTIONS
  if [ "$1" = "?" ]
  then
@@ -194,5 +198,5 @@
     printf "\n      any time and have the following meaning:"
     printf "\n        <param1>  -  IP-adress of destination host"
-    printf "\n                     or \"?\"  (creates this outline)"
+    printf "\n                     or \"?\"  (creates this short summary of options)"
     printf "\n        <param2>  -  abs. or rel. path of file to be transferred"
     printf "\n        <param3>  -  directory (abs.!) on destination host. Special cahracters"
@@ -206,5 +210,5 @@
 
 
-    # PRUEFEN, OB ALLE ARGUMENTE VORLIEGEN
+    # CHECK FOR COMPLETENESS OF ARGUMENTS
  if [[ "$1" = "" ]]
  then
@@ -229,19 +233,11 @@
  if [[ -z $remote_user ]]
  then
-
-       # PRUEFEN, OB NETRC-DATEI VORHANDEN
-    if [[ ! -f ~/.netrc ]]
-    then
-       printf " +++ option -u not given; \n"
-       printf "     getting remote-username from password file failed \n"
-       printf "     because ~/.netrc does not exist \n"
-       locat=netrc; exit
-    fi
-    grep  $1  ~/.netrc | read dum dum dum remote_user dum dum
- fi
-
-
-    # APPEND IST NUR BEI TRANSFER EINZELNER DATEIEN OHNE UEBERSCHREIBEN
-    # ERLAUBT. GET IST DABEI EBENFALLS NICHT ERLAUBT
+    printf " +++ option -u is missing \n"
+    locat=remote_user; exit
+ fi
+
+
+    # APPEND IS ONLY ALLOWED FOR TRANSFER OF SINGLE FILES WITHOUT OVERWRITING
+    # IN SUCH A CASE GET IS NOT ALLOWED TOO
  if [[ $append = true  &&  ( $get = true || $catalog_copy = true || $overwrite = true ) ]]
  then
@@ -251,5 +247,5 @@
 
 
-    # QUOTE WAIT FUNKTIONIERT NICHT BEIM KOPIEREN GANZER VERZEICHNISSE
+    # QUOTE WAIT DOES NOT WORK IF COMPLETE FOLDERS ARE COPIED
  if [[ $quote_wait = true  &&  $catalog_copy = true ]]
  then
@@ -259,14 +255,14 @@
 
 
-    # IM CHECK-MODUS WIRD SCRIPT HIER BEENDET
+    # SCRIPT WILL BE ENDED HERE IN CASE OF CHECK-MODE
  [[ $check = true ]]  &&  exit
 
 
-    # BESTIMMTE ZEIT WARTEN, BIS WEITERGEMACHT WIRD (NOETIG Z.B. BEI TRANSFER
-    # VON JOBPROTOKOLLEN AUS JOBS HERAUS)
+    # WAIT A BIT (MAY BE REQUIRED IN CASE OF TRANSFERS OF JOB PROTOCOLS FROM
+    # WITHIN A JOB)
  sleep  $wait
 
 
-    # Set port number option for calls of ssh/scp, subjob and batch_scp scripts
+    # SET PORT NUMBER OPTION FOR CALLS OF SSH/SCP
  if [[ "$scp_port" != "" ]]
  then
@@ -276,5 +272,5 @@
 
 
-    # PRUEFEN, OB LOKALE DATEI/LOKALES VERZEICHNIS VORHANDEN BZW. NICHT VORHANDEN
+    # CHECK, IF LOCAL FILE/FOLDER EXISTS
  if [[ $get = false ]]
  then
@@ -308,5 +304,5 @@
        else
 
-             # PRUEFEN, OB SICH LOKALE DATEI ANLEGEN LAESST
+             # CHECK, IF LOCAL FILE CAN BE CREATED
           local_dirname=`dirname $2`
           if [[ ! -d $local_dirname ]]
@@ -330,5 +326,5 @@
 
 
-    # VERZEICHNISLSTE DES ZIELRECHNERS ERSTELLEN
+    # CREATE FILE LIST OF THE TARGET HOST FOLDER
  ssh $SSH_PORTOPT $1 -l $remote_user "unset LANG; cd $3; ls -1; echo '*** list complete'" > $filelist  2>&1
  ssh_status=$?
@@ -350,7 +346,6 @@
 
 
-    # PRUEFEN, OB VERZEICHNIS VORHANDEN IST. WENN GANZES VERZEICHNISS ZUM
-    # ZIELRECHNER KOPIERT WERDEN SOLL, DARF DORT NOCH KEIN ENTSPRECHENDES
-    # VERZEICHNIS VORHANDEN SEIN
+    # CHECK, IF FOLDER EXISTS. A FOLDER MUST NOT EXIST, IF COMPLETE FOLDERS
+    # SHALL BE COPIED TO THE TARGET HOST
  if [[ $(cat $filelist | grep -c "not found") != 0  || \
        $(cat $filelist | grep -c "No such file or directory") != 0 ]]
@@ -375,12 +370,11 @@
 
 
-    # PRUEFEN, OB DATEI/VERZEICHNIS VORHANDEN, WENN JA, HOECHSTEN ZYKLUS
-    # ERMITTELN (BZW. IM ABSOLUT-MODUS PRUEFEN, OB DATEI VORHANDEN IST)
-    # DAS GANZE ABER NUR, WENN NICHT OVERWRITE-MODUS GEWAEHLT WURDE, DIE
-    # EVENTUELL VORHANDENE DATEI ALSO UEBERSCHRIEBEN WERDEN SOLL
+    # CHECK, IF FILE/FOLDER EXISTS. IF SO, DETERMINE HIGHEST CYCLE NUMBER
+    # (OR CHECK, IN ABSOLUT-MODE, IF FILE EXSITS)
+    # BUT DO THIS IN NON-OVERWRITE-MODE ONLY
  found=false
  if [[ ( $overwrite = false   &&  $get = false )  ||  $get = true ]]
  then
-    while  read zeile
+    while  read line
     do
        if [[ $absolut = false ]]
@@ -389,13 +383,13 @@
           if [[ "$5" != ""  &&  "$5" != " " ]]
           then
-             extension=${zeile##*.}
+             extension=${line##*.}
              if [[ $extension = $5 ]]
              then
-                text=${zeile%.*}
+                text=${line%.*}
              else
-                text=${zeile}
+                text=${line}
              fi
           else
-             text=${zeile}
+             text=${line}
           fi
 
@@ -446,7 +440,6 @@
        else
 
-             # IM ABSOLUT-MODUS MUSS NUR GEPRUEFT WERDEN, OB DIE DATEI
-             # VORHANDEN IST
-          [[ $4 = $zeile ]]  &&  found=true
+             # ABSOLUT-MODE ONLY REQUIRES TO CHECK IF FILE EXISTS
+          [[ $4 = $line ]]  &&  found=true
        fi
 
@@ -523,6 +516,5 @@
     fi
 
-       # ABBRUCH, WENN DATEI VON ZIELRECHNER GEHOLT WERDEN SOLL, DORT ABER
-       # NICHT VORHANDEN IST
+       # EXIT, IF FILE SHALL BE GET FROM THE TARGET HOST, BUT DOESN'T EXIST
     if [[ $get = true ]]
     then
@@ -534,6 +526,6 @@
 
 
-    # FALLS KATALOG ERZEUGT WIRD, DARF DIE DATEI IN KEINEM FALL EINE
-    # ZYKLUSNUMMER BESITZEN, DA SIE JA NOCh GARNICHT EXISTIEREN KANN
+    # IF A FOLDER IS CREATED, THE FILENAME MUST NOT CONTAIN A CYCLE NUMBER IN
+    # ANY CASE, SINCE IT CANNOT HAVE ONE
  if [[ $make_catalog = force ]]
  then
@@ -543,6 +535,6 @@
 
  
-    # FALLS NAMENSOPTION (-n) GEWAEHLT WURDE, NUR DEN ERMITTELTEN LOKALEN
-    # DATEINAMEN DES ZIELRECHNERS AUSGEBEN UND SCRIPT BEENDEN
+    # IF NAME-OPTION (-n) IS CHOSEN, ONLY DETERMINE THE LOCAL FILENAME ON THE
+    # TARGET HOST AND EXIT THE SCRIPT
  if [[ $print_local_filename = true ]]
  then
@@ -553,7 +545,6 @@
 
 
-    # FALLS 5. ARGUMENT ANGEGEBEN WURDE, WIRD DIES ALS FILE-EXTENSION
-    # HINTER DIE ZYKLUS-NUMMER GEHAENGT (FUNKTIONIERT NUR BEI KOPIEREN EINER
-    # DATEI AUF ZIELRECHNER
+    # IF A 5. ARGUMENT IS GIVEN, IT WILL BE PUT AS FILENAME EXTENSION/APPENDIX
+    # AFTER THE CYCLE NUMBER (ONLY WORKS IN CASE OF FILE COPY TO THE TARGET HOST)
  if [[ "$5" != ""  &&  $get = false ]]
  then
@@ -562,6 +553,6 @@
 
 
-    # BEI VERZEICHNISTRANSFER VON ZIELRECHNER AUF LOKALEN RECHNER PRUEFEN, OB
-    # $3 AUF ZIELRECHNER WIRKLICH EIN VERZEICHNIS IST
+    # IN CASE OF FOLDER TRANSER TO THE TARGET HOST, CHECK IF ARGUMENT $3 REALLY
+    # REFERS TO A FOLDER ON THE TARGET HOST
  if [[ $catalog_copy = true  &&  $get = true ]]
  then
@@ -584,6 +575,6 @@
 
 
-    # BEI KATALOGTRANSFER AUF LOKALEN RECHNER ENTSPRECHENDES VERZEICHNIS
-    # ANLEGEN
+    # IN CASE OF FOLDER TRANSFER FROM THE TARGET HOST TO THE LOCAL HOST,
+    # CREATE THE RESPECTIVE FOLDER ON THE LOCAL HOST
  if [[ $catalog_copy = true ]]
  then
@@ -599,5 +590,5 @@
 
 
-    # DATEI/VERZEICHNIS PER SCP UEBERTRAGEN
+    # COPY FILE/FOLDER VIA SCP
  if [[ $get = false ]]
  then
@@ -617,6 +608,5 @@
           if [[ $scp_status != 0 ]]
           then
-                # CHECK, OB DATEIGROESSEN AUF LOKALEM UND REMOTERECHNER
-                # UEBEREINSTIMMEN
+                # CHECK, IF FILE SIZES ON LOCAL HOST AND TARGET HOST MATCH
              local_size=`ls -al  $2`
              local_size=`echo $local_size | cut -d" " -f5`
@@ -640,6 +630,5 @@
           if [[ $? != 0 ]]
           then
-                # CHECK, OB DATEIGROESSEN AUF LOKALEM UND REMOTERECHNER
-                # UEBEREINSTIMMEN
+                # CHECK, OB IF FILE SIZES ON LOCAL HOST AND TARGET HOST MATCH
              local_size=`ls -al  $2`
              local_size=`echo $local_size | cut -d" " -f5`
@@ -724,5 +713,5 @@
 
 
-    # EVTL. TRANSFERIERTE DATEI AUF LOKALEM RECHNER LOESCHEN
+    # DELETE TRANSFERED FILE ON THE LOCAL HOST
  if [[ $delete = true  &&  $get = false ]]
  then
@@ -732,5 +721,5 @@
 
 
-    # ABSCHLUSSMELDUNG
+    # FINAL MESSAGES
  if [[ $silent = false ]]
  then
