Receiving a coupling (or I/O) field

In the component time stepping loop, each process receives its part of the coupling field.

• CALL oasis_get (var_id, date, fld, info)
• CALL prism_get_proto(var_id, date, fld, info)
  • var_id [INTEGER; IN]: field ID (returned by the corresponding oasis_def_var)
  • date [INTEGER; IN]: number of seconds (or any other time units as long as the same are used in all components and in the namcouple) at the time of the call (by convention at the beginning of the timestep)
  • fld [REAL, OUT]: I/O or coupling field array
  • info [INTEGER; OUT]: returned info code:
    • OASIS_Recvd(=3) if the field was received from another component
    • OASIS_FromRest (=10) if the field was read from a restart file only
    • OASIS_Input (=11) if the field was read from an input file only
    • OASIS_RecvOut (=12) if the field was both received from another component and written to an output file
    • OASIS_FromRestOut (=13) if the field was both read from a restart file and written to an output file
    • OASIS_Ok (=0) otherwise and no error occurred.

To ensure a proper use of the oasis_get, one has to take care of the following aspects:

• This routine may be called by the component at each timestep. The date argument is automatically analysed and the receiving action is actually performed only if date corresponds to a time for which it should be activated, given the period indicated by the user in the namcouple. An exchange at the beginning of the run at time=0 is expected.

• Trying to receive with oasis_get a field declared with a oasis_def_var but not defined in the configuration file namcouple will lead to an abort. In this case, the field ID returned by the oasis_def_var is equal to -1 and the corresponding oasis_get should not be called.

• If a coupling field has a positive lag, the coupling field that matches the oasis_get at time=0 will come from a coupling restart file written by the last active oasis_put of the previous run (see section 2.3).