1 |
C $Header: /u/gcmpack/MITgcm/eesupp/src/all_proc_die.F,v 1.7 2012/09/01 22:43:55 jmc Exp $ |
2 |
C $Name: $ |
3 |
|
4 |
#include "CPP_EEOPTIONS.h" |
5 |
|
6 |
CBOP |
7 |
C !ROUTINE: ALL_PROC_DIE |
8 |
|
9 |
C !INTERFACE: |
10 |
SUBROUTINE ALL_PROC_DIE( myThArg ) |
11 |
|
12 |
C !DESCRIPTION: |
13 |
C *==========================================================* |
14 |
C | SUBROUTINE ALL_PROC_DIE |
15 |
C | o when all process call this routine, die cleanly: |
16 |
C | set Error-Flag and call MPI finalise |
17 |
C *==========================================================* |
18 |
C | used before a STOP: |
19 |
C | - Only implemented for MPI multi-proc. |
20 |
C | - if some Proc do not call this S/R, MPI will hang. |
21 |
C *==========================================================* |
22 |
|
23 |
C !USES: |
24 |
IMPLICIT NONE |
25 |
|
26 |
C == Global variables == |
27 |
#include "SIZE.h" |
28 |
#include "EEPARAMS.h" |
29 |
#include "EESUPPORT.h" |
30 |
|
31 |
C !INPUT/OUTPUT PARAMETERS: |
32 |
C myThArg :: thread argument (= my Thread Id number |
33 |
C :: or = 0 if called within single-thread section) |
34 |
INTEGER myThArg |
35 |
CEOP |
36 |
|
37 |
C !FUNCTIONS |
38 |
INTEGER ILNBLNK |
39 |
EXTERNAL ILNBLNK |
40 |
|
41 |
C == Local variables == |
42 |
C msgBuf :: I/O Buffer |
43 |
C myThid :: my Thread Id number |
44 |
CHARACTER*(MAX_LEN_MBUF) msgBuf |
45 |
INTEGER myThid |
46 |
#ifdef ALLOW_USE_MPI |
47 |
C mpiRC :: Error code reporting variable used with MPI. |
48 |
INTEGER mpiRC |
49 |
#endif /* ALLOW_USE_MPI */ |
50 |
|
51 |
myThid = MAX(myThArg,1) |
52 |
C-- Print message |
53 |
WRITE(msgBuf,'(A)') 'S/R ALL_PROC_DIE: ending the run' |
54 |
CALL PRINT_ERROR( msgBuf, myThid ) |
55 |
|
56 |
_BEGIN_MASTER(myThid) |
57 |
|
58 |
C-- Finishes |
59 |
eeEndError = .TRUE. |
60 |
fatalError = .TRUE. |
61 |
|
62 |
C- Flush IO-unit before MPI termination |
63 |
CALL MDS_FLUSH( errorMessageUnit, myThid ) |
64 |
c#ifdef ALLOW_USE_MPI |
65 |
CALL MDS_FLUSH( standardMessageUnit, myThid ) |
66 |
c#endif /* ALLOW_USE_MPI */ |
67 |
|
68 |
#ifdef ALLOW_USE_MPI |
69 |
C- Note: since MPI_INIT is always called, better to also always terminate MPI |
70 |
C (even if usingMPI=F) --> comment out test on usingMPI |
71 |
c IF ( usingMPI ) THEN |
72 |
C better to avoid this call if multi-components set-up ; otherwise will |
73 |
C hang here since procs of other comp. are not calling MPI_finalize now. |
74 |
IF ( .NOT.( useCoupler |
75 |
& .OR. useNEST_PARENT |
76 |
& .OR. useNEST_CHILD ) |
77 |
& ) THEN |
78 |
#ifdef ALLOW_OASIS |
79 |
IF ( useOASIS ) CALL OASIS_ABORT |
80 |
#endif /* ALLOW_OASIS */ |
81 |
CALL MPI_FINALIZE ( mpiRC ) |
82 |
IF ( mpiRC .NE. MPI_SUCCESS ) THEN |
83 |
WRITE(msgBuf,'(A,I5)') |
84 |
& 'S/R FIN_PROCS: MPI_FINALIZE return code', mpiRC |
85 |
CALL PRINT_ERROR( msgBuf, myThid ) |
86 |
ENDIF |
87 |
ENDIF |
88 |
c ENDIF |
89 |
#endif /* ALLOW_USE_MPI */ |
90 |
|
91 |
C- Some systems do not always flush the IO buffer to disk. |
92 |
C To fix this, can either close these files (implies not to write |
93 |
C anything after) or flush the io-unit (done above). |
94 |
c CLOSE( errorMessageUnit ) |
95 |
#ifdef ALLOW_USE_MPI |
96 |
C- Note: comment out if usingMPI ... since we always open standardMessageUnit |
97 |
C when ALLOW_USE_MPI is defined, better to flush/close also if usingMPI=F |
98 |
cc IF ( usingMPI ) THEN |
99 |
c CLOSE( standardMessageUnit ) |
100 |
cc ENDIF |
101 |
#endif /* ALLOW_USE_MPI */ |
102 |
|
103 |
_END_MASTER(myThid) |
104 |
|
105 |
IF ( myThArg.GE.1 ) THEN |
106 |
_BARRIER |
107 |
ENDIF |
108 |
|
109 |
RETURN |
110 |
END |