0.50 COPY - копирование файлов

AMO COPY обеспечивает копирование файлов и областей жесткого диска с жесткого диска, магнитной ленты и картриджа на жесткий диск, магнитную ленту и картридж и обратно. Имена файлов могут задаваться частично.

Копирование файлов SAM:

Файлы SAM существуют на жестком диске, на магнитной ленте и на картридже. Они копируются при помощи DMS-команд PUT и GET. Когда производится перезапись файлов SAM, они сначала удаляются, а затем создаются снова.

Преобразование типов файлов:

Посредством объявления параметра DESTTYPE файлы SAM могут быть скопированы в байтовые файлы и наоборот. При этом действии, в зависимости от необходимости, удаляются или добавляются поля длины записи. При копировании байтовых файлов в файлы SAM длина записи целевого файла может быть определена посредством объявления параметра RECLEN.

Копирование файлов жесткого диска:

Когда байтовый файл перезаписывается на жесткий диск, файл не удаляется и затем записывается заново, а перезаписывается физически байт за байтом, с уменьшением или увеличением длины, как необходимо. Это означает, что файлы каталога остаются неизменными. Однако, более часто байтовые файлы удлиняются (т.е., перезаписываются на файлы больших размеров), время доступа к файлам при этом увеличивается. По этой причине для пользователя имеется возможность удаления файла, подлежащего перезаписи, используя AMO DEL (Удаление файлов).

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

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

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

Комплекс AMO FIDES	:	Служба файлов и устройств (смотрите, Система AMO, раздел "Система запуска ISY")
AMO RTAPE	:	Резервирование магнитной ленты
AMO DSSM	:	Переключение дисков
AMO DDSM	:	Статус диска

0.50.3 Функции AMO

START-COPY

:

Копирование файлов

0.50.3.1 START-COPY

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

Код команды	Параметр
START-COPY	SRCFILE=<строка>,DESTFILE=<строка>,[UNIT=<парам.>]
	,[DESTTYPE=<парам.>],[RECLEN=<число>]
	,[BLOCKLEN=<число>],[SRCADR=<число>]
	,[DESTADR=<число>],[LEN=<число>],[BUF=<число>]
	,[SRCVOL=<строка>],[DESTVOL=<строка>],[SEL=<парам.>]
	,[WARN=<парам.>],[ANS=<парам.>],[DIALOG=<парам.>];

Пример

Копирование файлов на магнитную ленту. Магнитная лента должна быть зарезервирована при помощи ACT-RTAPE.

Ввод:

START-COPY:":DBD:L31615/S0123X00100/RE/ADS",":M:RE.ADS";

Вывод:

   COPY READY 
   <:DBD:L31516/S0123X00100/RE/ADS> COPIED TO 
   <:M:RE.ADS> 
  
   COPY FINISHED 
   STATUS = H'0000 

Примечание:

Если после ввода команды START-COPY возникает ошибка, устройство должно быть выключено командой DEACT-DSSM. Далее действие копирования выполняется после ввода команды ACT-DSSM.

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

ANS	Ответ/отклик
	Ответ запрашивается, когда параметр SEL=Y.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	Y = копировать файл
			N = не копировать файл
			I = прерывание действия
			C = копирование всех дополнительно заданных файлов
	Значение по умолчанию	:	нет
BLOCKLEN	Размер блоков на целевом устройстве
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	128 - 65535
	Значение по умолчанию	:	4096
BUF	Размер буфера
	Размер буфера копирования в байтах.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	256 - 12000
	Значение по умолчанию	:	4096
DESTADR	Адрес целевого устройства
	Позиция байта, с которой должна начаться запись.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	адрес с максимум 9 позициями
	Значение по умолчанию	:	0
DESTFILE	Целевой файл
	Тип ввода	:	Одно значение
			обязательный
	Возможные значения	:	:PDS:tname2	полностью или частично определенное имя файла жесткого диска
			:C:tname2	полностью или частично определенное имя файла картриджа
			макс. длина 32
DESTTYPE	Тип целевого файла
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	BYTE = байт
			SAMF = файл SAM с фиксированной длиной записи
			SAMV = файл SAM с переменной длиной записи
	Значение по умолчанию	:	то же, что и исходный файл
DESTVOL	Имя целевого тома (только для FD )
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	имя тома с максимум 6 позициями
	Значение по умолчанию	:	' '
DIALOG	Режим диалога
	Должен ли выводиться программами текст на терминал, если вызвана AMO?
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	Y = да
	Значение по умолчанию	:	Y
LEN	Число байтов, которые должны быть скопированы; длина файла
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	макс. 9 позиций (числовое)
	Значение по умолчанию	:	Целый файл
RECLEN	Длина записи файлов SAM
	Длина записей в целевом файле, если исходный файл - файл байтового типа
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	1 - 1020
	Значение по умолчанию	:	128
SEL	Конфигурирование частично определенных имен посредством ответа/отклика Режим выбора. Задает, будут ли запрашиваться записи каждого файла с использованием параметра подсказки ANS или файлы будут копироваться непосредственно.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	Y = да, запрос при помощи параметра ANS
			N = нет, без запроса
	Значение по умолчанию	:	Y
SRCADR	Исходный адрес
	Позиция байта, с которой должно начинаться считывание.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	адрес с максимум 9 позициями
	Значение по умолчанию	:	0
SRCFILE	Исходный файл, отправляемый файл
	Тип ввода	:	Одно значение
			обязательный
	Возможные значения	:	:PDS:tname	полностью или частично определенное имя файла жесткого диска
			:C:tname	полностью или частично определенное имя файла картриджа
			макс. длина 32
SRCVOL	Имя исходного тома (только для FD)
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	имя тома с максимум 6 позициями
	Значение по умолчанию	:	' '
UNIT	Код функционального узла системы, т.е., swu или сервер
	Модуль, в который должна быть загружена AMO.
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	A1	= Сервер управления и данных	(ADS)
	Значение по умолчанию	:	A1
WARN	Предупреждение
	Запрос выполнения перезаписи файлов
	Тип ввода	:	Одно значение
			факультативный
	Возможные значения	:	Y = производится перезапись файла
			N = не производится перезапись файла
	Значение по умолчанию	:	Y

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

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

F01:	ИСХОДНЫЙ ФАЙЛ<srcfile> С ТИПОМ ФАЙЛА "ПЕРЕМЕННЫЙ SAM" НЕ МОЖЕТ БЫТЬ СКОПИРОВАН В ЦЕЛЕВОЙ ФАЙЛ <destfile> С ТИПОМ ФАЙЛА "ФИКСИРОВАННЫЙ SAM"
F02:	SRC ADDR БОЛЬШЕ, ЧЕМ РАЗМЕР ФАЙЛА SRC
F03:	SRCADR + LEN БОЛЬШЕ, ЧЕМ РАЗМЕР SRCFILE LEN:= H'new-len
F04:	АДРЕС ЦЕЛЕВОГО ФАЙЛА СЛИШКОМ ДЛИННЫЙ
F05:	DEST ADDR + LEN БОЛЬШЕ, ЧЕМ РАЗМЕР ЦЕЛЕВОГО УСТРОЙСТВА LEN:=H'len
F06:	УСТРОЙСТВО <device> НЕ МОЖЕТ БЫТЬ ЗАРЕЗЕРВИРОВАНО, ТАК КАК ОНО УЖЕ АКТИВИРОВАНО
F07:	ЦЕЛЕВОЙ ФАЙЛ ЯВЛЯЕТСЯ ФАЙЛОМ КАТАЛОГА
F08:	"ЖЕСТКИЙ" ОСТАНОВ
F09:	ОБА ИМЕНИ ФАЙЛА ДОЛЖНЫ БЫТЬ С ШАБЛОНАМИ ИЛИ БЕЗ ШАБЛОНОВ
F10:	НЕ ДОПУСКАЕТСЯ НАХОЖДЕНИЕ ФАЙЛА И ОБЛАСТИ НА ОДНОМ И ТОМ ЖЕ УСТРОЙСТВЕ
F11:	ТОМ ОТСУТСТВУЕТ НА УСТРОЙСТЕ <devname>
F12:	ТОМ НА УСТРОЙСТВЕ <devname> ЗАЩИЩЕН ОТ ЗАПИСИ

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

H01:	ИСХ. ФАЙЛ <destfile> СУЩЕСТВУЕТ: ПЕРЕЗАПИСАТЬ ?
H02:	ФАЙЛ <datnam> ФИЗИЧЕСКИ ОТКРЫТ ДЛЯ ЗАПИСИ ! СТРУКТУРЫ СУЩЕСТВУЮЩИХ ФАЙЛОВ МОГУТ БЫТЬ ПОВРЕЖДЕНЫ; ПРОДОЛЖИТЬ ?
H03:	РЕЗЕРВИРОВАНИЕ/ВОССТАНОВЛЕНИЕ ЗАВЕРШЕНО С ОШИБКОЙ :H'status ; ОБЫЧНОЕ КОПИРОВАНИЕ (Y (ДА)/N (НЕТ))
H04:	КОПИРОВАНИЕ НАЧАЛОСЬ
H05:	КОПИРОВАТЬ ?
H06:	ЧИСЛО КОПИРУЕМЫХ БАЙТОВ: H'bytes
H07:	КОПИРОВАНИЕ ЗАКОНЧЕНО
H08:	ПРИМЕЧАНИЕ: СКОПИРОВАНЫ НЕ ВСЕ ФАЙЛЫ
H09:	ФАЙЛ <srcfile> СКОПИРОВАН В" <destfile>
H10:	ФАЙЛ <srcfile> СКОПИРОВАН В" <destfile>, НАЧИНАЯ С БАЙТА H'destadr
H11:	ФАЙЛ <srcfile> СКОПИРОВАН, НАЧИНАЯ С БАЙТА H'srcadr, В <destfile>
H12:	ФАЙЛ <srcfile> СКОПИРОВАН, НАЧИНАЯ С БАЙТА H'srcadr, В <destfile>, НАЧИНАЯ С БАЙТА H'destadr