创建头文件
==========

在编写任务脚本之前，我们先创建一些头文件 (include files)，包括每个 ecFlow 任务都必须使用的两个头文件 **head.h** 和 **tail.h**。

在 ``${TUTORIAL_HOME}/def`` 目录下创建两个子目录：

.. code-block:: bash

    cd ${TUTORIAL_HOME}/def
    mkdir -p include
    mkdir -p ecffiles
    cd include

head.h
-----------

**head.h** 放在 ecf 脚本开头，完成如下任务：

- 准备与 ecFlow 服务通信的环境变量
- 定义脚本错误处理函数。当错误发生，通知服务该任务进入 *aborted* 状态
- 使用 ``ecflow_client`` 命令通知服务该任务已经开始

在 ``${TUTORIAL_HOME}/def/include`` 中创建头文件 **head.h**：

.. code-block:: bash

    #!/bin/ksh

    set -e          # stop the shell on first error
    set -u          # fail when using an undefined variable
    set -x          # echo script lines as they are executed
    # set -o pipefail # fail if last(rightmost) command exits with a non-zero status

    date

    export ECF_PORT=%ECF_PORT%    # The server port number
    export ECF_HOST=%ECF_HOST%
    export ECF_NODE=%ECF_HOST%    # The host name where the server is running
    export ECF_NAME=%ECF_NAME%    # The name of this current task
    export ECF_PASS=%ECF_PASS%    # A unique password
    export ECF_TRYNO=%ECF_TRYNO%  # Current try number of the task

    . /etc/profile.d/modules.sh

    export GEODIAG_ROOT=/g1/u/nwp_pd/GEODIAG
    export GEODIAG_TOOLS=/g1/u/nwp_pd/GEODIAG/tools

    PATH=$PATH:$HOME/bin

    RID=$( echo ${SLURM_JOB_ID:-0} )
    if [ $RID -eq 0 ] ; then
      RID=$$
    fi
    export ECF_RID=$RID

    # Tell ecFlow we have started
    ecflow_client --init=$RID

    # Define a error handler
    ERROR() {
       set +e                      # Clear -e flag, so we don't fail
       wait                        # wait for background process to stop
       ecflow_client --abort=trap  # Notify ecFlow that something went wrong, using 'trap' as the reason
       trap 0                      # Remove the trap
       exit 0                      # End the script
    }
    # Trap any calls to exit and errors caught by the -e flag

    trap ERROR 0

    # Trap any signal that may cause the script to fail

    #trap ' echo "Killed by a signal"; ERROR ; ' 1 2 3 4 5 6 7 8 10 12 13 15
    #trap '{ echo "Killed by a signal"; ERROR ; }' 1 2 3 4 5 6 7 8 10 12 13 15
    trap '{ echo "Killed by a signal";trap 0;ERROR; }' 1 2 3 4 5 6 7 8 10 12 13 15
    echo "exec on hostname:" $(hostname)



tail.h
-----------

**tail.h** 放在 ecf 脚本结尾，通知服务该任务已经完成。

在 ``${TUTORIAL_HOME}/def/include`` 中创建头文件 **tail.h**：

.. code-block::

    date
    wait                      # wait for background process to stop
    ecflow_client --complete  # Notify ecFlow of a normal end
    trap 0                    # Remove all traps
    exit 0                    # End the shell

    # slsubmit6 %ECF_JOB% %ECF_NAME% %ECF_TRIES% %ECF_TRYNO% %ECF_HOST% %ECF_PORT%
    # slcancel4 %ECF_RID% %ECF_NAME% %ECF_HOST% %ECF_PORT%


configure.h
----------------

**configure.h** 用于设置模式参数和目录。

在 ``${TUTORIAL_HOME}/def/include`` 中创建头文件 **configure.h**：

.. code-block:: bash

    #------------
    # START: configure.h
    #------------

    PROGRAM_BASE_DIR=%PROGRAM_BASE_DIR%
    RUN_BASE_DIR=%RUN_BASE_DIR%
    ECF_DATE=%ECF_DATE%
    HH=%HH%
    USE_GRAPES=%USE_GRAPES%
    FORECAST_LENGTH=%FORECAST_LENGTH%
    GMF_TINV=%GMF_TINV%
    RMF_TINV=%RMF_TINV%
    USE_GFS=%USE_GFS%

    START_TIME=${ECF_DATE}${HH}
    LAST_TIME=$(smsdate ${START_TIME} -6)
    END_TIME=$(smsdate ${START_TIME} +${FORECAST_LENGTH})

    COMPONENT_PROJECT_BASE=${PROGRAM_BASE_DIR}
    CYCLE_RUN_BASE_DIR=${RUN_BASE_DIR}/${START_TIME}

    PROGRAM_BIN_DIR=${COMPONENT_PROJECT_BASE}/bin
    PROGRAM_CON_DIR=${COMPONENT_PROJECT_BASE}/condat
    PROGRAM_SCRIPT_DIR=${COMPONENT_PROJECT_BASE}/scripts

    MSG_DIR=${RUN_BASE_DIR}/msg

    CYCLE_MSG_DIR=${CYCLE_RUN_BASE_DIR}/msg
    CYCLE_GMF_DIR=${CYCLE_RUN_BASE_DIR}/gmf
    CYCLE_RUN_DIR=${CYCLE_RUN_BASE_DIR}/run
    CYCLE_FIG_DIR=${CYCLE_RUN_BASE_DIR}/fig
    CYCLE_DAT_DIR=${CYCLE_RUN_BASE_DIR}/dat
    CYCLE_VTX_DIR=${CYCLE_RUN_BASE_DIR}/vtx
    CYCLE_GRIB2_DIR=${CYCLE_RUN_BASE_DIR}/grib2
    CYCLE_TCMESS_DIR=${CYCLE_RUN_BASE_DIR}/tcmess
    CYCLE_BAK_DIR=${CYCLE_RUN_BASE_DIR}/bak

    module load compiler/intel/composer_xe_2017.2.174 \
      mpi/intelmpi/2017.2.174

    module load mathlib/wgrib2/2.0.6/intel \
      mathlib/grib_api/1.24.0/intel \
      mathlib/netcdf/3.6.3/intel \
      mathlib/ncl_ncarg/6.4.0/gnu \
      mathlib/grads/2.0.2/gnu

    DATA_TYPE_PREFIX="grapes_tym"

    GEOGDIR=/g1/COMMONDATA/static/rfs/geog/v3

    export PATH=${PROGRAM_BIN_DIR}:${PROGRAM_SCRIPT_DIR}:${PATH}

    #------------
    # END: configure.h
    #------------