OpenIFS: Enable XIOS during compilation

This section shows how to enable XIOS when compiling OpenIFS so the model can use it.

OpenIFS should be compiled as usual (see 5.5 Building OpenIFS), but setting some environment variables in oifs-config.sh (like NetCDF or GRIB variables):

export OIFS_XIOS=enable
export OIFS_XIOS_DIR=$HOME/xios-install

You can optionally add these variables, but for a typical installation it should not be necessary:

export OIFS_XIOS_INCLUDE=<editme if necessary>
export OIFS_XIOS_LIB=<editme if necessary>

As you might be aware, it is possible to make a customized compilation of OpenIFS (see 5.7 Customize building OpenIFS) by creating your own configuration file:

make/fcm/${OIFS_COMP}-${OIFS_BUILD}.fcm

If you use a different compiler with regard to those predefined in OpenIFS, it requires creating two new configuration files to control the building with XIOS:

make/fcm/xios/${OIFS_COMP}-enable.fcm
make/fcm/xios/${OIFS_COMP}-disable.fcm

You can just create a symbolic link of ${OIFS_COMP}-disable.fcm pointing to disable.fcm, and depending on the needs of your compiler, also create a symbolic link of ${OIFS_COMP}-enable.fcm to an existing file. If this is not the case, you should then create your ${OIFS_COMP}-enable.fcm file.