Переменные nncron.ini

Примечание. Чтобы вернуть всем переменным nncron.ini их дефолтные значения (значения по умолчанию), поступите так:

После этой процедуры конфигурационный файл nncron.ini будет создан заново, а все его переменные примут значения по умолчанию.

Crontab: "filename"

Используется для подключения кронтабов. В nncron.ini можно использовать несколько переменных Crontab: - по числу подключенных кронтабов.

Crontab: "hotkey.tab"
Crontab: "vk.tab"
Crontab: "test.tab"
Crontab: "%YYYY%.tab"

Editor: "filename"

Определяет текстовой редактор, который будет запускаться при выборе пункта меню "Просмотреть лог-файл" и при нажатии кнопки nncron.ini в диалоговом окне "Параметры".

Кстати говоpя, для бесплатного текстового pедактоpа с откpытыми исходниками SciTE существует специальный pежим подсветки синтаксиса кpонтабов nnCron. Подсветка синтаксиса гибко настpаивается. Рекомендую! За дополнительной инфоpмацией - на сайт SciTE. (http://www.scintilla.org). Также подсветка синтаксиса кронтабов nnCron и языка программирования Форт есть для встроенного редатора файл-менеджера ФАР (http://www.farmanager.com).

Допустимые значения: 

Editor: "d:\tools\scite\scite.exe"

Language: <language_name>

Определяет язык графического интерфейса nnCron. Файлы с языковыми ресурсами nnCron располагаются в подкаталоге res. Новые и обновленные файлы с языковыми ресурсами nnCron вы можете скачать в интернете: http://www.nncron.ru/translation.shtml

Допустимые значения:

и т. д.

Language: English

Cronlog: "filename"

Задает имя лог-файла nnCron.

Cronlog: "log\nncron.log"

LogTimeFormat: "time_format"

Определяет формат выведения информации в лог-файл.

LogTimeFormat: "%DD% %MMM% %hh%:%mm%:%ss% %ThreadId%"

YearField <ON/OFF>

Определяет, используется ли поле года в cron-формате, который использует nnCron.

Допустимые значения: 

YearField ON

CompleteTaskTimeout: <time_in_ms>

Определяет паузу (в миллисекундах), в течение которой nnCron будет ожидать завершения запущенных задач при перечитывании кронтабов. Если задачи не успели завершиться за указанный промежуток времени, они будут принудительно остановлены.

CompleteTaskTimeout: 10000

QueryStartTimeout: <time_in_sec>

Определяет время (в секундах), в течение которого nnCron будет ожидать реакции пользователя на запрос о запуске программы (QSTART-APP:). Если в течение указанного времени реакции пользователя не последовало, то nnCron сам примет решение о запуске (см. переменную QueryStartAnswer:).

QueryStartTimeout: 30

QueryStartAnswer: <Yes/No>

Определяет ответ nnCron на вопрос "Запустить приложение?" (QSTART-APP:) в случае, если пользователь не отреагировал на запрос в течение времени, указанного в переменной QueryStartTimeout:.

Допустимые значения: 

QueryStartAnswer: Yes

PerfMonitor <ON/OFF>

Позволяет "включить" набор специальных слов для мониторинга производительности системы. В числе этих слов:

Допустимые значения: 

PerfMonitor OFF

ReloadImmediately <ON/OFF>

ReloadImmediately ON - при обнаружении изменений, немедленно перечитывать кронтабы, расположенные в домашнем каталоге nnCron (не дожидаясь 30-й секунды текущей или следующей минуты).
ReloadImmediately OFF - при обнаружении изменений, перечитывать кронтабы на 30-й секунде текущей или следующей минуты.

Допустимые значения: 

ReloadImmediately ON

DefaultOpenMode: <mode>

Задает режим по умолчанию, в котором nnCron будет запускать приложения (окно приложения отображается в обычном режиме, свернутым в значок, распахнутым на весь экран или скрытым).

Допустимые значения: 

DefaultOpenMode: ShowNormal

DefaultPriority: <priority>

Задает приоритет по умолчанию, с которым nnCron будет запускать приложения.

Допустимые значения: 

DefaultPriority: NormalPriority

DefaultRunMissedTime: <hh:mm|days>

Управляет запуском "просроченных" задач: устанавливает максимальное время ожидания (в часах и минутах или в днях), которое может пройти с момента просроченного (запланированного) старта задачи. Если с момента просроченного старта прошло больше времени, чем установлено в переменной DefaultRunMissedTask:, то внепланового запуска просроченной задачи не произойдет.

DefaultRunMissedTime: 360:00

DefaultLogonType: <logon_type>

Определяет тип логона по умолчанию.

Допустимые значения: 

DefaultLogonType: LogonInteractive

SysTrayIcon <ON/OFF>

Управляет отображением иконки nnCron в системном трее.

Допустимые значения:

SysTrayIcon ON

TrayIconDoubleClick: <forth_word>
TrayIconRightButton: <forth_word>
TrayIconBalloonClick: <forth_word>

Задают действия, которые будут происходить при двойном клике мышью и клике правой кнопкой мыши на иконке nnCron в системном трее, а также при щелчке мышью на подсказке BALLOON:. В качестве аргумента для слов TrayIconDoubleClick:, TrayIconRightButton: и TrayIconBalloonClick: можно использовать одно из предопределенных слов из приведенного ниже списка, либо любое другое форт-слово.

Предопределенные слова для использования с TrayIconDoubleClick:, TrayIconRightButton: и TrayIconBalloonClick:

TrayIconDoubleClick: options
TrayIconRightButton: menu
TrayIconBalloonClick: NOOP

См. также ответы на вопросы "...как запускать собственную задачу по двойному клику на иконке nnCron в системном трее?" и "...как сконструировать собственное меню, которое бы появлялось при клике правой кнопкой мыши на иконке nnCron в системном трее?".

IconForAdminsOnly <ON/OFF>

Позволяет отображать иконку nnCron в системном трее отображалась только для пользователей с правами администраторов. Если значение переменной установлено в ON, то пользователи с более низкими правами не будут видеть иконку nnCron в трее.

Допустимые значения:

IconForAdminsOnly OFF

MonitorResponseTime: <time_in_ms>

Задает минимальное время (в миллисекундах) между двумя событиями (Watch*). Подробнее этот вопрос рассмотрен в главе Спецификация события.

MonitorResponseTime: 100

: CRONTAB-ERROR ... ;

Слово CRONTAB-ERROR вызывается каждый раз, когда в кронтабе обнаружена синтаксическая ошибка. Меняя определение слова CRONTAB-ERROR, вы меняете содержание сообщения об ошибке. CRONTAB-ERROR отчасти дублирует действие переменной ShowErrorMsg, поэтому его можно использовать в качестве "вспомогательного" инструмента: например, оповещать об ошибке характерным звуком, создавать файл-флаг при появлении ошибки или совершать какое-то другое действие. Слово CRONTAB-ERROR может быть безопасно удалено из nncron.ini.

: CRONTAB-ERROR ( a u -- )
WinNT? IF 10 1 DO 100 I 100 * BEEP LOOP ELSE 1 1 BEEP THEN
ERR-MSG: "CRONTAB ERROR!!!.%crlf%%crlf%TASK FILE: %CUR-TAB-FILENAME COUNT%%crlf%TASK: %CUR-TASK-NAME%%crlf%Line: %CURSTR @%"
;

: REMINDER-SOUND ... ;

Слово REMINDER-SOUND определяет звуковой сигнал, сопровождающий появление "Напоминания" (Reminder).

: REMINDER-SOUND 500 500 BEEP ;

или:

: REMINDER-SOUND PLAY-SOUND: "%Windir%\media\tada.wav" ;

BackupPath: "folder_name"

Задает каталог, куда nnCron помещает резервные копии кронтабов и ини-файлов при их изменении.

BackupPath: "backup"

WatchWinCreateDelay: <time_in_ms>

Определяет задержку (в миллисекундах) перед срабатыванием WatchWinCreate:. Необходимость такой задержки вызвана тем, что в момент создания многие окна еще не имеют заголовков и, значит, не поддаются "отлавливанию" по этому признаку.

WatchWinCreateDelay: 100

WatchProcDelay: <time_in_ms>

Определяет задержку (в миллисекундах) перед срабатыванием WatchProc: и WatchProcStop:.

WatchProcDelay: 1000

Console <ON/OFF>

Определяет запускается ли форт-консоль одновременно со стартом nnCron.

Допустимые значения:

Console OFF

ItemConsole <ON/OFF>
ItemExit <ON/OFF>
ItemOptions <ON/OFF>
ItemReload <ON/OFF>
ItemSuspend <ON/OFF>

Эти переменные отвечают за наличие/отсутствие пунктов "Инструменты/Консоль", "Выход", "Параметры", "Перечитать кронтабы" и "Приостановить nnCron/Продолжить работу nnCron" в меню, которое появляется при клике правой кнопкой мыши на иконке nnCron в системном трее.

Допустимые значения: ON или OFF

ItemExit ON
ItemOptions ON
ItemConsole ON
ItemReload ON
ItemSuspend ON

Guard <ON/OFF>

Определяет, будет ли задействована программа nnguard.exe, которая отвечает за то, чтобы nnCron автоматически перезапускался после фатальных ошибок. Подробнее о "непотопляемом режиме" можно узнать в главе "Запуск и остановка nnCron. Непотопляемый режим".

Допустимые значения:

Guard ON

INCLUDE "filename"

"Подключает" указанные плагины. В nncron.ini можно использовать несколько слов INCLUDE - по числу подключенных плагинов.

INCLUDE "plugins\tools.spf"
INCLUDE "plugins\windows.spf"
INCLUDE "plugins\time.spf"
INCLUDE "plugins\win2tray.spf"
INCLUDE "plugins\wakeup.spf"
INCLUDE "plugins\procwin.spf"
INCLUDE "plugins\timesync.spf"

DialOnce <ON/OFF>

DialOnce ON - не перезванивать снова, если уже установлено интернет-соединение (не вызывается функция RasDial). Соответственно, для того, чтобы положить трубку достаточно одного вызова HANGUP.
DialOnce OFF полезен тогда, когда заранее неизвестно, сколько раз звонили. Если DIAL: вызывался несколько раз, то для того, чтобы положить трубку нужно столько же раз вызвать и HANGUP. Когда будет последний HANGUP, тогда и будет положена трубка.

Допустимые значения:

DialOnce ON

DefaultUser: "username"
DefaultPassword: "sec_password"
DefaultDomain: "domain_name"
DefaultLoadProfile <ON/OFF>

Задает параметры авторизации (логин, пароль, домен) для запуска всех задач от имени конкретного пользователя. (См. RunAsDefaultUser). Переменная DefaultLoadProfile определяет, должен ли при этом подгружаться профиль пользователя. В качестве значения переменной DefaultPassword: надо вводить зашифрованный пароль. 

DefaultUser: "test_user"
DefaultPassword: "h4jk2sdhl=="
DefaultDomain: ""
DefaultLoadProfile OFF

RunAsDefaultUser <ON/OFF>

Позволяет запускать все задачи от имени пользователя, указанного в переменных Default*.

Допустимые значения:

RunAsDefaultUser OFF

GUIUser: "username"
GUIPassword: "sec_password"
GUIDomain: "domain_name"
GUILoadProfile <ON/OFF>

Задает параметры авторизации (логин, пароль, домен) для запуска GUI nnCron от имени конкретного пользователя. (См. GUIAsUser). Переменная GUILoadProfile определяет, должен ли при этом подгружаться профиль пользователя. В качестве значения переменной GUIPassword: надо вводить зашифрованный пароль. 

GUIUser: "test_user"
GUIPassword: "h4jk2sdhl=="
GUIDomain: ""
GUILoadProfile OFF

GUIAsUser <ON/OFF>

Позволяет запускать GUI nnCron от имени пользователя, указанного в переменных GUI*.

Допустимые значения:

GUIAsUser OFF

ShowErrorMsg <ON/OFF>

Определяет, будут ли ошибки, которые попадают в лог-файл, дублироваться предупреждающим сообщением на экране. При необходимости вы можете менять время ожидания реакции пользователя на сообщение (по умолчанию: 30 секунд). Для этого, измените значение переменной ShowErrorTime:

10 ShowErrorTime !

Допустимые значения:

ShowErrorMsg ON

SyntaxRestriction <ON/OFF>

Принудительно ограничивает синтаксические конструкции, которые можно использовать в начале описания задачи. Если переменная SyntaxRestriction выставлена в ON, то между #( и Action: или Rule: можно использовать только ограниченный круг слов (Time:, Watch*, опции задачи, знак комментария). Таким образом можно обезопасить систему от случайных ошибок неопытных пользователей, поскольку неумелые действия пользователя могут "уронить" nnCron или даже привести к нестабильной работе системы.
Чтобы преодолеть это ограничение (предполагается, что в этом случае пользователь уже знает, что делает) есть слова <( и )>. Между этими скобками можно употреблять любые другие слова, даже в случае, если включен SyntaxRestriction.

Допустимые значения:

SyntaxRestriction OFF

HelpFile: "filename"

Определяет файл помощи, который будет открываться при "клике" мышью на пункте меню "Помощь".

HelpFile: "F:\My Documents\NNCRON\help_ru.chm"

Log2StdOut <ON/OFF>

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

Допустимые значения:

Log2StdOut OFF

RemConsole <ON/OFF>

Разрешает/запрещает запуск Remote Console вместо обычной форт-консоли. Если переменная RemConsole установлена в OFF, сервер Remote Console не запускается, а вместо стандартной консоли nnCron вызывается т. н. локальная консоль. Запрещение Remote Console может, например, понадобиться на системах, где не установлен TCP/IP, без которого Remote Console работать не будет.

Допустимые значения:

RemConsole ON

RemConsolePort: <port_number>

Задает номер порта, который будет "слушать" сервер Remote Console.

RemConsolePort: 2002

RemAllowed: <ip_address_mask>
RemDisallowed: <ip_address_mask>

Задает IP-адреса с которых можно (RemAllowed) и нельзя (RemDisallowed) подключаться к серверу Remote Console. В nncron.ini можно использовать несколько переменных RemAllowed/RemDisallowed. В качестве значений разрешено использовать маски и "несуществующие" IP-адреса.

Общее правило таково: подключение разрешено со всех адресов, заданных в RemAllowed, кроме адресов, заданных в RemDisallowed.

Например, разрешаем подключения с адресa 127.0.0.1 (localhost), а в RemDisallowed вводим несуществующий IP-адрес, что означает - "никаких запретов нет, но разрешено подключение только с адреса, указанного в RemAllowed":

RemAllowed: 127.0.0.1
RemDisallowed: x.x.x.x

Расширяем список адресов, с которых разрешено подключение:

RemAllowed: 127.0.0.*
RemAllowed: 127.127.15.15
RemAllowed: 127.63.63.3
RemDisallowed: x.x.x.x

Разрешаем подключения со всех адресов и запрещаем подключение со адресов 127.0.0.13,127.0.0.14 и 127.13.13.*:

RemAllowed: *
RemDisallowed: 127.0.0.13
RemDisallowed: 127.0.0.14
RemDisallowed: 127.13.13.*

MenuHotKey: "hotkey"

Определяет клавиатурное сокращение, которое будет вызывать всплывающее меню nnCron. Синтаксис клавиатурных сокращений соответствует синтаксису, который используется в слове WatchHotKey:

MenuHotKey: "^@n"

MaxClipboardSize: <size_in_bytes>

Ограничивает доступный для nnCron размер буфера обмена Windows. Если в буфере обмена находится текст, превышающий по размеру значение MaxClipboardSize:, то nnCron будет использовать только его начало. Переменная MaxClipboardSize: необходима для того, чтобы nnCron не "тормозил", когда в буфере обмена находятся большие тексты.

Значение MaxClipboardSize: по умолчанию равно 10KB (10240B).

MaxClipboardSize: 10240