Um Natural-Programme, die Db2-Statements enthalten, statisch mit NDZ auszuführen, müssen Sie die statischen Generierungsschritte für jedes auszuführende Programm durchführen. Alle notwendigen Informationen zur statischen Programmvorbereitung und -ausführung mit NDZ werden in diesem Kapitel beschrieben.
Die statische Programmgenerierung für Natural for Db2 for zIIP (NDZ) ist unabhängig von der statischen Programmgenerierung von Natural for Db2 (NDB). Natural-Programme, die bereits für die statische Ausführung mit NDB vorbereitet sind, werden durch die Installation von NDZ in keiner Weise beeinträchtigt. Diese Programme werden weiterhin statisch mit NDB ausgeführt. Wenn jedoch eine Natural-Sitzung erfolgreich mit NDZ initialisiert wird, werden sie dynamisch ausgeführt, bis sie auch für die statische Ausführung mit NDZ vorbereitet sind.
Die Natural-Programme, die der statischen NDZ-Generierung und der statischen NDB-Generierung unterliegen, müssen nicht identisch sein. Ein Natural-Programm kann jedoch nur in einem SQLJ-Profil und/oder in einem NDB DBRM/PACKAGE enthalten sein. Die folgende Abbildung zeigt eine statische NDZ-Generierung für die Natural-Programme PROG1 und PROG2, die im SQLJ-Profil und -Package PROF1 enthalten sind, und eine statische NDB-Generierung für die Natural-Programme PROG2 und PROG4, die im Package PACK1 enthalten sind.
NDZ verwendet Java, um eine Verbindung zu Db2 herzustellen und SQL-Statements
auszuführen. Der Standard zum Einbetten von SQL-Statements in Java-Programme heißt SQLJ
und die Java-Programme, die eingebettetes SQL enthalten, werden SQLJ-Programme genannt.
NDZ bietet einen SQLJ-Generator, der temporäre Assembler-Programme, die mit dem
NDB-Kommando CMD
CREATE erzeugt werden, in SQLJ übersetzt. Der NDZ
SQLJ-Generator wird in Schritt 2 -
NDZ SLQJ Generator beschrieben.
NDZ benötigt SQLJ Serialized Profiles, um Db2-SQL-Statements aus Natural-Programmen statisch auszuführen. Serialisierte SQLJ-Profile sind Dateien, die die Beschreibung der SQL-Statements und Cursors eines bestimmten Programms enthalten. NDZ verwendet serialisierte SQLJ-Profile zur Laufzeit, daher sind sie für die statische Ausführung von Db2 mit Natural und NDZ zwingend erforderlich. Sie werden durch den SQLJ Translator erzeugt. Der SQLJ Translator wird von IBM bereitgestellt.
Der SQLJ Translator erhält ein SQLJ-Programm als Eingabe. Die Verwendung des IBM SQLJ Translator im Zusammenhang mit NDZ wird in Schritt 3 - IBM SLQJ Translator beschrieben. Weitere Informationen über den SQLJ Translator finden Sie in der IBM Db2 Java-Dokumentation für SQLJ.
Ein SQLJ-Programm kann nur dann statisch ausgeführt werden, wenn es über serialisierte SQLJ-Profile verfügt, die angepasst und an Db2 gebunden sind. NDZ bietet ein eigenes Binder- und Customizer-Programm, das den IBM SQLJ Customizer aufruft.
Der NDZ-Binder verwendet die in der NDZ-Konfigurationsdatei db2.properties angegebenen Verbindungsparameter, um die Anpassung und optional den Bindeprozess in Db2 auszuführen.
Sie können den NDZ Binder und Customizer so einstellen, dass er den Bindeprozess überspringt und stattdessen eine DBRM-Datei erzeugt, die in einem späteren Schritt an Db2 gebunden wird. Der NDZ Binder und Customizer wird in Schritt 5 - NDZ SQLJ Binder / Customizer beschrieben.
Um Natural-Programme, die Db2-Statements enthalten, statisch mit NDZ auszuführen, müssen
Sie immer ein serialisiertes SQLJ-Profil haben. Das SQLJ-Profil wird zur Laufzeit und
optional im Bindeprozess verwendet. Falls gewünscht, können Sie aus dem serialisierten
SQLJ-Profil eine DBRM-Datei erzeugen und diese Datei mit dem Db2-Kommando
BIND PACKAGE an Db2 binden. Dies ist vor allem dann sinnvoll,
wenn der im NDZ angegebene Benutzer nicht über die erforderlichen Berechtigungen zur
Ausführung des Bindeprozesses in Db2 verfügt. In diesem Fall kann die Bindung mit den
Berechtigungen des Ausführenden des BIND PACKAGE-Kommandos
durchgeführt werden, z.B. dem Benutzer, der den Batch-Job mit dem Kommando absetzt. Ein
Beispiel hierfür finden Sie in der JCL in Schritt 6.
Benutzen Sie das Kommando CMD CREATE und wählen Sie die
Natural-Programme aus, die Sie für die statische Ausführung mit NDZ vorbereiten
möchten.
Das CMD CREATE-Kommando erzeugt ein temporäres
Assembler-Programm mit den SQL-Statements, die in den ausgewählten Natural-Programmen
enthalten sind. Dieser Schritt ist für NDZ und NDB identisch. Ausführliche Informationen
über das Kommando CMD CREATE finden Sie unter Generierungsprozedur - Kommando: CMD CREATE in der
Natural for Db2-Dokumentation.
//GENERATE EXEC PGM=natural batch nucleus //CMPRMIN DD Natural parameters //* //STEPLIB DD DSN=nucleus load library,DISP=SHR //SYSUDUMP DD SYSOUT=X //********* OUTPUT DECKS //CMWKF01 DD DSN=&&TMP1,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMWKF02 DD DSN=&&TMP2,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMWKF03 DD DSN=&&TMP3,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMWKF04 DD DSN=&&TMP4,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMWKF05 DD DSN=&&TMP5,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMWKF06 DD DSN=&&TMP6,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMPRINT DD SYSOUT=X //CMSYNIN DD *,SYMBOLS=JCLONLY LOGON SYSDB2 CMD CRE DBRM PROFILE NAME USING INPUT DATA WITH XREF YES|NO FS ON/OFF LIBRARY,PROGRAM LIBRARY,PROGRAM . FIN |
Führen Sie die Java-Klasse com.softwareag.ndz.sqljgen.SQLJGenerator über
den IBM JZOS Batch Launcher aus und verwenden Sie das in Schritt 1 erzeugte
Assembler-Programm als Eingabe.
NDZ stellt die Java-Klasse com.softwareag.ndz.sqljgen.SQLJGenerator zur
Verfügung, um die in Schritt 1 erzeugten temporären Assembler-Programme in
SQLJ-Programme zu übersetzen. Die Java-Klasse muss über den IBM JZOS Batch Launcher
ausgeführt werden. Der IBM JZOS Batch Launcher ist mit jeder vom NDZ unterstützten
Java-Version für z/OS verfügbar.
| DD-Name | Beschreibung |
|---|---|
INPUT |
Temporäres Assembler-Program, generiert in Schritt 1. |
OUTPUT |
SQL-Program, übersetzt aus dem Input. |
//GENSQLJ EXEC PROC=JVMPRC86|11|17|xx,REGSIZE=1024M, // JAVACLS='com.softwareag.ndz.sqljgen.SQLJGenerator' //INPUT DD DSN=&&TMP6,DISP=(OLD,PASS) //OUTPUT DD PATH='programs directory/program name.sqlj', // PATHDISP=(KEEP,DELETE), // PATHOPTS=(OCREAT,ORDWR), // PATHMODE=(SIRUSR,SIWUSR, // SIRGRP,SIWGRP, // SIROTH,SIWOTH), // FILEDATA=TEXT //MAINARGS DD *,SYMBOLS=JCLONLY &PROFILE //STDENV DD *,SYMBOLS=JCLONLY . /etc/profile . ndz installation path/bin/setenv.sh /* |
Führen Sie die Java-Klasse sqlj.tools.Sqlj über den IBM JZOS Batch
Launcher aus und verwenden Sie das in Schritt 2 übersetzte SQL-Programm als Eingabe.
Die Java-Klasse sqlj.tools.Sqlj wird mit dem IBM JDBC/SQLJ-Treiber für Db2
für z/OS bereitgestellt. Der IBM SQLJ Translator hat eine ähnliche Funktion wie ein Db2
Pre-Compiler für Assembler oder COBOL. Der Translator ermöglicht es, die eingebetteten
SQL-Statements in einem Programm statisch mit Db2 auszuführen.
Der Hauptunterschied besteht darin, dass der SQLJ Translator sowohl ein serialisiertes Profil als auch eine modifizierte Version des Eingabeprogramms als Ausgabe erzeugt. Ein weiterer wichtiger Unterschied ist, dass der IBM SQLJ Translator keine DBRM-Datei erzeugt. Einzelheiten zum IBM SQLJ Translator finden Sie in der Dokumentation IBM Db2 Application Programming and Reference for Java.
//GENPROF EXEC PROC=JVMPRC86|11|17|xx,REGSIZE=1024M, // JAVACLS='sqlj.tools.Sqlj' //MAINARGS DD *,SYMBOLS=JCLONLY -compile=true -d=profiles directory programs directory/program name.sqlj //STDENV DD *,SYMBOLS=JCLONLY . /etc/profile . ndz installation path/bin/setenv.sh /* |
Führen Sie das Kommando CMD MODIFYZ aus, um die
Natural-Objekte aus Schritt 1 mit den in Schritt 3 generierten Informationen zu
aktualisieren.
Der Aktualisierungsvorgang schreibt den Namen des serialisierten SQLJ-Profils und die Folgenummern des SQL-Statements in die Natural-Objekte.
Weitere Einzelheiten zum Kommando CMD MODIFYZ finden Sie
unter Änderungsprozedur - Kommando: CMD MODIFYZ in der
Natural for Db2-Dokumentation.
//MODIFYZ EXEC PGM=natural batch nucleus, // REGION=3000K //CMPRMIN DD * Natural parameters /* //* //STEPLIB DD DSN=nucleus load library,DISP=SHR //********* OUTPUT DECKS //CMWKF01 DD DSN=&&TMP6,DISP=(OLD,DELETE) //CMWKF02 DD DSN=&&TMP22,UNIT=SYSDA,DCB=(DSORG=PS,RECFM=FB,LRECL=80, // BLKSIZE=3120),DISP=(,PASS),SPACE=(TRK,(5,5)) //CMPRINT DD SYSOUT=X //CMSYNIN DD *,SYMBOLS=JCLONLY LOGON SYSDB2 CMD MODIFYZ XREF YES|NO FIN |
Führen Sie die Java-Klasse com.softwareag.ndz.sqljbinder.Main über den IBM
JZOS Batch Launcher aus, um das in Schritt 3 generierte serialisierte Profil anzupassen
und optional den Db2-Bind auszuführen.
NDZ bietet die Java-Klasse com.softwareag.ndz.sqljbinder.Main mit den
folgenden Optionen an:
| Option | Argument | Pflichtangabe | Beschreibung |
|---|---|---|---|
-url |
URL der Db2-Verbindung im Format
jdbc:db2://server:port/database
|
Nein | Die URL-Verbindung zu einer Db2-Serverinstanz. Wenn diese Option nicht
angegeben wird, werden stattdessen die in der Konfigurationsdatei
db2.properties verfügbaren Verbindungsparameter
verwendet. Wenn diese Option angegeben wird, müssen auch die Optionen
-user und -password angegeben werden.
|
-user |
Benutzerkennung der Db2-Verbindung | Nein | Die Verbindungsbenutzerkennung zur Authentifizierung bei einer
Db2-Serverinstanz. Wenn diese Option nicht angegeben wird, wird stattdessen der
in der Konfigurationsdatei db2.properties angegebene
Benutzer verwendet. Wenn diese Option angegeben wird, müssen auch die Optionen
-url und -password angegeben werden.
|
-password |
Passwort der Db2-Verbindung | Nein | Das Verbindungsbenutzerpasswort zur Authentifizierung bei einer
Db2-Serverinstanz. Wenn diese Option nicht angegeben wird, wird stattdessen das
verschlüsselte Passwort oder das in der Konfigurationsdatei
db2.properties angegebene Passwort verwendet. Wenn diese
Option angegeben wird, müssen auch die Optionen -url und
-user angegeben werden.
|
-automaticbind |
YES | NO | Nein | Gibt an, ob die Bindung nach der Anpassung ausgeführt werden soll oder
nicht.
Wenn sie auf Diese Option wird als |
-genDBRM |
- | Nein | Gibt an, ob die Klasse nach der Ausführung eine DBRM-Datei erzeugt. Wenn
diese Option angegeben wird, muss auch die Option -DBRMDir
angegeben werden.
|
-DBRMDir |
DBRM-Dateiverzeichnis | Nein | Unix System Services-Verzeichnis, in dem die aus dem serialisierten Profil
generierte DBRM-Datei gespeichert wird, wenn die Option -genDBRM
angegeben ist. Der generierte DBRM-Dateiname ist der im Parameter
-profile angegebene Wert. Diese Option muss angegeben werden,
wenn die Option -genDBRM angegeben wird.
|
-bindoptions |
Db2-Bind-Optionen | Ja | Die Bindeoptionen, die verwendet werden, um das serialisierte Profil an Db2
zu binden. Der Isolation Level (ISOLATION CS | RS | RR | UR | NC)
muss immer angegeben werden. Wenn die Option -automaticbind auf
YES gesetzt ist, können Sie weitere Bindungsoptionen
angeben.
|
-profile |
Name des serialisierten Profils | Ja |
Name des Profils, das in dem in der Eigenschaft
ndz.staticPath der Eigenschaftsdatei
ndz.properties angegebenen Verzeichnis erzeugt wird.
Der Name der generierten Profildatei hat das Format
|
-collection |
Name der Db2 Collection | Nein | Die Collection, zu der die im Bindeprozess erzeugten Pakete hinzugefügt werden sollen. |
-staticpositioned |
YES | NO | Nein | Gibt an, ob Positioned Update-Statements statisch oder dynamisch ausgeführt
werden sollen. Wir empfehlen Ihnen, diese Option auf YES zu
setzen.
|
-onlinecheck |
YES | NO | Nein | Gibt an, ob die Online-Prüfung von Datentypen gegen die in der Datei
db2.properties oder in der Option -url
angegebene Db2-Instanz durchgeführt wird.
Wir empfehlen Ihnen, diese Option
auf YES
gesetzt ist, muss der Benutzer die Berechtigung haben, die Statements, die
angepasst werden, auszuführen.
Diese Option wird auch dann als
|
-pkgversion |
AUTO | Versionskennung | Nein | Gibt an, welche Package-Version bei der Bindung von Packages an den Server für das serialisierte Profil, das angepasst wird, verwendet wird. Wenn dieser Parameter nicht angegeben wird, wird keine Version verwendet. |
-qualifier |
Qualifier-Name | Nein | Gibt den Qualifier an, der für nicht-qualifizierte Objekte im SQLJ-Programm
während der Online-Prüfung verwendet werden soll, wenn die Option
-onlinecheck auf YES gesetzt ist.
|
Wenn die Option -automaticbind auf YES gesetzt ist, bindet
die Klasse das serialisierte Profil an Db2 unter Verwendung der in der
NDZ-Konfigurationsdatei db2.properties angegebenen
Verbindungsparameter, sofern nicht die Eigenschaften -url,
-user und -password angegeben sind. In jedem Fall muss der
Benutzer über die Rechte eines SYSADM oder DBADM verfügen. Wenn das Paket nicht
existiert, muss der Benutzer außerdem die BINDADD-Berechtigung sowie entweder die
CREATEIN- oder die PACKADM-Berechtigung für die Collection oder alle Collections haben.
Wenn das Package existiert, muss der Benutzer die BIND-Berechtigung für das Package
haben.
Wenn die Option -automaticbind auf NO gesetzt ist und die
Optionen -genDBRM und -DBRMDir angegeben sind, führt die
Klasse die Bindung des serialisierten Profils an Db2 nicht aus. Stattdessen erzeugt die
Klasse eine DBRM-Datei in dem mit der Option -DBRMDir angegebenen
Verzeichnis. Sie können die DBRM-Datei in ein Dataset kopieren und es an Db2 binden,
indem Sie das Db2-Kommando BIND PACKAGE auf die gleiche Weise
wie bei NDB ausführen. Weitere Informationen über das Db2-Kommando BIND
PACKAGE finden Sie in der IBM Db2 for z/OS SQL
Reference-Dokumenation.
Wenn die Option -onlinecheck auf YES gesetzt ist, muss der in
der Eigenschaftsdatei db2.properties angegebene Benutzer oder der
im Parameter -user angegebene Benutzer Zugriff haben, um die im angepassten
SQLJ-Programm enthaltenen Statements auszuführen.
JCL Example //CUSTOM EXEC PROC= JVMPRC86|11|17|xx,REGSIZE=1024M, // JAVACLS='com.softwareag.ndz.sqljbinder.Main' //MAINARGS DD * -profile profile name -onlinecheck YES|NO -staticpositioned YES|NO -collection collection -bindoptions ISOLATION CS|RS|RR|UR|NC -automaticbind YES|NO -genDBRM -DBRMDir DBRM directory //STDENV DD *,SYMBOLS=JCLONLY . /etc/profile . ndz installation path/bin/setenv.sh /* |
Binden Sie die in Schritt 5 erzeugte DBRM-Datei an Db2, indem Sie das Db2-Kommando
BIND PACKAGE verwenden.
Dieser Schritt muss nur ausgeführt werden, wenn sowohl -automaticbind auf
NO gesetzt ist als auch -genDBRM in Schritt 5 angegeben
wurde. Weitere Informationen über das Db2-Kommando BIND
PACKAGE finden Sie in der IBM
Db2-Dokumentation.
//BIND EXEC PGM=IKJEFT01,DYNAMNBR=20,REGION=4096K //STEPLIB DD DSN=Db2 high level qualifier.SDSNLOAD,DISP=SHR //DBRMLIB DD DSN=DBRM Dataset,DISP=SHR //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSUDUMP DD SYSOUT=* //SYSTSIN DD *,SYMBOLS=JCLONLY DSN SYSTEM(DB2 SSID) BIND PACKAGE(COLLECTION) - MEM(DBRM NAME) - Other bind options - END /* |
Einige der statischen Vorbereitungsschritte können mit z/OS Unix System Services Shell-Skripten durchgeführt werden. Das NDZ bietet die folgenden Skripte im Unterverzeichnis bin:
Syntax:
ndz-generate-profile.sh program name
Dabei ist program name der SQLJ-Programmname.
Syntax:
ndz-binder.sh parameters
Dabei sind parameters Parameter der NDZ Binder / Customizer.
Dieses Skript führt eine IBM Db2 Utility zum Drucken eines SQLJ-Profils aus. Weitere Informationen siehe IBM Db2 Dokumentation für Java / SQLJ.
Syntax:
ndz-print-profile.sh profile name
Dabei ist profile name ein zuvor erstelltes und in dem in der Konfigurationsdatei ndz.properties definierten NDZ-Verzeichnis für statische Profile gespeichertes SQLJ-Profil.
In der folgenden Tabelle werden die verschiedenen Schritte der statischen Generierung mit NDZ und NDB verglichen.
| Step # | NDZ | NDB |
|---|---|---|
| Schritt 1 | CMD CREATE – generiere ein temporäres
SQL-Assembler-Programm mit CMD CREATE DBRM.
|
GENERATE/GENERATION – generiert ein temporäres
SQL-Assembler-Programm mit CMD CREATE DBRM.
|
| Schritt 2 | NDZ SQLJ Generator – generiert ein temporäres SQLJ-Programm. | Dieser Schritt wird bei der statischen NDB-Generierung ausgelassen. |
| Schritt 3 | IBM SQLJ Translator – generiert das SQLJ-Profil. | PC – Db2 prekompiliert das SQL-Assembler-Programm. |
| Schritt 4 | CMD MODIFYZ – ändere die Natural-Programme mit den
SQLJ-Profilnummern und SQLJ-Folgenummern mit CMD MODIFYZ.
|
MODIFY – ändert die Natural-Programme mit dem DB2
DBRM-Namen und den Abschnitts- und Statement-Nummern mit CMD
MODIFY.
|
| Schritt 5 | NDZ SQLJ Binder / Customizer – platziere statische SQL-Informationen in DB2
zum BIND PACKAGE oder, optional, generiere eine DBRM-Datei, die in
Schritt 6 verwendet werden kann.
|
BIND – platziert statische SQL-Informationen in DB2
zum BIND PACKAGE.
|
| Schritt 6 (optional) | Db2 BIND - platziere statische SQL-Informationen in DB2 zum BIND
PACKAGE, wenn der Bindungsvorgang nicht in Schritt 5 erfolgt ist.
|
