MPE/iX Intrinsics Reference Manual (32650-90875)

436 Chapter8
Command Definitions (HPMERGEEND-LOGSTATUS)
HPSORTINIT
HPSORTINIT
NM callable only.
Initializes the SORT/XL subsystem.
Syntax
I32 I32A I32A I32
HPSORTINIT(
status,inputfiles,outputfiles,outputoption,
I32V I32V I32V I32A
reclength,numrecs,numkeys,keys
CA PROC PROC I32A
altseq,keycompare,errorproc,statistics ,
I32V I32A
memsize,charseq );
Parameters
status 32-bit signed integer by reference (optional)
Returns the status of the HPSORTINIT call. If no errors or warnings are
encountered,
status returns 32 bits of zero. If errors or warnings are
encountered,
status is interpreted as two 16-bit fields.
Bits (0:16) comprise
status.info . A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys . The value represented by these bits
defines the subsystem that set the status information. The subsystem
identifier for HPSORTINIT is 195.
inputfiles 32-bit signed integer array (optional)
Passes the file identification numbers of the input files to be sorted. The
last element of this array should be set to zero. If the files are opened with
either the NOBUF or MR (multirecord) access option (
aoption ), the
Hewlett-Packard SORT program performs the buffering and
blocking\deblocking. $NULL is not a valid input file.
If this parameter is not used, there must be a call to HPSORTINPUT to
supply records to the Hewlett-Packard SORT program.
outputfiles 32-bit signed integer array (optional)
Passes the file identification number of the output file. The second array
element must be a zero, indicating the end of the array. If the files are
opened with either the NOBUF or MR (multirecord) access option (
aoption ),
the SORT/XL program performs the buffering and blocking\deblocking.
If you do not supply this parameter, you must call HPSORTOUTPUT to