1.15 HIDMP Создание и отображение управляющих данных HIDUMP

Во время выполнения пуско-наладочных тестов системы Hicom, тестов системы и во время эксплуатации, выявляются некоторые неисправленные ошибки, которые можно локализовать, если имеются необходимые данные диагностики. Пакет программ HIDUMP (состоящий из резидентного программного обеспечения HIDUMP и AMO HIDMP) дает в руки инженеру по эксплуатации инструмент для сохранения диагностических данных на жестком диске в случае рестарта системы HICOM.

Управление и модификация контрольных данных а также связь с сервисным терминалом осуществляется при помощи AMO HIDMP. Эта функция AMO используется исключительно для того, чтобы задавать, активировать и деактиваировать, удалять и отображать нужные управляющие данные HIDUMP. Без AMO, пакет HIDUMP способен работать только с управляющими данными, ранее сохраненными в управляющем сегменте, выбирая из него диагностические данные.

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

До того, как управляющие строки могут быть деактивированы или активированы для резидентной программы HIDUMP, для них должны быть определены условия и соответствующие им действия. Управляющие строки, которые более не нужны, могут быть удалены (вне зависимость от того, активны они или нет). Отображение информации возможно для определенных управляющих строк.

Note

AMO HIDMP выполняется исключительно в части CC устройства SWU. Резидентная часть программы HIDUMP может выполняться на всех процессорах SWU с системой обеспечения отказоустойчивости.

Обзор функций

такие функции реализованы в AMO:

a.	Смена управляющего сегмента (управляющих данных), которые будут обрабатываться командой P Возможно обрабатывать управляющие данные для CC или LTG.
b.	Задание управляющих данных, при помощи команды DEF Эта команда определяет управляющие данные м сохраняет их с управляющем сегменте. Максимальный объем управляющих данных - 1 килобайт. Управляющие данные хранятся в отдельных управляющих строках (каждая из которых создается командой DEF) в порядке возрастания их номеров.
c.	Активация управляющей строки при помощи команды ON Эта команда применяется для активирования ACTIVATE (разблокирования) управляющих данных и для определения того, сколько раз может обрабатываться управляющая строка.
d.	Деактивация управляющей строки при помощи команды OFF Эта команда используется для деактивирования DEACTIVATE (блокировки) управляющих данных.
e.	Вывод управляющих данных при помощи команды LST Эта команда используется для вывода информации данных управления.
f.	Удаление управляющих данных при помощи команды DEL Эта команда используется для удаления управляющих строк.
g.	Завершение выполнения AMO при помощи команды END

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

AMO HIDMP сообщается с (резидентной) программой HIDUMP.

1.15.2 Функции AMO

EXEC-HIDMP	:	Запуск AMO HIDMP
INPUT-HIDMP	:	Запрос на ввод команд в интерактивном режиме

1.15.2.1 EXEC-HIDMP

Замечания

a)

Вводом параметра MDL определяется, какой их управляющих сегментов (а именно, управляющие данные CC и LTG) обрабатывается.

b)

Запускается AMO HIDMP. Затем автоматически вызывается INPUT-HIDMP (скрытой командой). AMO теперь в интерактивном режиме.

c)

В течение нескольких минут AMO находится в диалоговом режиме, ожидая ввода данных. Если нет ввода, AMO автоматически завершается.

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

Код команды	Параметр
EXEC-HIDMP	MDL=<параметр>

Примеры

Ввод:

<EXEC-HIDMP:CC;

Вывод:

   AMO-HIDMP VARIANT/VERSION 100/004 OF 1993-09-24
   PLEASE HIDUMP INPUT FOR CC:
   *

Ввод:

*END;

/* * = Запрос на ввод команды */

Вывод:

   EXEC COMPLETED;'
   <

1.15.2.2 INPUT-HIDMP

Замечания

Глагол INPUT-HIDMP вызывается автоматически (скрытая команда) один раз при запуске AMO при помощи EXEC-HIDMP. Следующая команда должна вводится после символа ('*'). AMO находится в диалоговом режиме. После выполнения команды система вновь выводит запрос на ввод следующей команды:

ПОЖАЛУЙСТА, ВВЕДИТЕ ДАННЫЕ ДЛЯ <имя процессора>: *

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

