NCEPLIBS-bufr  11.5.0
 All Data Structures Files Functions Variables Pages
ireadmt.F File Reference

Go to the source code of this file.

Functions/Subroutines

INTEGER function ireadmt (LUN)
 THIS FUNCTION CHECKS THE MOST RECENT BUFR MESSAGE THAT WAS READ AS INPUT VIA SUBROUTINE READMG, READERME OR EQUIVALENT TO DETERMINE IF THE APPROPRIATE CORRESPONDING BUFR MASTER TABLES HAVE ALREADY BEEN READ INTO INTERNAL MEMORY. More...
 

Detailed Description

Author
ATOR
Date
2009-03-23

Definition in file ireadmt.F.

Function/Subroutine Documentation

INTEGER function ireadmt (   LUN)

THIS FUNCTION CHECKS THE MOST RECENT BUFR MESSAGE THAT WAS READ AS INPUT VIA SUBROUTINE READMG, READERME OR EQUIVALENT TO DETERMINE IF THE APPROPRIATE CORRESPONDING BUFR MASTER TABLES HAVE ALREADY BEEN READ INTO INTERNAL MEMORY.

IF NOT, THEN IT OPENS THE APPROPRIATE BUFR MASTER TABLE FILES AND READS THEM INTO INTERNAL MEMORY, CLEARING ANY PREVIOUS MASTER TABLE INFORMATION ALREADY STORED THERE. INFORMATION ABOUT THE BUFR MASTER TABLE FILES IS OBTAINED FROM THE MOST RECENT CALL TO SUBROUTINE MTINFO, OR ELSE AS DEFINED WITHIN SUBROUTINE BFRINI IF SUBROUTINE MTINFO WAS NEVER CALLED.

PROGRAM HISTORY LOG: 2009-03-23 J. ATOR – ORIGINAL AUTHOR 2014-11-25 J. ATOR – ADD CALL TO CPMSTABS FOR ACCESS TO MASTER TABLE INFORMATION WITHIN C WHEN USING DYNAMICALLY ALLOCATED ARRAYS 2017-10-13 J. ATOR – ADD FUNCTIONALITY TO CHECK WHETHER NEW MASTER TABLES NEED TO BE READ (THIS FUNCTIONALITY WAS PREVIOUSLY PART OF SUBROUTINE READS3) 2018-04-09 J. ATOR – ONLY READ MASTER B AND D TABLES WHEN SECTION 3 IS BEING USED FOR DECODING

USAGE: IREADMT ( LUN ) INPUT ARGUMENT LIST: LUN - INTEGER: I/O STREAM INDEX INTO INTERNAL MEMORY ARRAYS

OUTPUT ARGUMENT LIST: IREADMT - INTEGER: RETURN CODE INDICATING WHETHER NEW BUFR MASTER TABLE FILES NEEDED TO BE OPENED AND READ DURING THIS CALL TO THE FUNCTION 0 = NO 1 = YES

INPUT FILES: UNITS 98,99 - IF SUBROUTINE MTINFO WAS NEVER CALLED, THEN THESE LOGICAL UNIT NUMBERS ARE USED BY THIS ROUTINE FOR OPENING AND READING THE BUFR MASTER TABLES. ALTERNATIVELY, IF SUBROUTINE MTINFO WAS CALLED, THEN THE LOGICAL UNIT NUMBERS SPECIFIED IN THE MOST RECENT CALL TO MTINFO (ARGUMENTS LUNMT1 AND LUNMT2) ARE USED INSTEAD. REMARKS: THIS ROUTINE CALLS: BORT2 CPMSTABS ERRWRT ICVIDX IFXY ISTDESC IUPBS01 MTFNAM RDMTBB RDMTBD RDMTBF UPDS3 THIS ROUTINE IS CALLED BY: GETCFMNG READS3 UFDUMP Normally not called by any application programs.

Definition at line 54 of file ireadmt.F.

References bort2(), cpmstabs(), errwrt(), icvidx(), ifxy(), istdesc(), iupbs01(), mtfnam(), rdmtbb(), rdmtbd(), rdmtbf(), and upds3().

Referenced by getcfmng(), reads3(), and ufdump().