0.98 FAMUP Обновление дистанционного управления и обслуживания

AMO "FAMUP" управляет блоком логических устройств (LDU) FAMUP (обновление дистанционного управления и обслуживания).
Изменения в APS и каталоге исправлений передаются в сервисный центр через регулируемые интервалы времени.
Кроме того, через регулируемые интервалы времени AMO-FAMUP управляет пакетом AMO.

С помощью параметров может осуществляться управление следующими функциями:

FAMUP Активизация/деактивизация обработки пакета команд AMO.

PROT Параметр PROT управляет включением и выключением распечатки на терминале обслуживания. По желанию абонента обмен данными может протоколироваться. Независимо от параметра PROT, восстановление дополнительно регистрируется в рабочем файле :AMD:FBT/FAMUP/NOUNCO/A. Рабочие файлы трех последних неудачных процедур восстановления хранятся под именами :AMD:FBT/FAMUP/REGENERROR1 (или 2 и 3).

FTRNS Активизация/деактивизация передачи файлов в сервисный центр. Указывает, должны ли передаваться в сервисный центр APS, состояние PATCH при помощи LDU FAMUP .

RUPSTT Время начала обработки пакета AMO. Кроме того, блок логических устройств (LDU) FAMUP осуществляет проверку файла APS-DIR и каталог PATCH на предмет изменений. Затем данные передаются в сервисный центр системой передачи файлов HICOM. Если с момента последнего обновления в каталоге PATCH или в файле APS-DIR изменений не было, передача не производится.

RUPINT Это интервал времени между двумя началами обработки. Этот параметр служит для установки интервалов времени, через которые запускается исполнение AMOCMD, и, соответственно, передача данных, в момент RUPSTT. Он никогда не должен быть равным "0". Наибольший возможный вариант составляет 31 день.

SCNAME Это имя компьютера назначения в сервисном центре SZ. Для передачи данных компьютер назначения должен быть указан для Remote A&M UPDATE в сервисном центре (параметр OSPTNR в AMO FTCSM).

SZLOGON LOGON в компьютере назначения (SZLOGON) состоит из трех разных компонентов: USERID, ACCT, PASSWORD.

SUCCPROC Имя файла процедуры DO для пост-обработки данных после успешной передачи

FAILPROC Имя файла процедуры DO для пост-обработки данных после неудачной передачи

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

Это описание действительно начиная с ATLANTIC-R6.3

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

Отсутствуют

0.98.3 Функции AMO

ADD-FAMUP	:	Добавление параметров или команда AMO
CHANGE-FAMUP	:	Изменение параметров
DELETE-FAMUP	:	Удаление определенных записей AMOCMD-TAB
DISPLAY-FAMUP	:	Опрос параметров или AMOCMD-TAB
OUTPUT-FAMUP	:	Вывод значений, введенных LDU FAMUP в базу данных
REGENERATE-FAMUP	:	Восстановление параметров
ACTIVATE-FAMUP	:	Активизация FAMUP, PROT и FTRNS
DEACTIVATE-FAMUP	:	Деактивизация FAMUP, PROT и FTRNS
START-FAMUP	:	Ручной запуск процесса UPDATE

0.98.3.1 ADD-FAMUP

Создание списка параметров для блока логических устройств (LDU) FAMUP или таблицы выбора. Параметр ветвления TYPE используется для того, чтобы различать между списком параметров FAMUP и таблицей команд AMO.
Чтобы FAMUP работала нормально, при создании списка параметров необходимо указать все параметры.
При формировании пакета AMOCMD могут быть созданы до 50 команд AMO (максимальная длина строки = 80 символов). Эти строки передаются задаче пользователя. Операция ADD должна резервироваться для определенной привилегированной группы пользователей.

Параметр SUCCPROC/FAILPROC указывает для LDU FAMUP действительную партнерскую систему.

	запись	назначение
1	xx.NAME *	HTS
2	USR	NCC в PC MX
3	FTH	NCC в HICOM-ADS
4	FTX	NCC в локальной HICOM-ADS

