0.58 CRON - распределенное по времени выполнение команд

AMO CRON используется для выполнения команд MML в заданное время, однократно или периодически (каждые десять минут, ежечасно, ежедневно, еженедельно или ежемесячно). AMO базируется на механизме реализации расписания в системе, который активирует исполнение команд через временные интервалы, равные десяти минутам. Подлежащие выполнению команды MML сохраняются в таблице расписания, хранящейся на жестком диске.

Запись таблицы расписания содержит следующую информацию:

команда MML, которая должна выполняться

задание времени, когда должна выполняться команда MML

вариант, определяющий как часто должна выполняться команда MML (O=один раз или P=периодически)

Задание времени содержит пять записей параметров, которые задают минуту (0, 10, 20, 30, 40 или 50), час (0-23), день месяца (1-31), месяц года (1-12) и день недели (0-6, при 0=Воскресенье). Каждый из этих параметров может содержать:

число из приведенного выше диапазона

звездочку (*), означающую все допустимые значения

Задание времени может осуществляться в любой комбинации. Параметры, которые не заданы или содержат символ "звездочка", должны интерпретироваться как "без ограничения" ("don't care"), означающие все допустимые значения (каждые десять минут, ежечасно, ежедневно, еженедельно или ежемесячно, соответственно). Задание дней может производиться при помощи двух параметров (DAY (ДЕНЬ) и WEEKDAY (ДЕНЬ НЕДЕЛИ)). Если заданы оба параметра, то они оба учитываются. Например, если WEEKDAY=5, DAY=13, то команда MML будет запускаться каждую пятницу 13-го числа.

Все выполненные команды MML записываются в журнал регистрации MML (смотрите AMO LOGBK). Результат может отображаться с использованием AMO-LOGBK. Однако, в случае обнаружения ошибки командой контроля MMI, подсказки параметров, как в диалоге, не выводятся, но задание сбрасывается. При этом запись в AMO-LOGBK не делается.

Внимание: Пользователь должен проверить правильность команды MML.

Команды MML, которые должны выполняться только один раз, автоматически удаляются из таблицы расписания после выполнения (успешного или неуспешного). Команды MML, которые должны выполняться периодически, остаются в таблице расписания.

0.58.1 Ограничения

Так как команда MML содержит дефисы ( знаки препинания ), она должна быть заключена в двойные кавычки. Поэтому сама команда MML, появляющаяся в команде ADD из AMO CRON, не должна содержать двойные кавычки !

Длина команды MML должна быть макс. 48 символов.

В принципе, резидентно загруженные AMO не могут выполняться посредством AMO CRON в заданные времена. AMO DSSM является только резидентно загруженной AMO. Поэтому. AMO DSSM не может быть выполнена посредством AMO CRON.

Все "диалоговые AMO" не могут выполняться посредством AMO CRON. К таким AMO относятся, напр.: AMO TRACS AMO TRACA AMO DEBUG AMO DISPA Замечание: "диалоговая AMO" обладает следующими характерными свойствами:

1.

AMO должна запускаться с использованием команды ( напр.: EXEC-DISPA:A1; )

2.

Команды могут вводиться только после запуска ( режим - диалог ). Для ввода команд выводятся подсказки.

3.

Работа AMO должна завершаться с использованием команды.

AMO CRON должна использоваться только ЭКСПЕРТАМИ (EXPERTS) по следующим причинам:

1.

Правильность значений параметров никак не проверяется AMO CRON. Поэтому пользователь несет исключительную ответственность за правильность и выполняемость введенных команд.

2.

Применение многих AMO требует специального знания системы.

3.

Результатами неправильного использования AMO могут быть: потеря данных, фальсификация данных или перезапуск системы.

0.58.2 Функции AMO

ADD-CRON	:	Добавление новой записи в таблицу расписания
CHANGE-CRON	:	Изменение существующей записи в таблице расписания
DELETE-CRON	:	Удаление одной или нескольких записей из таблицы расписания
DISPLAY-CRON	:	Вывод списка из одной или нескольких (всех) записей таблицы расписания
REGENERATE-CRON	:	Команды восстановления таблицы расписания

