SQL_BLOB_OBJ_CREAT2 - SQLboc2

SQL_BLOB_OBJ_CREAT2 erzeugt ein neues BLOB-Objekt und gibt den generierten REF-Wert aus. Eingegeben werden der Datenbankname, der REF-Wert der Klasse, in der das neue BLOB-Objekt enthalten sein soll, sowie ein Intervall für die Objektnummer. 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 innerhalb des angegebenen Intervalls nach einem bestimmten Algorithmus vergeben. Dieser gewährleistet, dass die Objektnummern bei mehreren SQL_BLOB_OBJ_CREAT2-Aufrufen gleichmäßig auf das angegebene Intervall verteilt werden.

• 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_CREAT2( char *REFvalue
          ,char const *CatalogId
          ,long int *MinObjectNmbr
          ,long int *MaxObjectNmbr
          ,struct SQLda_t *SQLda);

CLI-Deklaration in Cobol:

IDENTIFICATION DIVISION.
PROGRAM-ID. SQLboc2 IS PROTOTYPE.
DATA DIVISION.
LINKAGE SECTION.
   01 REFvalue PIC X(237).
   01 CatalogId PIC X(31).
   01 MinObjectNmbr PIC S9(9) COMP.
   01 MaxObjectNmbr PIC S9(9) COMP.
   COPY SQLCA.     *> for group item SQLda.
PROCEDURE DIVISION USING REFvalue, MinObjectNmbr, MaxObjectNmbr, CatalogId, 
          SQLda.
END PROGRAM SQLboc2.

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.

MinObjectNmbr

Minimalwert für die Objektnummer (muss >= 1 sein).

MaxObjectNmbr

Maximalwert für die Objektnummer (muss größer als oder gleich dem Minimalwert sein).

SQLda

Diagnosebereich.