Назначение

Выполнение предварительно оттранслированной и сохраненной в БД пользовательской процедуры.

Параметры вызова

inter(CBL, NULL, OpBuf, [CondBuf], RowBuf);

Входные данные

Входными данными являются:

В контрольном блоке должны быть заполнены поля:

Буфер оператора OpBuf должен содержать SQL-выражение исполнения процедуры:

EXECUTE < имя процедуры >(< значения параметров >);

< значения параметров > представляют собой совокупность допустимых в SQL выражений, разделенных запятой. Некоторые из этих выражений могут отсутствовать (помечаются запятой). В случае пропуска фактических параметров и/или непривязке значений к параметрам формальные параметры получают значения по умолчанию (если для них заданы значения по умолчанию), либо NULL-значения в противном случае по умолчанию так же, как при вызове хранимой процедуры изнутри другой хранимой процедуры.

Для передачи логических значений используются целые числа (0 интерпретируется как FALSE, 1 – как TRUE) или символьные константы 'true' и 'false' (в любом регистре).

Выходные данные

Выходными данными являются:

В контрольном блоке будут возвращены:

Результат выполнения процедуры возвращается в буфере RowBuf в двоичном представлении в виде специальной структуры, которая содержит последовательно:

Описатель возвращаемого значения и описатель выходного параметра имеют следующую структуру:

struct ARGPROC_OUT
   {
   L_BYTE Flags;     /* Флаги значения */
   L_BYTE Reserv;    /* Зарезервировано */
#if _VER_MAX  >= 550
   L_WORD Expr;      /* Идентификатор выражения */
#endif
   L_WORD Value;     /* Смещение значения в буфере */
   P_TYPE Type;      /* Тип значения */
#if _VER_MAX  >= 550
   L_WORD Reserv2;   /* Зарезервировано */
#endif
   };

Описатель возвращаемого значения (выходного параметра) содержит следующие поля:

struct P_TYPE
 {
 L_WORD length;  /* Длина типа данных */
 L_BYTE ntyp;    /* Код типа данных */
 L_BYTE prcs;    /* Точность */
 L_BYTE scale;   /* Масштаб */
 L_BYTE reserv;  /* Резерв */
 #if _VER_MAX  >= 600
 L_WORD charset; /* Идентификатор кодовой стр-цы */
 #endif
 };

Описание

Выполнение хранимых процедур осуществляется последовательно в режиме квантования времени.

Допускается рекурсивный вызов процедуры. Глубина рекурсии ограничивается предоставленными ядру СУБД ЛИНТЕР ресурсами (размерами дисковой и оперативной памяти).

В рамках одной транзакции первая запущенная на выполнение хранимая процедура открывает для своей работы дочерний канал. Все последующие процедуры, вызываемые в рамках той же транзакции, переиспользуют этот канал, не открывая новых. Поэтому команды COMMIT/ROLLBACK в процедуре влияют не только на изменения, сделанные данной процедурой, но и на все изменения, осуществленные всеми вызванными ранее процедурами. Чтобы избежать этого, процедура должна использовать контрольные точки SAVEPOINT: установить точку сохранения в начале транзакции и подавать COMMIT/ROLLBACK до нее.

Поскольку триггерные транзакции выполняются точно так же, как и процедурные, то все сказанное о процедурной транзакции верно и для триггерных. Кроме того, в контексте триггеров такой механизм обработки транзакций дает полезный эффект: поскольку все изменения совершаются триггерами по одному общему каналу, то в случае нарушения логики работы, обнаруженной триггером, он может подать команду ROLLBACK, откатывающую изменения всех вызванных ранее триггеров и обеспечивающую целостность БД в рамках текущего запроса обработки данных.

Коды завершения

Пример формирования команды

#include < string.h >
#include < stdlib.h >
#include "inter.h"

L_LONG LinterExec(TCBL *pCBL, L_CHAR *ExecStat, void *Buf, L_WORD LenBuf)

   {
   memcpy(pCBL- >Command, "  ", 4);
   pCBL- >LnBufRow=LenBuf;
   pCBL- >PrzExe &= ~Q_ASYNC;
   inter(pCBL, NULL, ExecStat, NULL, Buf);
   return pCBL- >CodErr;
   }

Пример использования команды

См. приложение 14.