SHWCOO Miteigentümerschutzregel anzeigen

Mit dieser Funktion können Regeln des Miteigentümerschutzes aus einem Regelbehälter (Guard) angezeigt werden.

Ein Anwender, der weder Eigentümer des anzuzeigenden Behälters noch Guard-Administrator ist, erhält die Regeln nur dann angezeigt, wenn er die entsprechende Berechtigung hat, auf den Behälter zuzugreifen (SCOPE=*USER-GROUP oder *HOST-SYSTEM).

Makro

Operanden

SHWCOO

MF = C / D / L / M / E ,PREFIX = C / <name 1> ,MACID = OOS / <name 3> ,PARAM = <name 1..8> ,XPAND = PARAM / OUTPUT ,COGUARD = ' ' / <c-string 1..40: filename 1..40 without-gen-vers> / <var: char:40> ,RULENAM = *ALL / <c-string 1..20: alphanumeric name 1..12 with-wild(20)> / <var: char:20> ,OUTAREA = structure(2): (1) address: NULL / <var: pointer> (2) len: 0 / *ONERULE / *SUGRULES / <integer 144..268435455> / <var: int: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.

COGUARD

Name des Regelbehälters
Dieser Operand bezeichnet den Namen des Regelbehälters, aus dem eine oder alle Regeln angezeigt werden.

ACHTUNG!
Der Operand muss mit einem Wert versehen werden. Es dürfen nur Großbuchstaben verwendet werden! Es dürfen keine Musterzeichen verwendet werden!

RULENAM

Name der Regel
Dieser Operand bezeichnet den Namen der anzuzeigenden Regel. Musterzeichen im Namen sind erlaubt.

ACHTUNG!
Es dürfen nur Großbuchstaben verwendet werden!

=*ALL

Es werden alle Regeln angezeigt.

OUTAREA

Ausgabebereich
Dieser Operand bezeichnet Adresse und Länge des Adressraumes, in den die ermittelte Ausgabeinformation eingetragen wird. Passen nicht alle selektierten Regeln in den Ausgabebereich, wird ein Fehler gemeldet und der Aufrufer muss einen grösseren Ausgabebereich zur Verfügung stellen.

address:

Adresse
Angabe der Adresse des Ausgabebereiches.

ACHTUNG!
Der Ausgabebereich muss an Wortgrenze stehen.

len:

Länge
Angabe über die Länge des Ausgabebereiches.

ACHTUNG!
Der Ausgabebereich muss mindestens 144 Bytes betragen.

*ONERULE

Ausgabelänge für eine Regel.

*SUGRULES

Vorgeschlagene Ausgabelänge für mehrere Regeln.

Makro-Returncode

SC2	SC1	Maincode	Erläuterung
X’00’	X’00’	X’0000’	class A: CMD0001
	X’01’	X’3100’	class B: COO3100
X’00’ X’01’ X’02’ X’03’			ungültige Parameteradresse ungültiger Operand: COGUARD ungültiger Operand: RULENAM ungültiger Operand: OUTAREA
X’00’	X’20’	X’3200’	class C: COO3200
X’00’	X’40’	X’3300’	class D: COO3300
X’00’	X’40’	X’3301’	class D: COO3301
X’00’	X’40’	X’3302’	class D: COO3302
X’00’	X’40’	X’3306’	class D: COO3306
X’00’	X’40’	X’3308’	class D: COO3308
X’00’	X’40’	X’3309’	class D: COO3309
X’00’	X’40’	X’3310’	class D: COO3310
X’00’	X’40’	X’3313’	class D: COO3313
X’00’	X’40’	X’3314’	class D: COO3314
X’00’	X’40’	X’3315’	class D: COO3315
X’00’	X’40’	X’3317’	class D: Ausgabebereich ist nicht groß genug
X’00’	X’80’	X’3900’	class E: COO3900
X’00’	X’80’	X’3901’	class E: COO3901
X’00’	X’80’	X’3902’	class E: COO3902

Die genaue Fehlerursache kann durch Aufruf des Kommandos /HELP-MSG mit der in der Tabelle angegebenen Fehlernummer ermittelt werden, z.B. /HELP-MSG COO3902.