Aufruf von directaccess4i

Wie Sie im Kapitel 4 bereits gelesen haben, können Sie mittels STRDAISQL ganz einfach einen SQL Befehl gegen eine Datenbank ausführen. STRDAISQL dient u.a. dafür, einen SQL Befehl interaktiv auf dem System i zu testen, bevor man ihn in ein vorhandenes RPG, Cobol oder CL Programm einbaut.

STRCDBSQL verwendet für die Ausführung die gleiche Schnittstelle, die Sie in Ihren Anwendungen verwenden und die nun näher beschrieben wird.

Aus Ihren Programmen können Sie directaccess4i einfach per CALL aufrufen.

0033 – Aufruf Schnittstelle zur externen Datenbank

Die notwendigen Parameter lauten:

CTID – 4 A

Dies ist eine Identifikationsnummer, die von directaccess4i vorgegeben wird. Anhand dieser ID können Sie Ihre Befehle an die externe Datenbank nachverfolgen und protokollieren (s. SELECT Beispiel).

CTMODE – 2 A

Über den Modus können Sie steuern, wie directaccess4i laufen soll.

01 = Aufruf über CALL

D.h. wenn Sie directaccess4i jedes Mal aus Ihren Programmen per CALL aufrufen, wird es jedes Mal gestartet und läuft bis der übergebene Befehl abgearbeitet ist.

02 = Verarbeitung über Data Queue

Wenn Sie directaccess4i mit Parameter 02 starten, wird es permanent laufen und die DTAQ CTCMD überwachen. Über die DTAQ erhält directaccess4i seine Anweisungen.

Diese Verarbeitung ist bei vielen Zugriffen erheblich schneller und Resourcen schonender.

Mode 02 ist für INSERT, UPDATE und DELETE möglich.

Sie sollten directaccess4i mittels SBMJOB als Batch Job aufrufen. Statt nun aus Ihrem RPG/Cobol Programm die Befehle mittels CALL aufzurufen, schicken Sie sie in die DTAQ. Sie finden in der QRPGLESRC ein Beispielprogramm hierfür (EXAMPLED04).

03 = Aufruf über CALL mit Angabe einer extern beschriebenen Datei.

Dieser Modus gilt nur für SELECT Anweisungen, bei denen Sie das Ergebnis in einer extern beschriebenen Datenbankdatei auf dem System i empfangen möchten. Wenn die Datei noch nicht existiert wird sie automatisch erstellt.

WICHTIG: Wenn Sie Modus 03 nutzen möchten, muss auf dem Gateway PC IBM IBM i Access

V5R3 oder höhe mit dem ADO.NET Datenprovider von IBM installiert sein.

07 = Mit Mode 07 können Sie Daten vom System i mit nur einem SQL Befehl (der natürlich auch sehr komplex sein darf) in Excel und MS SQL Server exportieren. Im Falle von Excel geben Sie bei CTTARGETIP den Pfad und Dateinamen, der zu erstellenden Excel Tabelle an (z.B. c:\Temp\meinexcel.xls). Bei CTENHANCED können Sie den Sheetnamen der zu erstellenden Excel Datei angeben. Wenn Sie diesen weg lassen, wird Sheet1 als Standardname verwendet. Wie bei Mode 03 ist auch hier der IBM ADO.NET Datenprovider, der ab IBM i Access V5R3 oder höher vorhanden ist, notwendig.

CTEXTDB – 10 A

Mit diesem Parameter teilen Sie directaccess4i mit, welche externe Datenbank Sie ansprechen möchten:

• MYSQL4 - MySQL Datenbank Version 4.1
• MYSQL5 - MySQL Datenbank Version 5.1
• ACCESS2003 - Microsoft Access 2003 oder älter
• ACCESS2007 - Microsoft Access 2007
• EXCEL2000 - Microsoft Excel 2000 oder neuer
• EXCEL97 - Microsoft Excel 97
• MSSQL2000 - Microsoft SQL Server 2000
• MSSQL2005 - Microsoft SQL Server 2005
• ORACLE - Oracle Datenbank
• DB2IBM I - IBM DB2 auf System i
• DB2V9 - IBM DB2 V9 (Unix, Linux, Windows) inkl. XML Datentyp
• INFORMIX - IBM INFORMIX Datenbank
• SYBASE - Sybase Advantage Database Server
• PSTGRE - Postgre SQL Datenbank
• ODBC - Jede beliebige Datenbank, für die Sie einen ODBC Treiber haben

Im Falle des ODBC Treibers sollten Sie uns mitteilen, welche Datenbank Sie benutzen, damit wir einen nativen ADO.net Datenprovider einbauen können, der um einiges schneller ist, als ein ODBC Treiber.

CTRTCODE – 4 A

Dieser Parameter meldet Ihrem Programm zurück, ob der Befehl erfolgreich ausgeführt wurde oder ob Fehler aufgetreten sind.

Beachten Sie, dass mit unserem neuen Gateway Programm, welches Sie aktuell auf Anfrage erhalten, auch die exakte Fehlermeldung der Datenbank im Parameter CTSQLCMD zurückgeliefert wird!

Hier eine Liste der möglichen Fehlermeldungen:

