getbw

Name

getbwi, getbwj, getbwe, getbwc4, getbwf, getbwz, getbwc — Extract scalar keys from table

Synopsis

subroutine getbwi(key,value,status)
character*(*) key
integer*4 value
integer*4 status

subroutine getbwj(key,value,status)
character*(*) key
integer*4 value
integer*4 status

subroutine getbwe(key,value,status)
subroutine getbwue(key,value,status)
character*(*) key
real*4 value
integer*4 status

subroutine getbwc4(key,value,status)
subroutine getbwuc4(key,value,status)
character*(*) key
real*4 value
integer*4 status

subroutine getbwf(key,value,status)
subroutine getbwuf(key,value,status)
character*(*) key
real*8 value
integer*4 status

subroutine getbwz(key,value,status)
subroutine getbwuz(key,value,status)
character*(*) key
real*8 value
integer*4 status

subroutine getbwc(key,value,status)
subroutine getbwuc(key,value,status)
character*(*) key
character*(*) value
integer*4 status

Description

The getbw functions extract a single data element from a key in a relational table residing in the table buffer, returning the data to the user area. The calls to the getbwu functions perform the same operations as the getbw functions, but a warning instead of an error is returned if the key is not found.

Specifically, getbwi extracts a single data element of type I, getbwj a single data element of type J, getbwe a single data element of type E, getbwc4 (exception!) a single data element of type C, getbwf a single data element of type F, getbwz a single data element of type Z, and getbwc a single data element of type K (character string). Note that character strings (K) are treated as 'scalars', i.e without indicating the number of characters, because the size of a Fortran character string is implicit.

Parameters

key: Character string containing the name of the key (input).
value: Data buffer (output).
status