View source for User's and Developer's Guide for Fortuna 2.3

= Saving State (restart files) =

Normally the model saves a set of restart files at the end of each run segment to have a record of the state when it starts the next segment.  The model can also save restarts during a segment.  The parameters for this function are set in the following fields in AGCM.rc:

 # Restart Record Parameters
 # -------------------------
 #RECORD_FINAL:  >>>RECFINL<<<
 #RECORD_FREQUENCY: 000000       000000
 #RECORD_REF_DATE: >>>REFDATE<<< >>>FCSDATE<<<
 #RECORD_REF_TIME: >>>REFTIME<<< >>>FCSTIME<<<

The lines above need to be uncommented and appropriate parameters entered.  The fields are set as follows:

<code>RECORD_FINAL</code> determines whether a set of restarts is saved at the end of the segment.  The default is yes and the line needn't be changed to achieve this.  Otherwise modify the line to match

 RECORD_FINAL:  NO

<code>RECORD_FREQUENCY</code> determines how often in hours restarts are saved after being first saved at the model time set by the parameters that follow.  For example, if restarts are to be saved every six hours, the line should read

 RECORD_FREQUENCY:  060000

If restarts are to be saved only once before the end of the segment, then it should be set to 0.

<code>RECORD_REF_DATE</code> and <code>RECORD_REF_TIME</code> are the model time and date of the first saved restarts.  They are in the formant YYYYMMDD and HHMMSS respectively, and should replace <code>>>>REFDATE<<<</code> and <code>>>>REFTIME<<<</code>.  The strings <code>>>>FCSDATE<<<</code> and <code>>>>FCSTIME<<<</code> are used for DAS runs and should otherwise be deleted.

The files (with the date appended to the filename) are saved to the scratch directory, which gets wiped at the beginning of a new segment, so you have to include something in the run script to move them out at the end of the segment.