SHWGUAD Guard-Attribute anzeigen

Dieser Makro zeigt die Attribute von Guards an.

Makro

Operanden

SHWGUAD

MF = D / L / C / M / E ,PREFIX = P / <name 1> ,MACID = RON / <name 3> ,PARAM = <name 1..8> ,XPAND = PARAM / OUTPUT ,NAME = <c-string: filename 1..40 without-gen-vers with-wild> / <c-string: partial-filename 2..40 with-wild> / <var: char(40)> / (<reg: A(char(40))>) ,SCOPE = *ANY / list-poss(3): *USER_GROUP / *USERID / *HOST_SYSTEM ,INFORM = *ALL / *NAME / <var: enum INFORM> / (<reg: enum INFORM>) ,OUTAREA = structure(2): (1) address: <label> / (<reg: pointer>) (2) length: <integer 4..231-1> / <var: integer(4)> / (<reg: integer(4)>)

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

XPAND

gibt die zu expandierenden Deklarationen an. Dieser Operand gilt nur bei MF=D.

=PARAM

Das Modell des Parameterbereichs.

=OUTPUT

Die Modelle der Teilbereiche der Ausgabe.

NAME

Name des anzuzeigenden Guard. Es dürfen nur Großbuchstaben verwendet werden. Der NAME darf Musterzeichen enthalten. Musterzeichen in der Benutzerkennung sind nur für einen Guard-Administrator zulässig.

SCOPE

Auswahl nach dem SCOPE-Attribut (wurde bei CREATE-GUARD oder CREGUAD vergeben). Jede Angabe außer *ANY zeigt nur die Guards des angegebenen SCOPE an. Eine Selektion nach dem SCOPE-Attribut ist nur für den Eigentümer und den Guard-Administrator möglich.

INFORM

Auswahl der auszugebenden Information.

=*ALL

Es werden alle verfügbaren Informationen zu dem Guard ausgegeben.

=*NAME

Es werden nur die Namen der Guards ausgegeben. Diese Angabe ist nicht sinnvoll, wenn NAME keine Musterzeichen enthält (es wird nur der Guard-Name angezeigt, den man bei NAME bereits angegeben hat!).

OUTAREA

Adresse und Länge des Ausgabebereichs.

Hinweise zur Anwendung

1. Der Eigentümer und ein Guard-Administrator können sich immer alle Informationen eines Guards anzeigen lassen. Andere Benutzer dürfen dies nur, wenn es über das SCO-PE-Attribut zugelassen ist.

2. Liegen Guards auf einem Pubset, das über RFA zugreifbar ist, wird nur ein Ausgabebereich bis max. 64 KByte unterstützt, d.h. auch bei Angabe eines größeren Bereichs (> 64KByte) werden nur 64 KByte Ausgabeinformation in den Ausgabebereich übertragen. Ist der zu übertragende Block größer als 64 KByte, muss der Aufruf der Schnittstelle entsprechend oft wiederholt werden, um alle Daten zu übertragen.

3. Im Parameterbereich kann beim Indikator prefix.RONOMOR abgelesen werden, ob noch Guards das Auswahlkriterium erfüllen, aber keinen Platz im Ausgabebereich gefunden haben. Diese Guards können durch einen erneuten Aufruf der Prozedur gelesen werden, wobei jedoch zu beachten ist, dass der Parameterblock nicht verändert werden darf.

4. Das Feld prefix.RONOUS# gibt die in den Ausgabebereich übertragene Größe der Information an.

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’1004’	Speicher für den Parameterbereich nicht in der benötigten Länge allokiert oder nicht beschreibbar
	X’40’	X’1005’	Der Ausgabebereich ist zu klein
	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’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’1023’	Kein Guard entspricht den Auswahlkriterien
	X’40’	X’1024’	Nutzung des Guards nicht zugelassen
	X’40’	X’1029’	GUARDS auf dem fernen Rechner nicht verfügbar
	X’80’	X’1036’	Guardskatalog gesperrt