JCI_NewString

This function generates a new Java string object from a COBOL string.It is equivalent to the JNI function NewString. However, it also offers the option of transferring alphanumeric (EBCDIC) strings directly.

Call

CALL 'JCI_NewString' USING arg res

arg	Argument description
res	Result description

Arguments

arg	A structure of the form MethodArg Description of the string from which the string object is to be generated (see section "Arguments and event values of Java methods"). Only the partial structure CallArg(1) is required. The only permissible value for ArgType(1) is ARG-ANUM-STRING or ARG-NAT-STRING.
res	A structure of the form MethodRes Return value and error information (output only, result in ResValObject). In the event of an error, the value JCI-NULL is returned.

Return value (RETURN-CODE)

JCI-RET-OK

The call was successful.

JCI-RET-ENOVM

No Java VM has been started.

JCI-RET-EARGVERS

The statically generated version number in arg is invalid (possibly overwritten).

JCI-RET-ERESVERS

The statically generated version number in res is invalid (possibly overwritten).

JCI-RET-EARGTYPE

The value of the ArgType field is invalid.

JCI-RET-EARGCONV

An error occurred while the argument was being converted.
The ResErrCode field contains a more precise error code.

JCI-RET-ERR

The object could not be generated.

Exceptions

The exceptions generated by the function correspond to those of the JNI function NewString.