SESAM/SQL V9.1 (de)

Folgende Aufrufe des SESAM-CLI stehen dem Anwender zur Verfügung:

Operationen mit Klassen von BLOB-Objekten

CLI-Aufruf	Kurzform	Funktion
SQL_BLOB_CLS_REF	SQLbcre	REF-Wert der Klasse bilden und ausgeben
SQL_BLOB_CLS_ISBTAB	SQLbcis	Prüfung, ob BLOB-Tabelle vorliegt

Tabelle 56: CLI-Aufrufe für Operationen mit Klassen von BLOB-Objekten

BLOB-Objekte erzeugen und löschen

CLI-Aufruf	Kurzform	Funktion
SQL_BLOB_OBJ_CLONE	SQLbocl	Objekt klonen
SQL_BLOB_OBJ_CREATE	SQLbocr	Objekt erzeugen (Objektnummer sequenziell)
SQL_BLOB_OBJ_CREAT2	SQLboc2	Objekt erzeugen (Objektnummer bereichspezifisch)
SQL_BLOB_OBJ_DROP	SQLbodr	Objekt löschen

Tabelle 57: CLI-Aufrufe für BLOB-Objekte

Attribut eines BLOB-Objekts lesen und setzen

CLI-Aufruf	Kurzform	Funktion
SQL_BLOB_TAG_GET	SQLbtge	Attributwert lesen
SQL_BLOB_TAG_PUT	SQLbtpu	Attributwert setzen

Tabelle 58: CLI-Aufrufe für Attribute von BLOB-Objekten

BLOB-Werte lesen und schreiben

CLI-Aufruf	Kurzform	Funktion
SQL_BLOB_VAL_GET	SQLbvge	BLOB-Wert lesen
SQL_BLOB_VAL_PUT	SQLbvpu	BLOB-Wert setzen
SQL_BLOB_VAL_LEN	SQLbvle	Länge des BLOB-Werts ausgeben

Tabelle 59: CLI-Aufrufe für BLOB-Werte

Sequenzielle Bearbeitung von BLOB-Werten

CLI-Aufruf	Kurzform	Funktion
SQL_BLOB_VAL_OPEN	SQLbvop	Access-Handle öffnen
SQL_BLOB_VAL_CLOSE	SQLbvcl	Access-Handle schließen
SQL_BLOB_VAL_FETCH	SQLbvfe	Sequenzielles Lesen eines BLOB-Werts
SQL_BLOB_VAL_STOW	SQLbvst	Sequenzielles Setzen eines BLOB-Werts

Tabelle 60: CLI-Aufruf für einzelne Sequenzen der BLOB-Werte

Attributwerte bei dynamischen INSERT-Anweisungen bestimmen

CLI-Aufruf	Kurzform	Funktion
SQL_DIAG_SEQ_GET	SQLdsg	Bereitstellung der Funktionalität des RETURN INTO aus statischen INSERT-Anweisungen für dynamische INSERT-Anweisungen

Tabelle 61: CLI-Aufruf zur Bestimmung von Attributwerten bei dynamischen INSERT-Anweisungen

Beispiel

Ein Beispielprogramm zur Bearbeitung von BLOB-Werten mit SESAM-CLI finden
Sie in der Bibliothek SIPANY.SESAM-SQL.090.MAN-DB. Bei diesem Programm
handelt es sich um ein ESQL-COBOL-Programm, aus dem C-Funktionen zur
Ausführung der CLI-Aufrufe aufgerufen werden.

Im Folgenden sind die Schritte skizziert, die notwendig sind, um ein BLOB-Objekt
zu erzeugen.

Der REF-Wert ref_value wird ausgegeben für die Klasse der BLOB-Objekte, zu
der das neue BLOB-Objekt gehören soll. Das BLOB-Objekt soll in der Tabelle
table im Schema schema liegen.
SQL_BLOB_CLS_REF(table, schema, ref_value, &SQLDA)
Das BLOB-Objekt wird erzeugt, wobei der REF-Wert ref_value der Klasse und
der Name der Datenbank catalog eingegeben werden. Ausgegeben wird der
REF-Wert ref_value des neuen BLOB-Objekts.
SQL_BLOB_OBJ_CREATE(ref_value, catalog, &SQLDA)
Ein Access-Handle wird zum Schreiben geöffnet mit ForWriteAccess=1.
Es werden der REF-Wert ref_value des BLOB-Objekts und der Datenbankname
catalog angegeben. Das Access-Handle wird im Folgenden durch den
zurückgelieferten Wert access_handle identifiziert.
```
SQL_BLOB_VAL_OPEN (ref_value, catalog, 
                   (long int const *)&ForWriteAccess,
                   access_handle, &SQLDA)
```
Innerhalb des Access-Handle wird der BLOB-Wert sequenziell gesetzt. Zur
Identifizierung des Access-Handle wird access_handle angegeben. Dieser
Schritt wird so oft wiederholt, bis der gesamte BLOB-Wert aus dem Puffer
gelesen wurde.
```
SQL_BLOB_VAL_STOW  (access_handle, input_buffer,
                   (long int const *)&n, &SQLDA)
```
Der Access-Handle wird geschlossen. Zur Identifizierung des Access-Handle
wird access_handle angegeben.
SQL_BLOB_VAL_CLOSE (access_handle, &SQLDA)

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

Übersicht