Замечание

Снова, символ звездочки ('*') используется как подсказка оператору. В нашем примере он предшествует реальному вводу оператора.

Определены такие команды:

CMD=	P,MDL=<параметр>;
	Эта команда разблокирует управляющие сегменты HIDUMP, связанные с другими сегментами
	аппаратные модули будут обрабатываться в диалоговом режиме, то есть, без
	выхода из AMO. Вслед за командой, вновь выбранные управляющие данные
	могут быть обработаны.
	Параметр MDL используется для выбора аппаратного модуля.

Пример

Переход к обработке управляющих данных HIDUMP для LTG.

Ввод:

*P,LTG;

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *

CMD=	DEF,NUMBER=<параметр>,COND=<строка>,ACTION=<строка>;
	Эта команда определяет управляющие данные и сохраняет их в управляющем сегменте.
	Можно задать максимум 1 килобайт управляющих данных. Управляющие данные хранятся в отдельных управляющих
	строках (каждая из которых создана командой DEF) в порядке возрастания их номеров.
	Управляющая строка состоит из идентификационного номера (который определяет порядок их обработки программой
	HIDUMP, это означает, что управляющая строка с меньшим номером будет обработана первой),
	некоторые условия и связанные с ними действия.
	Параметр COND определяет условия.
	Параметр ACTION определяет действия, которые выполняются в случае выполнения условий
	После ввода того что управляющая строка деактивирована, счетчик числа ее выполнения обнуляется (0).
	Команда ON используется для активирования строки и ввода счетчика числа выполнений.

Замечание относительно параметра COND:

У параметра COND есть, как минимум, одно слагаемое. Каждое слагаемое состоит из трех частей:

1.	Переменная, которая будет сравниваться;		C ... Код подпрограммы E ... Код исключительного состояния I ... Прерывание ном. N ... NMI no. O ... OS sev.
2.	Математический оператор операция;		= ... равно > ... Больше >= ... больлше или равно < ... меньше <= ... меньше или равно /= ... не равно
3.	Сравниваемая величина;		(шестнадцатиричная, длиной до четырех символов)

Пример слагаемых: I<=9 , N=10 , C/=A7D;

При помощи логических операторов (OR, AND) и скобок можно объединить несколько таких слагаемых. Значение слагаемого или выражения в скобках можно поменять на противоположное предшествующим оператором NOT.

Параметр COND должен быть выделен символами '"', то есть, перед ним и после него должен стоять это символ.

Замечание

Выполнение условия NOT C=5000 инициирует выполнение заданных действий для любого исключительного события, за исключением C=5000 (даже для NMI, aso. ...). Если требуется аварийная распечатка только для каждого кода программы ( C), который не равен 5000, тогда условия должны быть записаны так:

a.

C>=0 AND NOT C=5000 AND C<FFFF

or

b.

C/=5000

Первый вариант дает дополнительную возможность задать верхний и нижний пределы.

Замечание относительно параметра ACTION:

Допустимы только следующие действия и синтаксис выражения.

a)

DUMP_BCA( <длина> )

b)

DUMP_MEM_LOG( <смещение> : <база> / <длина> )

b

DUMP_MEM_LOG(<селектор>:<смещение>/<длина> ) В случае DUMP_MEM_LOG, база / селектор и смещение должны разделены двоеточием ':'. Каждое из двух значений может быть длиной до четырех символов.

c)

DUMP_MEM_PHYS( <физ. адрес.> / <длина> ) В случае DUMP_MEM_PHYS, физический адрес может быть длиной до 6 символов.

d)

DUMP_DPR( <значение для DPR> / <длина> ) В случае аварийной распечатки памяти - DUMP_DPR, код для двухпортовой оперативной памяти (DPR), должен быть задан первым параметром. Допустимы такие коды 0 для IP-DPR, 1 для MIP-DPR, 2 для CCH-DPR, 3 для MBU_1-DPR, 4 для MBU_2-DPR, 5 для MBU_3-DPR, 6 для MBU_4-DPR, 7 для IOCG-DPR, 8 для DCL-DPR .

e)

DUMP_STACK( <длина> )

f)

DUMP_RNGT

g)

DUMP_001

h)

