ONXCOPY ['str1'= ... [, vsn/device | [:x:] [,smspar] ] ] [, STD | KD ]
'str1'= ... Namenstransformationsregeln
'str1'='str2' | 'str1'=DP[n][I] | 'str1'=DS[n][I]
'str1'='str2'
Die Namen der kopierten Datenobjekte werden gebildet, indem in den ursprünglichen Namen die Zeichenfolge 'str1' gesucht und durch 'str2' ersetzt wird. Definitionsgemäß wird der String '_' (Hochkomma Leerzeichen Hochkomma) am Ende und der Nullstring '' am Anfang eines jeden Namens gefunden.
'str1'=DP[n][I]
Delete Prefix: Der Name des neuen Datenobjekts wird gebildet, indem im ursprünglichen Namen die Zeichenfolge 'str1' gesucht und der links davorstehende Namensteil bzw. die n links davorstehenden Stellen gelöscht werden. Aufgrund des Zusatzes I wird auch das Suchitem 'str1' gelöscht.
'str1'=DS[n][I]
Delete Suffix: Der Name des neuen Datenobjekts wird gebildet, indem im ursprünglichen Namen die Zeichenfolge 'str1' gesucht und der nachfolgende Namensteil bzw. die n nachfolgenden Stellen gelöscht werden. Aufgrund des Zusatzes I wird auch das Suchitem 'str1' gelöscht. Näheres siehe Seite 5-.
Enthält der ursprüngliche Name die Zeichenfolge 'str1' nicht, so wird die COPY-Operation nicht durchgeführt.
Fehlt die Angabe 'str1'=..., so wird ''='' ergänzt (siehe unten, Beispiel 6).
vsn/device Die kopierten Dateien werden auf der angegebenen Privatplatte eingerichtet.
:x: Die kopierten Dateien werden in dem angegebenen PVS 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.
AVAILABILITY=HIGH
Die Datei soll innerhalb eines SM-Pubsets auf einem Volume-Set abgelegt werden, der erhöhte Ausfallsicherheit besitzt (z.B. durch DRV-gespiegelte Platten).
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 Dieser Parameter ist nur beim Kopieren von Dateien oder Jobvariablen von Bedeutung. Standardmäßig werden von der Variablen Action ONXCOPY die Schutzattribute der Quelldateien wie z.B. ACCESS=READ, RETPD oder Passworte auf die Zieldateien übertragen (COPY ..,SAME).
Der Operand STD bewirkt, daß die Quelldateien nicht mit "COPY ...,SAME" kopiert werden. Die Schutzattribute der Quelldateien werden somit nicht automatisch auf die Zieldateien übertragen.
KD AB BS2000 V8.0: Das Change-Date der Originaldatei wird auf die kopierte Datei übertragen.
Hinweise:
Bibliothekselemente werden unter Namensänderung in der aktuellen Bibliothek kopiert. Intern wird diese Variable Action umgesetzt in ONXADD 'str1'='str2' bibl. Die Variable Action ONXCOPY ist nur bei PLAM-Bibliotheken anwendbar.
Im Unterschied zum Copy-Kommando des BS2000 werden bei der Variablen Action ONXCOPY die Attribute der Ursprungsdateien übernommen (COPY ,SAME). Die erzeugten Kopien bzw. die durch ONXCOPY überschriebenen Dateien erhalten die gleichen Share-/Access-Attribute/Backup-Level wie die Ursprungsdateien.
Beim Kopieren von Dateien mit BLKCTRL=PAMKEY auf ein Nonkey PVS wird von der Variablen Action intern das Programm PAMCONV aufgerufen.
Kopierte Dateien werden automatisch am Ende der aktuellen Dateienliste ergänzt.
Beispiele:
ONXCOPY''='ABC.S.' Voranstellen des Prefix 'ABC.S.'
z.B. TEST --> ABC.S.TEST
ONXCOPY' '='.88' Nachstellen des Suffix '.88'
z.B. ABC.S.TEST --> ABC.S.TEST.88
ONXCOPY' '='.88',:A100: Nachstellen des Suffix '.88'
z.B. [:xxx:]ABC.S.TEST --> :A100:ABC.S.TEST.88
ONXCOPY' '=DP7
Die jeweils letzten sieben Stellen im Dateinamen werden entfernt.
z.B. ABC.S.TEST.950510 --> ABC.S.TEST
ONXCOPY''=''
Diese Variable Action ist nur sinnvoll, falls die selektierte User-Id nicht die eigene ist. Die Dateien/Jobvariablen der selektierten Benutzerkennung werden unter dem gleichen Namen in die eigene User-Id kopiert.
ONXCOPY''='':SRC:
ONXCOPY:SRC:
Die mit X markierten Dateien werden unter dem gleichen Kennung und dem gleichen Namen auf den Pubset :SRC: kopiert.
z.B. ABC.S.TEST.50510 --> :SRC:$userid.ABC.S.TEST.950510
 
--------------------------------------------------------
 
TSOS:
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