HP 3000 Manuals

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


MPE/iX Intrinsics Reference Manual

FERRMSG 

NM and CM callable.

Returns a message corresponding to an FCHECK error number and enables
error messages to be displayed from a program.

Syntax 
________________________________________________
|                                              |
|                 I16        CA        I16     |
|     FERRMSG(fserrorcode,msgbuffer,msglength);|
________________________________________________

            

Parameters 

fserrorcode           16-bit signed integer by reference (required) 

                      Passes an error code returned by the FCHECK
                      intrinsic indicating which message to return in
                      msgbuffer.

msgbuffer             character array (required) 

                      Returns the error message identified with
                      fserrorcode.  To contain the longest possible
                      message, msgbuffer must be >= 72 bytes long.

msglength             16-bit signed integer by reference (required) 

                      Returns the length of the error message in
                      msgbuffer.  The length is returned in positive
                      bytes.

Condition Codes 

CCE (2)               Request granted.

CCG (0)               Request denied.  No error message exists for this
                      fserrorcode.

CCL (1)               Request denied.  The msgbuffer address was out of
                      bounds, msgbuffer was not large enough, or
                      msglength was out of bounds.

Related Information 

Intrinsics            None

Commands              None

Manuals               Accessing Files Programmer's Guide (32650-90017).



MPE/iX 5.0 Documentation