HP 3000 Manuals

HPSORTERRORMESS [ MPE/iX Intrinsics Reference Manual ] MPE/iX 5.0 Documentation


MPE/iX Intrinsics Reference Manual

HPSORTERRORMESS 

NM callable only.

Retrieves an error message if a fatal error occurs in SORT/XL.

Syntax 
______________________________________________
|                                            |
|                      I32    CA    I32      |
|     HPSORTERRORMESS(status,message,length);|
______________________________________________

            

Parameters 

status                32-bit signed integer by reference (optional) 

                      Passes the status of a previous HPSORT intrinsic
                      call that failed.  The status value passed in is
                      used to locate the appropriate message catalog
                      entry associated with the status value.  If no
                      errors or warnings were encountered during the
                      execution of HPSORTERRORMESS, 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 
                      (32650-90066, 32650-90152, and 32650-90368) 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 HPSORTERRORMESS is 195.

message               character array (optional) 

                      Returns the text of the error message.  This
                      parameter may be up to 80 characters long.

length                32-bit signed integer by reference (optional) 

                      Returns the actual length of the message parameter
                      in characters.

Related Information 

Intrinsics            HPSORT, HPMERGE

Commands              None

Manuals               SORT-MERGE/XL Programmer's Guide (32650-90080).



MPE/iX 5.0 Documentation