2.1 TRACA - Трассировщик системных сообщений (IS)

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

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

AMO TRACA взаимодействует с резидентным трассировщиком в указанном модуле (процессоре).

Непосредственные взаимосвязи существуют с точками трассировки в ОС и ЛВС.

2.1.3 Введение

Трассировщик Hicom позволяет специалистам осуществлять трассировку сообщений, передаваемых между отдельными программными комплексами системы Hicom и объектами ЛВС.
Поэтому трассировщик является важным инструментом для настройки системы.

Связь с терминалом управляется AMO TRACA. Хотя трассировщик не может выбирать внутренние сообщения и другие объекты трассировки и записывать их в память без помощи этой команды AMO, он является важнейшим инструментом для выбора и вывода объектов трассировки.

Примечание

Для SWU также имеется аналогичный трассировщик, управляемый AMO TRACS. Эта команда AMO реализует несколько больший набор функций трассировки (см. описание AMO TRACS).

2.1.3.1 Основные понятия

Объекты трассировки:

a)

Сообщения, передаваемые между двумя задачами

b)

Данные ЛВС на разных уровнях ЛВС

Точки трассировки - это те места в программном обеспечении Hicom, в которых вызывается трассировщик.

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

Типичными, чаще всего используемыми критериями для сообщений, например, являются:

Байт 0 целевой задачи

Байт 1 исходной задачи

Байт 4 кода события

Таблица выбора также содержит "условные условия". Во время трассировки такие условия управляют выбором, который зависит от содержания сообщения.

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

В команде AMO реализованы следующие функции:

a)

Сохранение буфера трассировки в файле и сохранение в файле или восстановление из файла таблиц выбора трассировки с помощью команды COPY см. Раздел 2.1.4.2.4 на стр. 3279

b)

назначение файла для вывода с помощью команды DISPLAY см. Раздел 2.1.4.2.4 на стр. 3279

c)

Вывод объектов трассировки с DA, DB, DF, DL и DN см. Раздел 2.1.4.2.4 на стр. 3279

d)

Прерывание работы команды AMO с помощью END

Внимание: эта функция не влияет на сам трассировщик!

e)

Задание максимального количества объектов трассировки, помещаемых в буфер с помощью MAXNO

f)

Задание максимального количества объектов трассировки, помещаемых в буфер с помощью MSGLEN (длина сообщения) см. Раздел 2.1.4.2.2 на стр. 3278

g)

Активизация трассировщикаON см. Раздел 2.1.4.2.3 на стр. 3279

h)

Деактивизация трассировщика OFF см. Раздел 2.1.4.2.3 на стр. 3279

i)

Изменение процессора, управляющего трассировкой с помощью P (процессор)

j)

Сброс буфера трассировки или таблиц выбора с помощью RES (RESet)

k)

Задание устойчивости трассировщика к перезапуску с помощью RST

l)

Выбор сообщений или объектов ЛВС с помощью SELMSG (выбор сообщения) см. Раздел 2.1.4.2.1 на стр. 3275

m)

Выбор механизма продолжения работы трассировщика с помощью команды SELSTOP (прекращение выбора при конфликте)

n)

Выбор типов объектов ЛВС с помощью SETLAN см. Раздел 2.1.6.1 на стр. 3287

o)

Вывод состояния трассировки с помощью STA (STAtus) см. Раздел 2.1.4.2.5 на стр. 3282

p)

Ввод предупреждений для других пользователей трассировщика с помощью команды USER

Трассировщик Hicom может использоваться несколькими пользователями. Поэтому иногда трудно определить, кто изменил настройки трассировки, и нужны ли эти настройки.

Для идентификации изменившего настройки пользователя можно вводить любые комментарии (например, фамилию, номер телефона). Этот комментарий выводится при отображении данных состояния в средней и подробной форме (STA,M; или STA,L;).

2.1.4 Функции AMO

EXEC-TRACA	:	Запуск AMO TRACA
INPUT-TRACA	:	Запрос ввода данных в диалоговом режиме

2.1.4.1 EXEC-TRACA

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

Код команды	Параметры
EXEC-TRACA	UNIT=<параметр>;

Примечание

a)

Команда AMO остается в диалоговом режиме несколько минут, если в это время не введены данные, работа команды автоматически прерывается.

Пример

Ввод:

<EXEC-TRACA:A1 ; 

Вывод:

   AMO TRACA VARIANT/VERSION A0/005 OF 1991-09-03
   TRACER INPUT IN A1  PLEASE:

Ввод

*END;                         * = запрос на ввод команды

2.1.4.2 INPUT-TRACA

Функция INPUT-TRACA используется только для доступа для чтения/записи и не может вводиться оператором с терминала администрирования и обслуживания (AMT). На AMT выводится только приведенный ниже текст, как приглашение к вводу (звездочка после текста указывает на состояние готовности):

TRACER INPUT IN <processor name> PLEASE: 
* 

Также этот выводимый текст указывает, что команда AMO успешно выполнила предыдущую функцию.

Возможен ввод следующих команд  (CMD):

CMD=	COPY,AREA=<параметр>-<параметр>,FILE=<строка>;
CMD=	DISPLAY,FILE=<строка>;
CMD=	DA,[CNT=<число>],[LEN=<число>],TYPE=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	DA,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>],,,TEST=SELMSG;
	(Другие значения параметров игнорируются AMO)
CMD=	DA,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>]
	,[DISPLACE=<параметр>,VAL=<hex>,TEST=<параметр>];
CMD=	DB,[CNT=<число>],[LEN=<число>],TYPE=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	DB,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>],,,TEST=SELMSG;
	(Другие значения параметров игнорируются AMO)
CMD=	DB,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>]
	,[DISPLACE=<параметр>,VAL=<hex>,TEST=<параметр>];
CMD=	DF,[CNT=<число>],[LEN=<число>],TYPE=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	DF,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>],,,TEST=SELMSG;
	(Другие значения параметров игнорируются AMO)
CMD=	DF,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>]
	,[DISPLACE=<параметр>,VAL=<hex>,TEST=<параметр>];
CMD=	DL,[CNT=<число>],[LEN=<число>],TYPE=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	DL,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>],,,TEST=SELMSG;
	(Другие значения параметров игнорируются AMO)
CMD=	DL,[CNT=<число>],[LEN=<число>],[TYPE=<параметр>], ,[DISPLACE=<параметр>,VAL=<hex>,TEST=<параметр>];
CMD=	DN,NO=<число>,[LEN=<число>],TYPE=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	DN,NO=<число>,[LEN=<число>],[TYPE=<параметр>],,,TEST=SELMSG;
	(Другие значения параметров игнорируются AMO)
CMD=	DN,NO=<число>,[LEN=<число>],[TYPE=<параметр>]
	,[DISPLACE=<параметр>,VAL=<hex>,TEST=<параметр>];
CMD=	END;
CMD=	MAXNO,[MAXNO=<число>];
CMD=	MSGLEN,TRACEPT=<параметр>,CONDGRP=[param],[LEN=<число>];
CMD=	OFF;
CMD=	ON,[STYPE=BUF];
CMD=	ON,STYPE=HD,FILE=<строка>,[MAXBLOCK=<число>],WRAP=<параметр>;
	[OVERWRT=<J>];
