Appendix A HPSORT Intrinsic Status Returns

-1

MESSAGE

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

CAUSE

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

ACTION

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

-2

MESSAGE

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

CAUSE

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

ACTION

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

-3

MESSAGE

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

CAUSE

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.

ACTION

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

-4

MESSAGE

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

CAUSE

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

ACTION

Change outputoption to 1 or don't use keycompare.

-5

MESSAGE

FREAD error on the scratch file.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-6

MESSAGE

Illegal output option.

CAUSE

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

ACTION

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

-7

MESSAGE

The scratch file cannot be opened.

CAUSE

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

ACTION

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

-8

MESSAGE

Failure on FGETINFO (inputfile).

CAUSE

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

ACTION

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

-9

MESSAGE

Illegal numkeys parameter.

CAUSE

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

ACTION

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

-10

MESSAGE

The key field is not within the specified record length.

CAUSE

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

ACTION

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.

-11

MESSAGE

Illegal ascending/descending code.

CAUSE

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

ACTION

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

-12

MESSAGE

Illegal key code.

CAUSE

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

ACTION

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

-13

MESSAGE

Insufficient stack space.

CAUSE

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

ACTION

Open your files with the BUFF and NOMULTI options.

-14

MESSAGE

The input record does not include all key fields.

CAUSE

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

ACTION

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.

-15

MESSAGE

The input record is too long.

CAUSE

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

ACTION

Alter the reclength parameter to accurately reflect the record length.

-16

MESSAGE

There are too many input records.

CAUSE

SORT/XL internal error.

ACTION

Contact your Hewlett-Packard representative.

-17

MESSAGE

FWRITE error on the scratch file.

CAUSE

SORT/XL internal error.

ACTION

Contact your Hewlett-Packard representative.

-18

MESSAGE

FREAD error on the input file.

CAUSE

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

ACTION

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

-19

MESSAGE

FWRITE error on the output file.

CAUSE

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

ACTION

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

-20

MESSAGE

FCLOSE error on the scratch file.

CAUSE

SORT/XL internal error.

ACTION

Contact your Hewlett-Packard representative.

-21

MESSAGE

$NULL is not a valid input file.

CAUSE

You specified $NULL as an input file.

ACTION

Change the file specification to another file.

-22

MESSAGE

Failure on FGETINFO (outputfile).

CAUSE

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

ACTION

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

-23

MESSAGE

Error in attempting to write EOF on the scratch file.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-24

MESSAGE

Error attempting to rewind the scratch file.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-25

MESSAGE

Illegal characteristics for opening the scratch file with FOPEN.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-26

MESSAGE

Insufficient stack space for the specified allocation.

CAUSE

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

ACTION

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.

-27

MESSAGE

Failure of FFILEINFO (inputfile).

CAUSE

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

ACTION

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

-28

MESSAGE

Failure of FFILEINFO (outputfile).

CAUSE

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

ACTION

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

-29

MESSAGE

The sort language is not supported.

CAUSE

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

ACTION

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

-30

MESSAGE

NLINFO error obtaining the length of the collating sequence table.

CAUSE

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

ACTION

Contact your system manager or your Hewlett-Packard representative.

-31

MESSAGE

NLINFO error loading the collating sequence table.

CAUSE

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

ACTION

Contact your system manager or your Hewlett-Packard representative.

-32

MESSAGE

Invalid charseq parameter.

CAUSE

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

ACTION

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

-33

MESSAGE

A two-byte collating sequence table is not specified.

CAUSE

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

ACTION

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

-34

MESSAGE

FGETINFO failure on the two-byte collating sequence table.

CAUSE

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

ACTION

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

-35

MESSAGE

FREAD error on the two-byte collating sequence table.

CAUSE

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

ACTION

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

-36

MESSAGE

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

CAUSE

Error returned from NLINFO intrinsic called from SORT/XL.

ACTION

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

-37

MESSAGE

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

CAUSE

The two-byte value, xxxx, is undefined.

ACTION

Change xxxx to the correct value.

-38

MESSAGE

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

CAUSE

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

ACTION

Specify the key length as an even number.

-39

MESSAGE

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

CAUSE

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

ACTION

Contact your system manager or your Hewlett-Packard representative.

-40

MESSAGE

PRINT intrinsic failed in HPSORTTITLE.

CAUSE

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

ACTION

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

-41

MESSAGE

PRINT intrinsic failed in HPSORTSTAT.

CAUSE

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

ACTION

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

