NCEPLIBS-bufr  12.0.1
Functions/Subroutines
pkbs1.f File Reference

Write a data value into Section 1 of a BUFR message. More...

Go to the source code of this file.

Functions/Subroutines

recursive subroutine pkbs1 (IVAL, MBAY, S1MNEM)
 This subroutines writes a specified value into a specified location within Section 1 of a BUFR message, overwriting the value previously stored in that location. More...
 

Detailed Description

Write a data value into Section 1 of a BUFR message.

Authors
J. Ator, D. Keyser
Date
2005-11-29

Definition in file pkbs1.f.

Function/Subroutine Documentation

◆ pkbs1()

recursive subroutine pkbs1 (   IVAL,
dimension(*)  MBAY,
character*(*)  S1MNEM 
)

This subroutines writes a specified value into a specified location within Section 1 of a BUFR message, overwriting the value previously stored in that location.

This subroutine will work on any BUFR message encoded using BUFR edition 2, 3, or 4. It is similar to subroutine pkvs01(), except that it operates on a BUFR message passed in via a memory array, whereas pkvs01() operates on BUFR messages stored internally within the software.

Parameters
[in]IVAL– integer: Value to be stored
[in,out]MBAY– integer(*): BUFR message
[in]S1MNEM– character*(*): Location in Section 1 of MBAY within which to store IVAL
  • 'BMT' = BUFR master table
  • 'OGCE' = Originating center
  • 'GSES' = Originating subcenter
  • 'USN' = Update sequence number
  • 'MTYP' = Data category
  • 'MSBTI' = Data subcategory (international)
  • 'MSBT' = Data subcategory (local)
  • 'MTV' = Version number of master table
  • 'MTVL' = Version number of local tables
  • 'YCEN' = Year of century (1-100)
  • 'CENT' = Century (e.g., 20 for years 1901-2000, 21 for years 2001-2100)
  • 'YEAR' = Year (4-digit)
  • 'MNTH' = Month
  • 'DAYS' = Day
  • 'HOUR' = Hour
  • 'MINU' = Minute
  • 'SECO' = Second
Remarks
  • The start of the BUFR message (i.e. the string 'BUFR') must be aligned on the first 4 bytes of MBAY.
  • Values corresponding to S1MNEM = 'GSES' can only be stored within BUFR messages encoded using BUFR edition 3 or 4.
  • Values corresponding to S1MNEM = 'YCEN' or 'CENT' can only be stored within BUFR messages encoded using BUFR edition 2 or 3.
  • Values corresponding to S1MNEM = 'YEAR', 'SECO' or 'MSBTI' can only be stored within BUFR messages encoded using BUFR edition 4.
Authors
J. Ator, D. Keyser
Date
2005-11-29

Definition at line 50 of file pkbs1.f.

References bort(), gets1loc(), modv_im8b::im8b, iupbs01(), pkb(), and x84().

Referenced by minimg(), and msgwrt().