Enterprise Edition Home | Express Edition Home | Previous Page | Next Page   SQL Statements > ALLOCATE DESCRIPTOR >

WITH MAX Clause

You can use the WITH MAX clause to indicate the maximum number of item descriptors you need. When you use this clause, the COUNT field is set to the number of items that you specify. If you do not specify the WITH MAX clause, the default value of the COUNT field is 100. You can change the value of the COUNT field with the SET DESCRIPTOR statement.

The following examples show valid ALLOCATE DESCRIPTOR statements. Each example includes the WITH MAX clause. The first line uses embedded variable names to identify the system-descriptor area and to specify the desired number of item descriptors. The second line uses a quoted string to identify the system-descriptor area and an unsigned integer to specify the desired number of item descriptors.

EXEC SQL allocate descriptor :descname with max :occ;

EXEC SQL allocate descriptor 'desc1' with max 3;

Related Information

Related statements: DEALLOCATE DESCRIPTOR, DECLARE , DESCRIBE, EXECUTE , FETCH , GET DESCRIPTOR , OPEN , PREPARE, PUT , and SET DESCRIPTOR

For more information on system-descriptor areas, refer to the IBM Informix ESQL/C Programmer's Manual.

Enterprise Edition Home | Express Edition Home | [ Top of Page | Previous Page | Next Page | Contents | Index ]