1.107 TEST - регрессивные проверки, AMC, UT, TT

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

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

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

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

1.	ENDWRITE (только конец записи);

2.	WRITE on DIALOG DEVICE (запись на устройство "Диалог");

3.	WRITE ON ERROR DEVICE (запись на устройство "Ошибка");

4.	WRITE ON RESULT DEVICE (запись на устройство "Результат");

5.	RESERVATION/RELEASE of ERROR DEVICE (резервирование/освобождение устройства "Ошибка");

6.	только RESERVATION of ERROR DEVICE (резервирование устройства "Ошибка");

7.	RESERVATION/RELEASE of DIALOG DEVICE (резервирование/освобождение устройства "Ошибка");

8.	только RESERVATION of DIALOG DEVICE (резервирование устройства "Ошибка");

9.	сообщение PROMPT ("Приглашение");

10.	сообщение DIALOG ("Диалог");

11.	сообщение WRITE/READ ("Запись/считывание");

12.	TIMER (таймер на 15 секунд);

13.	LOGON INTERNAL (внутренний вход в систему);

14.	INTERNAL START (внутренний старт - вызов функции 15);

15.	для функции 14;

16.	сообщение для задания;

17.	порядок выполнения функций 1...14.

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

Настоящее описание относится к версиям, начиная с SP300-V3.4.

1.107.2 Взаимосвязанные команды

При выполнении функции 16 AMO TEST также поддерживает связь с указанным заданием. Это делается посредством базового индекса почтового ящика и идентификации процессора, либо по имени почтового ящика через процессоры.

1.107.3 Функции AMO

EXEC-TEST	:	начало проверки.
DIALOG01-TEST	:	запрос на автоматический диалоговый ввод для функций 10 и 11.
DIALOG02-TEST	:	запрос на автоматический диалоговый ввод для функции 16.

1.107.3.1 EXEC-TEST

Примечания

1.

При выполнении функций 1...14 команда AMO TEST выполняется в режиме опроса. После завершения соответствующей функции выполнение команды прекращается .

2.

При выполнении функции 16 команда AMO в течение нескольких минут остается в диалоговом режиме. Если за это время оператор не введет новых данных, выполнение команды прекращается с A&M ORG. В диалоговом режиме выполнение этой команды прекращает пользователь, введя 'E'.

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

Код команды	Параметр
EXEC-TEST	UNIT=<параметр>
	,FUNCT=1&&15&99,[PROMPT=<цифры>]; (1)
	|,FUNCT=16,RECEIVER=<имя>,[IB=<цифры>]; (2)

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

Код команды	Параметр
EXEC-TEST	UNIT=<параметр>
	,FUNCT=1&&15&99,[PROMPT=<цифры>]; (1)
	|,FUNCT=16,CATALOG=<параметр> (2)
	,CATTYPE=INDEX,MBXIDX=<параметр>,DESTPROC=<параметр> (3)
	,[MSGSIZE=<цифры>],[IB=<цифры>]
	,[PAUSE=<цифры>];
	|,CATTYPE=NAME,MBXNAME<имя> (4)
	,[MSGSIZE=<цифры>],[IB=<цифры>]
	,[PAUSE=<цифры>];

Пример

Для отображения функций на сервер административного управления и данных выводится полный пакет команд для АМО.

Шаг проверки 1: ENDWRITE (только конец записи).

Ввод:

EXEC-TEST:A1,1,0; 

Вывод:

   EXEC-TEST:A1,1,0; 
  
   H500:  AMO TEST  STARTED 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 2: WRITE on DIALOG (запись на "Диалог").

Ввод:

EXEC-TEST:A1,2; 

Вывод:

   EXEC-TEST:A1,2; 
  
   H500:  AMO TEST  STARTED
  
   M2: WRITE-MESSAGE AT  "DIALOG" 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT

   EXEC COMPLETED; 

Шаг проверки 3: WRITE on ERROR (Запись на "Ошибка").

Ввод:

