HP 3000 Manuals

HPSORT Intrinsic Status Returns [ SORT-MERGE/XL Programmer's Guide ] MPE/iX 5.0 Documentation


SORT-MERGE/XL Programmer's Guide

Appendix A  HPSORT Intrinsic Status Returns 

The following table lists the error number, message, cause, and user
corrective action for status returns from the HPSORT intrinsics.
SORT/XL's subsystem ID is 195.

---------------------------------------------------------------------------------------

-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 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 (32650-90028)

---------------------------------------------------------------------------------------

-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 (32650-90021).
---------------------------------------------------------------------------------------

-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 (32650-90021).

---------------------------------------------------------------------------------------

-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 (32650-90028).

---------------------------------------------------------------------------------------

-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 (32650-90028).

---------------------------------------------------------------------------------------

-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 (32650-90028)

---------------------------------------------------------------------------------------

-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 
                        (32650-90028).

---------------------------------------------------------------------------------------

-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 
                        (32650-90028).

---------------------------------------------------------------------------------------

-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 (32650-90028).

---------------------------------------------------------------------------------------

-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.

---------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation