First section of namcouple file

The first section of namcouple uses some predefined keywords prefixed by the $ sign to locate the related information. The $ sign must be in the second column. Only 4 keywords are really used by OASIS3-MCT_3.0:

• $NFIELDS: On the line below this keyword, put a number equal (or greater) to the total number of field entries in the second part of the namcouple. If more than one field are described on the same line, this counts as only one entry.

• $RUNTIME: On the line below this keyword, put the total simulated time of the run, expressed in seconds (or any other time units as long as the same are used in all components and in the namcouple, see 2.2.7).

• $NLOGPRT: The first and second numbers on the line below this keyword refer to the amount of debug and time statistic information written by OASIS3-MCT for each component and process.

  The first number (that can be modified at runtime with the oasis_set_debug routine, see section 2.2.9) may be:

  • 0 : production mode. One file debug.root.xx is open by the master process of each component and one file debug_notroot.xx is open for all the other processes of each component to write only error information.
  • 1 : one file debug.root.xx is open by the master process of each component to write information equivalent to level 10 (see below) and also to write memory usage information; one file debug_notroot.xx is open for all the other processes of each component to write error information.
  • 2 : one file debug.yy.xxxxxx is open by each process of each component (with ``yy” being the component number and ``xxxxxx” the process number) to write normal production diagnostics and memory usage information
  • 5 : as for 2 with in addition some initial debug info
  • 10: as for 5 with in addition the routine calling tree
  • 12: as for 10 with in addition some routine calling notes
  • 15: as for 12 with even more debug diagnostics
  • 20: as for 15 with in addition some extra runtime analysis
  • 30: full debug information
  The second number defines how time statistics are written out to file comp_name.timers_xxxx (with comp_name being the component name, see section 2.2.2); it can be:
  • 0 : nothing is calculated or written.
  • 1 : some time statistics are calculated and written in a single file by the processor 0 as well as the min and the max times over all the processors.
  • 2 : some time statistics are calculated and each processor writes its own file ; processor 0 also writes the min and the max times over all the processors in its file.
  • 3 : some time statistics are calculated and each processor writes its own file ; processor 0 also writes in its file the min and the max times over all processors and also writes in its file all the results for each processor.
  For more information on the time statistics written out, see section 6.4.2.

  The second number can also be set to -1 to activate the lucia tool that can be used to perform an analysis of the coupled components load balance. More information can be found in the README file in oasis3-mct/util/lucia directory and report mentioned therein.

• $SEQMODE, $CHANNEL, $JOBNAME, $NBMODEL, $INIDATE, $MODINFO, $CALTYPE: UNUSED