MPE/iX Intrinsics Reference Manual (32650-90905)

516 Chapter9
Command Definitions (MAIL-PUTJCW)
NLCOLLATE2
NLCOLLATE2
NM callable.
Collates two character strings according to the specified language collating sequence and
determines a lexical ordering. Designed to be used with a COBOL program.
Syntax
I32 CA I32V CA I32V
result :=NLCOLLATE2( buffer1,len1,buffer2,len2,
I16V U16A U16A U16A
langnum,error , collseq );
Parameters
result 32-bit signed integer by reference (required)
Returns the result of the collated character strings (
buffer1 and
buffer2 ):
Value Meaning
0
buffer1 collates equal to buffer2
-1 buffer1 collates before buffer2
1 buffer1 collates after buffer2
The result is 0 if a nonzero error is returned.
buffer1 character array (required)
Passes the first character string to be collated.
len1 32-bit signed integer by value (required)
The length, in bytes, of the first character string.
buffer2 character array (required)
Passes the second character string to be collated.
len2 32-bit signed integer by value (required)
The length, in bytes, of the second character string.
langnum 16-bit signed integer by value (required)
Contains the language ID number, specifying the collating sequence to be
used.
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: