Файл настройки событий и маршрутизации почты (events.ctl)
Ниже приводится описание конфигурационного файла, в котором
производится настройка "событий" и определяются правила маршрутизации
почты. По умолчанию он имеет имя events.ctl. Максимальная длина строки в
этом файле 255 символов.
Общий синтаксис конструкций этого файла таков:
[[<task_ident>]] [<modifier>] <keyword> <parameters> <time period>
или
[[<task_ident>]] [<modifier>] <keyword> <parameters> <time>
Правила для номера задачи <task_ident> такие же, как и для этого
параметра в файле t-mail.ctl и подробно описаны в части "Номер задачи" этой
главы. Следует лишь отметить, что этот номер может быть использован и для
отдельной строки, входящей в многострочную конструкцию (такие строки
начинаются с символа "#", см.ниже).
<modifier> - это специальное ключевое слово-префикс, может иметь
только одно из следующих значений:
Critical - префикс, который описывает событие как критическое. Для
каждого события есть вероятность того, что оно будет
пропущено, если интервал времени, заданный для него истек,
а мэйлер не смог выполнить его (по причине продолжительного
сеанса связи, выполнения внешней программы и т.п.). Если
событие описано как Critical, то оно будет выполнено даже в
этом случае при первой возможности в эти же сутки.
Start - префикс, означающий, что событие будет выполнено только
однажды при начале работы T-Mail. Для такого события, как
исключение, не может быть задан временной параметр в конце
строки.
Relative - префикс, означающий, что временной параметр, указанный в
конце строки, добавляется к текущему времени (в момент
чтения файла events.ctl). Например, строка:
Relative Hold All 0:10-4:00
в 3:00 будет эквивалентна строке
Hold All 3:10-7:00.
Чуть далее в таблице будут приведены описания всех директив <keyword>
с параметрами <parameters>. В конце каждой строки может стоять интервал
времени <time period>, определяющий, когда действует данное правило или
происходит данное событие, либо просто указано время <time> данного
события, в этом случае этот интервал подразумевается равным одному часу,
начиная с времени <time>. Если в течении этого часа мэйлер не сможет
обработать событие (долгий сеанс связи и т.п.), то событие выполнено не
будет вообще. Интервалов <time period> или моментов времени <time> может
быть указано несколько, в таком случае каждая такая строка рассматривается
как сумма независимых событий/правил и статус пpи их выполнении независим.
Существует одна тонкость в обработке событий на границе суток. Если
время события было задано с указанием конкретного дня недели (например,
3.23:30), то возможное время исполнения этого события - 23:30...23:59 в
каждую среду. Если же время события указано БЕЗ указания дня недели
(например, просто 23:30), то возможное время выполнения этого события -
23:30...00:30 каждый день.
Если в момент, когда начинается <time period> события мэйлер выполнял
какие-либо другие действия, то событие произойдет по окончании этих
действий, если этот <time period> еще не завершился. При повторном запуске
T-Mail в течение одного <time period> событие повторно произойдет лишь в
том случае, если был изменен файл конфигурации событий events.ctl. Формат
интервала <time period> подробно описан в части "Задание интервалов
времени" этой главы. Кроме того, в качестве <time period> может быть задан
указатель периодического события (periodical event), описанный ниже в
соответствующей части этой главы. В некоторых директивах можно задавать в
качестве дополнительного параметра (attr) атрибуты формируемых писем:
(Imm), (Crash), (Hold), (Dir), причем одновременно можно задавать несколько
атрибутов, тогда они помещаются в одни скобки и разделяются пробелом,
например, (Dir Imm). При задании атрибута вместе с номером задачи
<task_ident> атрибут будет действителен только для указанной задачи.
Ниже приведена сводная таблица директив файла events.ctl с краткой
аннотацией. В таблице для экономии места не указаны параметры времени.
После таблицы следуют подробные описания каждой директивы.
--------------------------------------------------------------------
Директива и ее параметры Что она задает
--------------------------------------------------------------------
'События':
Poll [(attr)] <addr list> poll (опрос) системы (в определенное
время).
Send [(attr)]<fname><addr group> Послать файл <fname> системам с
адресами <addr group> (в определенное
время).
Post [(attr)]<fname><addr group> Послать файл <fname> в виде письма
системам с адресами <addr group> (в
определенное время).
Freq [(attr)]<fname> Сформировать файловые запросы на
<addr group> <fname> для систем с
адресами <addr group> (в определенное
время).
UрdReq [(attr)]<fname> То же, что и Freq, файл будет принят
<addr group>) только при том условии, что он более
(синоним - UpdFreq) новый (по дате и времени создания или
модификации), чем имеющийся.
Exit <errorlevel> Выход из программы с <errorlevel>.
Repack <addr group> Пересоздание очереди (всей или для
адресов <addr group>).
* Drop <addr list> Удалить служебные письма для адресов
<addr list> и перепаковать для них
почту.
Set <parameter=value> Замена значения параметра <parameter>
или из файла t-mail.ctl на <value> или
Set @<filename> замена с использованием файла
<filename>.
Exec <command> Выполнение внешней программы, запуск
задачи в DesqView или выполнение
действий по ключевому слову.
Break <addr list> <time> Прерывает сеанс связи в указанный
момент времени <time>.
LimitIn <limit> [<addr list>] Задает ограничение для входящих
сеансов связи в минутах.
LimitOut <limit> [<addr list>] Задает ограничение для исходящих
сеансов в минутах.
KeyMacro <macro> Вызывает имитацию нажатия заданных
клавиш в определенное время.
-----------------------------------------------------------------------
Правила маршрутизации :
* Mail-For <addr list><address> Задание правила маршрутизации почты.
* Mail-From <addr list><address> Задание правила маршрутизации почты.
* Files-For <addr list><address> Задание правила маршрутизации файлов.
* Files-From <addr list><address> Задание правила маршрутизации файлов.
Share <addr list><address> Добавление AKA к адресам удаленной
системы.
Hold [(NN)] <addr list> Запрещает звонки на заданные системы.
Freeze [(NN)] <addr list> То же, что и Hold , игнорирует статус
immediate.
Priority <address list> Задает адреса систем, которые нужно
обслуживать в первую очередь.
NoReq <address list> Запрещает отправлять файловые запросы
заданным системам.
RestoreOut <address list> Формирует служебное письмо (poll) в
случае обрыва приема файла при
сеансах связи с системами, описанными
в <address list>. Для исходящих
сеансов связи.
RestoreIn <address list> Аналогично RestoreOut, но для
входящих сеансов связи.
* Direct <address list> Отменяет всякую маршрутизацию для
заданных адресов.
* Deny <address list> Запрещает формировать пакеты,
сканировать Bink-Style Outbound и
файловые ящики для заданных систем.
MailOnly <address list> Запрещает обмен файлами с заданными
системами, отправляется только
почта (.рkt).
SendOnly <address list> Запрещает принимать файлы и почту при
сеансах с указанными системами.
Flavor (<type> <flag>) <addr> Изменяет в заданное время атрибуты
определенных писем.
-----------------------------------------------------------------------
* - для многоканальных систем эти директивы оказывают действие только
на T-Mail/master.
Ниже подробно описаны все директивы файла events.ctl.
Poll
Send
Post
Freq и UрdReq
Exit
Repack
Drop
Set
Exec
Break
LimitIn и LimitOut
KeyMacro
Mail-For и Files-For
Mail-From и Files-From
Share
Direct
Hold и Freeze
NoReq
Deny
Priority
RestoreIn и RestoreOut
MailOnly
SendOnly
Flavor
