JCI_GetArray

Die Funktion kopiert Elemente eines Java-Arrays in eine bereitgestellte COBOL-Tabelle.
Sie ist äquivalent zu den JNI-Funktionen Get<PrimitiveType>ArrayRegion.

Aufruf

CALL 'JCI_GetArray' USING aObj start num res

aObj start num res

Array-Objekt Startposition Anzahl Ergebnisbeschreibung

Argumente

aObj	Datenfeld des Typs JCI-object Array-Objekt, dessen Elemente kopiert werden sollen.
start	Datenfeld des Typs JCI-size Position des ersten Elementes im Java-Array, das übertragen werden soll (beginnend bei 1).
num	Datenfeld des Typs JCI-size Maximale Anzahl der Elemente, die übertragen werden sollen. Nach dem Aufruf enthält num die Anzahl der Elemente, die tatsächlich übertragen wurden.
res	eine Struktur der Form MethodRes Rückgabewert und Fehlerinformation (siehe Abschnitt „Argumente und Ergebniswerte von Java-Methoden"). ResType muss entsprechend des COBOL-Datentyps der Tabellenelemente gesetzt werden. Es sind weder RES-OBJECT noch RES-ANUM-STRING noch RES-NAT-STRING zulässig. Die Adresse der COBOL-Tabelle, in die die Elemente kopiert werden sollen, wird unabhängig vom Datentyp immer im Feld ResValAddr übergeben.

Returnwert (RETURN-CODE)

JCI-RET-OK

Der Aufruf war erfolgreich.

JCI-RET-ENOVM

Es ist keine Java-VM gestartet.

JCI-RET-ENULLOBJ

aObj ist JCI-NULL.

JCI-RET-EARGUMENT

aObj ist kein Array-Objekt.

JCI-RET-EINDAOB

num ist kleiner als 0 oder start ist kleiner als 1 oder größer als die Anzahl der Elemente des Arrays.

JCI-RET-ERESVERS

Die statisch generierte Versionsnummer in res ist ungültig (eventuell überschrieben).

JCI-RET-ERESTYPE

Der Wert des Feldes ResType ist ungültig.

JCI-RET-ERESCONV

Bei der Konvertierung der Tabellenelemente ist ein Fehler aufgetreten.
Das Feld ResErrIndex enthält die Nummer des COBOL-Tabellenelementes (beginnend bei 1), das Feld ResErrCode einen genaueren Fehlercode.
Alle Elemente bis zum fehlerhaften Element werden übertragen, alle nachfolgenden Felder der COBOL-Tabelle bleiben unverändert.

Hinweise

Es werden maximal (Anzahl Array-Elemente - start + 1) bzw. num Elemente übertagen.