CMD=	P,UNIT=<параметр>;
CMD=	RES,[RESOBJ=<параметр>];
CMD=	RST,STYPE=<параметр>;
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=ALL;
	(Последующие значения параметров игнорируются AMO)
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=BYTE,DISPLACE=<число>,VAL=<hex>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=DEST,VAL=<hex>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=EV,VAL=<hex>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=PST,DISPLACE=<число>,BITPOS=<параметр>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=SRC,VAL=<hex>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CD1|...|CD8
	,FLDTYPE=SEVT,VAL=<hex>,[TEST=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CCD1|...|CCD8
	,STYPE=ADD|SET|SUB,AKTPOS=<число>,TARGETPO=<число>
	,[TARGETTP=<параметр>],[TARGETGRP=G1|...|G4],[TARGETCD=CD1|...|CD8]
	,[LOCK=<параметр>],[NUMCD=<параметр>],[CONVERT=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,COND=CCD1|...|CCD8
	,STYPE=DEL,[TARGETTP=<параметр>],[TARGETGRP=G1|...|G4]
	,[TARGETCD=CD1|...|CD8],[LOCK=<параметр>],[NUMCD=<параметр>];
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=G1|...|G4,[COND=OFF]
	(Другие значения параметров игнорируются AMO)
CMD=	SELMSG,TRACEPT=<параметр>,CONDGRP=OFF
	(Другие значения параметров игнорируются AMO)
CMD=	SELSTOP,STYPE=<параметр>;
CMD=	SETLAN,CONDGRP=<параметр>,TYPE=<параметр>;
CMD=	STA,[INFO=<параметр>];
CMD=	USER,[TEXT=<строка>];

Перед началом работы трассировщика необходимо выбрать точки трассировки и объекты трассировки, данные которых будут записываться. Эта осуществляется с помощью команды SELMSG.

2.1.4.2.1 SELMSG

Первый параметр TRACEPT определяет, выбрано ли сообщение OS (SD, RCV или OS в общем) или данные ЛВС (для задания специфичных точек трассировки ЛВС используется команда SETLAN: Раздел 2.1.6.1 ) или должны быть заданы условия пуска и остановки.

Возможно выполнение следующих функций:

1.

Все сообщения и объекты трассировки могут быть выбраны для каждой точки трассировки

2.

Выбираются только те сообщения или объекты ЛВС, которые удовлетворяют 4 группам с 8 условиями

3.

Сообщения или объекты ЛВС не выбираются

4.

Начало или окончание трассировки вызывают только те сообщения, которые удовлетворяют одной из 4 групп с 8 условиями

5.

Сообщения, которые удовлетворяют одной из 4 групп с 8 условиями вводятся в буфер с указанием даты и времени

6.

Сообщения или объекты ЛВС, которые удовлетворяют одной из 4 групп с 8 условиями, обуславливают во время трассировки генерацию специального сообщения, зависящего от изменения выбранных условий, которые определены в "условных условиях" .

7.

Пуск, остановка, остановка всех и/или условия по времени отключены

8.

Для последующего выбора можно сформулировать 8 условий

9.

Сформулированные условия для последующего выбора удаляются

10.

Удаляются условия для группы или точки трассировки.

Примечание

Учтите, что параметры CONDGRP и COND игнорируются (оба параметра необязательны!), трассировка в точке трассировки не выполняется, так как значение по умолчанию - OFF.

Выбор сообщений и объектов ЛВС

При задании условий можно выбрать только те объекты трассировки, которые интересуют пользователя. Трассировщик может обрабатывать сообщения двумя способами:

Ввод байтовых значений как результатов сравнения данных в трассировщике, которые только вводят данные в буфер трассировки, если адресуемый байт точно равен одному из значений этого байта. Для каждого байта можно вводить несколько значений (до 50). Также возможно указывать несколько условий (до 8) для одной группы; для выбора сообщения должны выполняться все эти условия.

При сравнении по маске (параметр FLDTYPE = PST) в качестве данных трассировки  вводится позиция одного или нескольких битов (= маска), которая должна содержаться в нужном байте сообщения. Если эти биты встречаются в байте сообщения, сообщение помещается в буфер трассировки. Если дополнительно к битам маски  имются другие биты, которые заданы в определенном байте сообщения, то сообщение также помещается в буфер, так как оно соответствует заданной маске. Используя этот метод можно контролировать наборы различных значений байтов, содержащихся в байте сообщения на уровне битов.

Пример:	BITPOS	BIT1&BIT4&&BIT7	B'01111010	H'7A
		or	B'01111011	H'7B
		или в общем случае	B'x1111x1x

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

Если заданы несколько групп условий заданы, то нужно рассматривать последовательность групп, так как трассировка работает следующим образом:

Трассировщик проверяет первую группу. Если условия для сообщения выполнены, сообщение копируется в буфер трассировки в соответствии с параметрами этой группы (длина, условные условия). Другие группы не не проверяются. Если условия не выполнены, эта процедура повторяется для следующей группы.

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

Практический способ: чем строже условие, тем меньше должен быть номер его группы.

Общее правило: если условие группы является частью другого, она должна иметь меньший номер группы.

Условные условия

Значения байтов, заданные для выбора могут во время трассировки задаваться, изменяться и удаляться автоматически в зависимости от содержания сообщения. Это происходит в соответствии с заданными условными условиями (параметр COND=CCD1/..CCD8).

Это означает: из сообщения, которое соответствует условиям выбора используются максимум 8 байтов в качестве условия для следующего сообщения.

Подробный пример использования этой функции приведен в описании команды AMO TRACS,  в разделе Примеры.

Условия пуска, остановки, остановки всех и времени

Условие пуска описывает свойства сообщения или объекта ЛВС, который активизирует трассировку (объект пуска).

Пример:	SELMSG,START,G1,CD1,SRC,34&57,e;	запуск трассировки при появлении сообщения

	SELMSG,START,G1,CD2,EV,3E,e;	 в котором 4-й байт равен 3E и 
		первый байт равен 34 или 57.

Условие остановки описывает свойства сообщения или объекта ЛВС, который деактивизирует трассировку (объект остановки).

Условие остановки всех описывает свойства сообщения или объекта ЛВС, который деактивизирует   трассировку  (объект остановки всех) для всех сконфигурированных процессов системы HICOM (включая IS).

Если заданы оба условия STOP и STOPALL, то трассировщик сначала проверяет условие STOP, а затем условие STOPALL. Если для обеих точек трассировки заданы одинаковые условия, то трассировщик проверяет только условие STOP и, при положительном результате, останавливает трассировку текущего процессора. В этом случает условие STOPALL игнорируется, т. е. оно не действует!

Условие времени описывает свойства сообщений, которые вводятся в буфер с датой и временем. Трассировка системного времени выполняется только вместе с другим объектом трассировки. Типичное использование: "SELMSG,TIME,G1,ALL;"

Пример:	SELMSG,OS,G1,CD1,SRC,34&57;	каждое сообщение ОС с первым байтом, равным  34
 	SELMSG,TIME,G1,ALL;	или 57 записывается с указанием даты и времени;

Примечание

Особым случаем является помещение в буфер трассировки сообщений или объектов ЛВС с указанием времени и перезапуск системы (включена стабильность перезапуска).  В этом случае  из-за ресурсов ОС (SELSTOP,OS) информация о дате времени не может быть запрошена в течение короткого периода времени. Причиной этого является недействительность времени операционной системы, и возврат значений DUMMY при вызове процедур ОС. В этом случае поля данных для времени содержат знаки вопроса ("?").
При использовании механизма сериализации блокировки прерывания (SELSTOP,LOCK) трассировщик всегда может получить информацию о дате и времени, однако эти данные не являются точными при запуске системы. После запуска системы время обновляется значением текущего системного времени. После этого выводимые трассировщиком данные о времени снова содержат правильную информацию.

Для того чтобы у пользователя было достаточно времени для задания всех необходимых индивидуальных условий, выполнение управляющих условий временно приостанавливается, пока не будет введены все условия.

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

Состояние задания управляющих условий отменяется при активизации трассировщика (команда ON); для этих управляющих условий задается состояние ожидания.

На этом этапе каждое сообщение и каждый объект ЛВС при активизации точек трассировки проверяется, чтобы определить, удовлетворяет ли он заданным управляющим условиям.

После получения объекта пуска трассировка активизируется и в буфер вводится сообщение пуска.  (Если условие пуска не задано, трассировка действовала начиная с активизации трассировщика).

Следующие сообщения или объекты ЛВС помещаются в буфер в соответствии с выбором точек трассировки. Объекты, соответствующие условиям времени, помещаются в буфер с указанием даты и времени.

При получении объекта остановки трассировка деактивизируется. Объект остановки является последним объектом, помещенным в буфер.

При получение объекта остановки всех трассировка деактивизируется во всех процессорах, в которых была активна. Последним помещенным в буфер объектом является объект остановки всех.

Заданные управляющие условия остаются доступными (статус = R для условий пуска, остановки, остановки всех,  статус = W для условий времени) и начинают действовать при следующей команде ON.

Команда STATUS выводит статус управляющих условий:

D (задано)

R (выполнено)

W (ожидание)

2.1.4.2.2 MSGLEN

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

Эта команда действует только для ввода SELMSG. Значение по умолчанию равно 16, это значение также используется, если эта команда не выполняется.

Пример:	'SELMSG,OS,G1,ALL;'	записываются первые 20 байтов всех сообщений ОС

	'MSGLEN,OS,G1,20;'	

2.1.4.2.3 Активизация и деактивизация трассировщика (ON, OFF)

Если условие пуска не задано, трассировщик начинает работать немедленно после ввода команды ON и записывает данные в буфер трассировки. Все заданные условия пуска, остановки и остановки всех переводятся в состояние ожидания.

При трассировке на жесткий диск ("ON,HD,имя файла,..") каждый раз, когда буфер трассировки заполняется, все его содержание пишется в файл трассировки. Если файл трассировки уже есть на жестком диске, его можно переписать с помощью опции OVERWRT: yes. Если этот параметр не введен, выводится запрос, хочет ли пользователь переписать файл трассировки. Если файла трассировки на жестком диске нет, параметр OVERWRT игнорируется.
Принципы работы: как только буфер трассировки полностью заполняется, он копируется и по сообщениям пересылается на жесткий диск. Функцией этой задачи является передача принятого буфера трассировки на жесткий диск. В это время трассировка продолжается.

Примечание: при высокой загрузке буфер трассировки может быть потерян из-за недостатка ресурсов.

Параметр MAXBLOCK определяет размер файла трассировки и количество буферов трассировки, которые могут быть сохранены в этом файле (значение по умолчанию: 10). Если параметр WRAP не задан, старые данные перезаписываются при заполнении файла. Параметр 'WRAP: no' предотвращает перезапись. Трассировщик продолжает работать, однако буфер трассировки больше не копируется в файл. Текущее состояние файла трассировки можно посмотреть с помощью "STA,HD;".

Если активизирована трассировка в буфер ("ON,BUF"  или просто  "ON;"), то старые данные перезаписываются при заполнении буфера трассировки.  Другими словами функция перезаписи всегда активна.

Команда OFF деактивизирует трассировщик. Для условий пуска, остановки и остановки всех задается статус "задано". Если была активизирована трассировка на жесткий диск, в файл трассировки, если возможно, копируется частично заполненный буфер трассировки.

2.1.4.2.4 Отображение и сохранение данных трассировки (DISPLAY, DA, DB, DF, DL, DN, COPY)

Сохраненные в буфере трассировки данные можно вывести в любое время (даже во время работы трассировщика) с помощью команд: DF, DL, DA, DB и DN.

Для вывода данных сессии трассировки на жесткий диск необходимо указать файл для вывода с помощью функции DISPLAY,"filename". Выводится подробный статус файла трассировки. Начиная с этого момента весь файл трассировки обрабатывается с учетом команд вывода (DA, DB, DF, DL, DN) как один большой буфер трассировки. Если вместо имени файла введено значение "*", используется последнее имя файла, которое было использовано в команде ON или DISPLAY. Использование команды DISPLAY возможно, только если трассировка выключена.

Вывод объектов трассировки

1.

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

2.

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

3.

первые <n> объектов трассировки, с помощью DF (вывод первых)

4.

последние <n> объектов трассировки, с помощью   DL (вывод последних)

5.

с одного определенного объекта до другого или 10 объектов, начиная с определенного номера объекта с помощью DN (вывод с номера)

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

После вывода краткого отчета о статусе с помощью команды STA, указатель чтения помещается на первой доступной записи данных буфера трассировки, если ранее указатель имел недопустимое значение.

	Буфер трассировки
Логическое начало буфера
Вывод с помощью команды DF (вывод первых)
Вывод с помощью команды DN (вывод с номера)	Объект с заданным номером.
Вывод с помощью команды DB (вывод до указателя чтения)
Указатель чтения
Вывод с помощью команды DA (вывод после указателя чтения)
Вывод с помощью команды DL (вывод последних)
Указатель записи

 

Рисунок 110  Опции чтения буфера трассировки  

Последующий выбор доступен для всех приведенных выше команд вывода:

1.

При запросе выводятся только определенные типы объектов трассировки. Обратите внимание, что значение по умолчанию для параметра TYPE является OS, а не ALL.

2.

Кроме того, вывод объектов трассировки может быть ограничен указанием значений любого байта. Альтернативой указания значений отдельных байтов непосредственно в команде вывода может быть задание максимум 8 условий выбора (команда SELMSG,BUF,..?), которые можно применить к текущей команде вывода, задав значение SELMSG для параметра TEST. (Так как эти условия выбора сохраняются в данных AMO, они доступны только до завершения работы AMO). С помощью команды копирования критерии выбора можно сохранить в файле.

3.

Последующий выбор не действует при чтении всех записей буфера трассировки (TYPE=ALL).

Параметр LAE определяет максимальную длину всех выводимых объектов трассировки.

Пример:	SELMSG,BUF,G1,CD1,SRC,34;	Выводятся все одиночные объекты с номерами с 100 до 200,

	SELMSG,BUF,G1,CD2,DEST,E5;	которые удовлетворяют условиям CD1 и CD2 
	DN,100-200,10,ALL,,,SELMSG;	

Также возможно сохранение данных трассировки, которые были помещены в буфер трассировки. Эта операция выполняется с помощью команды COPY,BUF-HD,"filename". Для вывода файла вы можете использовать команду DISPLAY.

2.1.4.2.5 Вывод статуса трассировщика (STA)

При выполнении команды STA возможен вывод статуса трассировщика в любое указанное время. Параметр  RES позволяет пользователю задать для параметров стандартные значения и очистить буфер трассировки.

1.

Краткий отчет о статусе при вводе INFO=S:

a)

Максимальное количество объектов трассировки, помещаемых в буфер

b)

