FB_DBStoredProceduresRecordArray

FB_DBStoredProceduresRecordArray 1:

Mit dem Funktionsbaustein FB_DBStoredProceduresRecordArray können Gespeichert Prozeduren aufgerufen werden die Datensätze zurückliefert. Im Gegensatz zum FB_DBStoredProceduresRecordReturn können mit diesem Baustein auch mehrere Datensätze mit einem Aufruf zurückgeliefert werden. Sie können Parameter mit ü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;
    nStartIndex     : UDINT;
    nRecordCount    : UDINT
    cbRecordArraySize       : UDINT;
    pDesAddr        : DWORD;
    bExecute        : BOOL;
    tTimeout        : TIME         := T#15s;
END_VAR

sNetID                            : Ist ein 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 Procedure an, welche ausgeführt werden soll

cbParameterList        : Gibt die Länge der Parameterliste an.

pParameterList          : Enthält die Adresse der Parameterliste

nStartIndex                  : Gibt den Index des ersten zu lesenden Datensatzes an.

nRecordCount             : Gibt die Anzahl der zu lesenden Datensätzen an.

cbRecordArraySize   : Gibt die Größe des Strukturarrays in Byte an.

pDestAddr                    : Gibt die Adresse des Strukturarrays an in das die Datensätze geschrieben werden soll.

bExecute                      : Mit der steigende Flanke wird das Kommando ausgeführt.

tTimeout                       : Gibt die Zeit bis zum Abbrechen 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, 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 v2.10.0

PC oder CX (x86)

TcDatabase.Lib (Ab TcDatabaseSrv Version 1.0.17)

TwinCAT v2.10.0

CX (ARM)