putba

Name

putbai, putbaj, putbae, putbac, putbaf, putbaz — Insert data in table

Synopsis

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

subroutine putbaj(key,size,buffer,status)
character*(*) key
integer*4 size
integer*8 values(*)
integer*4 status

subroutine putbae(key,size,buffer,status)
character*(*) key
integer*4 size
real*4 values(*)
integer*4 status

subroutine putbac(key,size,buffer,status)
character*(*) key
integer*4 size
complex real*4 values(*)
integer*4 status

subroutine putbaf(key,size,buffer,status)
character*(*) key
integer*4 size
real88 values(*)
integer*4 status

subroutine putbaz(key,size,buffer,status)
character*(*) key
integer*4 size
complex real*8 values(*)
integer*4 status

Description

The putba functions insert an array of data elements from buffer into the relational table residing in the table buffer. The putba are equivalent to the putbw functions if size is set to 1. Note that the putba functions inserted a complete array, i.e elements of arrays cannot be inserted separately. putbai insert data of type I, putbaj data of type J, putbae data of type E, putbac data of type C, putbaf data of type F, and putbaz data of type Z.

An error is flagged if key already exists in the table. If this is undesired, make use of the replacement routines rptb, which execute the sequence deletb - putb.

Parameters

key: Character string containing the name of the key (input).
nel: Number of data elements of buffer to be inserted (input). Note that the array size is limited by the table size.
buffer: Buffer containing data to be inserted (input). See description above.
status