HP 3000 Manuals

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


SORT-MERGE/XL Programmer's Guide

Appendix B  HPMERGE Intrinsic Status Returns 

The following table lists the error number, message, cause, and user
corrective action for status returns for all HPMERGE intrinsics.
MERGE/XL's subsystem ID is 196.

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

-3         MESSAGE      No inputfiles parameter was specified.

           CAUSE        You did not specify the inputfiles parameter in the HPMERGEINIT
                        intrinsic.

           ACTION       Specify the inputfiles parameter.

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

-4         MESSAGE      Neither an outputfiles nor a postprocessor parameter was
                        specified.

           CAUSE        You did not specify the outputfiles parameter in the
                        HPMERGEINIT intrinsic.
           ACTION       Specify the outputfiles parameter.

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

-5         MESSAGE      If you specify the keycompare parameter, you must not specify
                        the keys and numkeys parameters.

           CAUSE        You specified both the keycompare parameter, and the keys and
                        numkeys parameters in the HPMERGEINIT intrinsic.

           ACTION       Specify the keycompare parameter or the keys and numkeys 
                        parameters.

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

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

           CAUSE        You did not specify the keys and numkeys parameters in the
                        HPMERGEINIT intrinsic.

           ACTION       Specify the keys and numkeys parameters.

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

-7         MESSAGE      Illegal numkeys parameter.

           CAUSE        The numkeys parameter does not specify the same number of keys
                        that are described in the the numkeys parameter in HPMERGEINIT.

           ACTION       Make the numkeys and keys parameters pertain to the same number
                        of keys.

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

-8         MESSAGE      The key field is not within the record length of each file.

           CAUSE        One or more files have shorter record lengths and at least one
                        key field extends outside of the file's record length.

           ACTION       Make sure your files are of the correct length and that your
                        key field in within range of the records.

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

-9         MESSAGE      Illegal ascending/descending code.

           CAUSE        The fourth element of the keys array parameter is not 1 or 0.

           ACTION       Set the fourth element of the keys array parameter to 0 for
                        ascending or 1 for descending order.

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

-10        MESSAGE      Illegal key code.

           CAUSE        The 3rd element in the keys array parameter in HPMERGEINIT 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.
---------------------------------------------------------------------------------------

-11        MESSAGE      Failure on FGETINFO (inputfile).

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

           ACTION       Make sure that the input file number hasn't been corrupted.
                        Also refer to the MPE XL Intrinsics Reference Manual 
                        (32650-90028).

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

-12        MESSAGE      FREAD error on the input file.

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

           ACTION       Make sure that the input file number hasn't been corrupted.
                        Also refer to the MPE XL Intrinsics Reference Manual 
                        (32650-90028).

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

-13        MESSAGE      FWRITE error on the output file.

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

           ACTION       Make sure that the output file number hasn't been corrupted.
                        Also refer to the MPE XL Intrinsics Reference Manual 
                        (32650-90028).

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

-14        MESSAGE      The input record does not include all key fields.

           CAUSE        You are using variable length records that contain records that
                        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      If you specify the keycompare parameter, you must not specify
                        the keysonly parameter.

           CAUSE        You specified the keycompare parameter and the keys and numkeys 
                        parameters in the HPMERGEINIT intrinsic.

           ACTION       Specify either the keycompare parameter or the keys and numkeys 
                        parameters in HPMERGEINIT.

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

-16        MESSAGE      Insufficient stack space.

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

-17        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 merging operation.

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

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

-18        MESSAGE      Failure on FGETINFO (outputfile).

           CAUSE        CCL returned from the FGETINFO intrinsic called from MERGE/XL.

           ACTION       Make sure the output file number has not been corrupted.  Also
                        refer to the MPE XL Intrinsics Reference Manual (32650-90028).

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

-19        MESSAGE      $NULL is not a valid input file.

           CAUSE        You specified $NULL as an input file.

           ACTION       Change the file specification to another file.

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

-21        MESSAGE      Sort language is not supported.

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

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

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

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

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