*) Если системой назначения является HTS, необходимо указать всю процедуру пост-обработки. Это имя файла должно начинаться с двухсимвольного префикса (например, W9.). Действительность параметров USERID, ACCOUNT и PASSWORD - в зависимости от системы назначения.

	USERID	ACCOUNT	PASSWORD
1	X	X	X
2	X	---	X
3	---	---	---
4	---	---	---

Анализируются ячейки, отмеченные знаком X.

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

Код команды	Параметр
ADD-FAMUP	TYPE=LDU,
	,RUPSTT=<number>,RUPINT=<number>,FTSTT=<number>
	,SCNAME=<string>,USERID=<string>,ACCT=<string>
	,PASSWORD=<string>,SUCCPROC=<string>
	,FAILPROC=<string>;
	|TYPE=AMOCMD,AMOCMD=<string>;

Примеры

1.

Создание списка параметров блока логических устройств FAMUP Запуск пакета AMO в 02.00 часа с интервалами в один день; Начало передачи файлов через час в 03.00 Имя компьютера назначения в сервисном центре: N78H02 и LOGON ID компьютера назначения в сервисном центре: FBCLUDI Номер счета: 52B42730 Пароль: C 'xxxxx' Имя файла процедуры DO после успешной передачи: W9.FAMUP.SUCC Имя файла процедуры DO после неудачной передачи: W9.FAMUP.FAIL

Ввод:

ADD-FAMUP:LDU,02-00-01-01-1987,1,03-00,N78H02,FBCLUDI,52B42730,C'xxxxx'; 
              W9.FAMUP.SUCC,W9.FAMUP.FAIL; 

Вывод:

   ADD-FAMUP:LDU,02-00-01-01-1987,1,03-00,N78H02,FBCLUDI,52B42730,C'xxxxx'; 
   W9.FAMUP.SUCC,W9.FAMUP.FAIL; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   ADD COMPLETED 

2.	Добавление AMO DATE в пакет AMO

Ввод:

ADD-FAMUP:AMOCMD,"DISP-DATE;"; 

Вывод:

   ADD-FAMUP:AMOCMD,"DISP-DATE;"; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   ADD COMPLETED 

0.98.3.2 CHANGE-FAMUP

Изменение списка параметров блока логических устройств (LDU) FAMUP. В списке должен быть указан как минимум один параметр.

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

Код команды	Параметр
CHANGE-FAMUP	{RUPSTT=<number>,RUPINT=<number>,FTSTT=<number>
	,SCNAME=<string>,USERID=<string>
	,ACCT=<string>,PASSWORD=<string>
	,SUCCPROC=<string>,FAILPROC=<string>};

Пример

Изменение времени запуска пакета AMO и интервала в днях в списке параметров LDU FAMUP

Ввод:

CHANGE-FAMUP:05-00-02-02-1988,10; 

Вывод:

   CHANGE-FAMUP:05-00-02-02-1988,10; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   CHANGE COMPLETED 

0.98.3.3 DELETE-FAMUP

Удаление записи из таблицы AMOCMD.
Параметр ветвления SEL указывает, удаляется ли одна AMO или же вся таблица AMOCMD.
Посредством "linenr" из таблицы AMOCMD может быть удален номер строки записи (номер строки выводится командой DISPLAY)

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

Код команды	Параметр
DELETE-FAMUP	SEL=ALL;
	|SEL=AMOCMD,linenr=<number>;

Примеры

Ввод:

DELETE-FAMUP:AMOCMD,1; 

Вывод:

   DELETE-FAMUP:AMOCMD,1; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DELETE COMPLETED 

Удаление всей таблицы AMOCMD

Ввод:

DELETE-FAMUP:ALL; 

Вывод:

   DELETE-FAMUP:ALL; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DELETE COMPLETED 

0.98.3.4 DISPLAY-FAMUP

Вывод списка параметров блока логических устройств (LDU) FAMUP и таблицы AMOCMD

Возможности вывода (см. также форматы в примере вывода):

a)

Вывод списка параметров AMO-FAMUP (параметр SEL: PARAM, вывод в формате 1)

