COPGUAD Guard kopieren

Dieser Makro kopiert ein Guard.

Der Eigentümer darf seine eigenen Guards kopieren. Benutzer mit dem Privileg GUARD-ADMINISTRATION dürfen fremde Guards in ihre oder unter andere Kennungen kopieren. Andere Benutzer dürfen ein fremdes Guard nur kopieren, wenn das SCOPE-Attribut (CRE-GUAD oder MODGUAD) dies gestattet.

RFA kann nur verwendet werden, wenn beide Guards (Quell- und Ziel-Guard) auf dem gleichen Rechner lokal zugreifbar sind.

Makro	Operanden
COPGUAD	MF = D / L / C / M / E ,PREFIX = P / <name 1> ,MACID = ROO / <name 3> ,PARAM = <name 1..8> ,FRNAME = <c-string: filename 1..24 without-gen-vers> / <var: char(24)> / (<reg: A(char(24))>) ,TONAME = <c-string: filename 1..24 without-gen-vers> / <var: char(24)> / (<reg: A(char(24))>) ,REPLACE = *NO / *YES / *DIALOG / <var: enum REPLACE> / (<reg: enum REPLACE>)

Die Beschreibung der Parameter MF, PREFIX, MACID, PARAM finden Sie im Handbuch „Makroaufrufe an den Ablaufteil“ [16].

FRNAME

vollqualifizierter Name des Guards, das kopiert wird. Es dürfen nur Großbuchstaben verwendet werden.

TONAME

vollqualifizierter neuer Name des Guards. Es dürfen nur Großbuchstaben verwendet werden.
Es darf nur in die eigene Benutzerkennung kopiert werden.Ein Benutzer mit dem Privileg GUARD-ADMINISTRATION darf in jede Kennung kopieren, da er Eigentümer aller Kennungen ist).

REPLACE

regelt, ob ein existierendes Guard überschrieben werden darf oder nicht.

=*NO

wenn das Ziel-Guard bereits existiert, wird es nicht überschrieben.

=*YES

es wird überschrieben, falls ein Guard gleichen Namens bereits existiert.

=*DIALOG

Diese Angabe ist nur im Dialogbetrieb wirksam. Im Batchbetrieb gilt die Einstellung *NO. Sofern ein Ziel-Guard bereits existiert, wird ein Dialog begonnen, in dem der Aufrufer festlegen kann, ob das Guard überschrieben werden soll.

Makro-Returncode

SC2	SC1	Maincode	Erläuterung
	X’01’	X’1000’	Der angegebene Wert des Operanden liegt nicht im erlaubten Bereich. Der fehlerhafte Operand steht als symbolischer Wert im SC2
	X’20’	X’1001’	Ein interner Fehler trat auf. Für eine genauere Analyse wurde ein SERSLOG-Eintrag geschrieben
	X’40’	X’1002’	Der Guard-Name ist syntaktisch falsch
	X’40’	X’1003’	Speicher für den Parameterbereich nicht in der benötigten Länge allokiert oder nicht zugreifbar
	X’40’	X’1006’	Das angegebene Guard existiert bereits
	X’40’	X’1007’	Das angegebene Guard existiert nicht
	X’80’	X’1009’	Das angegebene Guard ist von einer anderen Task gesperrt
	X’40’	X’1012’	Der angegebene Katalog ist nicht definiert oder nicht zugreifbar
	X’40’	X’1013’	Das Pubset ist bei der GUARDS-Verwaltung unbekannt (Guardskatalog wurde wahrscheinlich bei IMPORT-PUBSET nicht geöffnet)
	X’40’	X’1014’	Der Benutzer ist nicht autorisiert, die Funktion auszuführen
	X’40’	X’1016’	Fehler im Kommunikationsmittel des MRS
	X’40’	X’1017’	Unbekannte Benutzerkennung
	X’40’	X’1018’	Fernes System nicht verfügbar
	X’40’	X’1020’	Kein Speicher mehr vorhanden
	X’40’	X’1021’	BCAM-Verbindungsfehler
	X’40’	X’1022’	BCAM-Verbindung unterbrochen
	X’40’	X’1024’	Nutzung des Guards nicht zugelassen
	X’40’	X’1025’	Kopieren vom/zum fernen System nicht möglich
	X’40’	X’1029’	GUARDS auf dem fernen Rechner nicht verfügbar
	X’80’	X’1036’	Guardskatalog gesperrt