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

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:

• 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 history documentation; outputs more complete diagnostic info when routine terminates abnormally; increased MAXMSG from 50000 to 200000
• 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 58 of file readmm.f.

References rdmemm().

Referenced by ireadmm().