SQL_BLOB_OBJ_DROP löscht ein existierendes BLOB-Objekt bei Eingabe des Datenbanknamens und des REF-Werts. Mit dem BLOB-Objekt werden auch der BLOB-Wert und alle seine Attribute gelöscht. Das Löschen eines BLOB-Objekts wird durch das Löschen von einem oder mehreren Sätzen in der BLOB-Tabelle realisiert. Falls dabei ein Fehler auftritt, wird dieser zurückgemeldet und das BLOB-Objekt bleibt unverändert. (Das Attribut UPDATED kann jedoch verändert sein.) Die Synchronisation von konkurrierenden Transaktionen erfolgt wie in SESAM/SQL üblich.
Das Löschen eines BLOB-Objekts erfordert die Privilegien DELETE und SELECT für die BLOB-Tabelle und das UPDATE-Privileg auf die Spalte slice_val der BLOB-Tabelle.
CLI-Deklaration in C:
void SQL_BLOB_OBJ_DROP( char const *REFvalue
,char const *CatalogId
,struct SQLda_t *SQLda);
CLI-Deklaration in COBOL:
IDENTIFICATION DIVISION. PROGRAM-ID. SQLbodr IS PROTOTYPE. DATA DIVISION. LINKAGE SECTION. 01 REFvalue PIC X(237). 01 CatalogId PIC X(31). COPY SQLCA. *> for group item SQLda. PROCEDURE DIVISION USING REFvalue, CatalogId, SQLda. END PROGRAM SQLbodr.
REFvalue
Der REF-Wert des BLOB-Objekts. Die genaue Struktur des REF-Werts ist auf "Spaltendefinition" beschrieben.
CatalogId
Name der Datenbank, in der die Tabelle liegt. CatalogId ist ein einfacher Name (siehe Abschnitt „Einfache Namen"). Der Name muss gegebenenfalls mit Leerzeichen auf 31 Zeichen verlängert oder mit einem Null-Byte abgeschlossen werden. Soll der Name der voreingestellten Datenbank verwendet werden, so müssen Sie statt des Datenbanknamens ein Null-Byte, ein oder mehrere Leerzeichen angeben.
SQLda
Diagnosebereich.