Количество выбранных объектов трассировки

c)

Количество объектов трассировки в буфере

d)

Положение указателя чтения по отношению к началу буфера (счетчик начинается с 1 или сообщается о недопустимом положении указателя)

e)

Активен ли трассировщик

f)

Статус условий пуска и остановки

2.

Средний отчет о статусе при вводе INFO=M:

a)

Краткий отчет о статусе

b)

Имеет ли трассировщик стабильность  к перезапуску

c)

Выбранный механизм сериализации

d)

Статус условий остановка всех, PETRA и время

e)

Информация о системе, остановившей трассировщик

f)

Вариант, версия и дата создания резидентного трассировщика

g)

Текущее название процессора

h)

Объем буфера в байтах

i)

Пользовательская информация

j)

Файлы трассировки и их статус

3.

Подробный отчет о статусе при вводе INFO=L:

a)

Средний отчет о статусе

b)

Отчет о статусе для данных выбора

4.

Отчет о статусе для данных выбора при вводе INFO=C:

a)

Все заданные группы и условия выбора для сообщений и объектов LAN

b)

Все условные условия для действий, зависящих от сообщений, для выбранных во время трассировки условий выбора

c)

Все динамическая память для всех точек трассировки обработки вызовов

d)

Биты условий для последующего выбора (если заданы)

e)

Условия пуска, остановки, остановки всех,  PETRA и времени (если заданы)

f)

Спецификация шлюза и всей запрашиваемой динамической памяти

g)

Выбор общесетевой остановки трассировки

5.

Отчет о статусе для файла трассировки при вводе INFO=HD:

a)

Краткий отчет о статусе

b)

Файл трассировки и его статус

c)

Краткая информация о содержании файла трассировки (подробная информация может быть выведена с помощью команды DISPLAY)

2.1.5 Техническая информация

Для трассировки сообщений определены следующие стандартные точки трассировки и соответствующие объекты трассировки:

a)

Вызовы ОС ON_P_SEND_MESSAGE_N, ON_P_SEND_MESSAGE_I, ON_P_SEND_MESSAGE_P, ON_P_SEND_MSG_N_NO_FREE, ON_P_SEND_MSG_I_NO_FREE, ON_P_SEND_MSG_P_NO_FREE с типом объекта SD

b)

Вызовы ОС ON_P_RECEIVE_MESSAGE и ON_P_ACCEPT_MESSAGE, с типом объекта RCV

c)

Точка трассировки ЛВС в процедуре трассировки интерфейса в подсистемах ЛВС. Эта процедура трассировки интерфейса ЛВС вызывается различными уровнями ЛВС с соответствующими типами объектов: ETHRV, ETHSD, TCP, TPI, IPDSD, IPDRV

При обнаружении ошибки во время трассировки трассировщик записывает в буфер трассировки запись с  индикацией ошибки. При вводе команды вывода с параметром TYPE=ALL эти индикаторы ошибок виды; их можно определить по указанию шестнадцатеричного числа в качестве типа объекта.

Это шестнадцатеричное число состоит из двух байтов:

первый байт  указывает тип ошибки

>  первая шестнадцатеричная цифра  указывает группу затронутых условий,  

1-я цифра 1-го байта	значение
0	несущественный
1	Ошибка в группе 1
2	Ошибка в группе 2
3	Ошибка в группе 3
4	Ошибка в группе 4

> вторая шестнадцатеричная цифра  является кодом ошибки

2-я цифра 1-го байта	значение	комментарий
1	неверный номер позиции сравнения	уничтожены административные переменные трассировщика
5	неверная длина сообщения	в трассировщик передан недопустимый маркер сообщения
6	неверное смещение для маркера	в трассировщик передан недопустимый маркер сообщения
8	недопустимая точка трассировки	процедура трассировки начала ветвление с точки, которая не совпадает с запланированным точками трассировки
A	недопустимое количество групп условий	уничтожены административные данные трассировщика (недопустимое количество групп условий)

второй байт  обозначает  тип объекта   код ошибки 2-й байт тип объекта комментарий 00   SD   была совершена попытка трассировки содержания сообщения для вызова SEND_MESSAGE 01   RCV   была совершена попытка трассировки содержания сообщения для вызова RECEIVE_MESSAGE 07   TIME   была совершена попытка трассировки информации о времени 16   TPI   была совершена попытка трассировки данных уровня TPI LAN 17   TCP   была совершена попытка трассировки данных уровня   TCP LAN 1A   IPDSD   была совершена попытка трассировки данных IP Dual Port Ram Send   1B   IPDRV   была совершена попытка трассировки данных IP Dual Port Ram Receive   1C   ETHSD   была совершена попытка трассировки данных заголовка протокола исходящего фрейма драйвера ethernet 1D   ETHRV   была совершена попытка трассировки данных заголовка протокола входящего фрейма драйвера ethernet

2.1.6 Точки трассировки ЛВС (описание приложения)

В подсистеме ЛВС имеется 4 точки трассировки:

TPI: Эта точка трассировки делает возможным протоколирование и анализ специфичной для соединения части интерфейса между подсистемой ЛВС и ее пользователями (OS,CMS) . Активизация этой точки трассировки может дать инструктивную информацию при возникновении ошибок в подсистеме ЛВС или вне нее.

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

ETHSD, ETHRV: Для анализа данных протокола (Ethernet, IP, TCP, ICMP, ARP) может использоваться точка трассировки ETHSD для исходящих пакетов и точка трассировки ETHRV для входящих пакетов. Обе точки трассировки дают именно те данные (протокола), которые передаются или принимаются от ЛВС. Драйвер Ethernet не имеет памяти для соединений, поэтому точки трассировки не специфичны для соединений. Кроме того, протоколирование пользовательских данных в этих точках не имеет смысла, так как работа TCP  не ориентирована на сообщения.

2.1.6.1 Активизация точки трассировки ЛВС

Для активизации точек трассировки ETHSD и ETHRV достаточно команд

selmsg,lan,g1,cd1..;

setlan,g1,ethsd&ethrv;

on;

в трассировщике HICOM. Дополнительно к точкам трассировки TPI и TCP необходимо выбрать протоколируемое соединение. Поэтому пользователь должен выполнить следующие действия:

3. Задание сегмента данных OLTSTRX

4. Запуск отладчика

5. Вывод сегмента данных OLTSTRX

6. При трассировке выводится 4 строки символов.  "Start of eCCONN"  и "End of eCCONN"  включают таблицу "ожидаемые соединения клиентов", "Start of Stable"  и "End of Stable" таблицы "сокеты трассировки".

7. Обе таблицы позволяют пользователю выбрать соединения, которые должны протоколироваться.

2.1.6.1.1 Ожидаемые соединения клиентов

Рисунок  111 OLTSTRX.CC trace_client_conn_tbl

Эта таблица позволяет пользователю задать опции трассировки для соединений, которые еще не установлены, и когда система является клиентом.  Поэтому пользователь вводит IP-адрес партнерского процессора и номер порта партнера в эту таблицу. Порядок байтов: BIG ENDIAN (соответствует порядку  байтов  в сети). Если пользователь TCP пытается установить клиентское соединение, TCP проверяет эту таблицу и, если необходимо, включает опцию трассировки для этого сокета.

