Appendix A HPSORT Intrinsic Status Returns

If you specified the keycompare parameter, you can not specify the keys and numkeys parameters.

You specified the keycompare and the keys and numkeys parameters in the HPSORTINIT intrinsic.

Specify the keycompare parameter or else specify the keys and numkeys parameters in the HPSORTINIT.

If you do not specify the keycompare parameter, you must specify the keys and numkeys parameters.

You specified neither the keycompare parameter or the keys and numkeys parameters in the HPSORTINIT intrinsic.

Specify either the keycompare parameter or specify the keys and numkeys parameters in the HPSORTINIT intrinsic.

You did not specify a reclength parameter, or you specified it less than or equal to 0.

You specified the reclength parameter in the HPSORTINIT intrinsic to be less than or equal to 0. or you did not specify an inputfile or use HPSORTINPUT.

Set the reclength parameter to a value that is greater than 1 or specify the inputfiles parameter use the HPSORTINPUT intrinsic.

You must not specify the keycompare parameter if you specified the outputoption parameter as greater than 1.

The keycompare is only allowed when the entire record is output.

Change outputoption to 1 or don't use keycompare.

FREAD error on the scratch file.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

Illegal output option.

You specified the outputoption parameter in HPSORTINIT to be less than zero or greater than three.

Set the outputoption parameter to 0, 1, 2, or 3.

The scratch file cannot be opened.

A common cause of this problem is that there is not enough contiguous disk space available for the scratch file.

Compare the size of the file to be sorted with the available contiguous disk space. Purge or archive files to tape as necessary.

Failure on FGETINFO (inputfile).

CCL condition code returned from the FGETINFO intrinsic called from SORT/XL.

Make sure the file number has not been corrupted. Also refer to the FGETINFO intrinsic in the MPE XL Intrinsics Reference Manual

Illegal numkeys parameter.

You specified the numkeys parameter in HPSORTINIT to not correlate to the number of keys in the keys parameter.

Set the numkeys parameter to correspond to the number of keys that you specified in the keys parameter.

The key field is not within the specified record length.

A key specified in your keys parameter in HPSORTINIT, indicates a field that begins and/or ends outside of the record.

Set the key field in the keys parameter to be contained in the record length or make sure that your record length is long enough to contain all your keys.

Illegal ascending/descending code.

The 4th element for a key in the keys array parameter in HPSORTINIT is less than 0 or greater than 1.

Set the 4th element for a key in the keys array parameter to 0 or 1.

Illegal key code.

The 3rd element in the keys array parameter in HPSORTINIT is less than 0 or greater than 13.

Set the 3rd element in the keys array parameter to a value that is from 0-13 inclusive.

Insufficient stack space.

Input file was opened with NOBUFF and MULTI options. The stack was used for blocking/deblocking the file and has insufficient space.

Open your files with the BUFF and NOMULTI options.

The input record does not include all key fields.

You are using variable length records that contain records that are not long enough to contain the key fields.

Set the key field in the keys parameter to be contained in the shortest record length or make sure that your shortest record is long enough to contain all your keys.

The input record is too long.

The input record is longer than specified in the reclength parameter.

Alter the reclength parameter to accurately reflect the record length.

There are too many input records.

SORT/XL internal error.

Contact your Hewlett-Packard representative.

FWRITE error on the scratch file.

SORT/XL internal error.

Contact your Hewlett-Packard representative.

FREAD error on the input file.

CCL returned from the FREAD intrinsic called from SORT/XL.

Make sure your input file number has not been corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

FWRITE error on the output file.

CCL returned from the FWRITE intrinsic called from SORT/XL.

Make sure your output file number has not been corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

FCLOSE error on the scratch file.

SORT/XL internal error.

Contact your Hewlett-Packard representative.

$NULL is not a valid input file.

You specified $NULL as an input file.

Change the file specification to another file.

Failure on FGETINFO (outputfile).

CCL returned from the FGETINFO intrinsic called from SORT/XL.

Make sure the output file number has not been corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

