Hostvariablen verwenden

Hostvariablen können unter folgenden Umständen benutzt werden:

In SELECT-, INSERT-, UPDATE- und DELETE-Anweisungen sind sie überall dort erlaubt, wo eine Zahlen- oder Zeichenfolgenkonstante erlaubt ist.
In der INTO-Klausel einer SELECT oder FETCH-Anweisung.
Hostvariablen können in Embedded SQL-Anweisungen auch anstelle eines Anweisungsnamens, eines Cursornamens oder eines Optionsnamens benutzt werden.
Bei CONNECT-, DISCONNECT- und SET CONNECT-Anweisungen kann eine Hostvariable anstelle eines Servernamens, eines Datenbanknamens, eines Verbindungsnamens, einer Benutzer-ID, eines Kennworts oder einer Verbindungszeichenfolge verwendet werden.
Bei SET OPTION und GET OPTION kann eine Hostvariable anstelle eines Optionswerts benutzt werden.

Hostvariablen können unter folgenden Umständen nicht benutzt werden:

Hostvariablen können in Anweisungen nicht anstelle eines Tabellennamens oder eines Spaltennamens benutzt werden.
Hostvariablen können nicht in Batches benutzt werden.
Hostvariablen können nicht in einer Unterabfrage einer SET-Anweisung verwendet werden.

Hostvariablen SQLCODE und SQLSTATE

Der ISO/ANSI-Standard gestattet es einer Embedded SQL-Quelldatei, die folgenden speziellen Hostvariablen innerhalb eines Embedded SQL-Deklarationsabschnitts zu deklarieren:

long SQLCODE;
char SQLSTATE[6];

Diese Variablen werden ggf. nach einer Embedded SQL-Anweisung gesetzt, die eine Datenbankanforderung enthält (EXEC SQL-Anweisungen, außer DECLARE SECTION, INCLUDE, WHENEVER SQLCODE usw.). Die Hostvariablen SQLCODE und SQLSTATE müssen daher im Bereich aller Embedded SQL-Anweisungen sichtbar sein, die Datenbankanforderungen generieren.

Folgendes ist gültiges Embedded SQL:

EXEC SQL INCLUDE SQLCA;
// declare SQLCODE with global scope
EXEC SQL BEGIN DECLARE SECTION;
long SQLCODE;
EXEC SQL END DECLARE SECTION;
sub1() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL CREATE TABLE ...
}
sub2() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL DROP TABLE ...
}

Der folgende Code ist kein gültiger Embedded SQL-Code, weil SQLSTATE im Bereich der Funktion sub2 nicht definiert wird:

EXEC SQL INCLUDE SQLCA;
sub1() {
 EXEC SQL BEGIN DECLARE SECTION;
 char SQLSTATE[6];
 EXEC SQL END DECLARE SECTION;
 exec SQL CREATE TABLE...
}
sub2() {
 exec SQL DROP TABLE...
}

Beachten Sie, dass die Option -k des SQL-Präprozessors die Deklaration der SQLCODE-Variablen außerhalb des Bereichs eines Embedded SQL-Deklarationsabschnitts zulässt.

Siehe auch

Kommentieren Sie diese Seite in DocCommentXchange.