browseNextElement()

Die Funktion 'browseNextElement()' liest Daten aus einer angegebenen iSeries-Datenwarteschlange, ohne die Daten aus der Warteschlange zu löschen. Vergleichen Sie diese Funktion mit der Funktion 'getNextElement()', die Daten auf dieselbe Weise liest, diese Daten jedoch 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.

Syntax

  iPlattformLib.browseNextElement(
    Datenwarteschlangendefinition DataQueueDefinition inOut,
    Elementdaten ANY inOut,
    Wartezeit INT in,
    [, Schlüsseldaten ANY in,
    Suchtyp CHAR[2] inOut] )
  returns (Ergebnis BOOLEAN)
Plattform
Die Zeichenfolge "Cobol" oder "Java™", je nach Plattform, für die Sie das Programm generieren.
Datenwarteschlangendefinition
Eine Variable auf Basis des Datensatzes für die Datenwarteschlangendefinition (DataQueueDefinition) (siehe iSeries-Datensatzdefinitionen).
Elementdaten
Das Ziel für die Daten. Wenn der Datentyp HEX(2)[] lautet, werden die Daten als Byte gelesen; andernfalls werden die Daten als Zeichenfolge (Typ STRING) gelesen.
Wartezeit
Gibt an, wie viele Sekunden die Funktion warten soll, wenn sie nicht in der Lage ist, die Leseoperation abzuschließen. Hierbei sind die beiden folgenden Sonderfälle zu beachten:
0
Unverzügliche Rückgabe.
-1
Unbegrenzte Wartezeit.
Schlüsseldaten
Optionale Angabe eines Schlüssels für Datenwarteschlangen mit geschlüsselten Daten.
Suchtyp
Die Beziehung zu den Schlüsseldaten, die übereinstimmende Daten erfüllen müssen. Der Suchtyp besteht aus einer der folgenden Beziehungen:
GT
Die Funktion liest nur die Elemente mit einem Schlüsselwert größer als dem Wert in Schlüsseldaten.
GE
Die Funktion liest nur die Elemente mit einem Schlüsselwert größer-gleich dem Wert in Schlüsseldaten.
EQ
Die Funktion liest nur die Elemente mit einem Schlüsselwert gleich dem Wert in Schlüsseldaten.
NE
Die Funktion liest nur die Elemente mit einem Schlüsselwert ungleich dem Wert in Schlüsseldaten.
LE
Die Funktion liest nur die Elemente mit einem Schlüsselwert kleiner-gleich dem Wert in Schlüsseldaten.
LT
Die Funktion liest nur die Elemente mit einem Schlüsselwert kleiner als dem Wert in Schlüsseldaten.
Ergebnis
Die Funktion gibt TRUE (wahr) zurück, wenn die Leseoperation erfolgreich war.

Feedback