NCEPLIBS-bufr  11.5.0
 All Data Structures Files Functions Variables Pages
rdmems.f File Reference

Read a specified data subset from a BUFR message. More...

Go to the source code of this file.

Functions/Subroutines

subroutine rdmems (ISUB, IRET)
 This subroutine reads a specified data subset from the BUFR message that was most recently read via a call to subroutine rdmemm() or readmm(). More...
 

Detailed Description

Read a specified data subset from a BUFR message.

Definition in file rdmems.f.

Function/Subroutine Documentation

subroutine rdmems (   ISUB,
  IRET 
)

This subroutine reads a specified data subset from the BUFR message that was most recently read via a call to subroutine rdmemm() or readmm().

Author
J. Woollen
Date
1994-01-06
Parameters
[in]ISUB- integer: Number of data subset to be read from BUFR message, counting from the beginning of the message
[out]IRET- integer: return code
  • 0 = requested data subset was successfully read
  • -1 = requested subset number could not be found in the message

Whenever this subroutine returns with IRET = 0, this indicates that a new BUFR data subset (i.e. report) was successfully read into internal arrays within the BUFRLIB software, and from where it can now be easily manipulated or further parsed via calls to any of the values-reading subroutines using the Fortran logical unit number IUNIT that was returned from the most recent call to subroutine ufbmem().

Program history log:

  • 1994-01-06 J. Woollen – Original author
  • 1998-07-08 J. Woollen – Replaced call to Cray library routine "ABORT" with call to new internal BUFRLIB routine "BORT"
  • 1998-10-27 J. Woollen – Modified to correct problems caused by in-lining code with fpp directives
  • 1999-11-18 J. Woollen – The number of BUFR files which can be opened at one time increased from 10 to 32 (necessary in order to process multiple BUFR files under the MPI)
  • 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
  • 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-04-21 J. Ator – Use errwrt()
  • 2014-12-10 J. Ator – Use modules instead of COMMON blocks

Definition at line 48 of file rdmems.f.

References bort(), errwrt(), iupb(), readsb(), and status().

Referenced by ufbmms(), ufbmns(), and ufbrms().