SQL_BLOB_OBJ_CREATE erzeugt ein neues BLOB-Objekt und gibt den generierten REF-Wert aus. Eingegeben werden der Datenbankname und der REF-Wert der Klasse, in der das neue BLOB-Objekt enthalten sein soll. Es kann auch der REF-Wert eines bereits existierenden Objekts dieser Klasse angegeben werden. Folgende Werte werden bei der Erzeugung des neuen Objekts in die BLOB-Tabelle eingetragen:
Das BLOB-Objekt erhält eine innerhalb der Klasse eindeutige Objektnummer. Diese Objektnummer wird sequenziell vergeben.
Die Attribute des BLOB-Objekts mit den Namen (Tags) UPDATED und CREATED erhalten beide den aktuellen Zeitstempel. Die anderen Attribute werden aus den Voreinstellungen übernommen.
Der BLOB-Wert des neu erzeugten BLOB-Objekts hat die Länge 0.
Das Erzeugen eines BLOB-Objekts erfordert die Privilegien INSERT und SELECT auf BLOB-Tabellen und das UPDATE-Privileg auf die Spalte obj_ref der BLOB-Tabelle.
CLI-Deklaration in C:
void SQL_BLOB_OBJ_CREATE( char *REFvalue
,char const *CatalogId
,struct SQLda_t *SQLda);
CLI-Deklaration in COBOL:
IDENTIFICATION DIVISION. PROGRAM-ID. SQLbocr 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 SQLbocr.
REFvalue
Der REF-Wert der Klasse oder eines bereits existierenden Objekts derselben Klasse. 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.