/[MITgcm]/MITgcm/model/src/do_write_pickup.F
ViewVC logotype

Annotation of /MITgcm/model/src/do_write_pickup.F

Parent Directory Parent Directory | Revision Log Revision Log | View Revision Graph Revision Graph


Revision 1.7 - (hide annotations) (download)
Thu Jun 7 17:10:28 2012 UTC (11 years, 11 months ago) by jmc
Branch: MAIN
CVS Tags: checkpoint63p, checkpoint63q, checkpoint63o
Changes since 1.6: +5 -3 lines
add phase-lag to argument list of S/R CAL_TIME2DUMP

1 jmc 1.7 C $Header: /u/gcmpack/MITgcm/model/src/do_write_pickup.F,v 1.6 2008/02/25 20:57:24 mlosch Exp $
2 jmc 1.1 C $Name: $
3    
4     #include "PACKAGES_CONFIG.h"
5     #include "CPP_OPTIONS.h"
6    
7     C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|
8     CBOP
9     C !ROUTINE: DO_WRITE_PICKUP
10     C !INTERFACE:
11     SUBROUTINE DO_WRITE_PICKUP(
12     I modelEnd,
13     I myTime, myIter, myThid )
14    
15     C !DESCRIPTION:
16     C This is the controlling routine that decides when to write restart
17     C (or "pickup" or "checkpoint" ) files. Then it calls 2 subroutines
18     C to write the main-model pickup and each package pickup files.
19     C
20     C Both ``rolling-pickup'' files and permanent pickup files
21     C are written from here. A rolling pickup works through a circular
22     C list of suffices. Generally the circular list has two entries so
23     C that a rolling pickup will overwrite the last rolling
24     C pickup but one. This is useful for running long jobs without
25     C filling too much disk space. In a permanent pickup, data is
26     C written suffixed by the current timestep number. Permanent
27     C pickups can be used to provide snap-shots from which the
28     C model can be restarted.
29    
30     C !USES:
31     IMPLICIT NONE
32     #include "SIZE.h"
33     #include "EEPARAMS.h"
34     #include "PARAMS.h"
35 jmc 1.4 #include "RESTART.h"
36 jmc 1.1 LOGICAL DIFFERENT_MULTIPLE
37     EXTERNAL DIFFERENT_MULTIPLE
38    
39     C !INPUT PARAMETERS:
40     C modelEnd :: true if call at end of model run.
41     C myTime :: Current time of simulation ( s )
42     C myIter :: Iteration number
43     C myThid :: Thread number for this instance of the routine.
44     LOGICAL modelEnd
45     INTEGER myThid
46     INTEGER myIter
47     _RL myTime
48     CEOP
49    
50     C !LOCAL VARIABLES:
51     C permPickup :: Flag indicating whether a permanent pickup will
52     C be written.
53     C tempPickup :: Flag indicating if it is time to write a non-permanent
54     C pickup (that will be permanent if permPickup=T)
55     C fn :: Temp. for building file name string.
56     C msgBuf :: message buffer
57     LOGICAL permPickup, tempPickup
58     CHARACTER*(MAX_LEN_FNAM) fn
59     CHARACTER*(MAX_LEN_MBUF) msgBuf
60 jmc 1.7 _RL zeroRL
61     PARAMETER( zeroRL = 0. _d 0 )
62 jmc 1.1
63     permPickup = .FALSE.
64     tempPickup = .FALSE.
65     permPickup =
66     & DIFFERENT_MULTIPLE(pChkPtFreq,myTime,deltaTClock)
67     tempPickup =
68     & DIFFERENT_MULTIPLE( chkPtFreq,myTime,deltaTClock)
69    
70     #ifdef ALLOW_CAL
71     IF ( useCAL ) THEN
72 jmc 1.7 CALL CAL_TIME2DUMP( zeroRL, pChkPtFreq, deltaTClock,
73 jmc 1.1 U permPickup,
74     I myTime, myIter, myThid )
75 jmc 1.7 CALL CAL_TIME2DUMP( zeroRL, chkPtFreq, deltaTClock,
76 jmc 1.1 U tempPickup,
77     I myTime, myIter, myThid )
78     ENDIF
79     #endif
80    
81 mlosch 1.6 IF ( (modelEnd.AND.writePickupAtEnd)
82     & .OR. permPickup .OR. tempPickup ) THEN
83 jmc 1.1 C-- this is time to write pickup files
84    
85     C- write a pickup for each package which need it to restart
86     CALL PACKAGES_WRITE_PICKUP(
87     I permPickup, myTime, myIter, myThid )
88    
89     C- write main model pickup
90 jmc 1.3 IF ( .NOT.useOffLine ) THEN
91 jmc 1.1 CALL WRITE_PICKUP(
92     I permPickup, myTime, myIter, myThid )
93     ENDIF
94    
95     _BEGIN_MASTER(myThid)
96     C- Write suffix for stdout information
97     IF ( permPickup ) THEN
98     WRITE(fn,'(I10.10)') myIter
99     ELSE
100     WRITE(fn,'(A)') checkPtSuff(nCheckLev)
101     ENDIF
102    
103     C- Write information to stdout so there is a record that
104     C writing the pickup was completed
105     WRITE(msgBuf,'(A11,I10,1X,A10)')
106     & "%CHECKPOINT ",myIter,fn
107     CALL PRINT_MESSAGE( msgBuf, standardMessageUnit,
108     & SQUEEZE_RIGHT, myThid )
109    
110     C- Update pickup level for the next time we write pickup
111     IF ( .NOT. permPickup ) THEN
112     nCheckLev = MOD(nCheckLev, maxNoChkptLev)+1
113     ENDIF
114     _END_MASTER(myThid)
115    
116 mlosch 1.6 ELSEIF ( modelEnd ) THEN
117     WRITE(msgBuf,'(A)')
118     & "Did not write pickup because writePickupAtEnd = FALSE"
119     CALL PRINT_MESSAGE( msgBuf, standardMessageUnit,
120     & SQUEEZE_RIGHT, myThid )
121    
122 jmc 1.1 C-- time to write pickup files: end
123     ENDIF
124    
125     RETURN
126     END

  ViewVC Help
Powered by ViewVC 1.1.22