An example of how to generate a restart file for the OASIS4 toyoa4 toy coupled model is available in directory oasis4/examples/toyoa4_restart. In the toyoa4 toy coupled model, a field with name COSENHFL is send from the atmosphere component to the land component; if a lag is specified for this field in the atmosphere SMIOC file, a restart file must be provided for this field at the beginning of the run. The sources from the toyoa4_restart example can serve as a template for the user to create her own restart files by extending the Fortran source (atmoa4_rsst.F90) and the XML file (atmoa4_atmos_smioc.xml).
One can note that although grid information is written into the restart file, this information is not interpreted by the OASIS4 PSMILe at runtime when the restart is read in. By having a closer look at atmoa4_rst.F90, one will recognise that only a dummy grid is written out, but that the size of the field written to the file exactly cover the valid shape of the global grid. The date in the restart file name and the time information written into the restart file must match with the start_date of toyoa4 first run. To achieve this, the run start_date and end_date and the upper date_bounds (date_bounds(2)) of the prism_put_restart are set to the toyoa4 initial run start_date which is 1 Jan 2000, 0:0:00.0.
If the same toy example is run with lag set to zero no restart file is required, and the first prism_get in the land model will be served by the first prism_put of the atmosphere.