Changes between Version 5 and Version 6 of doc/app/palm_iofiles

Timestamp:

Oct 30, 2018 2:24:59 PM (6 years ago)

Author:

raasch

Comment:

--

doc/app/palm_iofiles

@@ -43 +43 @@
   Same as {{{pe}}}, but the folders are transferred between the local and the remote host via {{{scp}}}.
 
-The '''third column''' gives the so-called activation strings. Two or more strings need to be separated by colons (":"). Activation strings are those given in the {{{palmrun}}} option {{{-a}}}. The respective file connection statement is only processed (i.e. the file is copied), if at least one of its activation strings is set with option {{{-a}}}. In case of the above example, {{{-d "d3#"}}} causes {{{palmrun}}} to provide the input files {{{PARIN}}} and {{{TOPOGRAPHY_DATA}}}. Option {{{-d "d3# restart"}}} additional copies/saves the output file {{{BINOUT}}}. Note that activation strings need to be separated by blanks when given with the option {{{-d}}} and that they need to be embraced by {{{"}}}, even if only one string is given (otherwise, a {{{#}}} would cause the shell to interpret the remaining part of the command as a comment). For output files, a wildcard may be given in the third column. Respective local files will then always be copied, in case they exist, independently from the activation strings given with option {{{-d}}}. No warning will be issued if no file exists. Wildcards in the third column are not allowed for input files.
+The '''third column''' gives the so-called activation strings. Two or more strings need to be separated by colons (":"). Activation strings are those given in the {{{palmrun}}} option {{{-a}}}. The respective file connection statement is only processed (i.e. the file is copied), if at least one of its activation strings is set with option {{{-a}}}. In case of the above example, {{{-r "d3#"}}} causes {{{palmrun}}} to provide the input files {{{PARIN}}} and {{{TOPOGRAPHY_DATA}}}. Option {{{-r "d3# restart"}}} additional copies/saves the output file {{{BINOUT}}}. Note that activation strings need to be separated by blanks when given with the option {{{-r}}} and that they need to be embraced by {{{"}}}, even if only one string is given (otherwise, a {{{#}}} would cause the shell to interpret the remaining part of the command as a comment). For output files, a wildcard may be given in the third column. Respective local files will then always be copied, in case they exist, independently from the activation strings given with option {{{-r}}}. No warning will be issued if no file exists. Wildcards in the third column are not allowed for input files.
 
-The path to the user's permanent file is given in the '''fourth column'''. It may contain environment variables that have been defined in the file connection file. {{{$jobname}}} will be replaced with the argument of {{{palmrun}}} option {{{-d}}}.
+The path to the user's permanent file is given in the '''fourth column'''. It may contain environment variables that have been defined in the file connection file. {{{$jobname}}} will be replaced with the argument of {{{palmrun}}} option {{{-r}}}.
 
 The '''fifth column''' gives the appendix of the user's permanent file.
@@ -54 +54 @@
 == Determination of full file paths
 
-The full path for input and output files is based on columns 4-6 and the argument of {{{palmrun}}} option {{{-d}}}:
+The full path for input and output files is based on columns 4-6 and the argument of {{{palmrun}}} option {{{-r}}}:
 {{{
-    <column 4>/<-d option><column 5>[.<column 6>]
+    <column 4>/<-r option><column 5>[.<column 6>]
 }}}
 As an example, the file connection statement
@@ -66 +66 @@
 %base_data         ~/palm/current_version/JOBS
 }}}
-in the file connection file, plus the call {{{palmrun -d example_test ...}}} will create the output file
+in the file connection file, plus the call {{{palmrun -r example_test ...}}} will create the output file
 {{{
   ~/palm/current_version/JOBS/example_test/OUTPUT/example_test_3d.nc