pkg/mnc/mnc_cw_udim.F

C $Header: /u/gcmpack/MITgcm/pkg/mnc/mnc_cw_udim.F,v 1.4 2004/04/02 16:12:48 edhill Exp $
C $Name:  $
      
#include "MNC_OPTIONS.h"
      
C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|
CBOP 0
C !ROUTINE: MNC_CW_SET_UDIM

C !INTERFACE:
      SUBROUTINE MNC_CW_SET_UDIM( 
     I     fgname, 
     I     nudim, 
     I     myThid ) 

C     !DESCRIPTION:
C     For a specified file group name, set the size of the NetCDF
C     unlimited (or record) dimension.  The options are:
C     \begin{equation}
C       \label{eq:yo}
C       \mbox{\bf nudim} = \left\{
C         \begin{array}[htb]{cl}
C           >0,  &  \mbox{\small use the specified value} \\
C           0,   &  \mbox{\small use the largest currently defined value} \\
C           -1,  &  \mbox{\small increment the largest value and then use it} \\
C         \end{array}
C         \right.
C     \end{equation}

C     !USES:
      implicit none
#include "mnc_common.h"
#include "EEPARAMS.h"

C     !INPUT PARAMETERS:
      integer nudim, myThid
      character*(*) fgname
CEOP

C     !LOCAL VARIABLES:
      integer fgf,fgl, indfg
      character*(MAX_LEN_MBUF) msgbuf

C     Functions
      integer IFNBLNK, ILNBLNK

C     Check that this name is not already defined
      fgf = IFNBLNK(fgname)
      fgl = ILNBLNK(fgname)
      CALL MNC_GET_IND(MNC_MAX_ID, fgname, mnc_cw_fgnm, indfg, myThid)
      IF (indfg .LT. 1) THEN
        CALL MNC_GET_NEXT_EMPTY_IND(
     &       MNC_MAX_ID, mnc_cw_fgnm, indfg, myThid)
        mnc_cw_fgud(indfg) = 0
      ENDIF
      mnc_cw_fgnm(indfg)(1:(fgl-fgf+1)) = fgname(fgf:fgl)
      IF (nudim .GT. 0) THEN
        mnc_cw_fgud(indfg) = nudim
        RETURN
      ENDIF
      IF (nudim .EQ. 0) RETURN
      IF (nudim .EQ. -1) THEN
        mnc_cw_fgud(indfg) = mnc_cw_fgud(indfg) + 1
        RETURN
      ENDIF
      write(msgbuf,'(3a,i,a)') 
     &     'MNC_CW_SET_UDIM ERROR: for file group name ''', 
     &     fgname(fgf:fgl), ''' the unlim dim ''', nudim, 
     &     ''' is not allowed'
      CALL print_error(msgbuf, mythid)
      STOP 'ABNORMAL END: S/R MNC_CW_SET_UDIM'

      RETURN
      END

C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|
CBOP 0
C !ROUTINE: MNC_CW_GET_UDIM

C !INTERFACE:
      SUBROUTINE MNC_CW_GET_UDIM( 
     I     fgname, 
     O     nudim, 
     I     myThid ) 

C     !DESCRIPTION:
C     For a specified file group name, get the size of the NetCDF
C     unlimited (or record) dimension.

C     !USES:
      implicit none
#include "mnc_common.h"
#include "EEPARAMS.h"

C     !INPUT PARAMETERS:
      integer nudim, myThid
      character*(*) fgname
CEOP

C     !LOCAL VARIABLES:
      integer fgf,fgl, indfg
      character*(MAX_LEN_MBUF) msgbuf

C     Functions
      integer IFNBLNK, ILNBLNK

      fgf = IFNBLNK(fgname)
      fgl = ILNBLNK(fgname)
      CALL MNC_GET_IND(MNC_MAX_ID, fgname, mnc_cw_fgnm, indfg, myThid)
      IF (indfg .LT. 1) THEN
        write(msgbuf,'(3a)') 
     &       'MNC_CW_GET_UDIM ERROR: file group name ''', 
     &       fgname(fgf:fgl), ''' is not defined'
        CALL print_error(msgbuf, mythid)
        STOP 'ABNORMAL END: S/R MNC_CW_GET_UDIM'
      ENDIF
      nudim = mnc_cw_fgud(indfg)

      RETURN
      END

C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-|--+----|

1	edhill	1.5	C $Header: /u/gcmpack/MITgcm/pkg/mnc/mnc_cw_udim.F,v 1.4 2004/04/02 16:12:48 edhill Exp $
2	edhill	1.1	C $Name: $
3
4			#include "MNC_OPTIONS.h"
5
6			C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-\|--+----\|
7	edhill	1.4	CBOP 0
8	edhill	1.3	C !ROUTINE: MNC_CW_SET_UDIM
9	edhill	1.1
10	edhill	1.3	C !INTERFACE:
11	edhill	1.1	SUBROUTINE MNC_CW_SET_UDIM(
12			I fgname,
13			I nudim,
14			I myThid )
15
16	edhill	1.3	C !DESCRIPTION:
17			C For a specified file group name, set the size of the NetCDF
18	edhill	1.4	C unlimited (or record) dimension. The options are:
19			C \begin{equation}
20			C \label{eq:yo}
21			C \mbox{\bf nudim} = \left\{
22			C \begin{array}[htb]{cl}
23			C >0, & \mbox{\small use the specified value} \\
24			C 0, & \mbox{\small use the largest currently defined value} \\
25			C -1, & \mbox{\small increment the largest value and then use it} \\
26			C \end{array}
27			C \right.
28			C \end{equation}
29
30	edhill	1.3	C !USES:
31	edhill	1.1	implicit none
32			#include "mnc_common.h"
33			#include "EEPARAMS.h"
34
35	edhill	1.3	C !INPUT PARAMETERS:
36	edhill	1.1	integer nudim, myThid
37			character() fgname
38	edhill	1.4	CEOP
39	edhill	1.1
40	edhill	1.3	C !LOCAL VARIABLES:
41			integer fgf,fgl, indfg
42			character*(MAX_LEN_MBUF) msgbuf
43	edhill	1.4
44	edhill	1.1	C Functions
45			integer IFNBLNK, ILNBLNK
46
47			C Check that this name is not already defined
48			fgf = IFNBLNK(fgname)
49			fgl = ILNBLNK(fgname)
50			CALL MNC_GET_IND(MNC_MAX_ID, fgname, mnc_cw_fgnm, indfg, myThid)
51	edhill	1.2	IF (indfg .LT. 1) THEN
52			CALL MNC_GET_NEXT_EMPTY_IND(
53			& MNC_MAX_ID, mnc_cw_fgnm, indfg, myThid)
54	edhill	1.5	mnc_cw_fgud(indfg) = 0
55	edhill	1.1	ENDIF
56			mnc_cw_fgnm(indfg)(1:(fgl-fgf+1)) = fgname(fgf:fgl)
57	edhill	1.5	IF (nudim .GT. 0) THEN
58			mnc_cw_fgud(indfg) = nudim
59			RETURN
60			ENDIF
61			IF (nudim .EQ. 0) RETURN
62			IF (nudim .EQ. -1) THEN
63			mnc_cw_fgud(indfg) = mnc_cw_fgud(indfg) + 1
64			RETURN
65			ENDIF
66			write(msgbuf,'(3a,i,a)')
67			& 'MNC_CW_SET_UDIM ERROR: for file group name ''',
68			& fgname(fgf:fgl), ''' the unlim dim ''', nudim,
69			& ''' is not allowed'
70			CALL print_error(msgbuf, mythid)
71			STOP 'ABNORMAL END: S/R MNC_CW_SET_UDIM'
72	edhill	1.1
73			RETURN
74			END
75
76			C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-\|--+----\|
77	edhill	1.4	CBOP 0
78	edhill	1.3	C !ROUTINE: MNC_CW_GET_UDIM
79	edhill	1.1
80	edhill	1.3	C !INTERFACE:
81	edhill	1.1	SUBROUTINE MNC_CW_GET_UDIM(
82			I fgname,
83			O nudim,
84			I myThid )
85
86	edhill	1.3	C !DESCRIPTION:
87			C For a specified file group name, get the size of the NetCDF
88			C unlimited (or record) dimension.
89
90			C !USES:
91	edhill	1.1	implicit none
92			#include "mnc_common.h"
93			#include "EEPARAMS.h"
94
95	edhill	1.3	C !INPUT PARAMETERS:
96	edhill	1.1	integer nudim, myThid
97			character() fgname
98	edhill	1.4	CEOP
99	edhill	1.1
100	edhill	1.3	C !LOCAL VARIABLES:
101			integer fgf,fgl, indfg
102			character*(MAX_LEN_MBUF) msgbuf
103	edhill	1.4
104	edhill	1.1	C Functions
105			integer IFNBLNK, ILNBLNK
106
107			fgf = IFNBLNK(fgname)
108			fgl = ILNBLNK(fgname)
109			CALL MNC_GET_IND(MNC_MAX_ID, fgname, mnc_cw_fgnm, indfg, myThid)
110			IF (indfg .LT. 1) THEN
111			write(msgbuf,'(3a)')
112	edhill	1.5	& 'MNC_CW_GET_UDIM ERROR: file group name ''',
113	edhill	1.1	& fgname(fgf:fgl), ''' is not defined'
114			CALL print_error(msgbuf, mythid)
115	edhill	1.5	STOP 'ABNORMAL END: S/R MNC_CW_GET_UDIM'
116	edhill	1.1	ENDIF
117			nudim = mnc_cw_fgud(indfg)
118
119			RETURN
120			END
121
122			C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-\|--+----\|
123