MassLockWithWait - Revision history

Admin: 1 revision imported

2022-03-13T10:09:33Z

1 revision imported

1>Admin at 09:09, 31 December 2021

2021-12-31T09:09:42Z

Admin: 1 revision imported

2021-02-07T06:51:47Z

1 revision imported

Admin at 10:50, 22 November 2020

2020-11-22T10:50:31Z

New page

{{infobox function
|name=MassLockWithWait
|object=[[Функции общего назначения]]
|caption=Блокировка группы объектов
|type=1
|status=2
|db=1
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция позволяет установить [[:Template:Типы блокировок системы|блокировку]] на множестве объектов базы данных (или/и семафорах), блокировка происходит по указанным правилам. Текстовые значения списка будут использованы для блокировки [[DBLockStringMutex|семафоров]], объекты базы данных, входящие в список, будут заблокированы, как [[DB.Lock|объекты БД]]. Если какой-нибудь объект уже был заблокирован или семафор уже принадлежит текущему сеансу, элемент пропускается. Для более полной информации по алгоритму блокировки, см. описание аргументов функции.

== Синтаксис ==
<code>
'''MassLockWithWait'''(''<Список с объектами для блокировки (LIST)>''{{Optional|,<Режим пропуска (INT)>{{OptionalDefault|{{eq}}0}},<Разблокировка при ошибках (INT)>{{OptionalDefault|{{eq}}1}},<Период ожидания млс. (INT)>{{OptionalDefault|{{eq}}0}},{{OptionalByRef|<Объект ошибки>}},{{OptionalByRef|<Заблокировано пользователем (STRING)>}},{{OptionalByRef|<Заблокировано на машине (STRING)>}},{{OptionalByRef|<Время блокировки (DATE)>}}}}):''<0 или 1 (INT)>''
</code>
==== Аргументы ====
* <code>''<Список с объектами для блокировки (LIST)>''</code> - Список, содержащий объекты базы данных или/и строки для установки блокировки.
* <code>''<Режим пропуска (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Возможные значения 0 и 1. Режим обратки ситуации, когда один из элементов не может быть заблокирован. Режим 0: После истечения периода ожидания (если задан), завершиться с флагом неудачи, заполнить агрументы ''Объект ошибки'', ''Заблокировано пользователем'', ''Заблокировано на машине'' и ''Время блокировки'' первым из объектов (семафоров), который не может быть заблокирован.
* <code>''<Разблокировка при ошибках (INT)>''{{Default|{{eq}}1}}</code> - {{optional}} Возможные значения 0 и 1. Режим разблокировки объектов, которые успела заблокировать эта функция, при невозможности блокировки одного из последующих объектов. Режим 0: объекты (семафоры) останутся заблокированы, Режим 1: объекты (семафоры) будут разблокированы. Важно: разблокировка, если происходит, касается только объектов, которые были заблокированы этой функцией, список, до начала выполнения функции, уже содержал заблокированные объекты, их статус не будет изменен.
* <code>''<Период ожидания млс. (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Общий период ожидания блокировки ''всех'' объектов в миллисекундах. Если хотя бы один из объектов (семафоров) остается незаблокированным по истечение указанного времени, функция будет завершена с неудачей. Если период ожидания равен 0, функция не ожидает объекты, которые нельзя заблокировать и возращается с неудачей сразу же, как будет найден подобный объект.
* <code>''<Объект ошибки>''</code> - {{optional}}{{byRef}} Переменная для идентификации объекта (семафора), который не может быть заблокирован
* <code>''<Заблокировано пользователем (STRING)>''</code> - {{optional}}{{byRef}} Переменная для получения идентификатора пользователя, который заблокировал ''<Объект ошибки>''
* <code>''<Заблокировано на машине (STRING)>''</code> - {{optional}}{{byRef}} Переменная для получения имени компьютера, на котором был заблокировал ''<Объект ошибки>''
* <code>''<Время блокировки (DATE)>''</code> - {{optional}}{{byRef}} Переменная для получения даты и времени блокировки ''<Объекта ошибки>''

==== Возвращаемое значение ====
Возвращает 1, все объекты списка были заблокированы, 0 -- если хотя бы один не был заблокирован.

== Примеры ==
<pre>
//Внимание: пример нельзя проверить на рабочей базе данных без изменения кодов объектов
a:=List.Create(DB("Ref.Номенклатура","Code","000000003661"),DB("Ref.Номенклатура","Code","000000007561"),"MUTEX01");
//Список содержит два объекта базы данных и одну строку, один из объектов является папкой.
аОбъект:=0;
аПольз:=0;
аМашина:=0;
аВремя:=0;
If MassLockWithWait(a,,,1000,аОбъект,аПольз,аМашина,аВремя) Then
Message("Блокировка произведена успешно");
Else
Message("Невозможно произвести блокировку объекта "+аОбъект+", он был заблокирован пользователем "+аПольз+" на машине "+аМашина+" в "+аВремя);
EndIf;
</pre>

← Older revision	Revision as of 10:09, 13 March 2022
(No difference)

@@ Line 23: / Line 23: @@
 * <code>''<Список с объектами для блокировки (LIST)>''</code> - Список, содержащий объекты базы данных или/и строки для установки блокировки.
 * <code>''<Режим пропуска (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Возможные значения 0 и 1. Режим обратки ситуации, когда один из элементов не может быть заблокирован. Режим 0: После истечения периода ожидания (если задан), завершиться с флагом неудачи, заполнить агрументы ''Объект ошибки'', ''Заблокировано пользователем'', ''Заблокировано на машине'' и ''Время блокировки'' первым из объектов (семафоров), который не может быть заблокирован.
-* <code>''<Разблокировка при ошибках (INT)>''{{Default|{{eq}}1}}</code> - {{optional}} Возможные значения 0 и 1. Режим разблокировки объектов, которые успела заблокировать эта функция, при невозможности блокировки одного из последующих объектов. Режим 0: объекты (семафоры) останутся заблокированы, Режим 1: объекты (семафоры) будут разблокированы. Важно: разблокировка, если происходит, касается только объектов, которые были заблокированы этой функцией, список, до начала выполнения функции, уже содержал заблокированные объекты, их статус не будет изменен.
+* <code>''<Разблокировка при ошибках (INT)>''{{Default|{{eq}}1}}</code> - {{optional}} Возможные значения 0 и 1. Режим разблокировки объектов, которые успела заблокировать эта функция, при невозможности блокировки одного из последующих объектов. Режим 0: объекты (семафоры) останутся заблокированы, Режим 1: объекты (семафоры) будут разблокированы. Важно: разблокировка, если происходит, касается только объектов, которые были заблокированы этой функцией, если список, до начала выполнения функции, уже содержал заблокированные объекты, их статус не будет изменен.
 * <code>''<Период ожидания млс. (INT)>''{{Default|{{eq}}0}}</code> - {{optional}} Общий период ожидания блокировки ''всех'' объектов в миллисекундах. Если хотя бы один из объектов (семафоров) остается незаблокированным по истечение указанного времени, функция будет завершена с неудачей. Если период ожидания равен 0, функция не ожидает объекты, которые нельзя заблокировать и возращается с неудачей сразу же, как будет найден подобный объект.
 * <code>''<Объект ошибки>''</code> - {{optional}}{{byRef}} Переменная для идентификации объекта (семафора), который не может быть заблокирован

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)