EXEC-TEST:A1,3; 

Вывод:

   EXEC-TEST:A1,3; 
  
   H500:  AMO TEST  STARTED 
  
   M2: WRITE-MESSAGE AT  "ERROR" 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED; 

Шаг проверки 4: WRITE on RESULT (запись на устройство "Результат").

Ввод:

EXEC-TEST:A1,4; 

Вывод:

   EXEC-TEST:A1,4; 
  
   H500:  AMO TEST  STARTED 
  
   M2: WRITE-MESSAGE AT  "RESULT" 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED; 

Шаг проверки 5 : RESERVATION/REL. of ERROR  (резервирование/освобождение устройства "Ошибка").

Ввод:

EXEC-TEST:A1,5; 

Вывод:

   EXEC-TEST:A1,5; 
  
   H500:  AMO TEST  STARTED 
  
   M3: RESERVE SYMBOLIC DEVICE "ERROR" 
  
   M2: WRITE-MESSAGE AT  "ERROR" - (ERROR RESERVED) 
  
   M2: WRITE-MESSAGE AT  "ERROR" - (RESERVATION RELEASED) 
  
   M1: ENDWRITE-MESSAGE AT  "ERROR" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED; 

Шаг проверки 6: RESERVATION of ERROR (только резервирование устройства "Ошибка").

Ввод:

EXEC-TEST:A1,6; 

Вывод:

   EXEC-TEST:A1,6; 
  
   H500:  AMO TEST  STARTED 
  
   M3: RESERVE SYMBOLIC DEVICE "ERROR" 
  
   M1: ENDWRITE-MESSAGE AT  "ERROR" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 7: RESERVATION/REL. of DIALOG (резервирование/освобождение устройства "Диалог").

Ввод:

EXEC-TEST:A1,7; 

Вывод:

   EXEC-TEST:A1,7; 
  
   H500:  AMO TEST  STARTED 
  
   M3: RESERVE SYMBOLIC DEVICE "DIALOG" 
  
   M2: WRITE-MESSAGE AT  "DIALOG" - (DIALOG RESERVED) 
  
   M2: WRITE-MESSAGE AT  "DIALOG" - (RESERVATION RELEASED) 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 8 : RESERVATION of DIALOG (только резервирование устройства "Диалог").

Ввод:

EXEC-TEST:A1,8; 

Вывод:

   EXEC-TEST:A1,8; 
  
   H500:  AMO TEST  STARTED 
  
   M3: RESERVE SYMBOLIC DEVICE "DIALOG" 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 9: сообщение PROMPT ("Приглашение").

Ввод:

EXEC-TEST:A1,9; 

Вывод:

   EXEC-TEST:A1,9; 
  
   H500:  AMO TEST  STARTED 
  
   M4: PROMPT-MESSAGE 
  
   M5: PLEASE INPUT A DIGIT FROM 0 TO 9 
  
   PROMPT = 

Ввод:

0 

Вывод:

   M10: 0 HAS BEEN ENTERED 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 10: сообщение DIALOG ("Диалог").

Ввод:

EXEC-TEST:A1,10; 

Вывод:

   EXEC-TEST:A1,10; 
  
   H500:  AMO TEST  STARTED 
  
   M6: DIALOG-MESSAGE 
  
   M7: TERMINATE WITH ";" OR INPUT A DIGIT FROM 0 TO 9 
  
   <DIALOG01-TEST: 

Ввод:

5 

Вывод:

   M10: 5 HAS BEEN ENTERED 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 11: сообщение WRITE/READ ("Запись/считывание").

Ввод:

EXEC-TEST:A1,11; 

Вывод:

   EXEC-TEST:A1,11; 
  
   H500:  AMO TEST  STARTED 
  
   M8: WRITE/READ-MESSAGE 
  
   M9: PLEASE INPUT A DIGIT FROM 0 TO 9 
  
       DIGIT = 

Ввод:

1; 

Вывод:

   M10: 1 HAS BEEN ENTERED 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 12: таймер на 15 секунд.