-190

MESSAGE

There are too many input files.

CAUSE

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

ACTION

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.

-191

MESSAGE

There are no input files in the supplied parameter.

CAUSE

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

ACTION

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

-193

MESSAGE

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

CAUSE

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

ACTION

Specify both the numkeys and the keys parameters.

-199

MESSAGE

The record length exceeds the maximum allowed.

CAUSE

Internal File System error.

ACTION

Contact your Hewlett-Packard representative.

-200

MESSAGE

Insufficient memory allocated for the record size.

CAUSE

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

ACTION

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.

-201

MESSAGE

Open of storage area failed.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-202

MESSAGE

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

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-203

MESSAGE

Invalid input file number.

CAUSE

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

ACTION

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.

-204

MESSAGE

Record length exceeds maximum allowed.

CAUSE

Internal File System error.

ACTION

Contact your Hewlett-Packard representative.

-250

MESSAGE

PROBE failure on the status parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-251

MESSAGE

PROBE failure on the inputfiles parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the inputfiles parameter.

-252

MESSAGE

PROBE failure on the outputfiles parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the outputfiles parameter.

-253

MESSAGE

PROBE failure on the keys parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the keys parameter.

-254

MESSAGE

PROBE failure on the altseq parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the altseq parameter.

-255

MESSAGE

PROBE failure on the statistics parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the statistics parameter.

-256

MESSAGE

PROBE failure on the charseq parameter of the HPSORTINIT intrinsic.

CAUSE

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

ACTION

Check the value of the charseq parameter.

-257

MESSAGE

PROBE failure on the status parameter of the HPSORTINPUT intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-258

MESSAGE

PROBE failure on the buffer parameter of the HPSORTINPUT intrinsic.

CAUSE

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

ACTION

Check the value of the buffer parameter.

-259

MESSAGE

PROBE failure on the length parameter of the HPSORTINPUT intrinsic.

CAUSE

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

ACTION

Check the value of the length parameter.

-260

MESSAGE

PROBE failure on the status parameter of the HPSORTOUTPUT intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-261

MESSAGE

PROBE failure on the buffer parameter of the HPSORTOUTPUT intrinsic.

CAUSE

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

ACTION

Check the value of the buffer parameter.

-262

MESSAGE

PROBE failure on the length parameter of the HPSORTOUTPUT intrinsic.

CAUSE

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

ACTION

Check the value of the length parameter.

-263

MESSAGE

PROBE failure on the status parameter of the HPSORTEND intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-264

MESSAGE

PROBE failure on the statistics parameter of the HPSORTEND intrinsic.

CAUSE

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

ACTION

Check the value of the statistics parameter.

-265

MESSAGE

PROBE failure on the status parameter of the HPSORTERRORMESS intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-266

MESSAGE

PROBE failure on the message parameter of the HPSORTERRORMESS intrinsic.

CAUSE

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

ACTION

Check the value of the message parameter.

-267

MESSAGE

PROBE failure on the length parameter of the HPSORTERRORMESS intrinsic.

CAUSE

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

ACTION

Check the value of the length parameter.

-268

MESSAGE

PROBE failure on the status parameter of the HPSORTSTAT intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-269

MESSAGE

PROBE failure on the statistics parameter of the HPSORTSTAT intrinsic.

CAUSE

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

ACTION

Check the value of the statistics parameter.

-270

MESSAGE

PROBE failure on the status parameter of the HPSORTTITLE intrinsic.

CAUSE

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

ACTION

Check the value of the status parameter.

-990

MESSAGE

Previous NM error occurred.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-992

MESSAGE

SWITCH_TO_CM error on the SORTTITLE call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-993

MESSAGE

SWITCH_TO_CM error on the SORTERRORMESS call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-994

MESSAGE

SWITCH_TO_CM error on the SORTEND2 call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-995

MESSAGE

SWITCH_TO_CM error on the SORTEND1 call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-996

MESSAGE

SWITCH_TO_CM error on the SORTOUTPUT call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-997

MESSAGE

SWITCH_TO_CM error on the SORTINPUT call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-998

MESSAGE

SWITCH_TO_CM error on the SORTGETHIDP call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-999

MESSAGE

SWITCH_TO_CM error on the SORTINIT call.

CAUSE

Internal SORT/XL error.

ACTION

Contact your Hewlett-Packard representative.

-1000

MESSAGE

HPSORTERRORMESS failed on the call to HPERRMSG.

CAUSE

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

ACTION

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