JCI_NewString

Die Funktion erzeugt ein neues Java-String-Objekt aus einer COBOL-Zeichenkette.
Sie ist äquivalent zur JNI-Funktion NewString. Sie bietet jedoch zusätzlich die Möglichkeit, alphanumerische (EBCDIC) Zeichenketten zu übergeben.

Aufruf

CALL 'JCI_NewString' USING arg res

arg res

Argumentbeschreibung Ergebnisbeschreibung

Argumente

arg	eine Struktur der Form MethodArg Beschreibung der Zeichenkette, aus der das String-Objekt erzeugt werden soll (siehe Abschnitt „Argumente und Ergebniswerte von Java-Methoden"). Es wird nur die Teilstruktur CallArg(1) benötigt. Als Wert von ArgType(1) ist nur ARG-ANUM-STRING bzw. ARG-NAT-STRING zulässig.
res	eine Struktur der Form MethodRes Rückgabewert und Fehlerinformation (nur Ausgabe, Ergebnis in ResValObject). Im Fehlerfall wird der Wert JCI-NULL zurückgeliefert.

Returnwert (RETURN-CODE)

JCI-RET-OK

Der Aufruf war erfolgreich.

JCI-RET-ENOVM

Es ist keine Java-VM gestartet.

JCI-RET-EARGVERS

Die statisch generierte Versionsnummer in arg 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 des Argumentes ist ein Fehler aufgetreten.
Das Feld ResErrCode enthält einen genaueren Fehlercode.

JCI-RET-ERR

Das Objekt konnte nicht erzeugt werden.

Exceptions

Die von der Funktion geworfenen Exceptions entsprechen denen der JNI-Funktion NewString.