0.58.2.1 ADD-CRON

Это действие добавляет новую запись в таблицу расписания.

Обзор процедуры

Код команды	Параметр
ADD-CRON	[POS =<число>],
	[EXEC =<парам.>],
	[MINUTE =<число> или *],
	[HOUR =<число> или *],
	[DAY =<число> или *],
	[MONTH =<число> или *],
	[WEEKDAY =<число> или *],
	COMMAND =<строка>;

Примеры

Инсталляция еженедельного резервного сохранения базы данных (каждое воскресенье в 23:30).

Ввод:

ADD-CRON:,30,23,,,0,"EXEC-UPDAT:BP;"; 

Инсталляция переключения категории обслуживания во время праздника Рождества Христова (с 12:00 24 декабря по 6:00 27 декабря для номера 7 группы переключения категории обслуживания).

Ввод:

ADD-CRON:,00,12,24,12,,"CHANGE-BERUM:COSX,7,2;";
ADD-CRON:,00,06,27,12,,"CHANGE-BERUM:COSX,7,1;";

0.58.2.2 CHANGE-CRON

Это действие изменяет одну или несколько записей таблицы расписания.

Обзор процедуры

Код команды	Параметр
CHANGE-CRON	POS =<число>,
	{EXEC =<парам.>,
	MINUTE =<число> или *,
	HOUR =<число> или *,
	DAY =<число> или *,
	MONTH =<число> или *,
	WEEKDAY =<число> или *,
	COMMAND =<строка>};

Пример

Перенести еженедельное резервное сохранение базы данных с воскресенья на субботу (первая позиция в таблице).

Ввод:

CHANGE-CRON:POS=1,WEEKDAY=6; 

Замечание: 

В записях, источником которых является задание JOB, не могут быть изменены параметры 'EXE' и 'COMMAND'
Для этих записей имеется JOB /= 0.

0.58.2.3 DELETE-CRON

Это действие удаляет одну или несколько записей из таблицы расписания.

Обзор процедуры

Код команды	Параметр
DELETE-CRON	POS=<число>;

Пример

Удалить все записи из таблицы расписания (включая файл с таблицей расписания).

Ввод:

DEL-CRON:1&&32; 

ЗАМЕЧАНИЕ: Записи таблицы CRON, имеющие JOB /= 0, не могут быть удалены при помощи AMO CRON.
Для удаления этих записей используйте AMO JOB.

0.58.2.4 DISPLAY-CRON

Это действие выводит перечень из одной или нескольких (всех) записей таблицы расписания.

Обзор процедуры

Код команды	Параметр
DISPLAY-CRON	[POS=<число>];

Пример

Вывести перечень всех записей таблицы расписания.

Ввод:

DISPLAY-CRON; 

Вывод:

                             TIME-SCHEDULE TABLE
|POS|JOB |EXE|MIN| H |DAY|MNT|WDY| COMMAND                                  | 
+===+====+===+===+===+===+===+==============================================+ 
| 1 | 19 | R |30 |23 | 2 | 3 | 2 | :DMS:BATCH/C009AN160094.C                | 
| 2 |  0 | R | 0 |11 |13 | * | 5 | EXEC-REST:SYSTEM;                        | 
| 3 | 20 | R | 0 |12 |24 |12 | 3 | :DMS:BATCH/C009AN160094.C                | 
| 4 |  0 | R | 0 | 6 |27 |12 | * | CHANGE-BERUM:COSX,7,1;                   | 
| 5 | 21 | R |30 |23 | 1 | 4 | 6 | :DMS:BATCH/C009AN160094.C                | 

ЗАМЕЧАНИЕ:Записи с JOB /= 0 были введены заданием JOB. 

0.58.2.5 REGENERATE-CRON

Это действие восстанавливает одну или несколько (все) записей(и) таблицы расписания.

Обзор процедуры

Код команды	Параметр
REGENERATE-CRON	[POS=<число>];

Пример

Восстановить все записи таблицы расписания.

Ввод:

REG-CRON; 

Вывод:

