Доступные версии документации

Дать описание кода завершения СУБД

Назначение
 

Команда GETE возвращает текстовое описание кода завершения операции СУБД ЛИНТЕР.

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

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

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

Входными данными является контрольный блок CBL.

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

Имя поля Значение
Command "GETE"
RowId Числовое значение кода завершения СУБД
LnBufRow Длина буфера выборки данных
Node Имя ЛИНТЕР-сервера
Выходные данные

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

  • контрольный блок CBL;

  • буфер выборки данных RowBuf.

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

Имя поля Значение
CodErr Код завершения операции СУБД ЛИНТЕР
LnBufRow Фактическая длина буфера выборки данных
SysErr Код состояния ОС

Текстовое описание кода завершения возвращается в буфере выборки данных RowBuf.

Для кодов завершения СУБД, относящихся к созданию (модификации) триггеров и хранимых процедур, вместо текста выдается другая информация (пункт Обработка ошибок трансляции хранимых процедур (триггеров)).

Описание

При выполнении команды GETE используется таблица ERRORS, содержащая текстовые описания кодов завершения. Если эта таблица отсутствует в БД, или задан несуществующий числовой код завершения, то в RowBuf возвращается следующий текст: Linter error NNNN

где NNNN – указанный в команде GETE числовой код завершения.

Примечание

Для создания таблицы ERRORS, в случае ее отсутствия в БД, необходимо выполнить командный файл cerrors.sql и затем загрузить в созданную таблицу данные из файла errors.lod. Указанные файлы входят в состав дистрибутива СУБД ЛИНТЕР.

Коды завершения
Код Описание
NORMAL Нормальное завершение
SMALLBUFKOR Недостаточный размер буфера выборки данных
Пример формирования команды
#include <string.h>
#include <stdlib.h>
#include "inter.h"

L_LONG LinterGETE(TCBL *pCBL, L_LONG CodErr, void *Str, L_WORD StrLen)
   {
   memcpy(pCBL->Command, "GETE", 4);
   pCBL->LnBufRow=StrLen;
   pCBL->RowId=CodErr;
   pCBL->PrzExe &= ~Q_ASYNC;
   inter(pCBL, NULL, NULL, NULL, Str);
   *((char*)Str + ((pCBL->LnBufRow>StrLen)?(StrLen-1):(pCBL->LnBufRow))) = 0;
   return pCBL->CodErr;
   }
Пример использования команды
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include "inter.h"
#include "exlib.h"

#ifndef WINCE
int    main()
#else
int    exgete()
#endif
   {
   TCBL  CBLconnect;
   L_CHAR Name_Pass[] = "SYSTEM/MANAGER";
   L_CHAR Node[] = "        ";
   L_WORD Priority = 0;
   L_LONG PrzExe = M_EXCLUSIVE | M_BINARY;
   L_LONG Err;
   L_CHAR  Str[256];
   L_CHAR  Query[] = "select ERROR NAME,FIRSTNAM,SEX from PERSON;";
   /* ошибка */

   memset(&CBLconnect,0,sizeof(TCBL));
   Err=LinterOPEN(&CBLconnect, Name_Pass, Node, Priority, PrzExe);
   if (Err != NORMAL)
     PrintError(&CBLconnect);
   printf("Connect to RDBMS Linter\n");

   LinterSLCT(&CBLconnect, PrzExe, Query, NULL, L_MAXWORD, NULL);
   Err=LinterGETE(&CBLconnect, CBLconnect.CodErr, Str, 255);
   if (Err != NORMAL)
     PrintError(&CBLconnect);
   printf("GETE: %s\n", Str);

   printf("End Example\n");

   return 0;
   }
Заметили ошибку?
Выделите текст и нажмите Ctrl + Enter