getba

Name

getbai, getbaj, getbae, getbac, getbaf, getbaz — Extract numerical arrays from keys

Synopsis

subroutine getbai(key,size,values,status)
subroutine getbaui(key,size,values,status)
character*(*) key
integer*4 size
integer*4 values(*)
integer*4 status

subroutine getbaj(key,size,values,status)
subroutine getbauj(key,size,values,status)
character*(*) key
integer*4 size
integer*4 values(*)
integer*4 status

subroutine getbae(key,size,values,status)
subroutine getbaue(key,size,values,status)
character*(*) key
integer*4 size
real*4 values(*)
integer*4 status

subroutine getbac(key,size,values,status)
subroutine getbauc(key,size,values,status)
character*(*) key
integer*4 size
real*4 values(*)
integer*4 status

subroutine getbaf(key,size,values,status)
subroutine getbauf(key,size,values,status)
character*(*) key
integer*4 size
real*8 values(*)
integer*4 status

subroutine getbaz(key,size,values,status)
subroutine getbauz(key,size,values,status)
character*(*) key
integer*4 size
real*8 values(*)
integer*4 status

Description

The getba functions extract arrays of data elements from the table residing in the table buffer, returning the data to the user area. The calls to the getbau functions perform the same operations as the getba functions, but a warning instead of an error is returned if the key is not found. Note that elements of arrays cannot be extracted separately, i.e the whole array must be extracted.

Specifically, getbai extract arrays of data elements of type I, getbaj data of type J, getbae data of type E, getbac data of type C, getbaf data of type F, and getbaz data of type Z.

Parameters

key: Character string containing the name of the key (input).
size: Number of data elements in the array to be retrieved (input/output). Note that, if n is set to 0 when calling the getba functions, the maximum number of elements of the array is returned and size is set to the maximum number of elements.
value: Data buffer (output).
status