Пример: По неизвестным причинам CCB не может установить соединение с CCB. При вводе IP-адреса (192.0.2.1) и номера порта (T'612) CCA  в эту таблицу  

>> 66 49 50 3A 20 C0 00 02 01 66 50 6F 3A 20 02 64 fIP: ....fPo: .d

и при включении точек трассировки TCP и TPI  с помощью трассировщика HICOM, пользователь   может контролировать TCP во время установления соединения.

2.1.6.1.2 Таблица сокетов трассировки

Рисунок 112 OLTSTRX.CC trace_socket_tbl

Единственным назначением этой таблицы является упрощение выбора сокетов/соединений TCP   для протоколирования. Поэтому TCP каждые две секунды вводит в таблицу все допустимые сокеты или соединения и указывает их статус и опции трассировки. Используя последний столбец таблицы пользователь может задать трассировку соединения, указав для байта "trace_toggle" значение, не равное 0. При следующем обновлении этой таблицы TCP проверяет столбец "trace_toggle" и включает переключает трассировки (ON->OFF или OFF->ON; ON=01,OFF=00). Затем TCP снова задает для байта "trace_toggle" значение 00.

Примечание

Если IP-адрес и удаленный порт равны 0, то это порт приемника. Если партнер хочет соединиться с этим портом, для нового соединения создается копия сокета и порт приемника обстается неизменным. При создании копии учитываются опции трассировщика, поэтому установление соединения может контролироваться на сервере.

Пример

Пользователь хочет контролировать сообщения ОС между ADP и CCB и уже соответственно подготовил трассировщик HICOM. Для выбора соединения он активизировал отладчик HICOM, получил таблицу сокетов трассировки и вывел ее.

C318:0062 = 53 74 61 72 74 20 6F 66 20 53 74 61 62 6C 65 00 Start of Stable.

C318:0072 = 02 00 00 00 80 03 00 00 00 00 02 64 00 00 01 00 ...........d....

C318:0082 = 67 00 00 00 82 03 C0 00 02 01 02 64 02 80 00 00 g..........d....

C318:0092 = 05 00 00 00 80 03 00 00 00 00 00 66 00 00 00 00 ...........f....

C318:00A2 = 0B 00 00 00 82 03 C0 00 02 02 02 64 02 80 00 00 ...........d....

C318:00B2 = 08 00 00 00 82 03 C0 00 02 10 00 66 07 DA 00 00 ...........f....

C318:00C2 = 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................

C318:00D2 = 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................

.....

.....

При использовании команды "SET" опции трассировки для соединений ADP<->CCB включены, как показано командой "DISPLAY".

* "set c318:C1(1)=5!"

* "d c318:b2(10)!"

C318:00B2 = 08 00 00 00 82 03 C0 00 02 10 00 66 07 DA 01 00 ...........f....

При повторном вводе указанной выше команды "SET" опции трассировки для соединения ADP<->CCB выключаются.

* "set c318:C1(1)=5!"

* "d c318:b2(10)!"

C318:00B2 = 08 00 00 00 82 03 C0 00 02 10 00 66 07 DA 00 00 ...........f....

2.1.6.2 Формат и интерпретация данных трассировки

Замечание: Если указанных данных не существует, соответствующий компонент записи трассировки задается равным 0.

2.1.6.2.1  Точка трассировки  TPI

Рисунок  113 Структура записи точки трассировки TPI

Смещение	Элемент данных	Размер	Комментарий
0	IP-адрес удаленного хоста	4 байта	Порядок байтов -  BIG ENDIAN
4	локальный порт	2 байта
6	удаленный порт	2 байта
8	вызванная функция TPI	2 байта	См. Таблицу 60
10	код возврата вызванной функции	2 байта
12	дополнительный параметр	2 байта	зависит от вызванной функции  см. Таблицу 61
14	дополнительный массив данных   ...	макс. 40 байт

Таблица 60 Идентификаторы функции TPI и коды возврата функции TPI

Идентификатор функции TPI			Код возврата функции TPI
Величина	Значение		Величина	Значение
0x012E	TPI_LISTEN		0x0000	GOOD
0x012F	TPI_CONNECT		0x0028	RESOURCE_BUSY
0x0130	TPI_ACCEPT		0x0029	WOULD_BLOCK
0x0131	TPI_SEND		0x002A	CONN_LOSS
0x0132	TPI_RECEIVE		0x002B	TIMEOUT
0x0133	TPI_CLOSE		0x002C	DUMMY_CALLED
0x0134	TPI_SET_OPTION		0x002D	BAD_PARAM
0x0135	TPI_SET_MAILBOX		0x002E	FATAL_INTERNAL
0x0136	TPI_GET_OPTION

Таблица 61 Дополнительные параметры и дополнительные данные

вызванная функция	add_param	add_data	длина
TPI_LISTEN	нет	NULL	0
TPI_CONNECT	нет	NULL	0
TPI_ACCEPT	нет	информация об адресе удаленного хоста	16
TPI_SEND	байты для передачи	передаваемые данные пользователя	<= 40
TPI_RECEIVE	байты получены пользователем	пользовательские данные, полученные пользователем	<= 40
TPI_CLOSE	нет	NULL	0
TPI_SET_OPTION	старший байт:  группа опции   младший байт: опция;  см. Таблицу 62	первый байт: действие задано(1)/сброшено(0)  другие 2 байта:  дополнительное значение	3
TPI_SET_MAILBOX	нет	асинхронное сообщение, которое должно быть отправлено  TCP в почтовый ящик;  см. Рисунок 114	33
TPI_GET_OPTION	старший байт:  группа опции   младший байт: опция; см.Таблицу 62	первый байт: действие задано(1)/сброшено(0)  другие 2 байта:  дополнительное значение	3

Рисунок 114 Структура сообщения ASYNC

Смещение	Элемент данных	Размер	Комментарий
0	пользовательские данные	16	задается пользователем
16	указатель на сокет	4	указатель на дескриптор сокета
20	идентификация сокета	4	см. Таблицу сокетов трассировки на стр. 3288
24	тип сообщения	1	см. Таблицу 63
25	тэг приложения	2	заданный пользователем вызов tpi_set_option (ROL_OPT_STD_CMS_COMM)
27	идентификатор функции	2	идентификатор и код возврата последней вызванной функции TPI; см. Таблицу 60
29	код возврата	2
31	информационное слово	2	количество переданных/принятых байтов или информация ошибки

Таблица 62 Группы опций и опции

Группа опций		Опция
Значение	Описание	Значение	Описание
0X00	OL_LEVEL_DUMMY		опция не задана
0X01	OL_LEVEL_IPPROTO	0X00	OL_IPPROTO_DUMMY
		0X01	OL_IPPROTO_NODELAY
0X02	OL_LEVEL_SOL_SOCKET	0X00	OL_SOL_SOCKET_DUMMY
		0X01	OL_SOL_SOCKET_SO_DEBUG
		0X02	OL_SOL_SOCKET_SO_KEEPALIVE
		0X03	OL_SOL_SOCKET_SO_DONTROUTE
		0X04	OL_SOL_SOCKET_SO_LINGER
		0X05	OL_SOL_SOCKET_SO_OOBINLINE
		0X06	OL_SOL_SOCKET_SO_RCVBUF
		0X07	OL_SOL_SOCKET_SO_SNDBUF
		0X08	OL_SOL_SOCKET_SO_REUSEADDR
		0X09	OL_SOL_SOCKET_SO_RCVLOWAT
		0X0A	OL_SOL_SOCKET_SO_SNDLOWAT
		0X0B	OL_SOL_SOCKET_SO_RCVTIMEO
		0X0C	OL_SOL_SOCKET_SO_SNDTIMEO
		0X0D	OL_SOL_SOCKET_SO_USELOOPBACK
		0X0E	OL_SOL_SOCKET_SO_ERROR
0X03	OL_LEVEL_FCNTL	0X00	OL_FCNTL_DUMMY
		0X01	OL_FCNTL_FNDELAY
		0X02	OL_FCNTL_FASYNC
0X04	OL_LEVEL_IOCTL		опция не задана
0X05	OL_LEVEL_ROLM	0X00	OL_ROLM_OPT_DUMMY
		0X01	OL_ROLM_OPT_OS_COMM
		0X02	OL_ROLM_OPT_APPL_TAG
		0X03	OL_ROLM_OPT_MBUF_DATA_SIZE
		0X04	OL_ROLM_OPT_CLUSTER_SIZE
		0X05	OL_ROLM_OPT_MTU_SIZE_MIN_HEAD
		0X06	OL_ROLM_OPT_STD_CMS_COMM

Таблица 63 Типы асинхронных сообщений

Значение	Тип сообщения	Описание
0X01	ASYNC_MSG_ERROR	В этом сокете произошла неисправимая ошибка.
0X02	ASYNC_MSG_ACCEPT_READY	Сокет имеет поставленные в очередь соединения.
0X03	ASYNC_MSG_CONNECT_READY	Инициированный ранее вызов соединения завершен.
0X04	ASYNC_MSG_WRITE_READY	В буфере вывода сокета имеется место. Это сообщение никогда не передается, если сокет работает в режиме коммуникации OS.
0X05	ASYNC_MSG_READ_READY	Во входном буфере сокета имеются данные. Это сообщение передается для каждого принятого сегмента входящих данных. Это сообщение никогда не передается, если сокет работает в режиме коммуникации OS.
0X06	ASYNC_MSG_CONN_LOSS	Сообщение потеряно в этом сокете.
0X07	ASYNC_MSG_OOB_DATA	В сокет поступили внеполосные данные.

2.1.6.2.2 Точка трассировки TCP

Рисунок 115 Структура записи трассировки TCP

Смещение	Элемент данных	порядок байтов	Комментарий
	байт0 байт1
0	IP-адрес удаленного хоста	hi, lo	см. Рисунок 112 на странице 3288
4	локальный порт	hi, lo
6	удаленный порт	hi, lo
8	расположение TCP	lo, hi	см. Таблицу 64 на странице 3295
10	событие TCP	lo, hi
12	состояние сокета после	lo, hi	статус после обработки события см. Таблицу 66 на странице 3296
14	состояние сокета перед	lo, hi	статус соединения перед обработкой события; см. Таблицу 67 на странице 3297
16	текущие символы в буфере	lo, hi	в  TA_INPUT или TA_DROP эти элементы относятся к буферу приема или буферу передачи
20	выделенная память	lo, hi	общее количество памяти выделенное mbufs и clusters (1 mbuf=256 байт, 1 clusters=1518 байт)
24	состояние соединения после	lo, hi	состояние соединения после обработки события см. Таблицу 67 на странице 3297
26	таймер повторной передачи	lo, hi	интервалы повторной передачи данных при "посл. ном.: передача не подтверждена" Примечание: 1 интервал = 0,5 сек.
28	таймер существования	lo, hi	интервал передачи следующих пробных данных
30	таймер поддержания соединения	lo, hi	интервал передачи пакетов поддержания соединения
32	количество повторов	lo, hi	индекс количества повторов
34	текущий интервал передачи	lo, hi	текущий интервал повторной передачи
36	посл. ном: передача не подтверждена	lo, hi	последовательный номер передача не подтверждена
40	посл. ном: передать следующий	lo, hi	последовательный номер передать следующий
44	окно передачи	lo, hi	максимальное количество неподтвержденных байтов
46	посл. ном: принять следующий	lo, hi	последовательный номер принять следующий
48
50	окно приема	lo, hi	объем принятых данных (фактический)
52	открытое окно приема	lo, hi	открытое окно приема

Таблица 64 места трассировки и возможные события TCP

Значение lo,hi	Место трассировки	События TCP	Комментарий
01 00	TA_USER	PRU_ATTACH	назначение протокола сокету
		PRU_DETACH	отмена протокола для сокета
		PRU_BIND	связь сокета с адресом
		PRU_LISTEN	ожидание соединения
		PRU_CONNECT	установление соединения с равным
		PRU_ACCEPT	прием соединения от равного
		PRU_DISCONNECT	отключение от равного
		PRU_ABORT	прерывание (быстрый DISCONNECT, DETATCH)
		PRU_SLOWTIMO	задержка 500 мс
02 00	TA_OUTPUT	TCP-флаги+  длина пользовательских данных в  WORDS	см. TA_INPUT
03 00	TA_INPUT	TCPфлаги+  длина пользовательских данных в WORDS	TCP-флаги (см. Таблицу 68 на стр. 3297) принятого пакета TCP сохраняются в битах Intel 0 - 5 байта 0 в событии TCP, длина пользовательских данных в словах сохраняется в битах 6,7 байта 0 и битах 0 - 7 байта 1 (старший байт)
04 00	TA_DROP	TCP-флаги + причина сброса	аналоговое к TA_INPUT; возможные значения причины сброса перечислены в Таблице 65 на стр. 3296
05 00	TA_DROPAFTERACK	TCP-флаги + причина сброса	аналоговое к TA_INPUT; возможные значения причины сброса перечислены в Таблице 65 на стр. 3296
06 00	TA_DROPWITHRST	TCP-флаги + причина сброса	аналоговое к TA_INPUT; возможные значения причины сброса перечислены в   Таблице 65 на стр. 3296

Таблица 65 Причины сброса пакетов TCP и/или соединений

Значение	Обозначение	Комментарий
1	TD_NOBUF	недоступен требуемый ресурс памяти
2	TD_NEWSOFAILED	не удалось создать новый сокет, так как нет места для сокета
3	TD_TCPFLAG	получен неожиданный флаг
4	TD_PCBFAILED	ошибка при вызове in_pcbconnect
5	TD_SEQFAIL	получен неожиданный последовательный номер
6	TD_CONNCLOSED	соединение уже закрыто
7	TD_WAITFIN	TCP ожидает FIN партнера

Таблица 66 Биты статуса сокета

Intel- бит	Значение lo, hi	Название	Комментарий
0	01 00	SS_NOFDREF	нет ссылки на таблицу файлов
1	02 00	SS_ISCONNECTED	соединение сокета с равным
2	04 00	SS_ISCONNECTING	осуществляется соединение с равным
3	08 00	SS_ISDISCONNECTING	осуществляется разъединение
4	10 00	SS_CANTSENDMORE	невозможно передать данные равному
5	20 00	SS_CANTRCVMORE	невозможно получить данные от равного
6	40 00	SS_RCVATMARK	на отметке входа
7	80 00	SS_PRIV	привилегия для широковещательной передачи
8	00 01	SS_NBIO	ops без блокировки
9	00 02	SS_ASYNC	сигнал асинхронного ввода/вывода
10	00 04	SS_ISCONFIRMING	принятие запроса соединения

Таблица 67 Определение состояний TCP FSM.  согласно RFC793, сентябрь, 1981.

Значение lo, hi	Название	Комментарий
00 00	TCPS_CLOSED	соединение закрыто
01 00	TCPS_LISTEN	ожидание соединения
02 00	TCPS_SYN_SENT	активен -  отправлен SYN
03 00	TCPS_SYN_RECEIVED	отправлен и получен  SYN
04 00	TCPS_ESTABLISHED	установлено соединение
05 00	TCPS_CLOSE_WAIT	получен FIN - ожидание закрытия
06 00	TCPS_FIN_WAIT_1	закрыт  - отправка FIN
07 00	TCPS_CLOSING	закрыт при обмене  FIN   -  ожидание FIN ACK
08 00	TCPS_LAST_ACK	FIN  и закрыт  - ожидание FIN ACK
09 00	TCPS_FIN_WAIT_2	закрыт  - FIN запрошен
0A 00	TCPS_TIME_WAIT	ожидание после закрытия

Бит ном.:1	Бит 5 (10)	Бит 4 (11)	Бит 3 (12)	Бит 2 (13)	Бит 1 (14)	Бит 0 (15)
Значение:	H'20	H'10	H'08	H'04	H'02'	H'01
Название:	URG	ACK	PUSH	RST	SYN	FIN
Описание:	"Срочный указатель"- важное поле	Важное поле подтверждения	Функция Push	Сброс (закрытие) соединения	Синхр. последов. номер; начало соединения	Нет данных от передающей стороны; соединение закрыто

1 нумерация в формате Intel (цифры в скобках соответствуют сетевой нумерации)

Таблица 68 Флаги TCP и их значение

Рисунок 116 Пример трассировки для точки трассировки TCP

2.1.6.2.3 Точки трассировки ETHSD, ETHRV

Как уже было подчеркнуто в   Разделе 2.1.6  на странице  3286, если нужны данные протокола, должны использоваться точки трассировки ETHSD и ETHRV. Структура данных трассировки одинакова для точек трассировки ETHSD и ETHRV. Эта структура - для соединений TCP -  указана и прокомментирована на Рисунке 118  на странице  3299. Подробная информация о других протоколах приведена в RFC791(IP), RFC792(ICMP), RFC793(TCP) и RFC826(ARP).

Примечание: для всех данных протоколов порядок байтов и битов - BIG ENDIAN, что соответствует "сетевому порядку байтов" (это означает: биты и байты с меньшими номерами позиций более значимы).

Рисунок 117 Пример трассировки для точек трассировки ETHSD  и ETHRV

Рисунок 118 Информация заголовка протокола, доступная в точках трассировки ETHSD & ETHRV

	байт0, бит0-бит7	байт1, бит8-бит15
0	Destination MAC Address		E	Заголовок Ethernet MAC-адрес назначения: адрес Ethernet  хоста назначения  (0xFF FF FF FF FF FF = широковещательный адрес)     MAC-адрес источника: адрес Ethernet  хоста источник   Type Field: тип фрейма Ethernet (EtherType_IP = 0x0800, EtherType_ARP = 0x0806)   IP Header   Ver (bit 0 - bit 3): IP-версия 4 поддерживает только IHL (bit 4 - bit 7): длина IP-заголовка в Dwords (обычно= 5)   TypeOfService: не используется в ЛВС Atlantic и всегда равно 0   Total Length: длина диаграммы, измеренная в октетах, включает заголовок internet и данные   Identification: значение, назначаемое передающей стороной для облегчения сбора фрагментов диаграммы.   Flags(bit0-2): бит 0: зарезервирован, должен равняться нулю Bit 1: 0 = возможна фрагментация, 1 = без фрагментации Bit 2: 0 = последний фрагмент, 1 = первый фрагмент.   Fragment Offset: указывает к какому месту диаграммы относится этот фрагмент, измеряется в единицах, равных 8  октетам     TimeToLive: максимально допустимое время нахождения диаграммы в системе internet   Protocol: указывает следующий уровень протокола, используемый в порции данных диаграммы (ICMP = 0x0001, TCP = 0x0006, UDP = 0x0011)   Header Checksum: контрольная сумма только заголовка Source/Destination Address: IP-адрес хоста источника/назначения  заголовка  TCP Source/Destination Port: номер порта источника/назначения.   Sequence Number: номер последовательности первого октета данных этого сегмента Acknowledgment Number: содержит значение следующего номер последовательности отправителя, прием которой ожидается   Data Offset (bit 0 - 3): длина заголовка TCP в Dwords( = 5)   Reserved (bit 4 - 9): зарезервированы для последующего использования, должны равняться 0.   Флаги (бит 10 - 15): см.  Таблицу 68 на странице 3297   Window: количество октетов данных, начиная с указанного в поле подтверждения, которые отправитель этого сегмента отправил для приема.   Checksum: 16-битное дополнение к сумме дополнительной сумме  всех 16 битов слов и заголовке и данных Urgent Pointer: текущее значение срочного указателя, как положительное смещение от последовательного номера этого сегмента. Срочный указатель указывает на последовательный номер октета, следующего за срочными данными. Это поле может интерпретироваться только в сегментах заданным управляющим битом URG.
2			T
4			H
6	Source MAC Address
8			H
10			D
12	Type Field		R
14	Ver+IHL	TypeOfService
16	Total Length		I
18	Identification		P
20	Flags + Fragment Offset
22	TimeToLive	Protocol	H
24	Header Checksum		E
26	Source Address		A
28			D
30	Destination Address		E
32			R
34	Source Port
36	Destination Port		T
38	Sequence Number		C
40			P
42	Acknowledgment Number
44			H
46	DataOffset +Reserved + Flags		D
48	Window		R
50	Checksum of Header + Data
52	Urgent Pointer

2.1.6.2.4 Некоторые адреса

Адреса Ethernet:	02 00 0C 00 02 01	CCA
	02 00 0C 00 02 02	CCB
	02 00 0C 00 02 03	ADP
IP-адреса:	0C 00 02 01	CCA
	0C 00 02 02	CCB
	0C 00 02 03	ADP
Адреса портов:	0200 - 0263	BOOT
	0264 - 02C7	OS
	02C8 - 032B,   0400 - 0463,   0066	CMS

адреса с сетевым порядком байтов (BIG ENDIAN)

2.1.6.2.5 Точки трассировки IPDSD, IPDRV

Это точки трассировки ЛВС в двухпортовой ram для unixware 7. Это IP-SEND и IP-Receive

2.1.7 Примеры

Запуск AMO TRACA (в ADS),  управление трассировкой в  A1

Ввод:

<EXEC-TRACA:A1;

Вывод:

   AMO TRACA VARIANT/VERSION J2/005 OF 1999-04-15
   TRACER INPUT IN A1  PLEASE:

Примечание

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

Пример 1: простой пример

Должны быть сброшены буфер и все таблицы выбора:

Ввод:

*RES,ALL;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Буферизация только первых 14 байтов сообщений OS_SEND и OS_RECEIVE.

Ввод:

   *MSGLEN, OS, G1, 14;

Вывод:

   TRACER INPUT IN A1  PLEASE:

В буфер трассировки помещается максимум 100 объектов:

Ввод:

*MAXNO, 100;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Выбираются только сообщения, полученные AMC (заданное значение  = H'33) или AMO
(заданное значение  = H'34):

Ввод:

   *SELMSG, RCV, G1, CD1, DEST, 33&34;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Активизация трассировщика:

Ввод:

*ON;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Вывод количества объектов трассировки в буфере трассировки:

Ввод:

*STA;

Вывод:

   MAX:100  SELOBJ:3  ACTOBJ:3  RDPTR:INVAL  TRC:ON STARTCD:D STOPCD:D

   TRACER INPUT IN A1  PLEASE:

Деактивизация трассировщика:

Ввод:

*OFF;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Вывод количества объектов трассировки в буфере трассировки:

Ввод:

*STA, M;

Вывод:

   MAX:100   SELOBJ:9     ACTOBJ:9     RDPTR:INVAL  TRC:ON STARTCD:D STOPCD:D
   STOPALLCD:D TIMECD:D RST:OFF SERI:OS
   TRACER VARIANT/VERSION J2/009 OF 1999-04-15
   LENGTH OF TRACE BUFFER IN A1   : 25000 BYTES
   TRACER INPUT IN A1  PLEASE:

Вывод первых 20 объектов трассировки. Так как в буфере всего 9 объектов, выводится только 9 объектов.

Сокращения в заголовке расшифровываются следующим образом:

CURNO     =   номер объекта
SDNO      =   SD- номер, нет вывода 
TY        =   тип объекта
DE        =   задача назначения 
SC        =   исходная задача 
PR        =   номер процессора. 
EV        =   код события 

Ввод:

*DF, 20;

Вывод:

   CURNO TY SDNO DE SC PR EV   MESSAGE IN HEX                   (ASCII)
      1 RCV      33 34 13  9   3334137609130900 130300020154     34.v..........T
      2 RCV      33 33 13  1   3333137601130900 130300020154     33.v..........T
      3 RCV      34 33 13  1   3433137601130900 130300020154     43.v..........T
      4 RCV      33 34 13  0   3334137600130900 130300020154     34.v..........T
      5 RCV      33 33 13  2   3333137602130900 130300020154     33.v..........T
      6 RCV      34 33 13  2   3433137602130900 130300020154     43.v..........T 
      7 RCV      33 34 13  9   3334137609130900 130300020154     34.v..........T
      8 RCV      33 33 13  1   3333137601130900 130300020154     33.v..........T 
      9 RCV      34 33 13  1   3433137601130900 130300020154     43.v..........T
   H01: NO FURTHER OBJECT IS IN THE BUFFER
   TRACER INPUT IN A1  PLEASE:

Вывод последних трех объектов из буфера

Ввод:

*DL,3;

Вывод:

   CURNO TY SDNO DE SC PR EV   MESSAGE IN HEX                   (ASCII) 
      7 RCV      33 34 13  9   3334137609130900 130300020154     34.v..........T
      8 RCV      33 33 13  1   3333137601130900 130300020154     33.v..........T
      9 RCV      34 33 13  1   3433137601130900 130300020154     43.v..........T
   TRACER INPUT IN A1  PLEASE:

Пример 2:  Выбор сообщений  с битовой маской

Должны быть выбраны все сообщения AMO (значение задачи  = H'34), если байт сообщения 1 содержит битовую маску H'E5.

Должны быть сброшены все таблицы выбора и буфер:

Ввод:

*RES,ALL;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Ввод:

  *SELMSG, OS, G1,CD1, DEST, 34;

TRACER INPUT IN A1  PLEASE:

  *SELMSG, OS, G1, CD2, PST, 1, BIT1&BIT6&&BIT8&BIT3;

TRACER INPUT IN A1  PLEASE:

Вывод статуса трассировщика

Ввод:

*STA, L;

Вывод:

   MAX:UNLTD  SELOBJ:27   ACTOBJ:27    RDPTR:INVAL TRC:OFF STARTCD:D STOPCD:D
   RST:OFF SERI:OS TIMECD:D STOPALLCD:D
   TRACER VARIANT/VERSION J2/005 OF 1999-04-15
   LENGTH OF TRACE BUFFER IN BPA: 25000 BYTES 
   USER: DUMMY TEL 4711 

   SELECTIONS AT TRACEPOINT SD :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8

   SELECTIONS AT TRACEPOINT RCV :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8

   TRACER INPUT IN A1  PLEASE:

Должны быть выбраны только принятые сообщения (RCV), если дополнительно к предыдущему условию,  бит 6 (= H'20)  содержит бит сообщения  4.

Ввод:

*SELMSG, RCV, G1, CD3, PST, 4, BIT6;

TRACER INPUT IN A1  PLEASE:

Вывод данных выбора

Ввод:

*STA,C;

Вывод:

   SELECTIONS AT TRACEPOINT SD :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8

   SELECTIONS AT TRACEPOINT RCV :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8
   CONDITION 3: BYTE     4  = BIT6

   TRACER INPUT IN A1  PLEASE:

Вывод сообщений между нижней (5) и верхней (12)  границей

Ввод:

*DN,5-12;

Вывод:

   CURNO TY SDNO DE SC PR EV   MESSAGE IN HEX                    (ASCII)
      5 SD      34 E5 13  A   34E513760A130900 13030C34020154   4.............T 
      6 SD      34 E5 13 23   34E5137623130900 1303BE00020136   4..#..........6
      7 RCV     34 E5 13 23   34E5137623130900 1303BE00020136   4..#..........6
      8 SD      34 E5 13  2   34E5137602130900 13030000020100   4..v...........
      9 SD      34 E5 13 2F   34E513762F130900 13030001020154   4
     10 RCV     34 E5 13 2F   34E513762F130900 13030001020154   4
     11 SD      34 E5 13 29   34E5137629130900 13030550         4
     12 RCV     34 E5 13 29   34E5137629130900 13030550         4
   TRACER INPUT IN A1  PLEASE:

Пример 3: Трассировка данных ЛВС;  Сохранение с помощью  COPY

Должны быть выбраны объекты ЛВС уровня ethernet  с значениями  H'19  или H'1A в байте 5:

Должны быть сброшены буфер и все таблицы выбора:

Ввод:

*RES,ALL;

Вывод:

   TRACER INPUT IN A1  PLEASE:

Ввод:

*SELMSG, LAN, G1, CD1, BY, 5, 19&1A;

Вывод:

   TRACEPOINTS SET: ETHRV ETHSD

   TRACER INPUT IN A1 PLEASE:

Должны быть выбраны дополнительные объекты ЛВС уровня  TCP с значением H'77  в байте  0:

Ввод:

*SELMSG, LAN, G2, CD1, BY, 0, 77;

*SETLAN, G2, TCP;

Вывод:

   TRACER INPUT IN A1 PLEASE:

Вывод статуса трассировки

Ввод:

*STA, L;

Вывод:

   MAX:UNLTD SELOBJ:0     ACTOBJ:0     RDPTR:INVAL TRC:OFF STARTCD:D STOPCD:D
   STOPALLCD:D TIMECD:D RST:OFF SERI:OS
   TRACER VARIANT/VERSION J2/009 OF 1999-04-15
   LENGTH OF TRACE BUFFER IN BPA  : 25000 BYTES

   SELECTIONS AT TRACEPOINT LAN :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   SELECTED LAN DATA: ETHRV ETHSD
   CONDITION 1: BYTE     5  = 19 1A

   CONDITIONGROUP 2  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   SELECTED LAN DATA: TCP 
   CONDITION 1: BYTE     0  = 77

   TRACER INPUT IN A1 PLEASE:

Активизация и деактивизация трассировщика и вывод первых 8 объектов трассировки:

Ввод:

ON;

OFF;

DF,8,,ALL;

Вывод:

   CURNO TY                    OBJECT IN HEX                     (ASCII)
       1 TCP                   77E513760A130900 13030C34020154   4.............T
       2 ETHSD                 34E5137623190900 1303BE00020136   4..#..........6
       3 ETHRV                 34E5137623190900 1303BE00020136   4..#..........6
       4 TCP                   77E5137602130900 13030000020100   4..v........... 
       5 ETHSD                 34E513762F1A0900 13030001020154   4
       6 ETHRV                 34E513762F1A0900 13030001020154   4
       7 TCP                   77E5137629130900 13030550         4
       8 TCP                   77E5137629130900 13030550         4 

   TRACER INPUT IN A1 PLEASE:

Сохранение буфера трассировки в файле на жестком диске:

Ввод:

*COPY,BUF-HD,":PAS:TRACER/TRACEBUF1";

Вывод:

   H15: WRITING OF TRACE BUFFER COMPLETED 

   TRACER INPUT IN A1 PLEASE:

Восстановление буфера трассировки из файла на жестком диске:

Ввод:

*DISPLAY,":PAS:TRACER/TRACEBUF2";

Вывод:

   +--------+-----------+-----------+-------+
   |  BLOCK | CURNO-BEG | CURNO-END | INFO  |
   +--------+-----------+-----------+-------+
   |    82  |   33152   |   33225   |1 END  |
   +--------+-----------+-----------+-------+

   TRACER INPUT IN A1 PLEASE:

Прерывание AMO TRACA

Ввод:

*END;

Пример 4: Сохранение таблицы выбора

Сохранение критериев выбора

Вывод:

   H23: WRITING TRACET SELECTION TABLES FINISHED

   TRACER INPUT IN A1 PLEASE:

Таблица выбора должна быть считана из файла на жестком диске.

Ввод:

*COPY,TAB-HD,":PAS:TRACER/SELTAB";

Вывод:

   MAX:UNLTD  SELOBJ:27   ACTOBJ:27    RDPTR:INVAL TRC:OFF STARTCD:D STOPCD:D
   RST:OFF SERI:OS TIMECD:D STOPALLCD:D
   TRACER VARIANT/VERSION J2/005 OF 1999-04-15
   LENGTH OF TRACE BUFFER IN BPA: 25000 BYTES 
   USER: DUMMY TEL 4711 

   SELECTIONS AT TRACEPOINT SD :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8

   SELECTIONS AT TRACEPOINT RCV :
   CONDITIONGROUP 1  ( MAX. MESSAGE LENGTH = 16 BYTES ):
   CONDITION 1: BYTE     0  = 34
   CONDITION 2: BYTE     1  = BIT1 BIT3 BIT6 BIT7 BIT8

   COPY SELECTIONS FOR WHICH TRACEPOINTS?

Ввод:

   SD

Вывод:

   H24: READING TRACER SELECTION TABLES FINISHED

   TRACER INPUT IN A1 PLEASE:

Пример 5: Трассировка на жесткий диск

После обычного выбора объектов с помощью SELMSG трассировщик активизируется командой ON,HD,":PAS:W3",7,Y;

Теперь выводится статус файла трассировки.

Ввод:

sta,hd;

Вывод:

MAX:UNLTD SELOBJ:645   ACTOBJ:32    RDPTR:65455 TRC:ON  STARTCD:D STOPCD:D

TRACE FILE ':PAS:W3' STATUS: WRITE

+--------+-----------+-----------+-------+                                      

|  BLOCK | CURNO-BEG | CURNO-END | INFO  |      
+--------+-----------+-----------+-------+
|  1-2   |       1   |    1667   |1      |
|  3-7   |       0   |       0   |0 EMPTY|
+--------+-----------+-----------+-------+
Файл: pas:w3 используется для трассировки на жесткий диск HD (STATUS: WRITE), уже записаны блоки 1 и 2.

Спустя некоторое время трассировка прекращается и проверяется файл трассировки.

off;
display,"pas:w3"

Вывод:

+--------+-----------+-----------+-------+                                      

|  BLOCK | CURNO-BEG | CURNO-END | INFO  |                                      

+--------+-----------+-----------+-------+
|    78  |   32178   |   32262   |1 <=64 |
|    79  |   32696   |   32782   |1 <=75 |
|    80  |   32955   |   33056   |1 <=80 |
|    81  |   33057   |   33151   |1   81 |
|    82  |   33152   |   33225   |1 ENDE |
|    76  |   31548   |   31616   |1 <=59 |
|    77  |   31884   |   31961   |1 <=62 |
+--------+-----------+-----------+-------+

При трассировке в файл :pas:w3 создавался сильный трафик сообщений, поэтому буфер трассировки заполнялся быстрее, чем сообщения могли сохраняться. Кроме того файл несколько раз перезаписывался.

Блок 78  содержит сообщения с 32178  по 32262. Цифра 1 в столбце INFO указывает, что этот блок был записан корректно.  Знак <= указывает, что из-за недостатка памяти некоторые сообщения отсутствуют: нет сообщений с 31962  по  32177. Число 64 означает, что перед блоком 78 не жестком диске был сохранен блок 64.

Для сравнения можно вывести статус файла трассировки:

Ввод:

sta,hd;

Вывод:

MAX:UNLTD SELOBJ:4166  ACTOBJ:833   RDPTR:2     TRC:OFF STARTCD:D STOPCD:D 
TRACE FILE ':PAS:W3' STATUS: READ
+--------+-----------+-----------+-------+                                      

|  BLOCK | CURNO-BEG | CURNO-END | INFO  |                                      

+--------+-----------+-----------+-------+
|  1-7   |   31548   |   33225   |1   05 |
+--------+-----------+-----------+-------+

:pas:w3 was был создан как WRAP-файл и был заполнен по крайней мере один раз. Число 05 в INFO  означает, что последним был записан блок  5.

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

AKTPOS	Используется в команде: SELMSG;
	определяет позицию байта в текущем сообщении (задание условного условия)
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - 12000
ANS	Используется в команде: COPY, ON;
	указывает, должно ли продолжаться копирование
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	Y N	да нет
AREA	Используется в команде: COPY; область действия команды
	Тип ввода	:	2 объединенных одиночных значения, обязательный
	Возможные значения	:	HD BUF TAB	файл на жестком диске буфер трассировки таблица выбора
	Возможные комбинации:
			BUF-HD	сохранение данных трассировки
			TAB-HD	сохранение таблицы выбора
			HD-TAB	чтение таблицы выбора
BITPOS	Используется в команде: SELMSG;
	Позиции битов, которые могут использоваться для создания битовой маски для сравнения по маске
	Тип ввода	:	одиночное значение, обязательное или
			объединенные одиночные значения и/или диапазон значений
			обязательное
	Возможные значения	:	BIT1	задание 1-го бита байта
			BIT2	задание 2-го бита байта
			BIT3	задание 3-го бита байта
			BIT4	задание 4-го бита байта
			BIT5	задание 5-го бита байта
			BIT6	задание 6-го бита байта
			BIT7	задание 7-го бита байта
			BIT8	задание 8-го бита байта
BLOCKNO	Используется в команде: DN; задние номера блока на жестком диске
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	1 - 65535
CMD	Параметр ветви,
	указывает команду  трассировки
	Тип ввода	:	одиночное значение, обязательное
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	OFF, USER, DA, DB, DF, DISPLAY, DL, DN, ON, COPY, END, MAXNO,
			MSGLEN, P, RES, RST, SELDYN, SELMSG, SELSTOP, SETLAN, STA
			(пояснения - см. обзор функций)
CNT	Используется в командах: DA, DB, DF, DL;
	указывает выводимое количество объектов трассировки
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	1 - 65535
	Значение по умолчанию	:	10
COND	Используется в командах: SELMSG
	параметр ветви, указывает заданное условие.
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	ALL	выбор всех сообщений
			OFF	деактивизация выбора сообщений для групп
				или деактивизация выбора в шлюзе точки трассировки
			CD1	1-е условие
			CD2	2-е условие
			CD3	3-е условие
			CD4	4-е условие
			CD5	5-е условие
			CD6	6-е условие
			CD7	7-е условие
			CD8	8-е условие
			CCD1	1-е условное условие (только SELMSG)
			CCD2	2-е условное условие (только SELMSG)
			CCD3	3-е условное условие (только SELMSG)
			CCD4	4-е условное условие (только SELMSG)
			CCD5	5-е условное условие (только SELMSG)
			CCD6	6-е условное условие (только SELMSG)
			CCD7	7-е условное условие (только SELMSG)
			CCD8	8-е условное условие (только SELMSG)
	Значение по умолчанию	:	OFF
CONDGRP	Используется в командах: MSGLEN, SELMSG, SETLAN;
	указывает группу, для которой должны быть заданы условия
	Тип ввода	:	одиночное значение, необязательное (SELMSG)
			одиночное значение, обязательное (MSGLEN, SETLAN)
	Возможные значения	:	для MSGLEN, SETLAN:
			G1	группа условий 1
			G2	группа условий 2
			G3	группа условий 3
			G4	группа условий 4
		:	для SELMSG:
			G1	группа условий 1
			G2	группа условий 2
			G3	группа условий 3
			G4	группа условий 4
			OFF	деактивизация выбора сообщений в точке трассировки
	Значение по умолчанию	:	OFF
DISPLACE	Используется в командах: DA, DB, DF, DL, DN, SELMSG;
	указывает смещение байта в объекте трассировки, который должен сравниваться
	с значением VAL
	Тип ввода	:	одиночное значение,
			обязательное в SELMSG необязательное  в DA, DB, DF, DL, DN, SELMSG
	Возможные значения	:	0 - 12000
FILE	Используется в командах: COPY, DISPLAY, ON; задает имя файла для сохранения буфера трассировки на жестком диске.
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	допустимое имя файла  (напр., ":PAS:TEST" или ":DBD:TEST") или "*" (только для  DISPLAY), что означает последнее имя файла, используемое в ON  или DISPLAY.
FLDTYPE	Используется в команде: SELMSG;
	параметр ветви, определяет поле в объекте трассировки
	на основании которого будет выполняться выбор.
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	BY	следующий определенный байт
			DEST	задача назначения
			EV	код события
			PST	powerset  или сравнение по маске
			SRC	исходная задачи
			SEVT	код подсобытия
			SU	подмодуль
INFO	Используется в команде: STA;
	указывает количество выводимой информации
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	S	краткий
			L	подробный
			M	средний
			C	условия выбора
	Значение по умолчанию	:	S
LEN	Используется в командах: DA, DB, DF, DL, DN, MSGLEN;
	Команды DA, DB, DF, DL, DN:
	максимальная выводимая длина объекта трассировки в байтах
	Команда MSGLEN:
	максимальная длина записи для сообщения.
	Вспомогательные данные, например, SDNO и т. д. не включаются.
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	0 - 65535
			(может быть уменьшено командой AMO до максимального допустимого значения)
	Значение по умолчанию	:	Команды DA, DB, DF, DL, DN:
			нет (объекты полной длины)
			Команда MSGLEN: 16
LOCK	Используется в команде: SELMSG;
	задает блокировку динамической обработки условий
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	BLOCK	блокировка выполнения условных условий
			UNBLO	отмена блокировки выполнения условных условий
MAXBLOCK	Используется в команде: ON;
	задает размер файла кратным буферу трассировки.
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	1 - 99
	Значение по умолчанию	:	10
MAXNO	Используется в команде: MAXNO;
	задает максимальное количество объектов трассировки, записываемых в буфер.
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	0 - 65535
	Значение по умолчанию	:	0 (= без ограничения)
NO	Используется в команде: DN;
	объекты буфера трассировки последовательно нумеруются с 1  до 65535 (0  соответсвует 65536).
	Последовательная нумерация может использоваться для указания адреса каждого объекта трассировки.
	Тип ввода	:	одиночное значение,  объединенные одиночные значения,  обязательное
	Возможные значения::		0 - 65535
NODEACC	Используется в команде: SELNET
	доступ к узлу системы hicom
	Тип ввода		одиночное значение, необязательное
	Возможные значения		0 -65535
NUMCD	Используется в команде: SELMSG;
	задание количества динамически изменяемых условий.
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	1 - 8
	Значение по умолчанию	:	1
OVERWRT	Используется в команде: ON;
	указывает, будет ли перезаписываться файл
	Тип ввода		одиночное значение, обязательное
	Возможные значения		Y	файл будет перезаписываться
			N	файл не будет перезаписываться
RESOBJ	Используется в команде: RES;
	перезапускаемые части трассировщика
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	BUF	Буфер трассировки, т.е. удаляется содержание буфера.
			TBL	Все таблицы выбора, т. е. не выбраны ни
				сообщения, ни динамическая память, ни управляющие условия.
				Все поля длины заданы равными 16 байтам.
				(Биты условий для поствыбора остаются
				без изменения).
			ALL	Сброс буфера трассировки и всех таблиц выбора.
	Значение по умолчанию	:	BUF
STYPE	Используется в командах: ON, RST, SELMSG, SELSTOP;
	определяет, как задаются критерии стабильности к перезапуску (RST)
	и/или механизм инициализации (SELSTOP)
	и/или выполняемое действие (SELMSG)
	и/или сохраняется ли результат трассировки на жестком диске (ON)
	Тип ввода	:	одиночное значение, необязательное в ON   одиночное значение, обязательное в RST, SELMSG, SELSTOP
	Возможные значения	:	для ON:
			BUF	Трассировка только в буфер трассировки   (значение по умолчанию)
			HD	весь буфер трассировки сохраняется в файле на жестком диске
			для RST:
			OFF	трассировщик не имеет стабильности к перезапуску
			ON	трассировщик должен иметь стабильность к перезапуску
			для SELMSG:
			ADD	добавление значения выбора
			DEL	удаление значений выбора условия
			SET	задание значения выбора
			SUB	удаление значения выбора
			для SELSTOP:
			OS	сериализация с ресурсами ОС
			LOCK	сериализация с прерываниями запрещена
TARGETCD	Используется в командах: SELMSG;
	указывает, должны ли задаваться динамические условия
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	CD1	первое условие
			CD2	второе условие
			CD3	третье   условие
			CD4	четвертое   условие
			CD5	пятое   условие
			CD6	шестое   условие
			CD7	седьмое   условие
			CD8	восьмое   условие
	Значение по умолчанию	:	Значение параметра COND
TARGETGRP	Используется в командах: SELMSG;
	указывает, какая группа динамических условий должна быть задана
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	G1	группа условий 1
			G2	группа условий 2
			G3	группа условий 3
			G4	группа условий 4
	Значение по умолчанию	:	значение параметра CONDGRP
TARGETPO	Используется в командах: SELMSG;
	указывает позицию байта в целевом сообщении (для задания условного условия)
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	0 - 12000
TARGETTP	Используется в командах: SELMSG;
	указывает целевую точку трассировки для условного условия
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	LAN	данные ЛВС
			PT	условие остановки для периферийного трассировщика lw
			RCV	точка трассировки в OS_RECEIVE_message
			SD	точка трассировки в  OS_SEND_ message
			START	условие пуска трассировщика
			STOP	условие остановки трассировщика
			STOPALL	условие остановки для всех трассировщиком системы
			TIME	условие времени для трассировщика
	Значение по умолчанию	:	значение параметра  TRACEPT
TEST	Используется в командах: DA, DB, DF, DL, DN, SELMSG;
	указывает, как должны проверяться значения в предварительном или последующем выборе (сравнение TEST).
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	команды DA, DB, DF, DL, DN:
			E	равно
			NE	не равно
			SELMSG в соответствии с набором битов условий
			(для SELMSG,BUF,..?)
			команда SELMSG:
			E	равно
			NE	не равно
	Значение по умолчанию	:	E
TEXT	Используется в командах: USER;
	содержит информационный текст, назначенный другим пользователям трассировщика и/или название собственного коммутатора для останавливаемого в сети партнерского коммутатора
	Тип ввода	:	одиночное значение, необязательное
	Возможные значения	:	текст,  макс. 70 символов
TRACEPT	Используется в командах: SELMSG, MSGLEN;
	указывает точку трассировки или условное условие,
	в котором для сообщения должны быть заданы критерии выбора.
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	BUF	буфер; набор условных битов для поствыбора  (только SELMSG)
			LAN	точка трассировки ЛВС
			OS	SD и RCV
			RCV	RECEIVE_MESSAGE в OS
			SD	SEND_MESSAGE в OS
			START	условие пуска
			STOP	условие остановки
			STOPALL	условие остановки всех
			TIME	условие времени
TYPE	Используется в командах: DA, DB, DF, DL, DN, SETLAN;
	для DA, DB, DF, DL, DN:
	указывает, какой тип объекта трассировки должен выводиться
	для SETLAN:
	указывает, трассировка какого объекта ЛВС должна производиться
	Тип ввода	:	одиночное значение, обязательное для SETLAN,  в остальных случаях необязательное
	Возможные значения	:	для SETLAN:
			ETHRV	драйвер Ethernet: заголовки протокола входящих фреймов
			ETHSD	драйвер Ethernet: заголовки протокола исходящих фреймов
			IPDSD	IP-данные: передача dual-port-ram
			IPDRV	IP-данные: прием dual-port-ram
			TCP	TCP-данные (Transmission Control Protocol)
			TPI	TPI-данные
			для DA, DB, DF, DL, DN:
			ALL	все объекты
			ETHRV	драйвер Ethernet: заголовки протокола входящих фреймов
			ETHSD	драйвер Ethernet: заголовки протокола исходящих фреймов
			LAN	все объекты ЛВС: ETHRV, ETHSD, TCP, TPI, IPDSD, IPDRV
			OS	SD и RCV
			RCV	все сообщения из точки трассировки RCV
			SD	все сообщения из точки трассировки   SD
			TCP	TCP-данные (Transmission Control Protocol)
			TPI	TPI-данные
	Значение по умолчанию	:	OS
UNIT	Используется в команде P
	Процессор, к которому относится AMO
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	A1	ADS
VAL	Используется в командах: DA, DB, DF, DL, DN, SELMSG;
	Значение, с которым для выбора сравнивается заданное поле.
	несколько одиночных значений должны рассматриваться как логическое   OR
	Тип ввода	:	одиночное значение,
			объединенные одиночные значения  и/или  диапазон
			обязательное в SELMSG
			необязательное в DA, DB, DF, DL, DN
	Возможные значения	:	шестнадцатеричные значения  00 - FF.
WRAP	Используется в командах: ON;
	указывает, должен ли перезаписываться файл трассировки
	Тип ввода	:	одиночное значение, обязательное
	Возможные значения	:	Y	перезапись файла
			N	если  файл заполнен, данные записываются только в буфер трассировки

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

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

F01:	НЕДОПУСТИМЫЙ УКАЗАТЕЛЬ ЧТЕНИЯ
F02:	НЕДОПУСТИМАЯ ТОЧКА ТРАССИРОВКИ В ПРОЦЕССОРЕ
F03:	ЗАПИСИ С ЭТИ НОМЕРОМ НЕТ В БУФЕРЕ
F04:	НЕДОПУСТИМЫЙ ВЫБОР ДЛЯ ЭТОЙ ТОЧКИ ТРАССИРОВКИ
F05:	СЛИШКОМ БОЛЬШАЯ ДЛИНА
F06:	СВЯЗЬ С ТРАССИРОВЩИКОМ В <xxxxx> НЕВОЗМОЖНА
F07:	ТРАССИРОВЩИК УЖЕ ЗАПУЩЕН; УСЛОВИЕ ПУСКА В РЕЖИМЕ ОЖИДАНИЯ
F08:	НЕВОЗМОЖНО ЗАДАТЬ ТОЧКУ ТРАССИРОВКИ
F09:	УСЛОВИЕ COND = ALL НЕДОПУСТИМО С ПУСКОМ ИЛИ ОСТАНОВКОЙ
F10:	ФУНКЦИЯ НЕДОПУСТИМА ИЗ-ЗА ОТКЛЮЧЕНИЯ ПРЕРЫВАНИЙ
F11:	НЕВЕРНАЯ АДРЕСНАЯ ИНФОРМАЦИЯ, НЕДОПУСТИМЫЙ ИНДЕКС БАЗЫ ДАННЫХ
F12:	НЕТ АДРЕСА ИЛИ НЕПОЛНЫЙ АДРЕС
F13:	НЕТ ДОПУСТИМОГО СЕЛЕКТОРА
F14:	НЕТ СЕЛЕКТОРА ШЛЮЗА ИЛИ ШЛЮЗ НЕ В GTD
F15:	ЗАДАННЫЙ ШЛЮЗ ВЫЗОВОВ НЕ МОЖЕТ БЫТЬ ЗАДАН В КАЧЕСТВЕ ТОЧКИ ТРАССИРОВКИ
F16:	НОМЕР LTG ПРЕВЫШАЕТ XX
F17:	НОМЕР LTU ПРЕВЫШАЕТ XX
F18:	НОМЕР ЛИНИИ ПРЕВЫШАЕТ XXXX
F19:	НЕДОПУСТИМЫЙ АДРЕС ПЛАТЫ ИЛИ ЛИНИЯ НЕ СКОНФИГУРИРОВАНА
F20:	ИЕРАРХИИ В FLEX-ADR НЕДОСТАТОЧНО ДЛЯ АДРЕСАЦИИ
F21:	НЕВОЗМОЖНО СБРОСИТЬ ТОЧКУ ТРАССИРОВКИ
F22:	НЕ УДАЛОСЬ СОЗДАТЬ ФАЙЛ - СТАТУС @@@@H
F23:	НЕ УДАЛОСЬ ОТКРЫТЬ ФАЙЛ - СТАТУС @@@@H
F24:	ОШИБКА ПРИ ИСКЕ В ФАЙЛЕ - СТАТУС @@@@H
F25:	ОШИБКА ПРИ ЧТЕНИИ ИЗ ФАЛА - СТАТУС @@@@H
F26:	ОШИБКА ПРИ ЗАПИСИ В ФАЙЛ - СТАТУС @@@@H
F27:	ОШИБКА ПРИ ЗАКРЫТИИ ФАЙЛА - СТАТУС @@@@H
F28:	ОШИБКА ПРИ СОЗДАНИИ СЕГМЕНТА - СТАТУС @@@@H
F29:	ФАЙЛ НЕ СОДЕРЖИТ ДАННЫХ ТРАССИРОВКИ
F30:	ФАЙЛ СОДЕРЖИТ ДАННЫЕ ТРАССИРОВКИ SWU. ИСПОЛЬЗУЙТЕ AMO TRACS
F31:	ТРАССИРОВЩИК АКТИВИЗИРОВАН.
	ВОССТАНОВЛЕНИЕ ДАННЫХ ТРАССИРОВКИ ВОЗМОЖНО ПОСЛЕ ДЕАКТИВИЗАЦИИ.
F32:	НЕВОЗМОЖНО ЗАДАТЬ ВЫБОР ЛВС ДЛЯ: @@@@@
F33:	ТОЧКА ТРАССИРОВКИ <xxxxxxx> НЕ ЗАДАНА
F34:	НЕВОЗМОЖНО ВЫПОЛНИТЬ ПРЕОБРАЗОВАНИЕ
F35:	ПРОТОКОЛ ЭТОЙ ПЛАТЫ НЕ ПОДДЕРЖИВАЕТСЯ
F36:	ФУНКЦИЯ НЕ ПОДДЕРЖИВАЕТСЯ APS
F37:	ОШИБКА ПРИ УДАЛЕНИИ ФАЙЛА - СТАТУС @H
F38:	НЕДОПУСТИМО ПРИ ТРАССИРОВКЕ НА ЖЕСТКИЙ ДИСК
F39:	ЗАПИСЬ С НЕПОЛНЫМИ ДАННЫМИ
F40:	ФАЙЛ НЕ СОДЕРЖИТ ТАБЛИЦ ВЫБОРА ТРАССИРОВКИ

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

H01:	В БУФЕРЕ БОЛЬШЕ НЕТ ОБЪЕКТОВ
H02:	НАЧИНАЯ С УКАЗАННОГО МЕСТА ИМЕЕТСЯ ТОЛЬКО <xxxxx> ЗАПИСЕЙ
H03:	AMO TRACA НЕ МОЖЕТ ВЫПОЛНЯТЬСЯ В ОДНОПРОЦЕССОРНЫХ СИСТЕМАХ, ИСПОЛЬЗУЙТЕ AMO TRACS
H04:	ЭТОТ ВЫБОР ВКЛЮЧАЕТ УСЛОВИЯ XX И XX
H05:	В ЭТОМ КОНТЕКСТЕ ЗНАЧЕНИЕ ОЗНАЧАЕТ ОТСУТСТВИЕ ПРЕДЕЛА
H06:	ТРЕБУЕМАЯ ФУНКЦИЯ НЕДОСТУПНА
H07:	ТЕПЕРЬ КОЛИЧЕСТВО (ЦИКЛИЧЕСКИ) ВВОДИМЫХ ОБЪЕКТОВ НЕ ОГРАНИЧЕНО
H08:	БУФЕР ТРАССИРОВКИ ПУСТ
H09:	ОБЪЕКТ НЕ МОЖЕТ БЫТЬ ВЫВЕДЕН ПОЛНОСТЬЮ
H10:	ЗАДАНЫ ТОЧКИ ТРАССИРОВКИ: XXXXX XXXXX XXXXX
H11:	ТОЧКИ ТРАССИРОВКИ ДОПУСТИМЫ В БОЛЬШИНСТВЕ: CP DH PP
H12:	ДЛИНА УМЕНЬШЕНА ДО МАКСИМАЛЬНО ДОПУСТИМОЙ
H13:	НЕТ ГРУПП ДЛЯ ПОСЛЕДУЮЩЕГО ВЫБОРА. ВВОД НЕ ИМЕЕТ ЗНАЧЕНИЯ
H14:	НЕ ВЫПОЛНЕНО ДЛЯ TPT @@, НЕ ЗАДАН ВЫБОР ДЛЯ G@
H15:	ЗАПИСЬ БУФЕРА ТРАССИРОВКИ ЗАВЕРШЕНА
H16:	ЧТЕНИЕ БУФЕРА ТРАССИРОВКИ ЗАВЕРШЕНО
H17:	ФАЙЛ УЖЕ СУЩЕСТВУЕТ. ПЕРЕПИСАТЬ? (Д/Н)
H18:	БУФЕР ТРАССИРОВКИ НЕ ПУСТ. ПЕРЕПИСАТЬ? (Д/Н)
H19:	СОЗДАН '<xxxxxxxxxxxxxxxxxxx>' С <xxxxxx> КБ
H20:	ЧИСЛО СУЩЕСТВУЕТ В БЛОКАХ <xxx> <xxx> <xxx> <xxx> <xxx> <xxx>
H21:	ЭТА КОМАНДА РАБОТАЕТ ТОЛЬКО С ПОСЛЕДНИМ БЛОКОМ
H22:	ЭТА КОМАНДА РАБОТАЕТ ТОЛЬКО С ТЕКУЩИМ БЛОКОМ
H23:	ЗАПИСЬ ТАБЛИЦ ВЫБОРА ТРАССИРОВКИ ЗАВЕРШЕНА
H24:	ЧТЕНИЕ ТАБЛИЦ ВЫБОРА ТРАССИРОВКИ ЗАВЕРШЕНО
H25:	ИСПОЛЬЗУЙТЕ КОМАНДУ DISPLAY
H26:	НЕВЕРНЫЙ ВВОД