Batch Condition Codes und User Exit Routinen

#### Search Results

Search

# Batch Condition Codes und User Exit Routinen

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.

- Im Batch-Modus zurückgegebene Condition Codes

- User Exit Routinen anwenden

- Verfügbare User Exit Routinen

## Im Batch-Modus zurückgegebene Condition Codes

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.

## User Exit Routinen anwenden

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.

## Verfügbare User Exit Routinen

Folgende User Exit Routinen stehen zur Verfügung:

- OBJHEX01 bei fehlgeschlagener Verarbeitung

- OBJHEX02 für abgelehnte Objekte

- OBJHEX03 für die Standardwerte der Optionen

- OBJHEX04 für Natural-Objekttyp-Statistiken

### OBJHEX01 bei fehlgeschlagener Verarbeitung

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.

### OBJHEX02 für abgelehnte Objekte

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.

### OBJHEX03 für die Standardwerte der Optionen

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.

### OBJHEX04 für Natural-Objekttyp-Statistiken

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.

### On this page

- Im Batch-Modus zurückgegebene Condition Codes
- User Exit Routinen anwenden
- Verfügbare User Exit Routinen