FB_DBStoredProceduresRecordReturn

FB_DBStoredProceduresRecordReturn 1:

Mit dem Funktionsbaustein FB_DBStoredProceduresRecordReturn können gespeichert Prozeduren (Stored Procedures) aufgerufen werden die einen Datensatz zurückliefert. Sie können Parameter übergeben, die in den Gespeicherten Prozeduren verwendet werden.

VAR_INPUT

VAR_INPUT
 sNetID         : T_AmsNetID     :='';
 hDBID          : UDINT          :=1;
 sProcedureName : T_MaxString    :='';
 cbParameterList: UDINT;
 pParameterList : POINTER TO ARRAY[0..MAX_STORED_PROCEDURES_PARAMETERS] OF ST_DBParameter;
 nRecordIndex   : UDINT;
 cbRecordSize   : UDINT;
 pRecordAddr    : POINTER TO BYTE;
 bExecute       : BOOL;
 tTimeout       : TIME           := T#15s;
END_VAR

sNetID: String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.

hDBID: Gibt die ID der zu verwendenden Datenbank an.

sProcedureName: Gibt den Namen der Prozedur an, welche ausgeführt werden soll.

cbParameterList: Gibt die Länge der Parameterliste an.

pParameterList: Enthält die Adresse der Parameterliste

nRecordIndex: Gibt den Index des zu lesenden Datensatzes an.

cbRecordSize: Gibt die Größe eines Datensatzes in Byte an.

pRecordAddr: Gibt die Adresse der Struktur an in die der Datensatz geschrieben werden soll.

bExecute: Mit steigender Flanke wird das Kommando ausgeführt.

tTimeout: Gibt die Zeit bis zum Abbruch der Funktion an.

VAR_OUTPUT

VAR_OUTPUT
    bBusy    : BOOL;
    bError   : BOOL;
    nErrID   : UDINT;
    sSQLState: ST_DBSQLError;
    nRecords : UDINT;
END_VAR

bBusy: Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE ist, wird kein neues Kommando angenommen.

bError: Wird TRUE, sobald ein Fehler eintritt.

nErrID: Liefert bei einem gesetzten bError-Ausgang den ADS Error Code bzw. TcDatabaseSrv_Error_Codes.

sSQLState: Liefert den SQL - Fehlercode des entsprechenden Datenbanktyps.

nRecords: Liefert die Anzahl der Datensätze.

Voraussetzungen

Entwicklungsumgebung

Zielplattform

Einzubindende SPS Bibliotheken

TwinCAT v3.0.0

PC oder CX (x86)

Tc2_Database