DUMP_002

i)

DUMP_003

j)

DUMP_004

k)

DEBUG_001

l)

DEBUG_002

m)

DEBUG_003

n)

DEBUG_004

o)

DEBUG_005

p)

DEBUG_006

q)

DEBUG_007

r)

DEBUG_008

Во всех случаях параметр <длина> может быть длиной до 4 символов. Он рассматривается как шестнадцатиричное число.

Если было определено несколько действий, они должны быть разделены посредством '&'. Если действие включает параметр, параметр должен быть заключен в скобки и должен следовать сразу после самого действия. Если задано несколько параметров, они должны разделяться косой чертой '/'.

Параметр ACTION должен быть с разделителями, то есть, ему должен предшествовать и за ним должен следовать символ '"'.

Примеры

1.	Если код исключительной ситуации >= 3A код исключительной ситуации <= 50, AND NOT код программы = 17 OR прерывание = 18, выполняются действия DEBUG_005 DUMP-BCA(200) DUMP_DPR(MBU-DPR,30). Номер управляющей строки 4.

Ввод:

*DEF,4,"( E=>3A AND E<=50) AND NOT C=17 OR I=18","DEBUG_005& DUMP_BCA(200)&DUMP_DPR(2/30)";

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *

2.	Если код исключительной ситуации 123 или программа с кодом 240 была причиной рестарта, выполняются действия DUMP_MEM_LOG с логическим адресом (база = 39A8 / селектор = 39A8, смещение = 14F), длина = 75 и DUMP_MEM_PHYS с физическим адресом 1C863E , длиной = 140. Номер управляющей строки 174.

Ввод:

*DEF,174," E=123 OR C=240","DUMP_MEM_LOG(14F:39A8/75)& DUMP_MEM_PHYS(1C863E/140)";
*DEF,174," E=123 OR C=240","DUMP_MEM_LOG(39A8:14F/75)& DUMP_MEM_PHYS(1C863E/140)";

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *     



    
CMD=

ON,TYPE=NO,NUMBER=<параметр>,CNT=<параметр>;






    


ON,TYPE=ALL,CNT=<параметр>;






    









    
   

   Эта команда используется для установки управляющей строки в состояние  ACTIVE, то есть, управляющая строка будет

   




    
   

   идентифицироваться как активная, и обрабатываться в случае рестарта программой HIDUMP (резидентной).

   




    
   

   Возможно  активировать либо все  (TYPE=ALL) либо только отдельные (TYPE=NO) управляющие строки.

   




    
   

   Параметр CNT определяет сколько раз будет выполняться управляющая строка программой HIDUMP.

   




    
   

   Активация не зависит от того, какой статус был раньше.

   




    
   

   

   

Примеры

1.	Все заданные управляющие строки активируются и будут выполняться 5 раз программой HIDUMP.

Ввод:

*ON,ALL,5;

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *

2.	Управляющая строка номер 38 активируется и один раз обрабатывается программой HIDUMP.

Ввод:

*ON,NO,38,1;

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *

CMD=	OFF,TYEP=NO,NUMBER=<параметр>;
	OFF,TYPE=ALL;
	Эта команда используется для деактивации DEACTIVATE заданной управляющей строки, а это значит, что управляющая
	строка не будет обрабатываться программой HIDUMP в случае рестарта.
	Возможно деактивировать либо все (TYPE=ALL) либо отдельные (TYPE=NO) управляющие строки.
	Деактивация на зависит от предыдущего состояния.

Примеры

1.	Все заданные управляющие строки будут деактивированы.

Ввод:

*OFF,ALL;

Выаод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *

2.	Управляющая строка номер 2 будет деактивирована.

Ввод:

*OFF,NO,2;

Вывод:

   PLEASE HIDUMP INPUT FOR LTG: 
   *
   



    
CMD=

LST,TYPE=NO,NUMBER=<параметр>,[CNT=<параметр>],[ACTION=<строка>];






    


LST,TYPE=ALL,[CNT=<параметр>],[ACTION=<строка>];






    


LST,TYPE=ACT,[CNT=<параметр>],[ACTION=<строка>];






    


LST,TYPE=DEACT,[CNT=<параметр>],[ACTION=<строка>];






    









    


