Scan String for Mixed Data (QLGSCNMX) API

Required Parameter Group:

1	Double-byte indicator	Output	Char(1)
2	Input data buffer	Input	Char(*)
3	Length of input data buffer	Input	Binary(4)
4	Error code	I/O	Char(*)

Default Public Authority: *EXCLUDE

Threadsafe: No

The Scan String for Mixed Data (QLGSCNMX) API tests a mixed EBCDIC input string to determine if the data contains any double-byte characters. If so, the double-byte indicator will be set to 1.

The QLGSCNMX API determines that a mixed EBCDIC input string contains double-byte characters when the shift-out (X'0E') control character is present.

Authorities and Locks

None.

Required Parameter Group

Double-byte indicator

OUTPUT; CHAR(1)

Information about the input data. The valid values are:

0	Input data does not contain double-byte data.
1	Input data contains double-byte data.

Input data buffer

INPUT; CHAR(*)

The data to be scanned.

Length of input data buffer

INPUT; BINARY(4)

The length of the input data buffer. The valid range is 1 to 32767 bytes.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF24B4 E	Severe error while addressing parameter list.
CPF2647 E	Buffer length not valid.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

API introduced: V2R3

[ Back to top | National Language Support APIs | APIs by category ]