IBM Books

Image, Audio, and Video Extenders Administration and Programming

QbCreateCatalog


Image Audio Video
X    

Creates a catalog in the currently connected database for the specified image column. The column must be enabled for image data. The API creates a name for the catalog, which is used as the qualifier.

Authorization

Alter

Library file
OS/2 and Windows AIX, HP-UX, and Solaris
dmbqbapi.lib libdmbqbapi.a (AIX)

libdmbqbapi.sl (HP-UX)

libdmbqbapi.so (Solaris)

Include file

dmbqbapi.h

Syntax

SQLRETURN QbCreateCatalog(
     char *tableName,
     char *columnName,
     SQLINTEGER autoCatalog,
     char *reserved
     );

Parameters

tableName (in)
The name of the table that contains an image column.

columnName (in)
The name of the image column for which you are creating a catalog.

autoCatalog (in)
Indicates whether images added to the image column will be automatically cataloged, that is, added to the feature tables and analyzed. Specify 1 to set auto-cataloging on or 0 to set it off. If you don't set auto-cataloging on, use the QbCatalogColumn or QbCatalogImage APIs to catalog images that you add to the image column.

reserved (in)
Not currently used.

Error codes

qbicECSqlError
An SQL error occurred.

qbicECNotEnabled
The database, table, or column is not enabled for the DB2Image data type.

qbicECDupCatalog
The catalog already exists.

qbicECunsupportedOption
An unsupported option was specified.

qbicECerrorParameterTooLong
A parameter was too long for processing.

qbicECqerr
A QBIC error occurred, a message was produced.

qbicECqerrUnknown
An internal QBIC error occurred, a generic error message was produced.

Examples

Create a catalog for the images in the picture column of the employee table. Set auto-cataloging on:

#include <dmbqbapi.h>
 
rc = QbCreateCatalog("employee",
        "picture", 1);


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]