Sie können von den alten Dienstprogrammen NATUNLD/NATLOAD und SYSTRANS zum Object Handler migrieren, indem Sie eine der beiden in diesem Kapitel beschriebenen Methoden anwenden.

• Konvertierung einzelner Kommandos

• Verarbeitung von Kommandos mit einer User Exit Routine

• Verarbeitung von SYSTRANS-Kommandos mit OBJHAPI

• Nicht unterstützte SYSTRANS-Optionen

---

Konvertierung einzelner Kommandos

Sie können die Direktkommandos NATUNLD/NATLOAD oder SYSTRANS in die entsprechenden Object Handler-Kommandos konvertieren, indem Sie die für die Migration vorgesehenen Object Handler-Kommandos verwenden. Diese Migrationskommandos konvertieren automatisch die von den alten Dienstprogrammen verwendete Kommandosyntax in die vom Object Handler verwendete Kommandosyntax.

Um ein einzelnes Kommando zu konvertieren:

1. Verwenden Sie eines der folgenden Direktkommandos des Object Handlers:

   NATUNLD

   gefolgt von einem NATUNLD-Direktkommando.

   Oder:

   NATLOAD

   gefolgt von einem NATLOAD-Direktkommando.

   Oder:

   SYSTRANS

   gefolgt von einem SYSTRANS-Direktkommando.

   Das angegebene alte Dienstprogramm-Kommando wird in das entsprechende Object Handler-Kommando umgewandelt.

2. Geben Sie jedes nachfolgende Kommando für den Object Handler in der Syntax an, die für das Dienstprogramm NATUNLD, NATLOAD bzw. SYSTRANS gilt.

   Die Syntax dieses Dienstprogramms bleibt für die Dauer der Object Handler-Sitzung gültig.

Beispiel für ein NATUNLD-Kommando:

Das folgende Beispiel zeigt zwei aufeinanderfolgende NATUNLD-Kommandos und die entsprechenden Object Handler-Kommandos.

Alte NATUNLD-Kommandos:	NATUNLD ALL * FM LIB1 TO LIB2
	ALL PG* FM LIB2
Neues Object Handler Kommando:	SYSOBJH NATUNLD ALL * FM LIB1 TO LIB2
	ALL PG* FM LIB2
Daraus folgendes Object Handler-Kommando in NATUNLD-Syntax:

Beispiel für ein SYSTRANS-Kommando:

Das folgende Beispiel zeigt zwei aufeinanderfolgende SYSTRANS-Dienstprogramm-Kommandos und die entsprechenden Object Handler-Kommandos.

Alte SYSTRANS-Kommandos:	TRANSCMD EXECUTE UNLOAD N FROM LIB1 NAME ETID
	END
Neues Object Handler-Kommando:	SYSOBJH SYSTRANS EXECUTE UNLOAD N FROM LIB1 NAME ETID END
Daraus folgendes Object Handler-Kommando in SYSTRANS-Syntax:	END

Beispiel für die Batch-Verarbeitung in SYSTRANS:

Im Folgenden finden Sie ein Beispiel für die Batch-Verarbeitung eines SYSTRANS-Dienstprogramm-Kommandos unter Verwendung von Using Map-Eingabedaten sowie des entsprechenden Object Handler-Kommandos und der Eingabedaten.

Alte SYSTRANS-Batch-Sequenz:

SYSTRANS
U
N,N,N,Y,N,N,N,N
N
SRCLIB1,PGM1,*,TGTLIB1

Neue Object Handler-Batch-Sequenz:

SYSOBJH SYSTRANS
U
N,N,N,Y,N,N,N,N
N
SRCLIB1,PGM1,*,TGTLIB1

Verarbeitung von Kommandos mit einer User Exit Routine

Alternativ zur Neudefinition jedes einzelnen Dienstprogramm-Kommandos können Sie in einer User Exit Routine festlegen, dass Dienstprogramm-Kommandos zur Funktionsausführung das Dienstprogramm SYSOBJH aufrufen. Diese Routine bestimmt, ob ein an NATUNLD/NATLOD oder SYSTRANS gerichtetes Direktkommando als SYSOBJH-Kommando an den Object Handler weitergeleitet wird oder nicht.

Um die User Exit Routine zu aktivieren:

1. Für NATUNLD/NATLOAD:

   Speichern Sie mit SAVE das Quellcodeobjekt U-S-EX03 unter dem Namen UNLDEX03 in der Natural System Library SYSUNLD. Das Quellcodeobjekt wird in SYSUNLD bereitgestellt.

   Für SYSTRANS:

   Speichern Sie mit SAVE das Quellcodeobjekt TRA-E2-S unter dem Namen TRA-EX-2 in der Natural System Library SYSTRANS. Das Quellcodeobjekt wird in SYSTRANS bereitgestellt.

2. Öffnen Sie den Quellcode von UNLDEX03 bzw. TRA-EX-2 und setzen Sie USE-SYSOBJH auf Y (dies ist der eingegebene Standardwert). Mit N wird die User Exit Routine deaktiviert.

   Sie können Bedingungen für die Verwendung festlegen, z.B. wann der Object Handler anstelle eines alten Dienstprogramms verwendet werden soll oder wer berechtigt ist, den Object Handler zu verwenden.

3. Speichern Sie das Quellcodeobjekt mit CATALOG oder STOW.

Verarbeitung von SYSTRANS-Kommandos mit OBJHAPI

Sie können die Anwendungsprogrammierschnittstelle OBJHAPI (die in der Natural System Library SYSOBJH enthalten ist) verwenden, um ein Object Handler-Kommando in der Syntax des SYSTRANS-Dienstprogramms auszuführen.

Wenn Sie OBJHAPI zu diesem Zweck verwenden, müssen Sie den Parameter P-EXTENSIONS-EXEC-SYSTRANS-CMD in dem Programm angeben, das OBJHAPI aufruft. Einzelheiten hierzu finden Sie in dem Beispielprogramm DOC-API, das in der Library SYSOBJH enthalten ist.

Nicht unterstützte SYSTRANS-Optionen

Der Object Handler unterstützt die folgenden Optionen des Direktkommandos SYSTRANS nicht:

WORK-FILE-INPUT, SPECIAL-CONVERSION, RULE-LOAD und UNLOAD-RULES.