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

Name

mcf_tb_create — Create new relational table (Fortran API)

Synopsis

subroutine mcf_tb_create(rt,status)

mcf_rtable rt
integer*4 status

Description

mcf_tb_create creates a relational table in the table buffer in memory and returns the table identifier rt. Depending on the information inserted, the size of the table is automatically updated. This function is also required to create a dataset descriptor.

[Note]Note

The mcf_tb_create functions create a relational table in memory, not on a database file! To create an empty relational table on a database file, make use of the function mcf_db_create.

Parameters

rt

Relational table identifier of table created in memory (output). If the table could no be created rt is set to -1. Note that a descriptor table is identical to a relational table.

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.