1.38 LOGBK Журнал регистрации

Для вывода на дисплей данных из журнала регистрации и проведения поиска таких данных можно использовать AMO LOGBK. Чтобы обеспечить реконструкцию операций администрирования в системе каждое отдельное использование AMO записывается в журнал регистрации на жестком диске.

1.38.1 Взаимозависимости

Нет.

1.38.2 Функции AMO

DISPLAY-LOGBK	:	Вывести данные из журнала регистрации (последняя запись выводится первой)
START-LOGBK	:	Вывод данных из журнала регистрации (первой выводится самая старая запись)

1.38.2.1 DISPLAY-LOGBK

Команда Display выводит на дисплей данные, записанные в журнал регистрации.

Краткий обзор процедуры

Код команды	Параметр
DISPLAY-LOGBK	[STIME=<строка>],[ETIME=<строка>],[NOUN=<строка>],
	[DEV=<парам>] ,[TSN=<число>] ,[UID=<число>] ,
	[TYPE=<парам>] ,[TEXT=<строка>] ,[ANS=<парам>] ;

Если ни один из параметров не задан, на дисплей выводится весь журнал регистрации. Команду AMO LOGBK можно использовать также для создания запросов, по которым в журнале регистрации можно осуществлять поиск по заданным критериям. Критерии поиска задаются путем ввода параметров.

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

Во время поиска в соответствии с STIME и/или ETIME, будут отображаться только записи, отметки времени которых лежат между STIME и ETIME. В выводе данных могут появляться пробелы, если записи данных имеют неправильные отметки времени или если выполнялся сброс системных часов.

С помощью параметров STIME и ETIME можно управлять также направлением вывода. Если ETIME установлено большим, чем STIME, вывод будет производиться в прямом направлении (самые старые записи идут первыми). Если ETIME задано меньшим, чем STIME, направление вывода будет обратным (последние записи будут идти первыми).

Исполнение AMO приостанавливается в некоторых положениях, и у пользователя спрашивается, хочет ли он продолжать исполнение программы. Этот диалог можно деактивизировать (как в начале, так и во время работы), задав для параметра ANS значение C.

Пример

Искать в журнале AMO BUEND и вывести на дисплей совпадения

Ввод:

DISPLAY-LOGBK:NOUN=BUEND,ANS=C; 

Вывод:

P4714 DEV:CON1 TSN:1234 UID=1  NOUN:BUEND TYPE:END      TIME:96-07-10 11:57:03 
ADD PERFORMED;

P4713 DEV:CON1 TSN:1234 UID=1  NOUN:BUEND TYPE:CONTINUE TIME:96-07-10 11:56:59 
ADD-BUEND:23,,30,;

P4712 DEV:CON1 TSN:1234 UID=1  NOUN:BUEND TYPE:OUTPUT   TIME:96-07-10 11:56:44 
F01: TGRP 22 ALREADY EXISTS

P4711 DEV:CON1 TSN:1234 UID=1  NOUN:BUEND TYPE:START    TIME:96-07-10 11:56:43 
ADD-BUEND:22,,30,;

4 MATCHES 

Примечание

Каждая отдельная запись в журнале выводится с предшествующей строкой заголовка. Каждая строка заголовка содержит данные о каждом вводе и каждом выводе MML. Сюда входят номер записи в журнал (P-число), вызывающее устройство, номер сеанса, идентификационный номер пользователя (ID), имя программы AMO, тип MML (START, CONTINUE, OUTPUT или END) и отметка времени.

1.38.2.2 START-LOGBK

То же действие, что при Display, но поиск ведется в прямом направлении (самые старые записи идут первыми).

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

ANS	Ответ на вопрос "Продолжить?" (CONTINUE) (Y/N/C)
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	Y	= Продолжить
			N	= Не продолжать
			C	= Продолжить без дальнейших вопросов
	Значение по умолчанию	:	Y
	Режим диалога можно деактивизировать с самого начала, введя для параметра ANS значение C.
