Имя обработчика событий (stproc)
Синтаксис
/stproc[=< имя программы >]
Описание
Задает путь к программе-обработчику событий сервера резервирования. Обработчик событий автоматически вызывается
при наступлении каждого события (см. подраздел «Основные понятия», понятие
События в системе резервирования). Все события ставятся в
очередь в порядке их возникновения. Вызов обработчика событий для обработки следующего события происходит только
после завершения обработки предыдущего события (однако администратор системы резервирования может отменить
очередность обработки событий с помощью ключа /nostprocquery
).
Обработчику событий в качестве аргументов передаются код состояния сервера резервирования в момент наступления события, а также дополнительная информация о событии.
Анализируя события системы резервирования, обработчик событий может инициировать дополнительные действия, связанные со сменой состояния сервера резервирования или остановом/запуском на нем определенных программ. Например, если предполагается поддерживать несколько версий архивных файлов БД, то в процессе обработки события «Программа архивирования создала архив БД» можно переименовать созданный со стандартным именем архивный файл с добавлением к имени файла даты его создания и удалить устаревшие версии, кроме трех последних.
Поиск программы-обработчика событий производится в текущем каталоге запуска сервера резервирования либо в каталогах, перечисленных в переменной окружения PATH. Также может быть указан полный путь к программе-обработчику.
Если значение ключа не задано, предполагаемое имя программы-обработчика – stproc.
Если ключ не задан, обработчик событий не запускается.
Примечание
Для распознавания некоторых событий можно использовать альтернативные коды событий (это упрощает анализ таких событий). Альтернативные коды событий генерируются и, соответственно, передаются обработчику событий только при наличии дополнительных ключей (см. столбец «Дополнительные условия» в таблице 1).
Пример
/stproc handler