Rambler's Top100

(c)2009-2017 openinfotech.ru

СУБД HyTech

Документация
Функция htIsNeedToRoll

htIsNeedToRoll - Проверка необходимости отката

Назначение:

Функция предназначена для диагностических целей и используется для поиска таблиц, подлежащих откату и транзакций, в которых эти таблицы задействованы.

В процессе обработки таблиц, задействованных в транзакциях, эти транзакции могут быть завершены другими станциями сети, например, по времени. Как уже упоминалось выше, в таком случае все операции над таблицами, попавшими в подлежащую откату транзакции будут завершаться аварийно, с ошибкой HT_ERR_TRT_ROLLED (транзакция подлежит откату). При выполнении нескольких транзакций на ряде таблиц может возникнуть необходимость поиска транзакций, подлежащих откату.

Функцию можно использовать для просмотра описателей открытых таблиц с целью обнаружения тех из них, которые попали в транзакции, подлежащие откату. Кроме того, функция позволяет определить идентификатор транзакции, которая подлежит откату.

Прототип:

 int HTAPI htIsNeedToRoll(
	THANDLE	hTable,	/* Обработчик таблицы */
	LPTRID	hTrID	/* Идентификатор для транзакции */
 );

Параметры

hTable
задает обработчик проверяемой таблицы
hTrID
задает адрес для приема идентификатора транзакции. Может быть NULL, если идентификатор не нужен

Результат:

0 возвращает "чистый" идентификатор транзакции, если таблица не входит в подлежащую откату транзакцию
1 возвращает заполненный идентификатор транзакции, подлежащей откату
отрицательное число код ошибки