Type | Intent | Optional | Attributes | Name | ||
---|---|---|---|---|---|---|
type(ESMF_KeywordEnforcer), | optional | :: | keywordEnforcer | |||
type(ESMF_VM), | intent(in), | optional | :: | vm | ||
logical, | intent(in), | optional | :: | keepAlloc | ||
integer, | intent(out), | optional | :: | rc |
subroutine ESMF_VMEpochExit(keywordEnforcer, vm, keepAlloc, rc) ! ! !ARGUMENTS: type(ESMF_KeywordEnforcer), optional:: keywordEnforcer ! must use keywords below type(ESMF_VM), intent(in), optional :: vm logical, intent(in), optional :: keepAlloc integer, intent(out), optional :: rc ! ! !DESCRIPTION: ! Exit the current VM epoch. ! ! The arguments are: ! \begin{description} ! \item[{[vm]}] ! {\tt ESMF\_VM} object. Defaults to the current VM. ! \item[{[keepAlloc]}] ! For {\tt .true.}, keep internal allocations to be reused by consecutive ! epoch phases. For {\tt .false.}, deallocate all internal buffers not ! actively used. ! The flag only affects the local PET. Defaults to {\tt .true.}. ! \item[{[rc]}] ! Return code; equals {\tt ESMF\_SUCCESS} if there are no errors. ! \end{description} ! !EOP !------------------------------------------------------------------------------ integer :: localrc ! local return code type(ESMF_VM) :: vm_opt ! helper variable type(ESMF_Logical) :: keepAlloc_opt ! helper variable ! initialize return code; assume routine not implemented localrc = ESMF_RC_NOT_IMPL if (present(rc)) rc = ESMF_RC_NOT_IMPL ! deal with optional arguments if (present(vm)) then vm_opt = vm else call ESMF_VMGetCurrent(vm_opt, rc=localrc) if (ESMF_LogFoundError(localrc, ESMF_ERR_PASSTHRU, & ESMF_CONTEXT, rcToReturn=rc)) return endif keepAlloc_opt = ESMF_TRUE ! default if (present(keepAlloc)) keepAlloc_opt = keepAlloc ! Check init status of arguments ESMF_INIT_CHECK_DEEP(ESMF_VMGetInit, vm_opt, rc) ! Call into the C++ interface call c_ESMC_VMEpochExit(vm_opt, keepAlloc_opt, localrc) if (ESMF_LogFoundError(localrc, ESMF_ERR_PASSTHRU, & ESMF_CONTEXT, rcToReturn=rc)) return ! return successfully if (present(rc)) rc = ESMF_SUCCESS end subroutine ESMF_VMEpochExit