ALLOCATE DESCRIPTOR legt einen SQL-Deskriptorbereich an. Der Deskriptorbereich dient bei dynamisch formulierten Anweisungen und Cursorbeschreibungen als Schnittstelle zwischen dem Anwendungsprogramm und der SQL-Datenbank.
Aufbau und Verwendung eines Deskriptorbereichseintrags sind im Abschnitt „Deskriptorbereich" beschrieben. Nach dem Anlegen des Bereichs mit ALLOCATE DESCRIPTOR ist der Inhalt zunächst noch nicht definiert.
ALLOCATE DESCRIPTOR GLOBAL deskriptor [WITH MAX anzahl ]
deskriptor ::= { alphanumerisches_literal | : benutzervariable }
anzahl ::= { ganzzahl | : benutzervariable }
GLOBAL
Der angelegte Deskriptorbereich kann in jeder Übersetzungseinheit der aktuellen SQL-Session verwendet werden.
deskriptor
Zeichenkette, die den Namen des SQL-Deskriptorbereichs enthält. Für deskriptor können Sie ein alphanumerisches Literal (nicht in der sedezimaler Form) oder eine alphanumerische Benutzervariable vom SQL-Datentyp CHAR(n) angeben, mit 1 <= n <= 18.
Der Deskriptorbereichsname kann mit einem oder mehreren Leerzeichen beginnen und enden. Nach Entfernen von führenden und abschließenden Leerzeichen muss die verbleibende Zeichenfolge ein einfacher Name sein (siehe Abschnitt „Einfache Namen" ).
Zwei Deskriptorbereichsnamen gelten als gleich, wenn nach Entfernen der Leerzeichen die verbleibenden einfachen Namen gleich sind (siehe Abschnitt „Gleichheit von einfachen Namen").
anzahl
Maximale Anzahl von Einträgen im SQL-Deskriptorbereich.
Für anzahl können Sie eine Ganzzahl oder eine Benutzervariable vom SQL-Datentyp SMALLINT angeben mit 1 <= anzahl <= 1000.
anzahl bestimmt die Größe des reservierten SQL-Deskriptorbereichs.
Wenn Sie längere alphanumerische Werte im Deskriptorbereich ablegen, reicht der Platz im Deskriptorbereich unter Umständen nicht aus, und Sie erhalten einen entsprechendenSQLSTATE. In diesem Fall müssen Sie anzahl erhöhen (siehe Beispiel).
Zur Speicherung von SQL-Deskriptorbereichen wird in UTM-Anwendungen das „UTM-Vorgangsmemory“ verwendet. Reicht dieser Speicherplatz nicht aus, so erfolgt eine Fehlermeldung.
WITH MAX anzahl nicht angegeben:
Für anzahl ist der Wert 20 voreingestellt.
Beispiele
SQL-Deskriptorbereich für maximal 100 Einträge anlegen:
ALLOCATE DESCRIPTOR GLOBAL :demo_desc WITH MAX 100
SQL-Deskriptorbereich für 100 Einträge anlegen. Der Deskriptorbereich soll so groß sein, dass die Einträge Werte vom Typ CHAR(80) speichern können:
ALLOCATE DESCRIPTOR GLOBAL :demo_desc WITH MAX 200
Siehe auch
DEALLOCATE DESCRIPTOR, DESCRIBE, GET DESCRIPTOR, SET DESCRIPTOR