SQL_BLOB_VAL_LEN - SQLbvle

SQL_BLOB_VAL_LEN bestimmt bei Eingabe des REF-Werts und des Datenbanknamens die Länge eines BLOB-Werts und gibt diese aus.

Für den Aufruf SQL_BLOB_VAL_LEN wird das SELECT-Privileg auf die BLOB-Tabelle benötigt.

CLI-Deklaration in C:

void SQL_BLOB_VAL_LEN( char const *REFvalue
          ,char const *CatalogId
          ,long int *ValueLength
          ,struct SQLda_t *SQLda);

CLI-Deklaration in COBOL:

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

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 mehr Leerzeichen angeben.

ValueLength

Länge des BLOB-Werts.

SQLda

Diagnosebereich.