MPE/iX Intrinsics Reference Manual (32650-90905)

560 Chapter9
Command Definitions (MAIL-PUTJCW)
NLREPCHAR
NLREPCHAR
NM and CM callable.
Replaces all nondisplayable control characters in the string with the replacement
character. Nondisplayable characters are those with attribute 3 (undefined graphic
character) or 5 (control code), as returned by
itemnum =12 of the NLINFO intrinsic.
Syntax
CA CA I16V
NLREPCHAR(
inbuffer,outbuffer,bufferlength,
CV I16V U16A U16A
replacechar,langnum,error , charset );
Parameters
inbuffer character array (required)
Passes the nondisplayable characters to be replaced.
outbuffer character array (required)
Returns the replaced character string.
bufferlength 16-bit signed integer by value (required)
Passes the length, in bytes, of
inbuffer .
replacechar character by value (required)
Contains the replacement character to be used.
langnum 16-bit signed integer by value (required)
Contains the language ID number.
error 16-bit unsigned integer array (required)
Returns two elements: the first element is the error number; the second
element is reserved and always returns 0. The possible error number
values are:
Value Meaning
0
Successful
1 *NLS not installed
2 *Specified language not configured
3 Invalid replacement character
4 Invalid length parameter
5 *NLS internal error
6 *NLS internal error