Эта команда используется для вывода информации управляющих данных. Возможно определить несколько






    
   

   критериев выбора. Параметр TYPE (обязательный) определяет все или некоторые активные управляющие строки,

   




    
   

   или все деакитивированные управляющие строки будут обрабатыватьс для вывода. Параметры CNT (необязательный)

   




    
   

   и ACTION (необязательный) можно использовать для того, чтобы выбрать данные для вывода.

   




    
   

   

   

NOTE

Так как обработка параметра ACTION в этой версии AMO HIDMP не реализована, параметр просто будет игнорирован AMO.

Примеры

1.	Вывести все активные управляющие строки.

Ввод:

*LST,ACT;

Вывод: :

   ------------------------------------------------------------------------------
   DUMP NO:  3      CNT: 3      STATUS: ACT
      N<66D  OR NOT(	O=4))
      DUMP_MEM_LOG(E435:1B48/1000)
      DUMP_MEM_LOG(1B48:E435/1000)
   DUMP NO: 9      CNT: 1      STATUS: ACT
      N/=FFF2
      DUMP_STACK(160)
   DUMP NO: 40      CNT: 3      STATUS: ACT
      ((	C=7F2  AND (	O/=55E  AND 	 I<EE2)) OR 	C>A3)
      DUMP_MEM_PHYS(28FAC1/50)
   DUMP NO: 61      CNT: 4      STATUS: ACT
      (	E>442A  OR NOT(	 I=5))
      DEBUG_001, DUMP_DPR(8/20)
   DUMP NO:204      CNT: 3      STATUS: ACT
      (	 I<A41 OR 	C=1000)
      DEBUG_005, DUMP_BCA
   ------------------------------------------------------------------------------
   PLEASE HIDUMP INPUT FOR LTG: 
*

2.	Все управляющие строки со счетчиком CNT = 3 будут выведены.

Ввод:

*LST,ALL,3;

Вывод:

   ------------------------------------------------------------------------------
   DUMP NO:  3      CNT: 3      STATUS: ACT
     (	N<66D  OR NOT(	O=4))
     DUMP_MEM_LOG(E435:1B48/1000)
     DUMP_MEM_LOG(1B48:E435/1000)
   DUMP NO: 7       CNT: 3      STATUS: DEACT
     C>=3F
     DUMP_DPR(6/200), DUMP_RNGT, DUMP_003
   DUMP NO: 10      CNT: 3      STATUS: DEACT
     NOT(	C=EE3  AND 	O<6)
     DEBUG_007, DUMP_STACK(70), DUMP_001
   DUMP NO: 40      CNT: 3      STATUS: ACT
     ((	C=7F2  AND (	O/=55E  AND 	 I<EE2)) OR 	C>A3)
     DUMP_MEM_PHYS(28FAC1/50)
   DUMP NO:119      CNT: 3      STATUS: DEACT
     N=2
     DUMP_004
   DUMP NO:204      CNT: 3      STATUS: ACT
     (	 I<A41 OR 	C=1000)
     DEBUG_005, DUMP_BCA
   ------------------------------------------------------------------------------
   PLEASE HIDUMP INPUT FOR LTG:
   *

Ввод:

*LST,NO,40;

Вывод:

   ------------------------------------------------------------------------------
   DUMP NO: 40      CNT: 3      STATUS: ACT
     ((	C=7F2  AND (	O/=55E  AND 	 I<EE2)) OR 	C>A3)
     DUMP_MEM_PHYS(28FAC1/50)
   ------------------------------------------------------------------------------
   PLEASE HIDUMP INPUT FOR LTG:
   *

CMD=	CMD= DEL,TYPE=NO,NUMBER=<параметр>;
	DEL,TYPE=ALL;
	Эта команда используется для удаления управляющих данных (Управляющих строк). Параметр TYPE
	определяет будут ли удалены все (TYPE=ALL) или только отдельные управляющие строки
	(TYPE=NO)

Примеры

1.	Будут удалены все управляющие строки.

Ввод:

*DEL,ALL;

Вывод: :

   PLEASE HIDUMP INPUT FOR LTG: 
   *

2.	Будет удалена управляющая строка номер 2.

Ввод:

*DEL,NO,2;

