Назначение

Команда OPEN используется для установления логической связи между клиентским приложением и СУБД ЛИНТЕР.

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

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

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

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

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

Буфер параметров команды VarBuf должен содержать имя и пароль зарегистрированного в БД пользователя, под чьим именем клиентское приложение будет взаимодействовать с БД.

Буфер SQL-запросов OpBuf может содержать имя устанавливаемой для данного канала кодовой страницы, которая должна быть известна СУБД. Список доступных кодовых страниц находится в системной таблице LINTER_SYSTEM_USER.$$$CHARSET.

При этом:

Если параметр OpBuf содержит неверное имя кодировки, то будет использована кодовая страница по умолчанию для БД, заданная через переменную окружения LINTER_CP, а если содержит пустую строку или пропущен (NULL), то будет использована кодовая страница по умолчанию интерфейсом нижнего уровня.

Заданная в команде OPEN кодовая страница имеет более высокий приоритет по сравнению с переменной окружения LINTER_CP.

При указании имени пользователя, имени кодовой страницы и пароля необходимо соблюдать следующие правила:

Пример.

Пусть имя и пароль пользователя имеют следующие значения:

Ниже приведено несколько иллюстраций употребления имени и пароля при обращении к СУБД:

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

Выходными данными является контрольный блок CBL и буфер RowBuf (если задан).

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

Если задан аргумент RowBuf, то в буфере возвращается структура данных OPEN_DESC, содержащая описание параметров БД, с которой установлено соединение:

typedef struct {
    L_LONG VerMajor;
    L_LONG VerMinor;
    L_LONG VerBuild;
    L_BYTE Flags;
    L_BYTE Reserv;
    L_WORD MaxRecSize;
    L_CHAR BaseName[18];
    L_CHAR SysLog;
    L_CHAR Sync;
    L_CHAR Log;
    L_CHAR Os;
    L_WORD DefCharSet;
    L_WORD UseCharSet;
    L_WORD Reserved;
    L_CHAR UseCharSetName[MAX_ID_LEN];
} OPEN_DESC;

Описание полей структуры OPEN_DESC приведено в таблице 6.

Объем выдаваемой информации определяется длиной буфера RowBuf, которая устанавливается в поле LnBufRow контрольного блока CBL.

Если произошла ошибка при поиске запрашиваемой кодировки, и кодировка была изменена, то в поле Flags структуры (таблица 6) устанавливается флаг 0x01.

Описание

В контрольном блоке (поле NumChan) устанавливается номер открытого канала.

Для идентификации и аутентификации пользователя с использованием Kerberos-сервера необходимо:

Пример идентификации и аутентификации по Kerberos-протоколу приведен в приложении 8.

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

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

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

L_LONG LinterOPEN(TCBL * pCBL, L_CHAR * Name_Pass, L_CHAR * Node, L_WORD Prior, L_LONG PrzExe)
  {
  memcpy(pCBL- >Command, "OPEN", 4);
  if (strlen(Node)  > MAX_NODE_LEN)
    {
    return SQLLONGID;
    }
  memset(pCBL- >Node, 0, MAX_NODE_LEN);
  memcpy(pCBL- >Node, Node, strlen(Node));
  pCBL- >PrzExe = PrzExe;
  pCBL- >Prior = Prior;
  pCBL- >PrzExe &= ~Q_ASYNC;
  inter(pCBL, Name_Pass, NULL, NULL, NULL);
  return pCBL- >CodErr;
  }

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