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 ]