Команда SET REPROCESS

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

Синтаксис

SET REPROCESS TO nAttempts [SECONDS] | TO AUTOMATIC

Параметры

TO nAttempts [SECONDS]

Определяет, сколько раз Visual FoxPro будет пытаться блокировать запись или файл после того, как первая попытка оказалась неудачной. По умолчанию испо ьзуется значение 0. Максимальное значение 32000.

Если указано ключевое слово SECONDS, Visual FoxPro будет предпринимать попытки блокирования файла или записи в течение nAttempts секунд. Данная возможность допустима только в случае, если значение nAttempts больше нуля.

Например, если nAttempts равно 30, Visual FoxPro пытается блокировать запись или файл до 30 раз. Если же еще задать ключевое слово SECONDS (SET REPROCESS TO 30 SECONDS), Visual FoxPro будет непрерывно повторять попытки блокирования записи или файла в течение 30 секунд.

Если установка SET STATUS имеет значение ON, выдается системное сообщение ("Waiting for lock ..." Ожидание блокировки).

Если активна программа ON ERROR, а попытки команды блокировать запись или файл остаются неудачными, инициируется программа ON ERROR. Однако если какая-либо функция попытается установить блокировку, программа ON ERROR выполняться не бу ет, а функция возвратит значение "ложь" (.F.).

Если программа ON ERROR не действует, команда пытается блокировать запись или файл, но блокировку установить невозможно, тогда выдается соответствующее пре упреждение (например, "Record is in use by another" [Запись обрабатывается д угим пользователем]). Если какая-либо функция попытается установить блокировку, п едупреждение не выдается, а функция возвращает значение "ложь" (.F.).

Если значение nAttempts равно 0 (принимается по умолчанию) и вы выдаете команду или функцию, п тающуюся блокировать запись или файл, Visual FoxPro будет продолжать попытки уста овить блокировку неопределенно долго. Все это время Visual FoxPro выдает системное сообщение "Attempting to lock... Press Escape to Cancel" [Попытки установить б окировку... Для отмены нажмите Escape]. Если запись или файл становятся доступ ыми для блокирования в процессе вашего ожидания, блокировка устанавливается и системное сообщение исчезает. Если какая-либо функция пыталась установить блоки овку, она возвращает значение "истина" (.T.).

Если в ответ на системное сообщение нажать клавишу Esc, появится соответствующее предупреждение (например, "Record is in use by another" [Запись обрабатывается другим пользователем]). Если какая-либо функция поп тается установить блокировку, предупреждение не выдается, а функция возвращает "ложь" (.F.).

Если программа ON ERROR активна и команда пытается блокировать запись или фай , программа ON ERROR пресекает дальнейшие попытки установить блокировку. Эта п ограмма выполняется немедленно. Visual FoxPro не предпринимает больше попыток б окировать запись или файл и не выдает системное сообщение.

Если значение nAttempts равно 1, Visual FoxPro неопределенно долго повторяет попытки блокировать запись или файл. Эти попытки нельзя отменить нажатием клавиши Esc, и программа ON ERROR не выполняется.

Visual FoxPro выдает системное сообщение "Waiting for lock ..." [Ожидание б окировки...] только в том случае, если установка SET STATUS имеет значение ON.

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

TO AUTOMATIC

Указывает, что Visual FoxPro будет неопределенно долго пытаться блокировать запись или файл (эквивалентно команде SET REPROCESS TO 2).

В то время, как Visual FoxPro повторяет попытки блокировать запись или файл, а экране отображается системное сообщение "Attempting to lock ... Press Escape to Cancel" [Попытки установить блокировку... Для отмены нажмите Escape]. Если запись или файл становится доступным для блокирования в процессе вашего ожида ия, блокировка устанавливается и системное сообщение исчезает. Если для установки блокировки использовалась функция, она возвращает значение "истина" (.T.).

Если программа ON ERROR не действует и вы нажимаете клавишу Esc в ответ на системное сообщение, появляется соответствующее предупреждение ( апример, "Record is in use by another" [Запись обрабатывается другим пользовате ем]). Если какая-либо функция пытается установить блокировку, предупреждение не выдается, а функция возвращает "ложь" (.F.).

Если при нажатии клавиши Esc программа ON ERROR активна, она выполняется. Если какая-либо функция пытается установить блокировку, программа ON ERROR не выполняется и функция возвращает "ложь" (.F.).

Подробнее о блокировании записей и файлов, а также о совместном использовании таблиц в сети см. главу 19 "Программирование совместного доступа к данным" Руководства разработчика.

Комментарии

Первая попытка блокировать запись или файл не всегда бывает успешной. Часто запись или файл оказываются блокированными другим пользователем в сети. Команда SET REPROCESS позволяет определить, будет ли Visual FoxPro делать повторные поп тки блокировать запись или файл, когда первая попытка оказывается неудачной. Вы можете задать либо количество повторных попыток, либо продолжительность их повторения.

Программа ON ERROR влияет на то, как обрабатываются неудачные попытки блоки овки.