-23        MESSAGE      NLINFO error loading the collating sequence.

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

           ACTION       Contact your system manager or your Hewlett-Packard
                        representative.

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

-24        MESSAGE      Invalid charseq parameter.
           CAUSE        The first element of the charseq parameter array is a value
                        other than one.

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

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

-25        MESSAGE      The two-byte collating sequence table is not specified.

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

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

-26        MESSAGE      Failure on FGETINFO (two-byte collating sequence table).

           CAUSE        CCL returned from the FGETINFO intrinsic called from MERGE/XL.

           ACTION       Make sure the file number in charseq is not corrupted.  Also
                        refer to the MPE XL Intrinsics Reference Manual (32650-90028).

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

-27        MESSAGE      FREAD error on the two-byte collating sequence table.

           CAUSE        CCL returned from the FREAD intrinsic called from MERGE/XL.

           ACTION       Make sure the file number in charseq is not corrupted.  Also
                        refer to the MPE XL Intrinsics Reference Manual (32650-90028).

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

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

           CAUSE        Error returned from NLINFO intrinsic called from MERGE/XL.

           ACTION       Check the file type.  Also refer to the MPE XL Intrinsics 
                        Reference Manual (32650-90028).

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

-29        MESSAGE      Two-byte xxxx 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.

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

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

           CAUSE        The second element of the keys array parameter must be an even
                        number if a two-byte collating sequence is specified.

           ACTION       Set the second element of the keys array to an even number.

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

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

           CAUSE        You redirected output from HPMERGETITLE to a file that is too
                        small; HPMERGETITLE requires two records in which to output
                        information.

           ACTION       Allow room for at lease two records when you redirect output
                        from HPMERGETITLE to a file.

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

-41        MESSAGE      PRINT intrinsic failed in HPMERGESTAT.

           CAUSE        You redirected output from HPMERGESTAT to a file that is too
                        small; HPMERGESTAT requires ten records in which to output
                        information.

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

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

-109       MESSAGE      Illegal numkeys parameter.

           CAUSE        You specified the numkeys parameter in HPMERGEINIT 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.

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

-250       MESSAGE      PROBE failure on the status parameter of the HPMERGEINIT
                        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 HPMERGEINIT
                        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 HPMERGEINIT
                        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 HPMERGEINIT
                        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 HPMERGEINIT
                        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 HPMERGEINIT
                        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 HPMERGEINIT
                        intrinsic.

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

           ACTION       Check the value of the charseq parameter.

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

-260       MESSAGE      PROBE failure on the status parameter of the HPMERGEOUTPUT
                        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 HPMERGEOUTPUT
                        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 HPMERGEOUTPUT
                        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 HPMERGEEND
                        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 HPMERGEEND
                        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 HPMERGEERRORMESS
                        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 HPMERGEERRORMESS
                        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 HPMERGEERRORMESS
                        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 HPMERGESTAT
                        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 HPMERGESTAT
                        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 HPMERGETITLE
                        intrinsic.

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

           ACTION       Check the value of the status parameter.

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

-993       MESSAGE      SWITCH_TO_CM failed on the MERGETITLE call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-994       MESSAGE      SWITCH_TO_CM failed on the MERGEERRORMESS call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-995       MESSAGE      SWITCH_TO_CM failed on the MERGEEND2 call.

           CAUSE        Internal MERGE/XL error.
           ACTION       Contact your Hewlett-Packard representative.

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

-996       MESSAGE      SWITCH_TO_CM failed on the MERGEEND1 call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-997       MESSAGE      SWITCH_TO_CM failed on the MERGEOUTPUT call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-998       MESSAGE      SWITCH_TO_CM failed on the MERGEGETHIDP call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-999       MESSAGE      SWITCH_TO_CM failed on the MERGEINIT call.

           CAUSE        Internal MERGE/XL error.

           ACTION       Contact your Hewlett-Packard representative.

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

-1000      MESSAGE      HPMERGEERRORMESS failed on the call to HPERRMSG.

           CAUSE        You called the HPMERGEERRORMESS intrinsic even though there was
                        no error.

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

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



MPE/iX 5.0 Documentation