Ввод:

EXEC-TEST:A1,12; 

Вывод:

   EXEC-TEST:A1,12; 
  
   H500:  AMO TEST  STARTED 
  
   M13: CALL TIMER WITH 15 SEC 
  
   M2: WRITE-MESSAGE AT  "DIALOG" - (TIMER TIMEOUT) 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 13: LOGON INTERNAL (внутренний вход в систему).

Ввод:

EXEC-TEST:A1,13; 

Вывод:

   EXEC-TEST:A1,13; 
  
   H500:  AMO TEST  STARTED 
  
   M14: PERFORM LOGON-INTERN 
  
   M2: WRITE-MESSAGE AT  "RESULT" 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 14: INTERNAL START (внутренний старт).

Ввод:

EXEC-TEST:A1,14; 

Вывод:

   EXEC-TEST:A1,14; 
  
   H500:  AMO TEST  STARTED 
  
   M15: INTERNAL START EXECUTED BY USER TASK 
  
   EXEC-TEST:"A1",15; 
  
   H500:  AMO TEST  STARTED 
  
   M2: WRITE-MESSAGE AT  "DIALOG" - (BY USER-TASK) 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" - (BY USER-TASK) 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED; 
  
   M1: ENDWRITE-MESSAGE AT  "DIALOG" 
  
   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED; 

Шаг проверки 15: функции внутреннего старта в пакете команд не нужны.

Шаг проверки 16: отправка сообщения для задания.

Возможны следующие задания:
ACT, AMCA1, AMCSWU, CPSWU, DEPS, SIT, TT, DC, TO, FA, FALTG, RTO, HL, PIT

Ввод:

EXEC-TEST:A1,16,SIT,00; 

Вывод:

   EXEC-TEST:A1,16,SIT,00; 
  
   H500:  AMO TEST  STARTED 
  
   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
   * 

Ввод:

"3A,54,00,00,11,14,01" 

Вывод:

   F4421 M4 N0387 NO ACT   BPA   VECO     STATISTIC CC           00-00-00 00:00:00 
         DEV CLASS:00000000 0000 0000000000000000 0000000000000000 000000 
         FORMAT:0 
   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
   * 

Ввод:

E 

Вывод:

   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Ввод:

EXEC-TEST:A1,16,OTTO,00; 

Вывод:

   EXEC-TEST:A1,16,OTTO,00; 
  
   H500:  AMO TEST  STARTED 
  
   F1: NAME OF TASK UNKNOWN 
       MESSAGES CAN BE SENT TO FOLLOWING TASKS : 
       ACT, AMCSWU, AMCA1, CPSWU, DEPS, TT, SIT, 
       DC, TO, FA, FALTG, RTO, HL, PIT 
  
   RECEIVER = 

Ввод:

SIT 

Вывод:

   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
* 

Ввод:

11 

Вывод:

   F1010 E4 N0362 HINWEIS  SIT   TOP     SOURCE TASK UNKNOWN    87-07-17 17:38:42 
         DEV CLASS:01000000 0000 0000000000000000 0000000000000000 000000 
         FORMAT:-- 
         1100 0000 0000 0000  0000 0000 0000 0000 
         0000 0000 0000 0000  0000 0000 0000 0000 
         0000 0000 0000 0000  0000 0000 0000 0000 
         0000 0000 0000 0000  0000 0000 0000 0000 
  
   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
   * 

Ввод:

E 

Вывод:

   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

Шаг проверки 16: отправка сообщения для задания.

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

идентификатором каталога (CATALOG), в котором числится почтовый ящик задания;

именем почтового ящика задания (MBXNAME), либо значением элемента задания из DB_M_BASIC_MBX_IDX_SET (MBXIDX) и идентификатором процессора-получателя (DESTPROC).

Примечание:

Почтовый ящик задания сигнализации, который используется в данном примере, каталогизирован по имени и индексу в системном каталоге System Catalog.

Ввод:

EXEC-TEST:A1,16,SYSTEM,INDEX,01,A1,FF,00; 
or 
EXEC-TEST:A1,16,SYSTEM,NAME,SITMBOX,FF,00; 

Вывод:

   EXEC-TEST:A1,16,SYSTEM,INDEX,01,A1,FF,00; 
   or 
   EXEC-TEST:A1,16,SYSTEM,NAME,SITMBOX,FF,00; 
  
   H500:  AMO TEST  STARTED 
  
   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
   * 

Ввод:

"3A,54,00,00,11,14,01"

Вывод:

   F4421 M4 N0387 NO ACT   BPA   VECO     STATISTIC CC           00-00-00 00:00:00 
         DEV CLASS:00000000 0000 0000000000000000 0000000000000000 000000 
         FORMAT:0 
  
   M17: PLEASE INPUT MESSAGE STRING      ( TERMINATE AMO WITH "E" ) 
  
   * 

Ввод:

E 

Вывод:

   AMO-TEST-...        REGRESSION TESTS, AMC,UT,TT 
   EXEC COMPLETED;

1.107.3.2 DIALOG01-TEST

Запуск процедуры

Оператор DIALOG01 используется в шаге DIALOG только при выполнении функции 10 и в шаге WRITE-READ при выполнении функции 11. Ввести его на терминале обслуживания (AMT) невозможно - на этом терминале пользователь видит лишь DIALOG01-TEST (при выполнении DIALOG) или символ звездочки "*" (при выполнении WRITE-READ), который заменяет пользовательское приглашение.

1.107.3.3 DIALOG02-TEST

Выполнение процедуры

Оператор DIALOG02 используется только для WRITE-READ при выполнении функции 16; ввести его на терминале обслуживания (AMT) невозможно. На этом терминале пользователь видит только звездочку, которая заменяет пользовательское приглашение.

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

CATALOG	Каталог, куда занесен почтовый ящик для задания, которому посылается сообщение.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	MODUL	Почтовый ящик включен в каталог модуля.
			SYSTEM	Почтовый ящик включен в системный каталог.
CATTYPE	Порядок каталогизации почтового ящика для задания, которому посылается сообщение.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	NAME	По имени.
			INDEX	По индексу.
DESTPROC	Идентификация процессора, которому направляется сообщение.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	A1	ADS.
			BPA	Базовый процессор A.
			BPB	Базовый процессор B.
			BPS	Базовый процессор в режиме готовности.
			C1	Сервер начисления оплаты вызовов.
			GP1A	Групповой процессор 1 A.
			GP1B	Групповой процессор 1 B.
			.	.
			.	.
			GP32A	Групповой процессор 32 A.
			GP32B	Групповой процессор 32 B.
			T1	Телекоммуникационная служба 1.
			T2	Телекоммуникационная служба 2.
			T3	Телекоммуникационная служба 3.
			V1	Служба голосовой почты 1.
			V2	Служба голосовой почты 2.
			V3	Служба голосовой почты 3.
DIGIT	Тестовый параметр для сообщений DIALOG и WRT/READ.
	Основной параметр при выполнении шагов проверки 10 и 11.
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	от 0 до 9
FUNCT	Выбор функции.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	от 1 до 15, 16, 99.
			Пояснения значений приводятся в обзоре функций.
IB	Инициализация значений для байтов сегмента сообщения.
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	Если данный необязательный параметр не указан, байты сегмента сообщения, которые не включены в параметр MSG, остаются не определенными.
MBXIDX	Базовый индекс почтового ящика задания, в который должно поступить данное сообщение (см. DB_M_BASIC_MBX_IDX_SET).
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	от 00 до FF (Hex).
MBXNAME	Имя почтового ящика задания, в который должно поступить данное сообщение.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	от 1 до 7 алфавитно-цифровых символов.
MSG	Сообщение для задания-получателя.
	Строка сообщения, шестнадцатеричная. .
	Основной параметр для шага проверки 16.
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	от 00 до FF (Hex); "hh,hh,.....";
			Значение строки сообщения зависит от его интерпретации заданием.
