Information Center

SQL-Anweisung konfigurieren

F�hren Sie die folgenden Schritte aus, um das Fenster 'SQL-Anweisung konfigurieren' zu �ffnen:

  1. Klicken Sie in einer 3270-, 5250- oder VT-Anzeigesitzung auf 'Aktionen > Daten�bertragung > Daten vom Host empfangen'.
  2. Klicken Sie im Fenster 'Dateien vom Host empfangen' auf 'Neu'.

Das Fenster 'SQL-Anweisung konfigurieren' besteht aus zwei Hauptabschnitten: einem Anweisungsabschnitt und einem Ergebnisabschnitt.

Der Anweisungsabschnitt befindet sich im oberen Bereich des Fensters und enth�lt die Felder f�r die 'Datenbank-URL', 'Treiber-ID', 'Treiberklasse', 'Benutzer-ID', 'Kennwort' und 'Anweisung'. Wenn Sie den Inhalt eines dieser Felder �ndern m�chten, setzen Sie den Textcursor in das Feld, und geben Sie den gew�nschten Text ein.

Der Ergebnisabschnitt befindet sich im oberen Bereich des Fensters und enth�lt die �brigen Felder: 'Ausgabe von Ergebnis an', 'Dateiname', 'Dateityp', '�berschreiben' und 'Anh�ngen'. Mit den Feldern in diesem Abschnitt k�nnen Sie die Daten, die sich als Ergebnis aus einer SQL-Anweisung ergeben, in eine Datei schreiben. (Standardm��ig zeigt Host On-Demand die Ergebnisdaten einer SQL-Anweisung des Typs an.)

Informationen zum Speichern und erneuten �ffnen von SQL-Anweisungen:

SQL-Assistent
Klicken Sie auf 'SQL-Assistent', um den SQL-Assistenten zu �ffnen. Mit dem SQL-Assistenten k�nnen Sie eine SQL-Anweisung erstellen, testen, die Testergebnisse anzeigen und die SQL-Anweisung speichern. F�hren Sie die folgenden Schritte aus, um den SQL-Assistenten zu verwenden:
  1. Klicken Sie auf 'SQL-Assistent'.
  2. Das Fenster 'SQL-Anweisung konfigurieren' wird geschlossen.
  3. Der SQL-Assistent wird ge�ffnet.
    • Wenn Sie oder Ihr Host On-Demand-Administrator Standardeinstellungen (Standardwerte) f�r die f�r die Daten�bertragung angegeben haben, verwendet Host On-Demand diese Werte, um die entsprechenden Felder im SQL-Assistenten zu initialisieren (siehe Standardeinstellungen f�r die Daten�bertragung).
  4. Verwenden Sie den SQL-Assistenten, um die erforderlichen Tasks auszuf�hren. Sie k�nnen folgende Aktionen ausf�hren:
    • Bei einem fernen Datenbankserver anmelden.
    • Die Namen der verf�gbaren Schemata und Tabellen anzeigen.
    • Eine SQL-Anweisung erstellen.
    • Die SQL-Anweisung ausf�hren und ihre Ergebnisse anzeigen.
  5. Wenn Sie die SQL-Anweisung, die Sie im SQL-Assistenten erstellt haben, speichern m�chten, verwenden Sie eine der folgenden Vorgehensweisen:
    • Vorgehensweise bei Ausf�hrung eines Java 1-Browsers:
      • Klicken Sie auf der SQL-Registerkarte des SQL-Assistenten auf 'SQL speichern' oder
      • klicken Sie auf der Registerkarte 'Ergebnisse' des SQL-Assistenten auf 'SQL speichern'.
    • Vorgehensweise bei Ausf�hrung eines mit Java 2 kompatiblen Browsers:
      • Klicken Sie auf der Registerkarte '�berpr�fung' des SQL-Assistenten auf 'Speichern' oder
      • klicken Sie auf der Registerkarte 'Ergebnisse' des SQL-Assistenten auf 'SQL speichern'.
    Host On-Demand speichert die SQL-Anweisung in der Definition der aktuellen Sitzung. Die SQL-Anweisung wird in der Unterverzeichnisstruktur 'Aktuelle Sitzung' im Fenster 'Daten vom Host empfangen' angezeigt.
  6. Wenn Sie den SQL-Assistenten schlie�en m�chten, klicken Sie auf 'Abbrechen'. Falls Sie die SQL-Anweisung zuvor nicht gespeichert haben, geht sie bei diesem Vorgang verloren.

Es ist nicht m�glich, Konfigurationsinformationen vom Fenster des SQL-Assistenten in das Fenster 'SQL-Anweisung konfigurieren' zu kopieren.

Wenn Sie eine SQL-Anweisung �ffnen, die Sie zuvor im SQL-Assistenten gespeichert haben, �ffnet Host On-Demand die SQL-Anweisung im SQL-Assistenten (siehe Informationen zum Speichern und erneuten �ffnen von SQL-Anweisungen).

Datenbank-URL
Geben Sie die URL einer Datenbank ein (siehe auch Datenbank-URL angeben).
Treiber-ID
Das Listenfenster enth�lt die Namen aller JDBC-Treiber, die mit Host On-Demand registriert wurden. Erweitern Sie das Listenfenster und klicken Sie auf den Namen des registrierten JDBC-Treibers, den Sie verwenden m�chten, oder klicken Sie auf 'Sonstige', um einen anderen Treiber auszuw�hlen.

