readmm.f File Reference

Read a specified BUFR message from internal arrays. More...

Go to the source code of this file.

Functions/Subroutines
subroutine	readmm (IMSG, SUBSET, JDATE, IRET)
	This subroutine reads a specified BUFR message from internal arrays in memory, so that it is now in scope for processing via a subsequent call to subroutine rdmems(). More...

Detailed Description

Read a specified BUFR message from internal arrays.

Definition in file readmm.f.

Function/Subroutine Documentation

readmm()

subroutine readmm	(		IMSG,
		character*8	SUBSET,
			JDATE,
			IRET
	)

This subroutine reads a specified BUFR message from internal arrays in memory, so that it is now in scope for processing via a subsequent call to subroutine rdmems().

BUFR messages should already be stored within internal arrays in memory via one or more previous calls to subroutine ufbmem().

This subroutine is similar to subroutine rdmemm(), except that it increments the value of IMSG prior to returning to the calling program, which in turn allows the subroutine to be easily called within an iterative program loop.

Author

J. Woollen

Date

1999-11-18

Parameters

[in,out]	IMSG	– integer: Message pointer within internal arrays On input, IMSG is the number of the BUFR message to be read into scope for further processing, counting from the beginning of the internal arrays in memory On output, IMSG is incremented by one from its input value
[out]	SUBSET	– character*8: Table A mnemonic for type of BUFR message that was read into scope (see DX BUFR Tables for further information about Table A mnemonics)
[out]	JDATE	– integer: Date-time stored within Section 1 of BUFR message that was read into scope, in format of either YYMMDDHH or YYYYMMDDHH, depending on the most recent call to subroutine datelen()
[out]	IRET	– integer: return code 0 = requested message was successfully read into scope -1 = requested message number could not be found in internal arrays

Program history log:

Date	Programmer	Comments
1999-11-18	J. Woollen	Original author
2000-09-19	J. Woollen	Maximum message length increased from 10,000 to 20,000 bytes
2001-08-15	D. Keyser	Increased MAXMEM from 8 Mb to 16 Mb
2003-11-04	S. Bender	Added remarks and routine interdependencies
2003-11-04	D. Keyser	Unified/portable for WRF; added documentation; outputs more complete diagnostic info when routine terminates abnormally
2004-08-09	J. Ator	Maximum message length increased from 20,000 to 50,000 bytes
2004-11-15	D. Keyser	Increased MAXMEM from 16 Mb to 50 Mb
2009-03-23	J. Ator	Rewrote to call rdmemm()

Definition at line 54 of file readmm.f.

References rdmemm().

Referenced by ireadmm().