Changes between Version 29 and Version 30 of doc/app/runs

Timestamp:

May 31, 2021 6:41:51 AM (3 years ago)

Author:

raasch

Comment:

--

doc/app/runs

@@ -26 +26 @@
       palmrun -c default -r abcde  -t 900 -X 96 -T 48  -a “d3# restart” -b -q queue_name
 }}}
-Giving the activation string {{{restart}}} as argument of option {{{-a}}} is essential. Only for that case the model writes binary data for a restart run to the local file [../iofiles#BINOUT BINOUT] (in case of running on more than 1 core, BINOUT is a folder). The local output file is then saved to a permanent file as defined in the file connection statement for BINOUT. The last line of the example above shows that saving of the file is only be done of the activation string {{{restart}}} has been set.
+It is mandatory to provide the activation string {{{restart}}} as argument of option {{{-a}}}. Only then the model writes binary data for a restart run to the local file [../iofiles#BINOUT BINOUT] (in case of running on more than 1 core, BINOUT is a folder). The local output file is then saved to a permanent file as defined in the file connection statement for BINOUT. The last line of the example above shows that saving of the file is only be done of the activation string {{{restart}}} has been set.
 
 Only by specifying {{{restart}}} as activation string, PALM is instructed to compute the remaining CPU time after each time step and to stop, if the run is not going to be completed and finished briefly before expiration of this time. Actually the stop takes place when the difference between the available job time (determined by the '''[wiki:doc/app/palmrun palmrun]''' option {{{-t}}}) and the time used by the job so far becomes smaller than the time given by the runtime parameter [../runtime_parameters#termination_time_needed termination_time_needed]. The runtime parameter '''termination_time_needed''' can be used to inform PALM, how much time is required for copying the binary data for restart runs, as well as for other pre- or post-processing steps that are done within the job. Thus, as soon as the remaining job time is less than '''termination_time_needed''', PALM interrupts the time stepping and outputs the restart data to local file/folder [../iofiles#BINOUT BINOUT]. The [../initialization_parameters initialization parameters] are also added to that file. In a last step, PALM creates a flag file with local name {{{CONTINUE_RUN}}}. The presence of this file signals '''[wiki:doc/app/palmrun palmrun]''' that a restart run needs to be generated and initiates and starts a respective job.