b)

Вывод состояния LDU FAMUP Вывод параметров FAMUP, PROT и FTRNS (параметр SEL: STATUS, вывод в формате 2)

c)

Вывод таблицы AMOCMD , ,. При AMOCMD выводится таблица команд AMO. Записи выводятся в табличной форме с указанием номера строки.

d)

Обзор процедуры Код команды Параметр   DISPLAY-FAMUP SEL=PARAM; |SEL=STATUS; |SEL=AMOCMD;

Примеры

1.	Вывод списка параметров LDU FAMUP

Ввод:

DISPLAY-FAMUP:PARAM; 

Вывод:

                                                                        Формат 1 
   DISPLAY-FAMUP:PARAM; 
   H500: AMO FAMUP STARTED 
   UPDATE STARTTIME            RUPSTT   : 02.00-01.01.1987 
  
   INTERVAL IN DAYS            RUPINT   : 01 DAYS 
  
   FILE TRANSFER START TIME    FTSTT    : 03.00 
  
   PARTNER COMPUTER IN SC      SCNAME   : N78H02 
  
   LOGON ID OF DEST. COMPUTER  USERID   : FBCLUDI 
  
   ACCOUNT NO. OF DEST COMP.   ACCT     : 52B42730 
  
   LOGON PWD OF DEST. COMP.    PASSWORD : C'HICOM' 
  
   COMMAND FOR HANDLING OF     SUCCPROC : W9.FAMUP.SUCC 
   SUCCESSFUL TRANSMISSION 
  
   COMMAND FOR HANDLING OF     FAILPROC : W9.FAMUP.FAIL 
   ERRONEOUS TRANSMISSION 
  
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DISPLAY COMPLETED 

2.	Вывод состояния LDU FAMUP

Ввод:

DISPLAY-FAMUP:STATUS; 

Вывод:

                                                                        Формат 2
   DISPLAY-FAMUP:STATUS; 
   H500: AMO FAMUP STARTED 
   PROT  OFF  *****  FAMUP  ON  *****  FTRNS  ON 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DISPLAY COMPLETED 

3.	Вывод полномочий UPDATE для команд AMO таблицы AMOCMD

Ввод:

DISPLAY-FAMUP:AMOCMD; 

Вывод:

                                                                        Формат 3
   DISPLAY-FAMUP:AMOCMD; 
   H500: AMO FAMUP STARTED 
   1 DISP-DATE;

   2 AFR,ADD&CHANGE;

   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DISPLAY COMPLETED 

0.98.3.5 OUTPUT-FAMUP

Вывод значений, введенных LDU FAMUP в базу данных (соответствует текущему состоянию LDU FAMUP)

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

Код команды	Параметр
OUTPUT-FAMUP	;

Пример

Вывод состояния LDU FAMUP

Ввод:

OUTPUT-FAMUP; 

Вывод:

   OUTPUT-FAMUP; 
   H500: AMO FAMUP STARTED 
  
   STATUS OF LDU FAMUP : 
   ===================== 
  
   REGENERATION RUNNING              :   NO 
   LAST REGENERATION SUCCESSFUL      :  YES 
  
   FILE TRANSFER ACTIVATED           :   NO 
  
   LAST MMLCMD TRANSMISSION OK       :  YES 
   LAST APSDIR TRANSMISSION OK       :  YES 
   LAST PATDIR TRANSMISSION OK       :  YES 
  
   DISK ACCESS POSSIBLE              :  YES 
  
   NUMBER OF NOUNS IN THE NOUN FILE  :    1 
  
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   OUTPUT COMPLETED 

0.98.3.6 REGENERATE-FAMUP

Опрос списка параметров блока логических устройств (LDU) FAMUP с выводом в форме команд на восстановление. Вывод осуществляется в форме команд с позиционно-ориентированными параметрами.

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

Код команды	Параметр
REGENERATE-FAMUP	;

Примеры

Восстановление списка параметров LDU FAMUP

Ввод:

REGENERATE-FAMUP; 

Вывод:

   REGENERATE-FAMUP; 
   H500: AMO FAMUP STARTED 
   ADD-FAMUP:LDU,02-00-01-01-1987,01,03-00,"N78H02","FBCLUDI","52B42730"; 
                    "C'HICOM'", 
                    "W9.FAMUP.SUCC", 
                    "W9.FAMUP.FAIL"; 
   ACTIVATE-FAMUP:FAMUP; 
   ACTIVATE-FAMUP:FTRNS; 
   DEACTIVATE-FAMUP:PROT; 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   REGENERATE COMPLETED 

0.98.3.7 ACTIVATE-FAMUP

Активизация исполнения AMOCMD, распечатки и передачи файлов

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

Код команды	Параметр
ACTIVATE-FAMUP	SEL=<param>;

Пример

Ввод:

ACTIVATE-FAMUP:FAMUP&PROT&FTRNS; 

Вывод:

   ACTIVATE-FAMUP:FAMUP&PROT&FTRNS; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   ACTIVATE COMPLETED 

0.98.3.8 DEACTIVATE-FAMUP

Деактивизация исполнения AMOCMD, распечатки и передачи файлов

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

Код команды	Параметр
DEACTIVATE-FAMUP	SEL=<param>;

Пример

Деактивизация функции обновления, распечатки и передачи файлов

Ввод:

DEACTIVATE-FAMUP:FAMUP&PROT&FTRNS; 

Вывод:

   DEACTIVATE-FAMUP:FAMUP&PROT&FTRNS; 
   H500: AMO FAMUP STARTED 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   DEACTIVATE COMPLETED 

0.98.3.9 START-FAMUP

UPDATE запускается вручную путем отправки задания SAVE в почтовый ящик входящих сообщений блока логических устройств (LDU) FAMUP. Все изменения, произведенные к этому времени в статической базе данных, каталоге APS и каталоге PATCH, передаются в сервисный центр SZ. FAMUP и FTRNS должны быть активны. Когда задание SAVE отправлено, AMO FAMUP выдает сообщение.
При указании параметра INIT=Y функция UPDATE инициализируется. Выявляется вся информация, накопленная к этому моменту времени, вместе с номерами версий передачи данных. Затем счет версий передачи обновлений базы данных вновь начинается с 1. Инициализация должна быть запущена немедленно после генерирования командного пакета MMLCMD (исходный генерирующий пакет), который затем хранится в HTS. Первая передача не должна начинаться до того, как будет принят генерирующий пакет.

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

Код команды	Параметр
START-FAMUP	[INIT=N];
	|[INIT=Y],[INS=<param>];

Пример

Ручной запуск UPDATE

Ввод:

STA-FAMUP:Y,Y; 

Вывод:

   START-FAMUP:Y,Y; 
   H500: AMO FAMUP STARTED 
   SAVE JOB SENT TO LDU FAMUP 87-12-31 23:59:59 
   AMO-FAMUP -...   REMOTE ADMINISTRATION & MAINTENANCE UPDATE 
   START COMPLETED 

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

ACCT	Номер счета компьютера назначения
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	см. командный язык BS2000
AMOCMD	Указание команды AMO
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	от 1 до 80 алфавитно-цифровых знаков
FAILPROC	Команда на действия при ошибочной передаче
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	см. ограничения DVS на имя файла в BS2000
FTSTT	Время начала передачи файла
	Тип ввода	:	одиночное значение
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	часы - минуты
			часы:	0 - 23
			минуты:	0 - 59
INIT	Инициализация LDU FAMUP
	Тип ввода	:	одиночное значение
			опционально	(START)
	Возможные значения	:	Y, N
INS	Система, вводимая в эксплуатацию для FAMUP
	Тип ввода	:	одиночное значение
			опционально	(START)
	Возможные значения	:	Y
LINENR	Номер строки вызова AMO
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения		от 1 до 50
PASSWORD	Пароль входа в систему крмпьютера назначения
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	см. командный язык BS2000
RUPINT	Интервал (в днях), с которым должно производиться обновление дистанционного управления
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения		от 1 до 31
RUPSTT	Время начала обновления дистанционного управления
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	часы - минуты
			часы:	1 - 23
			минуты:	0 - 59
			день:	1 - 31
			месяц:	1 - 12
			год:	1980 - 9999
SUCCPROC	Имя файла процедуры, выводимое после успешной передачи
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	см. ограничения DVS на имя файла в BS2000
SCNAME	Взаимодействующий компьютер в сервисном центре
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	все имена должны формироваться без спецсимволов,
			от 1 до 8 алфавитно-цифровых знаков
SEL	Параметр выбора
	Тип ввода	:	одиночное значение,
			обязательно	(ACTIVATE, DEACTIVATE, DELETE, DISPLAY)
	Возможные значения	:	PARAM, AMOCMD, STATUS (DISPLAY)
			ALL, AMOCMD (DELETE)
			FAMUP, PROT, FTRNS (ACTIVATE, DEACTIVATE)
TYPE	Желаемые опции обновления дистанционного обслуживания
	Тип ввода	:	одиночное значение, обязательно
			обязательно	(ADD)
	Возможные значения	:	LDU, AMOCMD
USERID	Идентификатор компьютера назначения
	Тип ввода	:	одиночное значение,
			обязательно	(ADD)
			групповой параметр	(CHANGE)
	Возможные значения	:	см. командный язык BS2000

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

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

F01:	RUPSTT ВНЕ ДИАПАЗОНА ЗНАЧЕНИЙ [ЧЧ-ММ-ДД-ММ-ГГГГ]
F02:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ SCNAME
F03:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ USERID
F04:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ ACCT
F05:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ PASSWORD
F06:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ SUCCPROC
F07:	НЕДЕЙСТВИТЕЛЬНОЕ ЗНАЧЕНИЕ ДЛЯ FAILPROC
F11:	ИМЯ ПРОЦЕДУРЫ ПОСТ-ОБРАБОТКИ МОЖЕТ НАЧИНАТЬСЯ ТОЛЬКО С USR, FTH, FTX ИЛИ ПРЕФИКСА ИЗ 2 ЗНАКОВ
F12:	ГОД, УКАЗАННЫЙ В RUPSTT, ДОЛЖЕН БЫТЬ 1980 ИЛИ БОЛЬШЕ
F13:	ВРЕМЯ НАЧАЛА ПЕРЕДАЧИ ФАЙЛА ВНЕ ДЕЙСТВИТЕЛЬНОГО ДИАПАЗОНА
F14:	ДЕАКТИВИЗИРУЙТЕ FTRNS ПЕРЕД АКТИВИЗАЦИЕЙ FAMUP
F15:	ДЕАКТИВИЗИРУЙТЕ FAMUP ПЕРЕД АКТИВИЗАЦИЕЙ FTRNS

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

H01:	LDU FAMUP ДЕАКТИВИЗИРОВАН, ЗАДАНИЕ SAVE НЕ БУДЕТ ОТПРАВЛЕНО
H03:	ЗАДАНИЕ INIT СЕЙЧАС НЕ МОЖЕТ ОБРАБАТЫВАТЬСЯ ИЗ-ЗА ИДУЩЕГО ПРОЦЕССА ОБНОВЛЕНИЯ
H04:	FAMUP УЖЕ БЫЛА АКТИВИЗИРОВАН
H05:	FAMUP УЖЕ БЫЛА ДЕАКТИВИЗИРОВАН
H06:	ПРОТОКОЛИРОВАНИЕ УЖЕ БЫЛО АКТИВИЗИРОВАНО
H07:	ПРОТОКОЛИРОВАНИЕ УЖЕ БЫЛО ДЕАКТИВИЗИРОВАНО
H08:	FTRNS УЖЕ БЫЛА АКТИВИЗИРОВАНА
H09:	FTRNS УЖЕ БЫЛА ДЕАКТИВИЗИРОВАНА
H10:	КОМАНДА "REGENERATE" В ЭТОМ КОНТЕКСТЕ НЕ ИМЕЕТ СМЫСЛА