invtag.f

Go to the documentation of this file.

C> @file
C> @author WOOLLEN @date 1994-01-06
      
C> THIS FUNCTION LOOKS FOR A SPECIFIED MNEMONIC WITHIN THE
C>   PORTION OF THE CURRENT SUBSET BUFFER BOUNDED BY THE INDICES INV1
C>   AND INV2.  IT IS SIMILAR TO BUFR ARCHIVE LIBRARY FUNCTION INVWIN,
C>   EXCEPT THAT INVWIN SEARCHES BASED ON THE ACTUAL NODE WITHIN THE
C>   INTERNAL JUMP/LINK TABLE, RATHER THAN ON THE MNEMONIC CORRESPONDING
C>   TO THAT NODE.
C>
C> PROGRAM HISTORY LOG:
C> 1994-01-06  J. WOOLLEN -- ORIGINAL AUTHOR
C> 1999-11-18  J. WOOLLEN -- THE NUMBER OF BUFR FILES WHICH CAN BE
C>                           OPENED AT ONE TIME INCREASED FROM 10 TO 32
C>                           (NECESSARY IN ORDER TO PROCESS MULTIPLE
C>                           BUFR FILES UNDER THE MPI)
C> 2003-11-04  S. BENDER  -- ADDED REMARKS/BUFRLIB ROUTINE
C>                           INTERDEPENDENCIES
C> 2003-11-04  D. KEYSER  -- MAXJL (MAXIMUM NUMBER OF JUMP/LINK ENTRIES)
C>                           INCREASED FROM 15000 TO 16000 (WAS IN
C>                           VERIFICATION VERSION); UNIFIED/PORTABLE FOR
C>                           WRF; ADDED DOCUMENTATION (INCLUDING
C>                           HISTORY); OUTPUTS MORE COMPLETE DIAGNOSTIC
C>                           INFO WHEN UNUSUAL THINGS HAPPEN
C> 2009-03-31  J. WOOLLEN -- ADDED DOCUMENTATION
C> 2009-04-21  J. ATOR    -- USE ERRWRT
C> 2014-12-10  J. ATOR    -- USE MODULES INSTEAD OF COMMON BLOCKS
C>
C> USAGE:    INVTAG (NODE, LUN, INV1, INV2)
C>   INPUT ARGUMENT LIST:
C>     NODE     - INTEGER: JUMP/LINK TABLE INDEX OF MNEMONIC TO LOOK FOR
C>     LUN      - INTEGER: I/O STREAM INDEX INTO INTERNAL MEMORY ARRAYS
C>     INV1     - INTEGER: STARTING INDEX OF THE PORTION OF THE SUBSET
C>                BUFFER IN WHICH TO LOOK
C>     INV2     - INTEGER: ENDING INDEX OF THE PORTION OF THE SUBSET
C>                BUFFER IN WHICH TO LOOK
C>
C>   OUTPUT ARGUMENT LIST:
C>     INVTAG   - INTEGER: LOCATION INDEX OF NODE WITHIN SPECIFIED
C>                PORTION OF SUBSET BUFFER
C>                  0 = NOT FOUND
C>
C> REMARKS:
C>    THIS ROUTINE CALLS:        ERRWRT
C>    THIS ROUTINE IS CALLED BY: UFBRP    UFBSEQ   UFBSP
C>                               Normally not called by any application
C>                               programs.
C>
      FUNCTION invtag(NODE,LUN,INV1,INV2)
 
      USE moda_usrint
      USE moda_tables
 
      COMMON /quiet/  iprt
 
      CHARACTER*10 tagn
 
C----------------------------------------------------------------------
C----------------------------------------------------------------------
 
      invtag = 0
      IF(node.EQ.0) GOTO 200
      tagn = tag(node)
 
C  SEARCH BETWEEN INV1 AND INV2
C  ----------------------------
 
10    DO invtag=inv1,inv2
      IF(tag(inv(invtag,lun)).EQ.tagn) GOTO 100
      ENDDO
 
      invtag = 0
 
200   IF(iprt.GE.2) THEN
      CALL errwrt('++++++++++++++BUFR ARCHIVE LIBRARY+++++++++++++++++')
      CALL errwrt('BUFRLIB: INVTAG - RETURNING WITH A VALUE OF 0')
      CALL errwrt('++++++++++++++BUFR ARCHIVE LIBRARY+++++++++++++++++')
      CALL errwrt(' ')
      ENDIF
 
C  EXIT
C  ----
 
100   RETURN
      END