ADD-CRON:1,P,30,23, *, *,6,"EXEC-UPDAT:BP;";
ADD-CRON:2,P, 0,11,13, *,5,"EXEC-REST:SYSTEM;";
ADD-CRON:3,P, 0,12,24,12,*,"CHANGE-BERUM:COSX,7,2;";
ADD-CRON:4,P, 0, 6,27,12,*,"CHANGE-BERUM:COSX,7,1;";

0.58.3 Описание параметров

COMMAND	Команда MML, которая должна быть выполнена
	Тип ввода	:	Строка текста, обязательный
	Возможные значения	:	1-48 символов
DAY	День месяца
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	1-31
			*	еженедельно (или в определенный день недели)
	Значение по умолчанию	:	*
EXEC	Выполнение
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	O	однократно
			P	периодически
	Значение по умолчанию	:	P
HOUR	Час
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	0-23
			*	ежечасно
	Значение по умолчанию	:	*
MINUTE	Минута
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	0, 10, 20, 30, 40 и 50
			*	каждые десять минут
	Значение по умолчанию	:	*
MONTH	Месяц года
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	1-12
			*	ежемесячно
	Значение по умолчанию	:	*
POS	Позиция в таблице расписания
	Тип ввода	:	Одно значение или диапазон значений,
			обязательный	(CHANGE и DELETE)
			факультативный	(ADD, DISPLAY и REGENERATE)
	Возможные значения	:	1-32
	Значение по умолчанию	:	n	первая свободная позиция (ADD)
		:	1&&32	все записи (DISPLAY и REGENERATE)
	Если позиция не введена, AMO делает попытку найти свободную позицию (ADD) или выводит все записи таблицы (DISPLAY и REGENERATE).
WEEKDAY	День недели (0-6, с 0=Воскресенье)
	Тип ввода	:	Одно значение, факультативный
	Возможные значения	:	0-6	0=Воскресенье, ... , 6=Суббота
			*	еженедельно (или день месяца)
	Значение по умолчанию	:	*

0.58.4 Сообщения об ошибках и информационные сообщения

0.58.4.1 Сообщения об ошибках

F01:	НЕ НАЙДЕНА СВОБОДНАЯ ПОЗИЦИЯ
F02:	НЕ НАЙДЕНО НИ ОДНОЙ ЗАПИСИ
F03:	ПОЗИЦИЯ <xxx> УЖЕ ИСПОЛЬЗУЕТСЯ
F04:	ПОЗИЦИЯ <xxx> НЕ ИСПОЛЬЗУЕТСЯ
F05:	<значение> <парам.> НЕДЕЙСТВИТЕЛЬНО
F06:	<МИНУТЫ> <значение> НЕДЕЙСТВИТЕЛЬНЫЕ (НЕ 0, 10, 20, 30, 40, 50)
F07:	ОШИБКА ДОСТУПА: КОД ОЩИБКИ DMS: <xxxxx>
F08:	СИНТАКСИЧЕСКИ НЕПРАВИЛЬНАЯ КОМАНДА
F09:	AMO <существительное> НЕ СУЩЕСТВУЕТ
F10:	ДЕЙСТВИЕ <глагол>-<существительное> НЕ СУЩЕСТВУЕТ
F11:	КОМАНДА ОТКЛОНЕНА - НЕДОСТАТОЧНЫЙ УРОВЕНЬ БЕЗОПАСНОСТИ
F12:	КОМАНДНЫЙ ФАЙЛ НЕ СУЩЕСТВУЕТ
F13:	ЗАДАНИЕ НА ПОЗИЦИИ <xxx> НЕ МОЖЕТ БЫТЬ УДАЛЕНО (ИСПОЛЬЗУЙТЕ AMO JOB)
F14:	ПОЛЯ EXE ИЛИ COMMAND ЗАДАНИЯ НА ПОЗИЦИИ <xxx> НЕ МОГУТ БЫТЬ ИЗМЕНЕНЫ

0.58.4.2 Информационные сообщения

H01:	КОМАНДА РАСПИСАНИЯ БЫЛА СОХРАНЕНА НА ПОЗИЦИИ <x>
H02:	ПОЗИЦИЯ <x> ИЗМЕНЕНА
H03:	ПОЗИЦИЯ <x> УДАЛЕНА