Allgemeine Informationen zur Verwendung eines JDBC-Treibers mit dem Host On-Demand-Client enth�lt das Kapitel JDBC-Treiber registrieren.

Treiberklasse
Der vollst�ndig qualifizierte Java-Klassenname des JDBC-Treibers.
Benutzer-ID
Die Benutzer-ID f�r den Zugriff auf die Datenbank (sofern erforderlich).
Kennwort
Das Kennwort f�r den Zugriff auf die Datenbank (sofern erforderlich). Bei der Eingabe eines Kennworts (wie beispielsweise meinkennwort) in das Feld 'Kennwort' zeigt Host On-Demand das Kennwort in Form von Sternen (************ ) an.
Anweisung
Die SQL-Anweisung, die an den Datenbankserver gesendet werden soll. Sie k�nnen dieselben vier Arten von SQL-Anweisungen erstellen, die auch im SQL-Assistenten verf�gbar sind:

Host On-Demand �berpr�ft die Formate von SQL-Anweisungen nicht auf ihre G�ltigkeit. Sollte das Format der SQL-Anweisung ung�ltig sein, tritt bei der Verarbeitung der SQL-Anweisung durch Host On-Demand ein Laufzeitfehler auf, und Host On-Demand zeigt eine Fehlernachricht an.

Ausgabe von Ergebnis an
Hiermit wird das Ausgabeziel der Daten ausgew�hlt, die als Ergebnis einer SQL-Anweisung zur�ckgegeben wurden:
Dateiname
Die SQL-Anweisung ist eine SQL-Anweisung des Typs 'Select': Die SQL-Anweisung ist eine SQL-Anweisung des Typs 'Insert', 'Update', 'Delete': Ignorieren dieses Feld.
Dateityp
Klicken Sie auf den gew�nschten Datenbanktyp f�r die Ausgabedatei. Wenn die SQL-Anweisung eine SQL-Anweisung des Typs 'Insert', 'Update' oder 'Delete' ist, ignorieren dieses Feld.

Wenn der Dateityp HTML oder XML ist, h�lt Host On-Demand zus�tzliche Optionen (wie zum Beispiel Tabellenrahmen, Zellenabstand und weitere Optionen f�r den Dateityp 'HTML' sowie XML-Formatierungsoptionen und Zeichenverschl�sselung f�r den Dateityp 'XML') mit Standardeinstellungen bereit, die Sie im SQL-Assistenten (auf der Registerkarte 'Ausgabe') �ndern k�nnen. Im Fenster 'SQL-Anweisung konfigurieren' selbst k�nnen keine �nderungen ausgef�hrt werden; hier werden lediglich die Standardeinstellungen angezeigt.

Die Standardeinstellungen sind wie folgt:

Wenn Sie f�r eine dieser Optionen einen andere als die Standardeinstellung festlegen m�chten, erstellen Sie im SQL-Assistenten die entsprechende SQL-Anweisung (siehe Informationen zum Speichern und erneuten �ffnen von SQL-Anweisungen:) und geben Sie die gew�nschten Werte an. (Klicken Sie im SQL-Assistenten auf die Registerkarte 'Ausgabe', w�hlen Sie 'Datei' und anschlie�end 'HTML' oder 'XML' aus, und klicken Sie auf 'Einstellungen'). Wenn Sie die SQL-Anweisung ausf�hren, verwendet Host On-Demand die von Ihnen angegebenen Werte.

�berschreiben, Anh�ngen
Klicken Sie auf �berschreiben, damit der Inhalt der vorhandenen Datei �berschrieben wird, oder klicken Sie auf Anh�ngen, damit die Daten an die vorhandene Datei angef�gt werden. Sollte die Datei nicht vorhanden sein, wird die Datei bei Verwendung der Optionen '�berschreiben' bzw. 'Anh�ngen' erstellt. Wenn die SQL-Anweisung eine SQL-Anweisung des Typs 'Insert', 'Update' oder 'Delete' ist, ignorieren dieses Feld.
Ausf�hren
Klicken Sie auf 'Ausf�hren', um die SQL-Anweisung auszuf�hren. Die Ausf�hrung einer SQL-Anweisung von diesem Fenster aus erfolgt genau so, als ob Sie im Fenster 'Daten vom Host empfangen' auf 'Ausf�hren' klicken w�rden (siehe Ausf�hren ).
Speichern
Klicken Sie auf 'Speichern', um die SQL-Anweisung in der Definition der aktuellen Sitzung zu speichern. Die SQL-Anweisung wird in der Unterverzeichnisstruktur 'Aktuelle Sitzung' im Fenster 'Daten vom Host empfangen' angezeigt.

Wenn Sie eine SQL-Anweisung �ffnen, die Sie zuvor im Fenster 'SQL-Anweisung konfigurieren' gespeichert haben, �ffnet Host On-Demand die SQL-Anweisung im Fenster 'SQL-Anweisung konfigurieren' (siehe Informationen zum Speichern und erneuten �ffnen von SQL-Anweisungen).

Viele Felder im Fenster 'SQL-Abfrage konfigurieren' sind mit den Feldern im Fenster f�r SQL-Abfragen im Makroeditor identisch. Weitere Informationen zu diesen Feldern finden Sie unter SQLQuery action im Macro Programming Guide.

Zugeh�rige Abschnitte: