Provides a one-call interface to the table space query data. The query data for all table spaces in the database is returned in an array.
In a partitioned database environment, only the table spaces on the current database partition are listed.
Database
sqlutil.h
SQL_API_RC SQL_API_FN
sqlbmtsq (
struct sqlca * pSqlca,
sqluint32 * pNumTablespaces,
struct SQLB_TBSPQRY_DATA *** pppTablespaceData,
sqluint32 reserved1,
sqluint32 reserved2);
SQL_API_RC SQL_API_FN
sqlgmtsq (
struct sqlca * pSqlca,
sqluint32 * pNumTablespaces,
struct SQLB_TBSPQRY_DATA *** pppTablespaceData,
sqluint32 reserved1,
sqluint32 reserved2);
If sufficient memory is available, this function returns the number of table spaces, and a pointer to the memory location of the table space query data. It is the user's responsibility to free this memory with a call to sqlefmem.
If sufficient memory is not available, this function simply returns the number of table spaces, and no memory is allocated. If this should happen, use sqlbotsq, sqlbftpq, and sqlbctsq, to fetch less than the whole list at once.