Vorbereiten von Programmen für die statische Ausführung

Bevor Sie ein Programm für die statische Ausführung mit Natural for Db2 for zIIP (NDZ) vorbereiten, muss das Programm zuvor für die statische Ausführung mit Natural for Db2 (NDB) vorbereitet werden. Weitere Informationen hierzu finden Sie unter Dynamische und statische SQL-Unterstützung in der Natural for Db2-Dokumentation.

NDZ verwendet das temporäre Assembler-Programm, das in der Generierungsprozedur – Kommando: CMD CREATE (Schritt 1 im folgenden Diagramm) erstellt wurde, und stützt sich auf die Informationen, die dem Natural-Objekt während der Modifikationsprozedur (CMD MODIFY) (Schritt 3) hinzugefügt wurden. Darüber hinaus muss das temporäre Assembler-Programm in ein temporäres SQLJ-Programm umgewandelt werden (Schritt Z1). Dann generiert der Db2-SQLJ-Übersetzer das SQLJ-Profil unter Verwendung des temporären SQLJ-Programms als Eingabe (Schritt Z2). Im letzten Schritt wird der Db2-Bind unter Verwendung des SQLJ-Profils ausgeführt.

Derzeit ist es nicht möglich, Programme für die statische Ausführung nur für NDB oder nur für NDZ vorzubereiten. Es müssen beide Vorbereitungen durchgeführt werden. Für Programme, die bereits für die statische Ausführung mit NDB vorbereitet sind, müssen die Schritte 2, 3 und 4 jedoch nicht ausgeführt werden. In diesem Fall müssen Sie bei Schritt 1 darauf achten, dass Sie dieselbe Liste von Programmen verwenden, die bei der Vorbereitung des Programms für die statische Ausführung mit NDB verwendet wurde. Außerdem müssen Sie sicherstellen, dass in Schritt Z3 derselbe DBRM-Name verwendet wird. Eine andere Programmliste und/oder ein anderer DBRM-Name führen zu Fehlern bei der Ausführung der Programme, da die in den Natural-Objekten enthaltenen Informationen über die statische Ausführung dann nicht korrekt sind. Die folgende Tabelle gibt einen Überblick über die notwendigen Schritte zur Vorbereitung eines Programms für die statische Ausführung mit NDZ.

overview of the necessary steps to prepare a program for static execution with NDZ

Ausführliche Informationen zu den einzelnen Schritten siehe unten.

Dieses Kapitel behandelt folgende Themen:

Schritt 1 - Generierungsprozedur

Dieser Schritt wird im Abschnitt Generierungsprozedur – Kommando: CMD CREATE in der Natural for Db2-Dokumentation beschrieben.

Schritt 2 - Db2 Precompiler

Dieser Schritt wird im Abschnitt Vorkompilierung des generierten Assembler-Programms in der Natural for Db2-Dokumentation beschrieben.

Schritt 3 - Änderungsprozedur

Dieser Schritt wird im Abschnitt Änderungsprozedur – Kommando: CMD MODIFY in der Natural for Db2-Dokumentation beschrieben.

Schritt 4 - Bind

Dieser Schritt wird im Abschnitt Vorkompiliertes DBRM einbinden – Kommando BIND in der Natural for Db2-Dokumentation beschrieben.

Schritt Z1 - Temporäres SQLJ generieren

Das in Schritt 1 - Generierungsprozedur generierte temporäre Assemblerprogramm wird in ein SQLJ-Programm umgewandelt.

Für diese Konvertierung steht das Java-Programm com.softwareag.ndz.sqljgen.SQLJGenerator zur Verfügung.

Eingabe-Parameter

DBRM-Name - der Name des generierten SQLJ-Programms. Dieser Name muss derselbe sein, der in Schritt 1 verwendet wurde.

DD Namen

INPUT - Das temporäre Assembler-Programm, das in Schritt 1 generiert wurde.

OUTPUT - Das temporäre SQLJ-Programm.

Schritt Z2 - SQLJ-Profil generieren

Der Db2 SQLJ Translator (sqlj) generiert ein SQLJ-Profil unter Verwendung des im vorherigen Schritt generierten SQLJ-Programms als Eingabe. Das mitgelieferte Shell-Skript genprof.sh führt diese Aufgabe aus.

Schritt Z3 - Bind

Der Db2 SQLJ Profile Binder (db2sqljbind) bindet Pakete für das im vorherigen Schritt generierte SQLJ-Profil. Das mitgelieferte Shell-Skript bind.sh führt diese Aufgabe aus.

Shell-Skripte für die statische Vorbereitung

setenv.sh - Setzt die Umgebungsvariablen für Java, Db2 und NDZ. Die Variablen werden von anderen Skripten benötigt.

genprof.sh - Generiert ein Profil für die statische Ausführung.

Syntax:

genprof ndz_path program

Dabei steht ndz_path für den NDZ-Installationspfad und program für das SQLJ-Programm, mit dem das Profil erstellt wird.

bind.sh - Bindet ein statisches Profil an Db2.

Syntax:

bind NDZ_PATH url user password program bind_opts

Dabei ist

  • NDZ_PATH der Installationspfad von NDZ.

  • url die URL für den Db2-Zugang.

  • user der Benutzername für den Db2-Zugang.

  • password das Passwort für den ausgewählten Benutzernamen für den Db2-Zugang.

  • program das Natural-Programm, das auf Db2 zugreift.

  • bind_opts eine Liste von Bindungsoptionen. Jede Option muss durch ein Leerzeichen getrennt werden und hat die gleiche Funktion wie die Db2 Precompile- und Bind-Optionen. Weitere Informationen finden Sie im Abschnitt über das Kommando BIND PACKAGE in der IBM Db2-Dokumentation.