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

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

Go to the source code of this file.

Functions/Subroutines

function ireadmm (IMSG, SUBSET, IDATE)
 This function calls BUFRLIB subroutine readmm() and passes back its return code as the function value. More...
 

Detailed Description

Read a specified BUFR message from internal arrays.

Definition in file ireadmm.f.

Function/Subroutine Documentation

function ireadmm (   IMSG,
character*8  SUBSET,
  IDATE 
)

This function calls BUFRLIB subroutine readmm() and passes back its return code as the function value.

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]IDATE- 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()
Returns
ireadmm - integer:
  • 0 = new BUFR message was successfully read into scope
  • -1 = requested message number could not be found in internal arrays
Remarks
  • The use of this function allows the return code from readmm() to be used as the target variable within an iterative program loop.

Program history log:

  • 1999-11-18 J. Woollen – Original author
  • 2002-05-14 J. Woollen – Changed from an entry point to increase portability to other platforms

Definition at line 41 of file ireadmm.f.

References readmm().

Referenced by ufbmns().