DEV	Устройство администратора
	Набор выводимых данных ограничивается записями данных заданного устройства.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	CON1	= Консоль 1
			CON2	= Консоль 2
			CON3	= Консоль 3
			CON4	= Консоль 4
			CON5	= Консоль 5
			CON6	= Консоль 6
			FAS	= Работа с удаленного устройства
			USER	= Внутренний пользователь
	Значение по умолчанию	:	Без ограничений
ETIME	Конечное время в виде "YY-MM-DD/hh:mm:ss"
	Набор выводимых данных ограничивается записями данных с отметками времени не позже, чем заданное конечное время.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	YY	: Последние 2 цифры года - 00 до 99
			MM	: Месяц года - 01 до 12
			DD	: День месяца - 01 до 31
			hh	: Час - 00 до 23
			mm	: Минута - 00 до 59
			ss	: Секунда - 00 до 59
	Значение по умолчанию	:	Без ограничений
	Данные с недействительной отметкой времени (в системе не было установлено правильное время) будут выдаваться только если не был введен параметр ETIME.
NOUN	Имя команды AMO
	Выводимые данные ограничены записями данных заданного AMO.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	Любая строка текста длиной до 5 символов.
	Значение по умолчанию	:	Без ограничений
STIME	Время начала записи в виде "YY-MM-DD/hh:mm:ss"
	Набор выводимых данных ограничивается записями данных с отметками времени не раньше, чем заданное начальное время.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	YY	: 2 последние цифры года - 00 до 99
			MM	: Месяц года - 01 до 12
			DD	: День месяца - 01 до 31
			hh	: Час - 00 до 23
			mm	: Минута - 00 до 59
			ss	: Секунда - 00 до 59
	Значение по умолчанию	:	Без ограничений
TEXT	Образец текста
	Набор выводимых данных ограничивается записями данных, содержащих заданный образец текста.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	Любая строка текста длиной до 20 символов.
	Значение по умолчанию	:	Без ограничений
	Поиск требует длительного времени, и поэтому его следует ограничить введением дополнительных критериев, чтобы повысить скорость работы.
TSN	Номер последовательности задач
	Набор выводимых данных ограничивается записями данных заданного сеанса работы.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	0 до 9999
	Значение по умолчанию	:	Без ограничений
TYPE	Тип MML
	Набор выводимых данных ограничивается записями данных с типом MML, совпадающим с заданным.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	START	= MML ввод (стартовые команды AMO )
			CONTINUE	= MML ввод после запроса AMO
			OUTPUT	= MML вывод
			END	= MML сообщения об окончании работы
	Значение по умолчанию	:	Без ограничений
	Этот запрос рекомендуется в сочетании с поиском заданных текстов.
UID	ID пользователя
	Набор выводимых данных ограничивается записями данных с заданным ID пользователя.
	Тип вводимых данных	:	Одно значение, опция
	Допустимые значения	:	от 1 до 40
	Значение по умолчанию	:	Без ограничений

1.38.4 Сообщения об ошибках и Предупреждения

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

F01:	ПАРАМЕТР <парам> ДОЛЖЕН БЫТЬ В ВИДЕ: "YY-MM-DD/HH:MM:SS"
F02:	ОШИБКА ДОСТУПА; КОД ОШИБКИ DMS :<xxxxx>

1.38.4.2 Предупреждения

ЖУРНАЛ РЕГИСТРАЦИИ СОДЕРЖИТ В ОБЩЕМ <xxxx> ЗАПИСЕЙ
ПОИСК ТЕКСТА ПРОИЗВОДИТСЯ В <xxxx> ЗАПИСЕЙ
ИДЕТ ПОИСК, ПРОСЬБА ПОДОЖДАТЬ
ПОИСК ЗАКОНЧЕН НА <xx> ПРОЦЕНТОВ
<xxxx> СОВПАДЕНИЙ
ЗАПИСЬ P<xxxx> БЫЛА ПЕРЕЗАПИСАНА
ПРОДОЛЖИТЬ (Y/N/C)