SUBROUTINE READMM(IMSG,SUBSET,JDATE,IRET) C$$$ SUBPROGRAM DOCUMENTATION BLOCK C C SUBPROGRAM: READMM C PRGMMR: WOOLLEN ORG: NP20 DATE: 1999-11-18 C C ABSTRACT: THIS SUBROUTINE READS A PARTICULAR BUFR MESSAGE FROM C INTERNAL MEMORY (ARRAY MSGS IN COMMON BLOCK /MSGMEM/) INTO A C MESSAGE BUFFER (ARRAY MBAY IN COMMON BLOCK /BITBUF/). IT IS C IDENTICAL TO BUFR ARCHIVE LIBRARY SUBROUTINE RDMEMM EXCEPT IT C ADVANCES THE VALUE OF IMSG BY ONE PRIOR TO RETURNING TO CALLING C PROGRAM. C C PROGRAM HISTORY LOG: C 1999-11-18 J. WOOLLEN -- ORIGINAL AUTHOR C 2000-09-19 J. WOOLLEN -- MAXIMUM MESSAGE LENGTH INCREASED FROM C 10,000 TO 20,000 BYTES C 2001-08-15 D. KEYSER -- PARAMETER MAXMEM (THE MAXIMUM NUMBER OF C BYTES REQUIRED TO STORE ALL MESSAGES C INTERNALLY) WAS INCREASED FROM 8 MBYTES TO C 16 MBYTES C 2003-11-04 S. BENDER -- ADDED REMARKS/BUFRLIB ROUTINE C INTERDEPENDENCIES C 2003-11-04 D. KEYSER -- PARAMETER MAXMSG (THE MAXIMUM NUMBER OF C BUFR MESSAGES WHICH CAN BE STORED C INTERNALLY) INCREASED FROM 50000 TO 200000; C UNIFIED/PORTABLE FOR WRF; ADDED C DOCUMENTATION (INCLUDING HISTORY); OUTPUTS C MORE COMPLETE DIAGNOSTIC INFO WHEN ROUTINE C TERMINATES ABNORMALLY OR UNUSUAL THINGS C HAPPEN C 2004-08-09 J. ATOR -- MAXIMUM MESSAGE LENGTH INCREASED FROM C 20,000 TO 50,000 BYTES C 2004-11-15 D. KEYSER -- PARAMETER MAXMEM (THE MAXIMUM NUMBER OF C BYTES REQUIRED TO STORE ALL MESSAGES C INTERNALLY) WAS INCREASED FROM 16 MBYTES TO C 50 MBYTES C 2009-03-23 J. ATOR -- REWROTE TO CALL RDMEMM C C USAGE: CALL READMM (IMSG, SUBSET, JDATE, IRET) C INPUT ARGUMENT LIST: C IMSG - INTEGER: POINTER TO BUFR MESSAGE NUMBER (RECORD) IN C STORAGE C C OUTPUT ARGUMENT LIST: C IMSG - INTEGER: POINTER TO BUFR MESSAGE NUMBER (RECORD) IN C STORAGE C SUBSET - CHARACTER*8: TABLE A MNEMONIC FOR TYPE OF BUFR MESSAGE C BEING READ C JDATE - INTEGER: DATE-TIME STORED WITHIN SECTION 1 OF BUFR C MESSAGE BEING READ, IN FORMAT OF EITHER YYMMDDHH OR C YYYYMMDDHH, DEPENDING ON DATELEN() VALUE C IRET - INTEGER: RETURN CODE: C 0 = normal return C -1 = IMSG is either zero or greater than the C number of messages in memory C C REMARKS: C NOTE THAT UFBMEM IS CALLED PRIOR TO THIS TO STORE THE BUFR C MESSAGES INTO INTERNAL MEMORY. C C THIS ROUTINE CALLS: RDMEMM C THIS ROUTINE IS CALLED BY: IREADMM C Also called by application programs. C C ATTRIBUTES: C LANGUAGE: FORTRAN 77 C MACHINE: PORTABLE TO ALL PLATFORMS C C$$$ CHARACTER*8 SUBSET C----------------------------------------------------------------------- C----------------------------------------------------------------------- CALL RDMEMM(IMSG,SUBSET,JDATE,IRET) IMSG = IMSG+1 RETURN END