JCI_SetArray

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

Aufruf

CALL 'JCI_SetArray' USING aObj start num arg res

aObj start num arg res

Array-Objekt Startposition Anzahl Argumentbeschreibung Ergebnisbeschreibung

Argumente

aObj	Datenfeld des Typs JCI-object Array-Objekt, dessen Elemente gesetzt werden sollen.
start	Datenfeld des Typs JCI-size Position des ersten Elementes im Java-Array, das überschrieben 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, im Fehlerfall 0.
arg	eine Struktur der Form MethodArg Beschreibung der Array-Elemente. Es werden nur die Felder ArgType(1) und ArgValAddr(1) benötigt. ArgType(1) muss entsprechend des COBOL-Datentyps der Tabellenelemente gesetzt werden. Es sind weder ARG-OBJECT noch ARG-ANUM-STRING noch ARG-NAT-STRING zulässig. Die Adresse der COBOL-Tabelle, aus der die Elemente kopiert werden sollen, wird unabhängig vom Datentyp immer im Feld ArgValAddr(1) übergeben.
res	eine Struktur der Form MethodRes Fehlerinformation (nur Ausgabe).

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-EARGVERS

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

JCI-RET-ERESVERS

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

JCI-RET-EARGTYPE

Der Wert des Feldes ArgType ist ungültig.

JCI-RET-EARGCONV

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.
Tritt bei einem Element ein Konvertierungsfehler auf, so findet keine Übertragung statt, d. h. alle Felder des Java-Arrays bleiben unverändert

JCI-RET-EINDAOB

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

Hinweise

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