IBM Books

Image, Audio, and Video Extenders Administration and Programming

QbQueryNameCreate


Image Audio Video
X    

Stores and names a query object so that you can use it in a UDF. You provide the name and can provide the description of the query object.

Notes:

  1. EEE Only: QbQueryNameCreate is not supported in a partitioned database environment.

  2. QbQueryNameCreate will be deprecated in future releases for non-partitioned database environments. To save a query, you should use QbQueryGetString to get the query string and save that string for later use in your application.

Authorization

None.

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

libdmbqqry.sl (HP-UX)

libdmbqqry.so (Solaris)

Include file

dmbqbapi.h

Syntax

SQLRETURN QbQueryNameCreate(
      QbQueryHandle qObj,
      char *name,
      char *description
      );

Parameters

qObj (in)
The handle of the query object.

name (in)
The name of the query object. The name can be up to 18 characters.

description (in)
A brief description of the query object, up to 250 characters.

Error codes

qbiECinvalidQueryHandle
The query object handle that you specified does not reference a valid query .

Examples

Give a name and description to the query object created with the QbQueryCreate API:

#include <dmbqbapi.h>
 
rc = QbQueryNameCreate(qHandle,
       "fshavgcol",
       "average color query, 10/15/96");


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