Назначение

Команда DIRF предназначена для получения информации об указанном элементе очереди дескрипторов файлов.

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

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

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

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

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

Буфер SQL-запросов OpBuf может содержать имя устанавливаемой для данного канала кодовой страницы, которая должна быть известна БД, то есть:

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

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

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

В буфере выборки данных RowBuf информация будет представлена в следующем виде:

struct DIRF_OUT
   {
   L_LONG Owner;               /* Идентификатор владельца таблицы */
   L_CHAR TblName[MAX_ID_LEN]; /* Имя таблицы */
   L_BYTE Type;                /* Тип файла */
   L_BYTE Extent;              /* Номер файла */
   L_LONG State;               /* Признак состояния */
   };

В полях буфера выборки данных будет содержаться:

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

Изменяя размер очереди файлов (насколько позволят системные ресурсы) и выполняя мониторинг БД, можно добиться оптимального размера – когда элементы из очереди не вытесняются, и в то же время количество неиспользуемых элементов очереди минимально.

Первые 10 элементов очереди файлов заняты дескрипторами системных файлов в порядке, приведенном в таблице 16.

Описание

СУБД ЛИНТЕР ведет очереди, не меняя положения элемента очереди в оперативной памяти. Поэтому, если при двух обращениях к элементу с тем же самым порядковым номером были возвращены разные данные, то между двумя этими обращениями СУБД осуществила запись элемента очереди на диск, а на освободившееся место была записана новая информация.

Для файлов с кодами типа 2,3,4 (таблица 15) поля Owner и TblName будут заполнены нулем и пробелами соответственно.

Информация о файлах с кодом типа 5 (таблица 15) по команде DIRF не выдается.

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

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

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

L_LONG LinterDIRF(TCBL *pCBL, L_LONG N, DIRF_OUT *Out)
   {
   memcpy(pCBL- >Command, "DIRF", 4);
   pCBL- >LnBufRow=sizeof(DIRF_OUT);
   pCBL- >RowId=N;
   pCBL- >PrzExe &= ~Q_ASYNC;
   inter(pCBL, NULL, NULL, NULL, Out);
   return pCBL- >CodErr;
   }