MemCom Reference Manual > MemCom ftn Fortran API > Relational Table Manager (TB) > mcf_tb_insert

Name

mcf_tb_insert — Insert data in relational table (Fortran API)

Synopsis

subroutine mcf_tb_insert(rt,key,type,size,buffer,status)
mcf_rtable rt
character*(*) key
character*4 type
integer*4 size
void buffer(size)
integer*4 status

subroutine mcf_tb_insert_char(rt,key,cbuffer,status)
mcf_rtable rt
character*(*) key
character cbuffer*(*)
integer*4 status

Description

mcf_tb_insert inserts data of type I, J, E, F, C, or Z in a relational table residing in the table buffer rt. mcf_tb_insert_char inserts data of type K (character string) in a relational table residing in the table buffer rt. To replace a key in a relational table make use of mcf_tb_replace .

Parameters

rt

Relational table identifier (input).

key

Data access keyword (input). The string may not exceed the maximum key name length.

size

Number of data elements of buffer to be inserted (input). The first site data elements of buffer are inserted.

buffer | cbuffer

Buffer containing the data elements to be inserted in the table (input).

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued.