Dateien kopieren von einer Kennung in eine andere Kennung (ONX COPY)

ONXCOPY ':x:$user-id1.'=':y:$user-id2.' [, STD] [, KD]

	Diese Variante der Variablen Action COPY hat zur Voraussetzung, daß die Dateien durch Eingabe von FSTAT $user-id1. im Feld FILENAME-SELECT selektiert wurden oder daß die CFN-Option (Complete FileNames) aktiv ist.

	Die Variable Action bewirkt, daß alle durch X markierten Dateien aus der Kennung $user-id1. und PVS :x: in die Kennung $user-id2. und den PVS :y: kopiert werden.

ONXCOPY '' = '$user-id.' [, vsn/device | :x: [,smspar] ] [, STD] [, KD]

	Die angekreuzten Dateien werden von der selektierten Benutzerkennung in die in der ONXCOPY-Anweisung angegebene Kennung ($user-id.) kopiert. Die kopierten Dateien erhalten dabei bis auf die neue Benutzerkennung die gleichen Namen wie die Ursprungsdateien.

	vsn/device	Die kopierten Dateien werden auf der angegebenen Privatplatte eingerichtet.

	:x:	Die kopierten Dateien werden in dem angegebenen Public-Volume-Set eingerichtet.

	smspar	Falls die kopierte Datei auf einem SM-Pubset (System Managed Pubset) angelegt wird, so kann mit diesem Parameter in Abhängigkeit von den Vorgaben des Systemverwalters der Ablageort (Volume-Set) der Datei genauer bestimmt werden.

		Falls vor smspar der Parameter :x: nicht angegeben wurde, so bezieht sich smspar auf den Default-Pubset der Benutzerkennung.

		STORAGE-CL=class

		Name einer vom Systemverwalter eingerichteten Storage Klasse. Über die Storage Klasse wird das Volume-Set der Datei und damit die Speichereigenschaften wie z.B. Performance Attribute, Availability festgelegt.

		VOLUME-SET=vset

		Bestimmt das Volume-Set, auf dem die Datei innerhalb des SM-Pubsets eingerichtet werden soll. Der Systemverwalter kann mit *CONTROL bzw. mit der Angabe einer ein- bis vierstelligen Cat-Id vset (ohne ':') einen Volume-Set explizit angeben.

		Der nichtprivilegierte Benutzer kann einen Volume-Set nur dann angeben, wenn ihm der Systemverwalter das Recht zur physikalischen Allokierung gegeben hat.

		WORK-FILE=YES|NO

		Gibt an, ob die Datei eine Arbeitsdatei ist, die von der Systemverwaltung zu einem bestimmten Zeitpunkt gelöscht werden darf. Work-Dateien werden auf einem Volume-Set abgelegt, für das der Systemverwalter die Nutzungsart WORK vorgegeben hat.

	STD	Vorbemerkung: Beim Kopieren von Dateien mit der Variablen Action ONXCOPY werden die Schutzattribute der Quelldateien wie z.B. ACCESS=READ, RETPD oder Passworte auf die Zieldateien übertragen (COPY ..,SAME). Unter TSOS setzt CFS zusätzlich alle für den lesenden Zugriff auf die Quelldateien und den schreibenden Zugriff auf die Zieldateien notwendigen Passworte ab. Weitere Schutzattribute der mit Copy zu überschreibenden Zieldateien wie ACCESS=READ und RETPD>0 werden von CFS zum Zwecke des Kopierens kurzzeitig zurückgesetzt. Gleiches gilt auch für die Variable Action ONXMOVE.

	Der Operand STD in der Variablen Action ONXCOPY bewirkt zweierlei:

	1)	Die Quelldateien werden nicht mit dem Parameter "COPY ...,SAME" kopiert, d.h. die Schutzattribute der Quelldateien werden nicht auf die Zieldateien übertragen.

	2)	Die Schutzattribute der Dateien werden durch CFS auch unter der Kennung TSOS nicht umgangen. Es können somit nur die Dateien kopiert werden, für die der Benutzer zuvor die zum Lesen und Überschreiben benötigten Passworte abgesetzt hat. Darüber hinaus können Zieldateien durch COPY nicht überschrieben werden, falls diese bereits existieren und mit ACCESS=READ oder RETPD>0 geschützt sind.

	KD	Keep Date. Beim Kopieren wird das Change Date der Originaldateien auf die Zieldateien übertragen. Die kopierten Dateien erhalten somit das gleiche Change Date wie die Ursprungsdateien und nicht das Datum des heutigen Tages. Die KD-Option ist unwirksam, falls Dateien auf eine Privatplatte kopiert werden.

		Bei eingeschaltetem KLA-Modus (Kommando (KLA) ) wird zusätzlich das Last Access Date der Eingabe- und Ausgabe-Datei wieder hergestellt.

		Beispiele:	$ABC. = selektierte Benutzerkennung.

		ONXCOPY''='$USER2.'	$ABC.name -->   $USER2.name

		ONXCOPY':X:'=':Y:'	:X:$ABC.name -->   :Y:$ABC.name

		ONXCOPY''='A.'	$ABC.name -->   $ABC.A.name

		ONXCOPY''=''	$ABC.name -->   name (eigene Kennung)

		ONXCOPY' '='.X'	$ABC.name -->   $ABC.name.X

		ONXCOPY' '='.X',:A100: [:xxx:]$ABC.name -->   :A100:$ABC.name.X

	Hinweise:

	Mit der Variablen Action ONXCOPY können unter TSOS auch Katalogeinträge für Banddateien zwischen verschiedenen Kennungen und/oder Public-Volume-Sets kopiert werden, ohne daß die entsprechenden Bandvolumes zum Mounten angefordert werden.

	Das automatische Absetzen von Passworten ist auch in BS2000-Systemen mit Passwortverschlüsselung anwendbar (ENCRYPT=YES).

ONXCOPY :x: [, STD] [, KD]

	Die angekreuzten Dateien werden auf den angegebenen Pubset kopiert.

	Die Dateien werden auf dem neuen Pubset unter der gleichen Kennung wie die Ursprungsdateien angelegt.

	Diese Variante der Variablen Action ONXCOPY hat die gleiche Wirkung wie ONXMOVE, mit dem Unterschied, daß die Ursprungsdateien nicht gelöscht werden.

	:x:	Public-Volume-Set der Zieldateien.

		Beispiel:	ausgewählte Dateien: NP USER-ID=:X:USER2

		ONXCOPY :RST:	:X:$USER2.name -->   :RST:$USER2.name

ONXCOPY '$user-id.' | ':x:'

	Die angekreuzten Dateien werden überschrieben durch gleichnamige Dateien aus der Benutzerkennung $user-id. bzw. aus dem PVS :x:.

	$user-id.	Benutzerkennung der Quelldateien.

	:x:	Public-Volume-Set der Quelldateien.

		Beispiele:	ausgewählte Dateien: NP USER-ID=:R:

			d.h. alle Dateien der eigenen Kennung auf PVS R.

		ONXCOPY':X:'	:X:name -->   :R:name

		ONXCOPY'$USER2.'	$USER2.name -->   :R:name