Error in attempting to write EOF on the scratch file.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

Error attempting to rewind the scratch file.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

Illegal characteristics
for opening the scratch file with FOPEN.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

Insufficient stack space for the specified allocation.

The amount of space that you specified in the memsize parameter does not allow enough room to perform the sort.

Increase the value of the parameter or do not specify the memsize| parameter and let SORT/XL use as much stack space as it needs.

Failure of FFILEINFO (inputfile).

CCL returned from the FFILEINFO intrinsic called from SORT/XL.

Make sure that the input file number is not corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

Failure of FFILEINFO (outputfile).

CCL returned from the FFILEINFO intrinsic called from SORT/XL.

Make sure that the output file number is not corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

The sort language is not supported.

The language specified in the second element of the charseq parameter array in HPSORTINIT is not supported on your system.

Check valid language IDs by running NLUTIL. Set the second element of the charseq array to a valid language ID.

NLINFO error obtaining the length of the collating sequence table.

Native Language (NL) not installed or internal NL error.

Contact your system manager or your Hewlett-Packard representative.

NLINFO error loading the collating sequence table.

Native Language (NL) not installed or internal NL error.

Contact your system manager or your Hewlett-Packard representative.

Invalid charseq parameter.

The first element of the charseq parameter array is a value other than one (1).

Set the first element in the charseq parameter array to one.

A two-byte collating sequence table is not specified.

A two-byte collating sequence table was not specified in the charseq parameter although a two-byte key was specified in the keys parameter.

Specify a two-byte sequence in both the charseq and keys parameters.

FGETINFO failure on the two-byte
collating sequence table.

CCL returned from the FGETINFO intrinsic called from SORT/XL.

Make sure the file number passed in charseq is not corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

FREAD error on the two-byte collating sequence table.

CCL returned from the FREAD intrinsic called from SORT/XL.

Make sure the file number passed in charseq is not corrupted. Also refer to the MPE XL Intrinsics Reference Manual.

The file is not a valid two-byte collating sequence.

Error returned from NLINFO intrinsic called from SORT/XL.

Check the file type. Also refer to the MPE XL Intrinsics Reference Manual.

Two-byte xxxx is undefined in the collating sequence table; the largest number is assigned.

The two-byte value, xxxx, is undefined.

Change xxxx to the correct value.

The length of the two-byte key must be an even number of bytes.

Although you specified a two-byte sequence, the key length specified in the keys parameter is an odd number.

Specify the key length as an even number.

The file type is not a valid two-byte collating sequence table.

The file containing the two-byte sequence has been corrupted, or Native Language (NL) not installed or internal NL error.

Contact your system manager or your Hewlett-Packard representative.

PRINT intrinsic failed in HPSORTTITLE.

You redirected output from HPSORTTITLE to a file that is too small; HPSORTTITLE requires two records to output information.

Allow room for at least two records when you redirect output from HPSORTTITLE to a file.

PRINT intrinsic failed in HPSORTSTAT.

You redirected output from HPSORTSTAT to a file that is too small; HPSORTSTAT requires ten records to output information.

Allow room for at least ten records when you redirect output from HPSORTSTAT to a file.

There are too many input files.

You input more than 100 input files to SORT/XL.

Run SORT/XL several times with allowable number of files then run MERGE/XL to merge the sorted files or consolidate several files into one until you are within SORT/XL's limit.

There are no input files in the supplied parameter.

You did not specify any input file numbers in the inputfiles parameter of the HPSORTINIT intrinsic. The array contains no file numbers.

Specify input file numbers in the inputfiles parameter of the HPSORTINPUT intrinsic.

If you specify the keys parameter, you must also specify the numkeys parameter.

You specified the keys parameter without specifying the numkeys parameter in HPSORTINIT (or vice-versa).

Specify both the numkeys and the keys parameters.

The record length exceeds the maximum allowed.

Internal File System error.

Contact your Hewlett-Packard representative.

Insufficient memory allocated for the record size.

You are trying to sort more data than SORT/XL can handle.

