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.