MSGSIZE	Размер сегмента сообщения..
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	от 00 до FFFF (Hex).
	Если MSGSIZE не задано, размер сегмента сообщения определяется непосредственно по количеству содержащихся в нем байтов.
PAUSE	Задержка в секундах перед следующим сообщением.
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	от 0 до 60.
	Значение по умолчанию	:	0
PROMPT	Тестовый параметр для приглашения AMO.
	Тестовый параметр, используемый по необходимости в автодиалоге.
	Используется также при выполнении функции 9.
	Тип ввода	:	одиночное значение, необязательное.
	Возможные значения	:	от 0 до 9.
RECEIVER	Задание-получатель.
	Задание, которому АМО направляет сообщение.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	ACT, AMCA1, AMCSWU, CPSWU, DEPS, TT, SIT, DC и т.д.
			Если указывается неизвестное задание, AMO выводит на дисплей текущий список заданий.
			Пример:	EXEC-TEST:A1,16,OTTO,0;
UNIT	Функциональный системный элемент, то есть, коммутационное устройство или сервер.
	Тип ввода	:	одиночное значение, обязательное.
	Возможные значения	:	A1	ADS.
			BP	Активный базовый процессор.
			BPA	Базовый процессор А.
			BPB	Базовый процессор В.
			BPS	Базовый процессор в режиме готовности.
			C1	Сервер начисления оплаты вызовов.
			GP0	Активный групповой процессор 0.
			GP0A	Групповой процессор 0 А.
			GP0B	Групповой процессор 0 В.
			GP0S	Групповой процессор 0 в режиме готовности.
			.	.
			.	.
			GP31	Активный групповой процессор 31.
			GP31A	Групповой процессор 31 А.
			GP31B	Групповой процессор 31 В.
			GP31S	Групповой процессор 31 в режиме готовности.
			T1	Телекоммуникационная служба 1.
			T2	Телекоммуникационная служба 2.
			T3	Телекоммуникационная служба 3.
			V1	Служба голосовой почты 1.
			V2	Служба голосовой почты 2.
			V3	Служба голосовой почты 3.

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

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

F01:	НЕИЗВЕСТНОЕ ИМЯ ЗАДАНИЯ.
	СООБЩЕНИЯ БУДУТ НАПРАВЛЕНЫ СЛЕДУЮЩИМ ЗАДАНИЯМ:
	ACT, AMCSWU, AMCA1, CPSWU, DEPS, TT, SIT,
	DC, TO, FA, FALTG, RTO, HL, PIT
F02:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ОБНАРУЖЕНА ПРИ ПРОВЕРКЕ ДЛИНЫ.
F03:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ДОЛЖНО БЫТЬ ШЕСТНАДЦАТЕРИЧНОЕ ЗНАЧЕНИЕ.
F04:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ДОЛЖНА БЫТЬ ЗАПЯТАЯ.

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

F01:	ПОЧТОВЫЙ ЯЩИК ДЛЯ MBXIDX/DESTPROC ОТСУТСТВУЕТ.
F02:	ПОЧТОВЫЙ ЯЩИК MBXIDX/DESTPROC ОТСУТСТВУЕТ В КАТАЛОГЕ @@@@@.
F03:	MBXNAME ОТСУТСТВУЕТ В КАТАЛОГЕ @@@@@.
F04:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ОБНАРУЖЕНА ПРИ ПРОВЕРКЕ ДЛИНЫ.
F05:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ДОЛЖНО БЫТЬ ШЕСТНАДЦАТЕРИЧНОЕ ЗНАЧЕНИЕ.
F06:	ОШИБКА В СТРОКЕ СООБЩЕНИЯ
	- ДОЛЖНА БЫТЬ ЗАПЯТАЯ.

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

Отсутствуют.

1.107.5.4 Сообщения, выводимые при каждой операции

EXEC           : F01,   F02,   F03,   F04