pkg/mnc/mnc_cw_udim.F

C $Header: /u/gcmpack/MITgcm/pkg/mnc/mnc_cw_udim.F,v 1.3 2004/03/29 03:33:51 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)
      ENDIF
      mnc_cw_fgnm(indfg)(1:(fgl-fgf+1)) = fgname(fgf:fgl)
      mnc_cw_fgud(indfg) = nudim

      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_SET_UDIM ERROR: file group name ''', 
     &       fgname(fgf:fgl), ''' is not defined'
        CALL print_error(msgbuf, mythid)
        STOP 'ABNORMAL END: S/R MNC_CW_SET_UDIM'
      ENDIF
      nudim = mnc_cw_fgud(indfg)

      RETURN
      END

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

1	edhill	1.4	C $Header: /u/gcmpack/MITgcm/pkg/mnc/mnc_cw_udim.F,v 1.3 2004/03/29 03:33:51 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.1	ENDIF
55			mnc_cw_fgnm(indfg)(1:(fgl-fgf+1)) = fgname(fgf:fgl)
56			mnc_cw_fgud(indfg) = nudim
57
58			RETURN
59			END
60
61			C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-\|--+----\|
62	edhill	1.4	CBOP 0
63	edhill	1.3	C !ROUTINE: MNC_CW_GET_UDIM
64	edhill	1.1
65	edhill	1.3	C !INTERFACE:
66	edhill	1.1	SUBROUTINE MNC_CW_GET_UDIM(
67			I fgname,
68			O nudim,
69			I myThid )
70
71	edhill	1.3	C !DESCRIPTION:
72			C For a specified file group name, get the size of the NetCDF
73			C unlimited (or record) dimension.
74
75			C !USES:
76	edhill	1.1	implicit none
77			#include "mnc_common.h"
78			#include "EEPARAMS.h"
79
80	edhill	1.3	C !INPUT PARAMETERS:
81	edhill	1.1	integer nudim, myThid
82			character() fgname
83	edhill	1.4	CEOP
84	edhill	1.1
85	edhill	1.3	C !LOCAL VARIABLES:
86			integer fgf,fgl, indfg
87			character*(MAX_LEN_MBUF) msgbuf
88	edhill	1.4
89	edhill	1.1	C Functions
90			integer IFNBLNK, ILNBLNK
91
92			fgf = IFNBLNK(fgname)
93			fgl = ILNBLNK(fgname)
94			CALL MNC_GET_IND(MNC_MAX_ID, fgname, mnc_cw_fgnm, indfg, myThid)
95			IF (indfg .LT. 1) THEN
96			write(msgbuf,'(3a)')
97			& 'MNC_CW_SET_UDIM ERROR: file group name ''',
98			& fgname(fgf:fgl), ''' is not defined'
99			CALL print_error(msgbuf, mythid)
100			STOP 'ABNORMAL END: S/R MNC_CW_SET_UDIM'
101			ENDIF
102			nudim = mnc_cw_fgud(indfg)
103
104			RETURN
105			END
106
107			C---+----1----+----2----+----3----+----4----+----5----+----6----+----7-\|--+----\|
108