Dieses Kapitel beschreibt die Condition Codes (Bedingungscodes), die für Object Handler-Funktionen im Batch-Modus zurückgegeben werden, und die für die Funktionsverarbeitung verfügbaren User Exit Routinen.
Die Object Handler-Verarbeitung im Batch-Modus wird mit einem der folgenden Condition Codes beendet:
| Condition Code | Erläuterung |
|---|---|
| 0 | Object Handler-Prozess erfolgreich beendet. |
| 30 | Ein interner Object Handler-Fehler ist aufgetreten. |
| 40 | Ein Fehler wurde im Object Handler-Kommando entdeckt. |
| 50 | Ein Fehler ist während der Object Handler-Verarbeitung aufgetreten. |
| 60 | Ein Natural Security-Fehler ist während der Object Handler-Verarbeitung aufgetreten. |
| 99 | Ein Natural-Fehler ist während der Object Handler-Verarbeitung aufgetreten. |
Die User Exit Routinen des Object Handlers werden als Quellcodeobjekte in der Natural
System Library SYSOBJH ausgeliefert. Diese Quellcodeobjekte tragen den Namen
SRC-EXnn, wobei
nn die Nummer der User Exit Routine
angibt.
Um eine User Exit Routine zu aktivieren:
Benutzen Sie das Systemkommando CATALOG oder
STOW, um das Quellcodeobjekt
SRC-EXnn unter dem Namen
OBJHEXnn in der Natural System Library
SYSOBJH zu aktivieren.
Es werden unterschiedliche Namen verwendet, um zu gewährleisten, dass das (eventuell nach Ihren Anforderungen modifizierte) Quellcodeobjekt und das katalogisierte Objekt der User Exit Routine nicht durch eine Update-Installation überschrieben werden.
Detaillierte Beschreibungen der User Exit Routinen finden Sie in den
Quellcodeobjekten von SRC-EXnn in der
Library SYSOBJH.
Folgende User Exit Routinen stehen zur Verfügung:
Immer wenn im Batch-Modus ein Condition Code auf einen Wert größer als 0
(Null) gesetzt wird, wird die User Exit Routine OBJHEX01 (falls vorhanden)
aufgerufen, bevor der Object Handler die Verarbeitung beendet. Mit dieser User Exit
Routine können Sie festlegen, ob die Verarbeitung des Object Handler fortgesetzt oder
abgebrochen werden soll. Im Falle eines Abbruchs können Sie den Condition Code ändern.
Weitere Einzelheiten finden Sie im Quellcode der User Exit Routine SRC-EX01
in der Natural System Library SYSOBJH.
Wenn die Ladefunktion des Object Handlers im Batch-Modus (mit Condition Code
0) oder im Online-Kommandomodus erfolgreich ausgeführt wurde, aber ein
oder mehrere Objekte während des Ladens abgelehnt wurden (z.B. nicht ersetzt), bevor der
Object Handler die Verarbeitung beendet, wird die User Exit Routine
OBJHEX02 (falls vorhanden) aufgerufen. Mit OBJHEX02 können
Sie festlegen, ob die Verarbeitung des Object Handler fortgesetzt oder abgebrochen
werden soll. Im Falle eines Abbruchs können Sie einen Condition Code setzen. Weitere
Einzelheiten finden Sie im Quellcode der User Exit Routine SRC-EX02 in der
Natural System Library SYSOBJH.
Sie können die User Exit Routine OBJHEX03 anwenden, um die
Standardeinstellungen der Optionen für die Verarbeitung von Object Handler-Kommandos
festzulegen. Dieser User-Exit wird aufgerufen, bevor ein Object Handler-Kommando
verarbeitet wird. Weitere Einzelheiten finden Sie im Quellcodeobjekt der User Exit
Routine SRC-EX03 in der Natural System Library SYSOBJH.
Wenn die Object Handler-Funktionen Unload,
Load oder Scan im Kommandomodus erfolgreich
ausgeführt wurden, wird die User Exit Routine OBJHEX04 (falls vorhanden)
aufgerufen. Sie liefert für jeden Natural-Objekttyp Statistiken über die verarbeiteten,
ersetzten, nicht ersetzten oder zurückgewiesenen Quellcodeobjekte und katalogisierten
Objekte. Mit OBJHEX04 können Sie festlegen, ob die Object
Handler-Verarbeitung im Batch-Modus fortgesetzt oder abgebrochen werden soll. Im Falle
eines Abbruchs können Sie einen Condition Code setzen. Weitere Einzelheiten finden Sie
im Quellcode der User Exit Routine SRC-EX04 in der Natural System Library
SYSOBJH.
