0.42 CLIST - циклические файлы списков

AMO CLIST служит для вывода файлов, записанных циклически при помощи FILE TASK.

Циклические файлы конфигурируются при помощи AMO ASSGN. Отличие между циклическими файлами и другими файлами заключается в особой структуре заголовка файла. Циклическая организация означает, что при записи файла ограниченной длины система возвращается к началу файла, как только достигнуто окончание файла.
Тогда производится перезапись старого содержимого с начала.

В системе Hicom C-файлы заполняются текстами. Этими текстами могут быть отчеты о неисправностях, генерируемые системой обеспечения надежности, вывод текста из резидентных заданий (сообщения во время исполнения) или вывод текста командами AMO. Функция вывода AMO изначально ограничивается отчетами о неисправностях, уже обработанных в MMI.

Главной задачей AMO является считывание выведенного текста из резидентных заданий (сообщения во время исполнения) и выведенного текста из AMO.
AMO HISTO используется для считывания файла HTS-Histo.

Имя C-файла должно начинаться с "C-". AMO ориентирована на то, что циклические файлы будут найдены на :AMD: зона (конфигурируется при помощи AMO ASSGN).

AMO отображает строку за строкой сохраненный в циклическом файле текст. Может отображаться весь циклический файл или заданное число строк.

Имеется функция пейджинга (пересылка), похожая на функция в AMO LIST.
После вывода страницы размером во весь экран AMO запрашивает подтверждение, указывающее, продолжать или завершить вывод или вывести сразу все оставшиеся строки.

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

0.42.1 Ограничение

Это описание действительно, начиная с SP300-V3.3

0.42.2 Взаимосвязи

AMO-ASSGN	:	Закрепление устройства
AMO-HISTO	:	Считывание файла предыстории HTS

0.42.3 Функции AMO

START-CLIST

:

Вывод циклических файлов

0.42.3.1 START-CLIST

Действие Start выводит отдельный циклический файл.

Если задан параметр ADR, вывод начинается с указанной в нем строки. (Если ADR=5, вывод начинается с пятой самой старой строки.)

Если задан параметр LEN, отображается число строк, заданное параметром LEN, начиная с очень старой строки циклического файла или после числа строк, определенного параметром ADR.

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

Код команды	Параметр
START-CLIST	FILENAME=<строка>,[ADR=<число>],[LEN=<число>]
	,[ANS=<парам.>];

Примеры

1.	Отобразить 5 самых старых строк циклического файла C-File.

Ввод:

START-CLIST:"C-FILE",,5,N; 

Вывод:

   +-------------------- CUSTOMER DATA BACKUP & RESTORE --------------------+ 
   |                                                                        | 
   | ROUTINE BACKUP    :  DEACTIVATED - BY AMO-ORDER                        | 
   |                                                                        | 

2.	отобразить весь циклический файл C-FILE.

Ввод:

START-CLIST:"C-FILE"; 

Вывод:

   +-------------------- CUSTOMER DATA BACKUP & RESTORE --------------------+ 
   |                                                                        | 
   | ROUTINE BACKUP    :  DEACTIVATED - BY AMO-ORDER                        | 
   |                                                                        | 
   |  DESTINATION-FILE :  :PAS:TESTFILE                                     | 
   |                                                                        | 
   |  COMPRESSION      :  NONE                                              | 
   |                                                                        | 
   |  DATE: 01/01/1993  TIME: 16-55-00  REP-TYPE: HOUR   REP-INTERVAL: 1    | 
   |                                                                        | 
   | CURRENT PHASE     : NONE                                               | 
   |                                                                        | 
   +------------------------------------------------------------------------+ 
  
   F05: BST NOT SWITCHED ON. 
        RESIDENT PART OF BST NOT AVAILABLE. 
   AMO-BST  -125       BACKGROUND SIGNALLING TASK 
   DISPLAY NOT COMPLETED; 
   H500: AMO DATE STARTED 
        +------------------------+ 
  
   CONTINUE (Y/N/C) ? 
  
   <y 
        |  DATE:          TIME : | 
        | 1993-04-07    11:06:01 | 
        +------------------------+

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

ADR	Первая строка для считывания
	Тип ввода	:	Одно значение,
			факультативный
	Возможные значения	:	от 1 до 9999999
	Значение по умолчанию	:	1 (означает самую старую строку)
ANS	Ответ
	Отображение после вывода каждой экранной страницы
	Тип ввода	:	Одно значение,
			факультативный
	Возможные значения	:	Y = Продолжить вывод файла
			N = Не продолжать вывод файла
			C = Продолжить вывод файла без нового ответа
	Значение по умолчанию	:	Y = Продолжить вывод файла
FILENAME	Имя циклического файла
	Тип ввода	:	Одно значение,
			обязательный
	Возможные значения	:	макс. 12 позиций; начиная с "C-"
			Позиции AMO: перед AMD:
LEN	Число строк, которые должны быть считаны
	Тип ввода	:	Одно значение,
			факультативный
	Возможные значения	:	от 0 до 9999999
	Значение по умолчанию	:	0 (означает весь файл)

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

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

F01:	ИМЯ ФАЙЛА ДОЛЖНО НАЧИНАТЬСЯ С "C-".
F02:	ФАЙЛ <FILENAME> НЕ СУЩЕСТВУЕТ.
F03:	ФАЙЛ <FILENAME> НЕ ЯВЛЯЕТСЯ ЦИКЛИЧЕСКИМ ФАЙЛОМ.
F04:	ОШИБКА ДОСТУПА К ФАЙЛУ. КОД ВЫЗОВА <H'XXXX> - КОД ИСКЛЮЧЕНИЯ <H'XXXX>.

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

H01:	ЦИКЛИЧЕСКИЙ ФАЙЛ ПУСТ.
H02:	ПОСТУПИЛИ НОВЫЕ ДАННЫЕ, ПРОЦЕСС СЧИТЫВАНИЯ БУДЕТ СИНХРОНИЗИРОВАН.

0.42.5.3 Использование сообщений об ошибках и информационных сообщений в отдельных действиях

START          : F01,  F02,  F03,  F04,  H01,  H02