Die Funktion 'getNextElement()' liest Daten aus einer angegebenen iSeries-Datenwarteschlange und löscht diese Daten anschließend aus der Warteschlange. Vergleichen Sie diese Funktion mit der Funktion 'browseNextElement()', die Daten auf dieselbe Weise liest, diese Daten jedoch nicht aus der Warteschlange löscht.
Wenn das Ziel für die Daten aus einer Feldgruppe aus HEX(2)-Elementen besteht, werden die Daten von der Funktion als unaufbereitete Byte gelesen; andernfalls werden die Daten als Zeichenfolge (STRING) gelesen.
Die Funktion liest das erste Element in der Warteschlange, sofern Sie keinen Schlüssel angeben. Wenn Sie einen Schlüssel angeben, liest die Funktion das/die Element(e), das/die dem Schlüssel und dem Suchtyp (beispielsweise größer als der Schlüsselwert, ungleich dem Schlüsselwert etc.) entspricht/entsprechen.
iPlattformLib.getNextElement(
Datenwarteschlangendefinition DataQueueDefinition inOut,
Elementdaten ANY inOut,
Wartezeit INT in,
[, Schlüsseldaten ANY in,
Suchtyp CHAR[2] inOut] )
returns (Ergebnis BOOLEAN)