If you are sorting one large file, break it into several smaller files. If you are sorting many large files, sort them individually and then merge them with MERGE/XL.

Open of storage area failed.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

NM to CM switch occurred, but NM cannot handle the sort.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

Invalid input file number.

Input file number specified in inputfiles parameter of HPSORTINIT intrinsic is not a valid file number.

Don't hardcode a file number for the inputfiles parameter, make sure the file number returned from the HPFOPEN or FOPEN intrinsic is not corrupted.

Record length exceeds maximum allowed.

Internal File System error.

Contact your Hewlett-Packard representative.

PROBE failure on the status parameter of the
HPSORTINIT intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the inputfiles parameter of the HPSORTINIT intrinsic.

The address specified in the inputfiles parameter is not within the allowable address range.

Check the value of the inputfiles parameter.

PROBE failure on the outputfiles parameter of the HPSORTINIT intrinsic.

The address specified in the outputfiles parameter is not within the allowable address range.

Check the value of the outputfiles parameter.

PROBE failure on the keys parameter of the
HPSORTINIT intrinsic.

The address specified in the keys parameter is not within the allowable address range.

Check the value of the keys parameter.

PROBE failure on the altseq parameter of the
HPSORTINIT intrinsic.

The address specified in the altseq parameter is not within the allowable address range.

Check the value of the altseq parameter.

PROBE failure on the statistics parameter of the HPSORTINIT intrinsic.

The address specified in the statistics parameter is not within the allowable address range.

Check the value of the statistics parameter.

PROBE failure on the charseq parameter of the
HPSORTINIT intrinsic.

The address specified in the charseq parameter is not within the allowable address range.

Check the value of the charseq parameter.

PROBE failure on the status parameter of the
HPSORTINPUT intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the buffer parameter of the
HPSORTINPUT intrinsic.

The address specified in the buffer parameter is not within the allowable address range.

Check the value of the buffer parameter.

PROBE failure on the length parameter of the
HPSORTINPUT intrinsic.

The address specified in the length parameter is not within the allowable address range.

Check the value of the length parameter.

PROBE failure on the status parameter of the
HPSORTOUTPUT intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the buffer parameter of the
HPSORTOUTPUT intrinsic.

The address specified in the buffer parameter is not within the allowable address range.

Check the value of the buffer parameter.

PROBE failure on the length parameter of the
HPSORTOUTPUT intrinsic.

The address specified in the length parameter is not within the allowable address range.

Check the value of the length parameter.

PROBE failure on the status parameter of the
HPSORTEND intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the statistics parameter of the HPSORTEND intrinsic.

The address specified in the statistics parameter is not within the allowable address range.

Check the value of the statistics parameter.

PROBE failure on the status parameter of the
HPSORTERRORMESS intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the message parameter of the
HPSORTERRORMESS intrinsic.

The address specified in the message parameter is not within the allowable address range.

Check the value of the message parameter.

PROBE failure on the length parameter of the
HPSORTERRORMESS intrinsic.

The address specified in the length parameter is not within the allowable address range.

Check the value of the length parameter.

PROBE failure on the status parameter of the
HPSORTSTAT intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

PROBE failure on the statistics parameter of the HPSORTSTAT intrinsic.

The address specified in the statistics parameter is not within the allowable address range.

Check the value of the statistics parameter.

PROBE failure on the status parameter of the
HPSORTTITLE intrinsic.

The address specified in the status parameter is not within the allowable address range.

Check the value of the status parameter.

Previous NM error occurred.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTTITLE call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTERRORMESS call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTEND2 call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTEND1 call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTOUTPUT call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTINPUT call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTGETHIDP call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

SWITCH_TO_CM error on the SORTINIT call.

Internal SORT/XL error.

Contact your Hewlett-Packard representative.

HPSORTERRORMESS failed on the call to HPERRMSG.

You called the HPSORTERRORMESS intrinsic even though there was no error.

Only call HPSORTERRORMESS if the status parameter from the previous intrinsic call does not equal zero.