ЛИНТЕР

Присвоение значений дескриптору

Назначение

Описание фактических значений параметров динамического запроса и присвоение входным параметрам в дескрипторе требуемых значений для последующего использования в динамических SQL-запросах.

Синтаксис

<присвоить значение дескриптору>::=
EXEC SQL SET DESCRIPTOR <имя дескриптора>
 COUNT = :<переменная основного языка> | <литерал>
| VALUE <номер параметра>
 <описатель параметра> [, < описатель параметра> … ]
<описатель параметра>::=
{ TYPE
| LENGTH
| PRECISION
| SCALE
| NULLABLE
| INDICATOR
| DATA
} = :{< переменная основного языка>| <литерал>} <данные>

Описание

COUNT – задает общее количество описателей динамических параметров в дескрипторе <имя дескриптора>. Указанное значение не должно превышать количества описателей, для которых выделено место в дескрипторе при выполнении оператора ALLOCATE DESCRIPTOR. Если COUNT превышает <количество описателей> (см. ALLOCATE DESCRIPTOR), на этапе выполнения программы будет фиксироваться ошибочная ситуация (ошибка ErrPCI_InvDescIdx).
<Номер параметра> задает номер параметра в дескрипторе <имя дескриптора>. Значение должно находиться в диапазоне от 1 до <количества описателей>, где <количество описателей> – количество объявленных описателей в дескрипторе <имя дескриптора>. <Номер параметра> может быть задан целочисленной константой или целочисленной переменной основного языка. Если <номер параметра> больше значения <количества описателей> или меньше 1, при выполнении возникает ошибка ErrPCI_DescSmall.
Каждому динамическому параметру в его описателе можно присвоить следующие атрибуты:
- TYPE – тип переменной основного языка, привязанной к данному параметру в дескрипторе (см. таблицу 8);
```
EXEC SQL SET DESCRIPTOR DSC VALUE 1 TYPE =PCC_CHR_TYP; /* тип задан непосредственно */
type = PCC_CHR_TYP;
EXEC SQL SET DESCRIPTOR DSC VALUE 1 TYPE = :type; /* тип задан переменной основного языка */
```
- LENGTH – длина переменной основного языка, привязанной к данному параметру в дескрипторе. Длину параметра можно установить равной нулю. В этом случае при привязке значения (DATE) длина будет определена автоматически по типу привязываемой переменной и ее фактическому значению на момент привязки (для CHAR, BIT – strlen(); для VARCHAR, VARBIT – значение поля len). Последующая операция GET DESCRIPTOR VALUE LENGTH(RETURNED_LENGTH) дает фактическую длину привязанного параметра.
```
EXEC SQL SET DESCRIPTOR DSC VALUE 1 LENGTH = 32; /* длина задана непосредственно */
/* длина задана переменной основного языка и установлена в неопределенное значение. */
/* Фактическая длина параметра будет определена в момент привязки данных.*/
len = 0;
EXEC SQL SET DESCRIPTOR DSC VALUE 1 LENGHT = :len;
```
- PRECISION – точность числа типа NUMERIC (не используется; зарезервировано для будущего использования);
- SCALE – масштаб числа типа NUMERIC (не используется; зарезервировано для будущего использования);
- NULLABLE – признак допустимости NULL-значений (0 – столбец таблицы допускает NULL-значение, не ноль – NULL-значения не допускаются). Если NULL-значение недопустимо, то при получении его в процессе исполнения предложения SQL возникает ошибка ErrPCI_NullProhibited;
- DATA – задает значение параметру предложения SQL. Перед присвоением значения необходимо инициализировать атрибуты TYPE и LENGTH в соответствии с типом и длиной привязываемой переменной основного языка (непосредственных данных).
  
  Если атрибут DATA содержит непосредственно данные или переменную типа PCC_DAT_TYP, то они копируются во внутренний буфер описателя. Если DATA содержит переменную основного языка, то в описателе сохраняется ее адрес. Копирование данных в этом случае не производится;
- непосредственно присвоить значение параметру типа VARCHAR, VARBIT нельзя. При выполнении возникнет ошибка ErrPCI_IncTyp.
```
/* данные заданы непосредственно */
EXEC SQL SET DESCRIPTOR DSC VALUE 1 DATA = 'sample_data';
EXEC SQL SET DESCRIPTOR DSC VALUE 1 DATA = :s; /* данные заданы переменной основного языка */
```
- INDICATOR – задает значение индикаторной переменной. Для привязки NULL-значения во входном параметре необходимо установить значение -1.
Входной дескриптор считается полностью описанным, если заданы атрибуты LENGTH, TYPE, DATA для всех точек входа. Если хотя бы одно из этих значений не установлено в описателе параметра, то фактическим значением параметра станет NULL-значение, и при исполнении будет выдано предупреждение ErrPCI_NotBind.
<Имя дескриптора>, указанное в конструкции <присвоить значение дескриптору>, должно ссылаться на дескриптор, инициализированный ранее (ALLOCATE DESCRIPTOR).
Тип данных переменной, указанной в атрибуте DATA, должен соответствовать типу данных и длине описателя, указанного в <номере описателя параметра>.