Вывод::

   PLEASE HIDUMP INPUT FOR LTG: 
   *

CMD=	END;
	Эта команда завершает выполнение AMO.

1.15.3 Описание параметра

ACTION	Используется в командах: DEF, LST;
	Для ввода выполняемых процедур.
	Тип ввода	:	строка, обязательный для DEF
			необязательный для LST
	Возможные значения	:	Строка символов длиной до 1019
	Допустимые действия : DUMP_BCA(<длина>), DUMP_STACK(<длина>),
	DUMP_MEM_PHYS(<физ. адрес>/<длина>), DUMP_DPR(<значение для DPR>/<длина>),
	DUMP_MEM_LOG(<смещение>:<база>/<длина>), DUMP_RNGT, DUMP_001,
	DUMP_MEM_LOG(<selector>:<смещение>/<длина>)
	DUMP_002, DUMP_003, DUMP_004, DEBUG_001, DEBUG_002, DEBUG_003
	DEBUG_004, DEBUG_005, DEBUG_006, DEBUG_007, DEBUG_008
CNT	Используется в командах: ON, LST;
	Определяет сколько раз управляющая строка будет выполняться программой HIDUMP.
	Тип ввода	:	Одно значение, обязательный для ON
			необязательный для LST
	Возможные значения	:	0 - 255
COND	Используется в командах: DEF;
	Для ввода условий.
	Тип ввода	:	Строка, обязательный для DEF
	Возможные значения	:	Символьная строка длиной до 1019 символов
CMD	Параметр варианта,
	Определяет команду AMO-HIDMP.
	Тип ввода	:	Одно значение, обязательный
	Возможные значения	:	DEF, DEL, END, LST, OFF, ON, P
	(Смысл этих значений объясняется в обзоре функций.)
MDL	Используется в командах: P, EXEC-HIDMP;
	Определяет аппаратные модуль для которого программа HIDUMP будет обрабатывать управляющий сегмент.
	Тип ввода	:	Одно значение, обязательный
	Возможные значения	:	CC, LTG
NUMBER	Используется в командах: DEF, DEL, LST, OFF, ON
	Определяет номер (ID) управляющей строки.
	Тип ввода	:	Одно значение, обязательный
	Возможные значения	:	0 - 255
TYPE	Используется в командах: DEL, LST, OFF, ON
	Параметр варианта; определяет которая строка будет обрабатываться.
	Тип ввода	:	Одно значение, обязательный
	Возможные значения	:	ALL, NO		в DEL
			ACT, ALL, DEACT, NO		в LST
			ALL, NO		в OFF
			ALL, NO		в ON

1.15.4 Сообщения об ошибках и предупредительные сообщения

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

F01:	АВАРИЙНАЯ РАСПЕЧАТКА <номер> НЕ ОПРЕДЕЛЕНА
F02:	АВАРИЙНАЯ РАСПЕЧАТКА <номер> УЖЕ СУЩЕСТВУЕТ
F03:	ДЕЙСТВИЕ НЕ ОПРЕДЕЛЕНО
F04:	НЕДОПУСТИМОЕ ЗНАЧЕНИЕ В УСЛОВИИ
F05:	СИМВОЛ НЕ ОПРЕДЕЛЕН
F06:	НЕВОЗМОЖНО ВКЛЮЧИТЬ АВАРИЙНУЮ РАСПЕЧАТКУ (НЕ ХВАТАЕТ ПАМЯТИ)
F07:	ТРЕБУЕМАЯ АВАРИЙНАЯ РАСПЕЧАТКА НЕ НАЙДЕНА
F08:	СИНТАКСИЧЕСКАЯ ОШИБКА В ЗАПИСИ ДЕЙСТВИЯ
F09:	СИНТАКСИЧЕСКАЯ ОШИБКА В ЗАПИСИ УСЛОВИЯ
F10:	ОШИБКА В ЛОГИЧЕСКОМ ОПЕРАТОРЕ
F11:	НЕВЕРНЫЙ ОПЕРАТОР ИЛИ ТЕРМ
F12:	НЕДОПУСТИМОЕ ЗНАЧЕНИЕ В ДЕЙСТВИИ

1.15.4.2 Предупредительные сообщения

Отсутствуют