• 0xxx - Lizenzfehler
• 0001 - Der Key ist abgelaufen
• 0002 - Die Systemdaten passen nicht zum eingetragenen Schlüssel
• 3xxx - Fehler aus Socket-Programm
• 3425 - Ein ferner Host hat den Verbindungsversuch abgelehnt
• 3455 - Broken Pipe - Tritt normalerweise auf, wenn die Verbindung bereits hergestellt ist und dann abbricht. Im Testfall ist es aufgetreten, weil gar keine Verbindung hergestellt werden konnte
• 6xxx - Fehler aus directaccess4i Gateway Programm
• 6001 - Microsoft Access Datenbank konnte nicht geöffnet werden
• 6002 - Microsoft Access Datenbank Befehl konnte nicht ausgeführt werden
• 6003 - MySQL Datenbank konnte nicht geöffnet werden
• 6004 - MySQL Datenbank Befehl konnte nicht ausgeführt werden
• 6005 - ORACLE Datenbank konnte nicht geöffnet werden
• 6006 - ORACLE Datenbank Befehl konnte nicht ausgeführt werden
• 6007 - Microsoft SQL Server Datenbank konnte nicht geöffnet werden
• 6008 - Microsoft SQL Server Datenbank Befehl konnte nicht ausgeführt werden
• 6009 - IBM DB2 for IBM i Datenbank konnte nicht geöffnet werden
• 6010 - IBM DB2 for IBM i Datenbank Befehl konnte nicht ausgeführt werden
• 6011 - ODBC Datenbank konnte nicht geöffnet werden
• 6012 - ODBC Datenbank Befehl konnte nicht ausgeführt werden
• 7xxx - Fehler aus RPG-Programm
• 7001 - Kein Zeilenendezeichen übergeben §$
• 7002 - Keine SQL-Anweisung übergeben
• 7003 - Modus ungültig
• 7004 - Datenbank nicht unterstützt
• 7005 - Portnummer ist nicht numerisch
• 7006 - Bei Modus 03 muss auch EPPFODTAQ und EPLIBRARY gefüllt sein

CTDTAQ2PF – 1 A

Mit diesem Parameter können Sie directaccess4i anweisen, alle Daten, die er per SELECT (s.u.) aus der externen Datenbank gelesen hat, parallel in eine DTAQ UND eine physische Datenbankdatei zu schreiben.

Mögliche Werte:

J = JA – Daten werden nur in die physische Datei CTRCV geschrieben

N oder BLANK – Daten werden nur in DTAQ CTRECV geschrieben

CTTARGETIP – 200 A

Dieser Parameter enthält entweder die TCP/IP Adresse bzw. DNS Namen des externen Datenbankservers oder den Windows Pfadnamen einer Access Datenbank.

Im Falle von ODBC muss hier der Name des ODBC Treibers des directaccess4i Gateway PC's eingetragen sein.

WICHTIG: Der Parameter muss mit den Zeichen §$ abgeschlossen werden bzw. den Zeilenendezeichen, die Sie im directaccess4i Administrator oder WRKCDB Punkt 2 hinterlegt haben.

Beispiele:

192.168.1.1§$
IBM IProduktion§$
C:\Datenbank\MeineAccessDatenbank.mdb§$

CTUSER – 30 A

CTPASSWORD – 30 A

Wenn bei der externen Datenbank ein Benutzername und ein Kennwort benötigt werden, können diese hier eingetragen werden.

CTENHANCED – 30 A

Dieser Parameter ist für optionale Zusatzinformationen vorgesehen.

Bei ORACLE Datenbanken kann hier der Servicename angegeben werden. Bei Oracle 10g wird, wenn kein Servicename angegeben wird, XE als Standardwert benutzt.

Bei Mode 07 können Sie hier im Falle eines Exports in Excel z.B. den Sheet Namen angeben, der in der zu erstellenden Excel Tabelle erstellt und verwendet werden soll.

Bei der IBM DB2 für Linux, Unix und Windows müssen Sie hier z.B. den Namen der Datenbank angeben.

CTPFODTAQ – 20 A

Zusammen mit dem Modus 03 müssen Sie hier den Namen der extern beschriebenen Datenbankdatei auf der IBM i angeben, in die die SELECT Ergebnisdaten geschrieben werden.

Bei Modus 02 können Sie hier den Namen einer eigenen DTAQ eintragen, in die die Daten von directaccess4i zurückgegeben werden.

Bei Modus 01 können Sie hier den Namen einer eigenen DTAQ eintragen, in welche Daten, die mittels SELECT zurück geliefert werden, geschrieben werden.

Damit kann z.B. für jede Bildschirmsitzung eine DTAQ angelegt werden, wenn directaccess4i im Dialog verwendet werden soll.

CTLIBRARY – 10 A

Hier muss der Namen der Bibliothek stehen, für die DTAQ oder physische Datei aus dem vorherigen Parameter CTPFODTAQ.

CTSQLCMD – 32000 A

Last but not least – der Parameter, der den SQL Befehl enthält.

Sie müssen hier den SQL Befehl so angeben, wie er von der externen Datenbank erwartet wird.

D.h. eine MySQL Datenbank hat u.U. eine andere Schreibweise für div. Angaben, als eine Microsoft SQL Server Datenbank.

WICHTIG: Der Parameter muss ebenfalls mit den Zeilenendezeichen (Standard §$) abgeschlossen

werden, die Sie im directaccess4i Administrator bzw. WRKDIRACC Punkt 2 eingetragen haben.